mirror of
https://code.forgejo.org/actions/setup-go.git
synced 2026-08-28 04:54:58 -04:00
71b6f8926f
By default an exact version read from go-version-file is used as written, so a "go 1.22.0" directive pins CI to the oldest patch release of the minor even when newer patches with security fixes exist. Dependencies can force such an exact version into go.mod. Setting go-version-file-behavior to latest-patch widens an exact major.minor.patch version into a ~X.Y.Z range, resolving the newest available patch release of the same minor while keeping the file's version as a floor. Bare minors and prereleases pass through unchanged. The default behavior (exact) is unchanged.
36 lines
2.3 KiB
YAML
36 lines
2.3 KiB
YAML
name: 'Setup Go environment'
|
|
description: 'Setup a Go environment and add it to the PATH'
|
|
author: 'GitHub'
|
|
inputs:
|
|
go-version:
|
|
description: 'The Go version to download (if necessary) and use. Supports semver spec and ranges. Be sure to enclose this option in single quotation marks.'
|
|
go-version-file:
|
|
description: 'Path to the go.mod, go.work, .go-version, or .tool-versions file.'
|
|
go-version-file-behavior:
|
|
description: 'How to interpret an exact version read from go-version-file. Use "latest-patch" to resolve the newest available patch release of the same minor version (e.g. "1.22.0" in go.mod resolves to the newest 1.22.x). Defaults to "exact", which uses the version as written.'
|
|
default: exact
|
|
check-latest:
|
|
description: 'Set this option to true if you want the action to always check for the latest available version that satisfies the version spec'
|
|
default: false
|
|
token:
|
|
description: Used to pull Go distributions from go-versions. Since there's a default, this is typically not supplied by the user. When running this action on github.com, the default value is sufficient. When running on GHES, you can pass a personal access token for github.com if you are experiencing rate limiting.
|
|
default: ${{ github.server_url == 'https://github.com' && github.token || '' }}
|
|
cache:
|
|
description: Used to specify whether caching is needed. Set to true, if you'd like to enable caching.
|
|
default: true
|
|
cache-dependency-path:
|
|
description: 'Used to specify the path to a dependency file (e.g., go.mod, go.sum)'
|
|
architecture:
|
|
description: 'Target architecture for Go to use. Examples: x86, x64. Will use system architecture by default.'
|
|
go-download-base-url:
|
|
description: 'Custom base URL for downloading Go distributions. Use this to download Go from a mirror or custom source. Defaults to "https://go.dev/dl". Can also be set via the GO_DOWNLOAD_BASE_URL environment variable. The input takes precedence over the environment variable.'
|
|
outputs:
|
|
go-version:
|
|
description: 'The installed Go version. Useful when given a version range as input.'
|
|
cache-hit:
|
|
description: 'A boolean value to indicate if a cache was hit'
|
|
runs:
|
|
using: 'node24'
|
|
main: 'dist/setup/index.js'
|
|
post: 'dist/cache-save/index.js'
|
|
post-if: success()
|