goreleaser/www/docs/cookbooks/override-image-name.md

Override hardcoded registry and image name ?

If you are curious about how to avoid hard-coded registry and image names within your .goreleaser.yml, we have good news for you. Here is the solution. Suppose you haven't been aware of GoReleaser Action, which allows you to install GoReleaser binary in your workflow easily. In that case, this is the right time to be mindful of that because, in this section, we'll give an example through GoReleaser's GitHub Action.

To get more detail about the GoReleaser's GitHub Action, please see.

As you can see from the description here, you can pass environment variables to the GoReleaser to use within the .goreleaser.yml via syntax {{ .Env.<something> }}. So, let' define our registry and image names as an environment variable in the workflow, then pass those to the GoReleaser via env section of the GoReleaser's GitHub Action like the following:

 jobs:
  # use goreleaser to cross-compile go binaries and add them to GitHub release
  goreleaser:
    runs-on: ubuntu-latest
    env:
      REGISTRY: "ghcr.io"
      IMAGE_NAME: "google/addlicense"
...
      - name: Run GoReleaser
        uses:  goreleaser/goreleaser-action@v4
        with:
          distribution: goreleaser
          version: latest
          args: release --clean
       env:
         REGISTRY: ${{ env.REGISTRY }}
         IMAGE: ${{ env.IMAGE_NAME }}
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Once you pass those to the GoReleaser, you can access them within your .goreleaser.yml file as I mentioned above, here is the example of this:

dockers:
    - image_templates:
        - '{{ .Env.REGISTRY }}/{{ .Env.IMAGE_NAME }}:{{ .Tag }}-amd64'
      dockerfile: Dockerfile.goreleaser
      use: buildx
      build_flag_templates:
        - "--pull"
        - "--label=org.opencontainers.image.created={{.Date}}"
        - "--label=org.opencontainers.image.name={{.ProjectName}}"
        - "--label=org.opencontainers.image.revision={{.FullCommit}}"
        - "--label=org.opencontainers.image.version={{.Version}}"
        - "--label=org.opencontainers.image.source={{.GitURL}}"
        - "--platform=linux/amd64"

That's all we need to do, you even might be surprised when you notice that how easy it is to overcome this issue.