Go

Go modules have no central registry. A module is "published" by tagging a version in its repository, and the Go module proxy serves it from there. See the Go configuration for module path options.

Because of this, the Go target needs no registry account, no token, and no secrets. The vX.Y.Z Git tag and GitHub Release cut when you merge the release pull request are the published version.

Enable publishing

{
  "targets": {
    "go": {
      "repo": "acme/acme-go",
      "publish": { "go": true }
    }
  }
}

This adds the VERSIONING.md note and ensures every release is tagged. The generated sdk-ci.yml builds and vets the module on each pull request.

Go is the one tag-served target that still gets a release workflow, but it uploads nothing. After the tag is cut, the publish job asks the public Go module proxy for the new version so it is cached (and indexed on pkg.go.dev) immediately, instead of on the first consumer's go get. It reads the module path out of go.mod at run time and is best-effort: a private repository is invisible to the public proxy, and a failed warm-up never fails the release.

How consumers install it

go get github.com/acme/acme-go@v1.2.3

The proxy fetches the version from the Git tag the first time someone requests it.

Notes

• The repository must be public for the public module proxy to serve it. For private modules, consumers set GOPRIVATE (or use a private proxy).
• The module path is derived from the repository, so make sure the repo matches where consumers will import from.