mirror of
https://code.forgejo.org/actions/setup-go.git
synced 2026-08-27 20:44:57 -04:00
f75efb3f19
- latest-patch implies check-latest so the newest patch release comes from the versions manifest instead of a possibly stale runner tool cache, with a warning when the manifest cannot be reached - fail fast when latest-patch is combined with a custom download base URL - never widen an exact toolchain directive pin - validate go-version-file-behavior on every input path - widen v-prefixed versions and log when a version is used as written - document dependency cache invalidation on new patch releases
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); this implies check-latest and is not supported with go-download-base-url. 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()
|