This action sets up a go environment for use in actions by:

• optionally downloading and caching a version of Go by version and adding to PATH
• registering problem matchers for error output

The V2 offers:

• Adds GOBIN to the PATH
• 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 repository and on miss or failure, it will fall back to the previous behavior of download directly from go dist.

Matching by semver spec:

steps:
  - 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

Matching an unstable pre-release:

steps:
  - 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

See action.yml

Basic:

steps:
  - 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

Matrix Testing:

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        go: [ '1.14', '1.13' ]
    name: Go ${{ matrix.go }} sample
    steps:
      - uses: actions/checkout@v2
      - name: Setup go
        uses: actions/setup-go@v2
        with:
          go-version: ${{ matrix.go }}
      - run: go run hello.go

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 documentation

The scripts and documentation in this project are released under the MIT License

Contributions are welcome! See Contributor's Guide

👋 Be nice. See our code of conduct