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

Too Long; Didn't Read

In your car, at home, or at work — Bosch technology shapes many areas of life.

Publish Go Packages With Goreleaser

Too Long; Didn't Read

Company Mentioned

Damilare Ogunmola

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

Publish Go Packages With Goreleaser

Too Long; Didn't Read

Company Mentioned

Damilare Ogunmola

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

RELATED STORIES