setup-go/README.md

51 lines
1.2 KiB
Markdown
Raw Normal View History

2019-07-17 10:50:58 -04:00
# setup-go
2019-06-19 09:44:17 -04:00
2019-08-12 15:13:31 -04:00
<p align="left">
<a href="https://github.com/actions/setup-go"><img alt="GitHub Actions status" src="https://github.com/actions/setup-go/workflows/Main%20workflow/badge.svg"></a>
</p>
2019-07-17 10:50:58 -04:00
This action sets up a go environment for use in actions by:
2019-06-19 09:44:17 -04:00
2019-07-17 10:50:58 -04:00
- optionally downloading and caching a version of go by version and adding to PATH
- registering problem matchers for error output
# Usage
See [action.yml](action.yml)
Basic:
```yaml
2019-07-25 21:28:46 -04:00
steps:
2019-07-23 15:46:37 -04:00
- uses: actions/checkout@master
2019-08-01 09:19:30 -04:00
- uses: actions/setup-go@v1
2019-07-17 10:50:58 -04:00
with:
2019-08-01 11:05:15 -04:00
version: '1.9.3' // The Go version to download (if necessary) and use.
2019-07-17 10:50:58 -04:00
- run: go run hello.go
```
Matrix Testing:
```yaml
jobs:
build:
2019-08-01 11:05:15 -04:00
runs-on: ubuntu-16.04
2019-07-17 10:50:58 -04:00
strategy:
matrix:
2019-08-01 11:05:15 -04:00
go: [ '1.8', '1.9.3', '1.10' ]
2019-07-17 10:50:58 -04:00
name: Go ${{ matrix.go }} sample
2019-07-25 21:28:46 -04:00
steps:
2019-07-23 15:46:37 -04:00
- uses: actions/checkout@master
2019-07-17 10:50:58 -04:00
- name: Setup go
2019-08-01 09:19:30 -04:00
uses: actions/setup-go@v1
2019-07-17 10:50:58 -04:00
with:
version: ${{ matrix.go }}
- run: go run hello.go
```
2019-06-19 09:44:17 -04:00
# License
The scripts and documentation in this project are released under the [MIT License](LICENSE)
# Contributions
Contributions are welcome! See [Contributor's Guide](docs/contributors.md)