goreleaser/goreleaser-action@v7

GitHub Action for GoReleaser, a release automation tool for Go projects

At a glance

Latest major
v7
Repository
goreleaser/goreleaser-action
Inputs
6 (0 required)
Outputs
2
Runs using
node24
License
MIT
Last checked

Inputs and outputs come straight from the action's official action.yml. See our editorial standards.

Usage

- uses: goreleaser/goreleaser-action@v7

Inputs

NameRequiredDefaultDescription
distributionNogoreleaserGoReleaser Distribution (goreleaser or goreleaser-pro)
versionNo~> v2GoReleaser version
version-fileNononeRead the GoReleaser version from a file. Path is resolved relative to `workdir`. Currently only `.tool-versions` (asdf/mise) is supported. When set, takes precedence over `version`.
argsNononeArguments to pass to GoReleaser
workdirNo.Working directory (below repository root)
install-onlyNofalseJust install GoReleaser

Outputs

NameDescription
artifactsBuild result artifacts
metadataBuild result metadata

Read an output with ${{ steps.<step-id>.outputs.<name> }}; the step needs an id.

Examples

Release a Go project

Build and publish release archives when a tag is pushed.

name: Example
on:
  push:
    tags: ["v*"]

permissions:
  contents: write

jobs:
  example:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - name: GoReleaser Action
        uses: goreleaser/goreleaser-action@v7
        with:
          distribution: goreleaser
          version: "~> v2"
          args: release --clean

Each example passed actionlint (syntax, expressions and the inputs it knows for this action). They were not run in a live repository, so replace placeholder values such as names, ARNs and paths with your own.

Something out of date or wrong? Report it on our Contact page. This page is rebuilt from the action's repository roughly once a week.