Skip to content

Latest commit

 

History

History
287 lines (214 loc) · 7.35 KB

install.md

File metadata and controls

287 lines (214 loc) · 7.35 KB
Raw

Install

There are two GoReleaser distributions: OSS and Pro.

You can install the pre-compiled binary (in several different ways), use Docker or compile from source (when on OSS).

Bellow you can find the steps for each of them.

Install the pre-compiled binary

homebrew tap

=== "OSS" sh brew install goreleaser/tap/goreleaser

=== "Pro" sh brew install goreleaser/tap/goreleaser-pro

homebrew

=== "OSS" sh brew install goreleaser

!!! info The formula in homebrew-core might be slightly outdated. Use our homebrew tap to always get the latest updates.

snapcraft

=== "OSS" sh sudo snap install --classic goreleaser

scoop

=== "OSS" sh scoop bucket add goreleaser https://github.com/goreleaser/scoop-bucket.git scoop install goreleaser

=== "Pro" sh scoop bucket add goreleaser https://github.com/goreleaser/scoop-bucket.git scoop install goreleaser-pro

apt

=== "OSS" sh echo 'deb [trusted=yes] https://repo.goreleaser.com/apt/ /' | sudo tee /etc/apt/sources.list.d/goreleaser.list sudo apt update sudo apt install goreleaser

=== "Pro" sh echo 'deb [trusted=yes] https://repo.goreleaser.com/apt/ /' | sudo tee /etc/apt/sources.list.d/goreleaser.list sudo apt update sudo apt install goreleaser-pro

yum

=== "OSS" sh echo '[goreleaser] name=GoReleaser baseurl=https://repo.goreleaser.com/yum/ enabled=1 gpgcheck=0' | sudo tee /etc/yum.repos.d/goreleaser.repo sudo yum install goreleaser

=== "Pro" sh echo '[goreleaser] name=GoReleaser baseurl=https://repo.goreleaser.com/yum/ enabled=1 gpgcheck=0' | sudo tee /etc/yum.repos.d/goreleaser.repo sudo yum install goreleaser-pro

deb, rpm and apk packages

=== "OSS" Download the .deb, .rpm or .apk packages from the OSS releases page and install them with the appropriate tools.

=== "Pro" Download the .deb, .rpm or .apk packages from the Pro releases page and install them with the appropriate tools.

shell script

=== "OSS" sh curl -sfL https://install.goreleaser.com/github.com/goreleaser/goreleaser.sh | sh

go install

=== "OSS" sh go install github.com/goreleaser/goreleaser@latest

manually

=== "OSS" Download the pre-compiled binaries from the OSS releases page and copy them to the desired location.

=== "Pro" Download the pre-compiled binaries from the Pro releases page and copy them to the desired location.

Verifying the binaries

All artifacts are checksummed and the checksum file is signed with cosign.

You can verify it using our public key.

=== "OSS" 1. Download the files you want, the goreleaser_checksums.txt and goreleaser_checksums.txt.sig files from the releases page. 1. Get our public key: sh wget https://goreleaser.com/static/goreleaser.pub 1. Verify the signature: sh cosign verify-blob \ -key goreleaser.pub \ -signature goreleaser_checksums.txt.sig \ goreleaser_checksums.txt 1. If the signature is valid, you can then verify the SHA256 sums match with the downloaded binary: sh sha256sum --ignore-missing -c goreleaser_checksums.txt

=== "Pro" 1. Download the files you want, the goreleaser-pro_checksums.txt and goreleaser-pro_checksums.txt.sig files from the releases page. 1. Get our public key: sh wget https://goreleaser.com/static/goreleaser.pub 1. Verify the signature: sh cosign verify-blob \ -key goreleaser.pub \ -signature goreleaser-pro_checksums.txt.sig \ goreleaser-pro_checksums.txt 1. If the signature is ok, you can then verify the SHA256 sums match with the downloaded binary: sh sha256sum --ignore-missing -c goreleaser-pro_checksums.txt

Verifying docker images

Our Docker image is signed with cosign.

You can verify it using our public key.

=== "OSS" sh wget https://goreleaser.com/static/goreleaser.pub cosign verify -key goreleaser.pub goreleaser/goreleaser cosign verify -key goreleaser.pub ghcr.io/goreleaser/goreleaser

=== "Pro" sh wget https://goreleaser.com/static/goreleaser.pub cosign verify -key goreleaser.pub goreleaser/goreleaser-pro cosign verify -key goreleaser.pub ghcr.io/goreleaser/goreleaser-pro

Running with Docker

You can also use it within a Docker container. To do that, you'll need to execute something more-or-less like the examples bellow.

=== "OSS" Registries:

- [`goreleaser/goreleaser`](https://hub.docker.com/r/goreleaser/goreleaser)
- [`ghcr.io/goreleaser/goreleaser`](https://github.com/orgs/goreleaser/packages/container/package/goreleaser)

Example usage:

```sh
docker run --rm --privileged \
  -v $PWD:/go/src/github.com/user/repo \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -w /go/src/github.com/user/repo \
  -e GITHUB_TOKEN \
  -e DOCKER_USERNAME \
  -e DOCKER_PASSWORD \
  -e DOCKER_REGISTRY \
  goreleaser/goreleaser release
```

=== "Pro" Registries:

- [`goreleaser/goreleaser-pro`](https://hub.docker.com/r/goreleaser/goreleaser-pro)
- [`ghcr.io/goreleaser/goreleaser-pro`](https://github.com/orgs/goreleaser/packages/container/package/goreleaser-pro)

Example usage:

```sh
docker run --rm --privileged \
  -v $PWD:/go/src/github.com/user/repo \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -w /go/src/github.com/user/repo \
  -e GITHUB_TOKEN \
  -e DOCKER_USERNAME \
  -e DOCKER_PASSWORD \
  -e DOCKER_REGISTRY \
  -e GORELEASER_KEY \
  goreleaser/goreleaser-pro release
```

!!! info Currently, the provided docker image does not support the generation of snapcraft packages.

Note that the image will almost always have the last stable Go version.

The DOCKER_REGISTRY environment variable can be left empty when you are releasing to the public docker registry.

If you need more things, you are encouraged to keep your own image. You can always use GoReleaser's own Dockerfile as an example though and iterate from that.

Compiling from source

Here you have two options:

If you want to contribute to the project, please follow the steps on our contributing guide.

If you just want to build from source for whatever reason, follow these steps:

clone:

git clone https://github.com/goreleaser/goreleaser
cd goreleaser

get the dependencies:

go mod tidy

build:

go build -o goreleaser .

verify it works:

./goreleaser --version