is awesome. It's a simple tool that allows you to release your packages. Recently, my team and I used it with a company-wide CLI tool that we built. Goreleaser go In this tutorial, we'll use to automate the release of a simple package. goreleaser go Installation On macOS, to install , we can install using: goreleaser go install github.com/goreleaser/goreleaser@latest Or we use the popular package manager for macOS and Linux with: homebrew brew install goreleaser/tap/goreleaser On Ubuntu Linux, we can use : apt 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 More options can be found . here Create Package Create a new folder to house our project. Then initialize the modules with: go mod init main Next, we create a file called . In , copy and paste the following code: main.go main.go package main func main() { println("This is a tutorial about Goreleaser!") } Initialize Goreleaser The next step is to set up . To do this, we run: goreleaser goreleaser init This command creates the file in our directory. We'll take a closer look at this file. .goreleaser.yaml Update .goreleaser.yaml I have added a few more fields to the generated file. We'll go through the important parts. .goreleaser.yaml release: github: owner: justdamilare name: mytool before: hooks: - go mod tidy - go generate ./... builds: - env: - GO_VERSION=1.19 goos: - linux - windows - darwin # replaces architecture naming in the archive name archives: - replacements: darwin: Darwin linux: Linux windows: Windows 386: i386 amd64: x86_64 format_overrides: - goos: windows format: zip checksum: name_template: 'checksums.txt' snapshot: name_template: "{{ incpatch .Version }}-next" changelog: sort: asc filters: exclude: - '^docs:' - '^test:' # upload binaries to gcloud bucket called `mytool` blobs: - provider: gs bucket: mytool folder: "{{ .Version }}" # generate homebrew-tap brews: - name: justdamilare tap: owner: mytool name: homebrew-tap folder: Formula homepage: https://github.com/justdamilare/mytool description: A simple go project # use custom download strategy in case the Github repository is private download_strategy: GitHubPrivateRepositoryReleaseDownloadStrategy custom_require: "../custom_download_strategy" test: | system "#{bin}/mytool" install: | bin.install "mytool" It should be noted that if and are not needed, the sections can be removed. If is needed, a GitHub repo called should be created also. homebrew-tap blobs homebrew-tap homebrew-tap Release Package Finally, we can release our packages. To do that, we need to create a tag for our release on Git. For example, to create a tag for version , we can run: 0.1.0 git tag v0.1.0 and git push origin v0.1.0 Then in the directory with , run: main.go goreleaser release Goreleaser will build all the binaries. These binaries will be uploaded automatically to Github using the local GitHub credentials. The builds will also be located in a folder in the home directory. /dist If the publish method is included, a generated file will also be in the folder. In case Goreleaser does not copy the generated to the repo automatically, it can be copied manually. brew *.rb /dist Formula homebrew-tap You can see how to publish the build to a private homebrew-tap . here Summary Install goreleaser Create package go Initialize Goreleaser with goreleaser init Update .goreleaser.yaml Release build by creating a tag with and then run git tag vX.X.X goreleaser release Photo by on Leone Venter Unsplash
