Skip to content

Update GoTool task documentation to clarify download URL options and … #21712

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rm-dmiri wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Update GoTool task documentation to clarify download URL options and … #21712

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d1cb964
Update GoTool task documentation to clarify download URL options and …
rm-dmiri Jan 19, 2026
c056f33
Bump GoTool task patch version to 1
rm-dmiri Jan 19, 2026
090c3c3
Update Go download URL help text for clarity and consistency
rm-dmiri Jan 19, 2026
9e694c8
Merge branch 'master' into users/rm-dmiri/document-gotool-env-var
rm-dmiri Jan 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion Tasks/GoToolV0/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,9 @@ This task can run on Windows, Linux, or Mac machines.

* **Go download URL:** URL for downloading Go binaries. Leave empty to use the default (https://go.dev/dl). Supported URLs:
- `https://go.dev/dl` - [Official Go distribution](https://go.dev/dl/). (default)
- `https://aka.ms/golang/release/latest` - the [Microsoft build of Go](https://github.com/microsoft/go), a fork of the official Go distribution. See [the Migration Guide](https://github.com/microsoft/go/blob/microsoft/main/eng/doc/MigrationGuide.md) for an introduction to the Microsoft build of Go.
- `https://aka.ms/golang/release/latest` - the [Microsoft build of Go](https://github.com/microsoft/go) prefix, a fork of the official Go distribution. See [the Migration Guide](https://github.com/microsoft/go/blob/microsoft/main/eng/doc/MigrationGuide.md) for an introduction to the Microsoft build of Go.

### Environment Variables

* **GOTOOL_GODOWNLOADURL:** Optional. Specify the download URL for Go binaries. If both the **Go download URL** task parameter and this environment variable are set, the task parameter takes precedence.

2 changes: 1 addition & 1 deletion Tasks/GoToolV0/Strings/resources.resjson/en-US/resources.resjson
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
"loc.input.label.goBin": "GOBIN",
"loc.input.help.goBin": "A custom value for the GOBIN environment variable.",
"loc.input.label.goDownloadUrl": "Go download URL",
"loc.input.help.goDownloadUrl": "URL for downloading Go binaries. Only https://go.dev/dl (official) and https://aka.ms/golang/release/latest (Microsoft build) are supported. If omitted, the official Go download URL (https://go.dev/dl) will be used. This parameter takes priority over the GOTOOL_GODOWNLOADURL environment variable if both are set.",
"loc.input.help.goDownloadUrl": "URL for downloading Go binaries. Only https://go.dev/dl (official) and https://aka.ms/golang/release/latest (Microsoft build prefix) are supported. If omitted, the official Go download URL (https://go.dev/dl) will be used. You can also set the 'GOTOOL_GODOWNLOADURL' environment variable to specify the download URL. The parameter takes priority over the environment variable if both are set.",
"loc.messages.FailedToDownload": "Failed to download Go version %s. Verify that the version is valid and resolve any other issues. Error: %s",
"loc.messages.TempDirNotSet": "The 'Agent.TempDirectory' environment variable was expected to be set."
}
4 changes: 2 additions & 2 deletions Tasks/GoToolV0/task.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"author": "Microsoft Corporation",
"version": {
"Major": 0,
"Minor": 268,
"Minor": 269,
"Patch": 0
},
"satisfies": [
Expand Down Expand Up @@ -57,7 +57,7 @@
"label": "Go download URL",
"required": false,
"defaultValue": "https://go.dev/dl",
"helpMarkDown": "URL for downloading Go binaries. Only https://go.dev/dl (official) and https://aka.ms/golang/release/latest (Microsoft build) are supported. If omitted, the official Go download URL (https://go.dev/dl) will be used. This parameter takes priority over the GOTOOL_GODOWNLOADURL environment variable if both are set.",
"helpMarkDown": "URL for downloading Go binaries. Only https://go.dev/dl (official) and https://aka.ms/golang/release/latest (Microsoft build prefix) are supported. If omitted, the official Go download URL (https://go.dev/dl) will be used. You can also set the 'GOTOOL_GODOWNLOADURL' environment variable to specify the download URL. The parameter takes priority over the environment variable if both are set.",
"groupName": "advanced"
}
],
Expand Down
2 changes: 1 addition & 1 deletion Tasks/GoToolV0/task.loc.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"author": "Microsoft Corporation",
"version": {
"Major": 0,
"Minor": 268,
"Minor": 269,
"Patch": 0
},
"satisfies": [
Expand Down