Using GoReleaser on CircleCI for Continuous Deployment

Posted on November 17, 2020

The GoReleaser CircleCI orb makes it very simple to compile and publish Go projects on CircleCI. Here’s a quick look.

In GoReleaser’s own words, “Deliver Go binaries as fast and easily as possible. GoReleaser builds Go binaries for several platforms, creates a GitHub release and then pushes a Homebrew formula to a tap repository.” It also supports automated publishing of Linux Snaps, .deb packages, rpm packages, and more. CircleCI orbs on the other hand are reusable snippets of CircleCI configuration, the stuff that powers your Continuous Integration.

This GoReleaser CircleCI orb makes it simple to install GoReleaser in a CI builds and use it to make a release. You can find the official orb page here and the GitHub repository here.

Here’s an example CircleCI config using the GoReleaser orb job to publish on git tags:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53


version: 2.1

orbs:
  gor: hubci/goreleaser@1.0

workflows:
  # General workflow for regular commits
  main:
    jobs:
      - test
      - gor/release:
          version: "0.147.1"
          go-version: "1.15.5"
          dry-run: true
  # Workflow for releasing with git tags
  release:
    jobs:
      - test:
          filters:
            branches:
              ignore: /.*/
            tags:
              # Simplified SemVer regex
              only: /^v\d+\.\d+\.\d+$/
      - gor/release:
          version: "0.147.1"
          go-version: "1.15.5"
          filters:
            branches:
              ignore: /.*/
            tags:
              # Simplified SemVer regex
              only: /^v\d+\.\d+\.\d+$/

jobs:
  test:
    docker:
      - image: cimg/go:1.15.5
    steps:
      - checkout
      - restore_cache:
          keys:
            - go-mod-v1
      - run:
          name: "Download Dependancies"
          command: cd src && go mod download
      - run:
          name: "Run Tests"
          command: cd src && go test
      - save_cache:
          key: go-mod-v1
          paths:
            - "/go/pkg/mod"

It’s completely open source. Please submit feedback and feature requests on GitHub.