setup-go/README.md

95 lines
2.7 KiB
Markdown
Raw Normal View History

2019-07-17 16:50:58 +02:00
# setup-go
2019-06-19 15:44:17 +02:00
2019-08-12 21:13:31 +02:00
<p align="left">
2020-02-09 06:21:39 +01:00
<a href="https://github.com/actions/setup-go/actions"><img alt="GitHub Actions status" src="https://github.com/actions/setup-go/workflows/build-test/badge.svg"></a>
<a href="https://github.com/actions/setup-go/actions"><img alt="versions status" src="https://github.com/actions/setup-go/workflows/go-versions/badge.svg"></a>
2019-08-12 21:13:31 +02:00
</p>
2019-07-17 16:50:58 +02:00
This action sets up a go environment for use in actions by:
2019-06-19 15:44:17 +02:00
2019-08-13 22:31:11 +02:00
- optionally downloading and caching a version of Go by version and adding to PATH
2019-07-17 16:50:58 +02:00
- registering problem matchers for error output
2020-04-17 00:52:17 +02:00
# V2
2020-02-09 20:39:34 +01:00
2020-04-17 00:52:17 +02:00
The V2 offers:
- Adds GOBIN to the PATH
2020-02-09 20:39:34 +01:00
- Proxy Support
- stable input
- Bug Fixes (including issues around version matching and semver)
It will first check the local cache for a version match. If version is not found locally, It will pull it from `main` branch of [go-versions](https://github.com/actions/go-versions/blob/main/versions-manifest.json) repository and on miss or failure, it will fall back to the previous behavior of download directly from [go dist](https://storage.googleapis.com/golang).
Matching by [semver spec](https://github.com/npm/node-semver):
2020-02-09 20:39:34 +01:00
```yaml
steps:
2021-11-08 11:28:08 +01:00
- uses: actions/checkout@v2
- uses: actions/setup-go@v2
with:
go-version: '^1.13.1' # The Go version to download (if necessary) and use.
- run: go version
2020-02-09 20:39:34 +01:00
```
2020-02-11 01:18:01 +01:00
Matching an unstable pre-release:
```yaml
steps:
2021-11-08 11:28:08 +01:00
- uses: actions/checkout@v2
- uses: actions/setup-go@v2
with:
stable: 'false'
go-version: '1.14.0-rc1' # The Go version to download (if necessary) and use.
- run: go version
2020-02-11 01:18:01 +01:00
```
2019-07-17 16:50:58 +02:00
# Usage
See [action.yml](action.yml)
Basic:
```yaml
2019-07-26 03:28:46 +02:00
steps:
2021-11-08 11:28:08 +01:00
- uses: actions/checkout@master
- uses: actions/setup-go@v2
with:
go-version: '1.9.3' # The Go version to download (if necessary) and use.
- run: go run hello.go
2019-07-17 16:50:58 +02:00
```
Matrix Testing:
```yaml
jobs:
build:
runs-on: ubuntu-latest
2019-07-17 16:50:58 +02:00
strategy:
matrix:
2020-07-22 13:52:29 +02:00
go: [ '1.14', '1.13' ]
2019-07-17 16:50:58 +02:00
name: Go ${{ matrix.go }} sample
2019-07-26 03:28:46 +02:00
steps:
2020-02-09 06:21:39 +01:00
- uses: actions/checkout@v2
2019-07-17 16:50:58 +02:00
- name: Setup go
2020-11-27 08:11:50 +01:00
uses: actions/setup-go@v2
2019-07-17 16:50:58 +02:00
with:
2019-08-13 22:31:11 +02:00
go-version: ${{ matrix.go }}
2019-07-17 16:50:58 +02:00
- run: go run hello.go
```
2019-06-19 15:44:17 +02:00
### Supported version syntax
The `go-version` input supports the following syntax:
Specific versions: `1.15`, `1.16.1`, `1.17.0-rc2`, `1.16.0-beta1`
SemVer's version range syntax: `^1.13.1`
For more information about semantic versioning please refer [semver](https://github.com/npm/node-semver) documentation
2019-06-19 15:44:17 +02: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)
2020-02-09 06:21:39 +01:00
## Code of Conduct
:wave: Be nice. See [our code of conduct](CONDUCT)