multi os binary build

setup gox

gox๋ผ๋Š” ๋ช…๋ น์–ด๋ฅผ ์ด์šฉํ•  ๊ฒƒ์ด๋‹ค.

Gox - Simple Go Cross Compilation

๋‹ค์Œ ์›น์‚ฌ์ดํŠธ๋ฅผ ์ฐธ๊ณ ํ•˜์ž.

https://github.com/mitchellh/gox

project ํด๋”์—์„œ ๋‹ค์Œ์„ ์‹คํ–‰ํ•œ๋‹ค.

go get github.com/mitchellh/gox@v1.0.1

go.mod์— ๋‚ด์šฉ์ด ์ถ”๊ฐ€๋œ๊ฑธ ํ™•์ธํ• ์ˆ˜ ์žˆ๋‹ค.

์ด์ œ ci/cd์‹œ์— ์ด ํ”„๋กœ์ ํŠธ๋ฅผ ์„ค์น˜ํ•˜๊ฒŒ ํ•ด์ฃผ๋ฉด๋œ๋‹ค.

tools.go ์ถ”๊ฐ€

vi tools.go

//go:build tools
// +build tools

package main

// These imports are to force `go mod tidy` not to remove that tools we depend
// on development. This is explained in great detail in
// https://marcofranssen.nl/manage-go-tools-via-go-modules/
import (
  _ "github.com/mitchellh/gox"
)

build

make ํŒŒ์ผ์„ ์‚ฌ์šฉํ•ด์„œ ๋นŒ๋“œ๋ฅผ ํ•ด๋ณด์ž.

ํ”„๋กœ์ ํŠธ์— Makefile์„ ๋งŒ๋“ค์ž.

vi Makefile

PROJECT_NAME := jiractl

.PHONY: setup clean build-binaries
setup: clean
 $Q mkdir -p bin/
 $Q go mod tidy
# From https://marcofranssen.nl/manage-go-tools-via-go-modules/
 @cat tools.go | \
  grep _ | \
  awk -F'"' '{print $$2}' | \
  GOBIN=$(CURDIR)/bin xargs -tI % go install %

clean:
 $Q rm -rf bin/*

BUILD_PLATFORMS ?= -os '!netbsd' -os '!openbsd'

build-binaries: setup
 # Building $(PROJECT_NAME) for $(BUILD_PLATFORMS)
 ${CURDIR}/bin/gox $(BUILD_PLATFORMS) \
  -output="bin/binaries/$(PROJECT_NAME)-{{.OS}}-{{.Arch}}" .

clean -> setup -> build-binaries ๋กœ ๋™์ž‘ํ•œ๋‹ค.

make build-binaries๋ฅผ ํ•˜๋ฉด ํŒจํ‚ค์ง€๋ฅผ ๋นŒ๋“œํ•œ๋‹ค.

ci/cd setup

.gitlab-ci.yml

variables:
  GO_VERSION: '1.18.5'
  # See https://docs.gitlab.com/ee/user/packages/generic_packages/#publish-a-package-file
  PACKAGE_REGISTRY_URL: '$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/generic/jiractl'

image: golang:${GO_VERSION}

.binaries: &binaries
  image: golang:1.18
  rules:
    - if: '$CI_COMMIT_TAG'
  stage: build
  script:
    - export platforms=$(echo $CI_JOB_NAME | sed 's|binaries ||')
    - make build-binaries BUILD_PLATFORMS="-osarch='$platforms'"
  artifacts:
    paths:
      - app/bin/binaries
    expire_in: 7d

binaries darwin/amd64: *binaries
binaries darwin/arm64: *binaries
binaries freebsd/386 freebsd/amd64 freebsd/arm: *binaries
binaries linux/386 linux/amd64 linux/arm linux/arm64 linux/ppc64le: *binaries
binaries windows/386 windows/amd64:
  extends: .binaries

yaml yank๋ฅผ ์ด์šฉํ•ด์„œ yaml์„ ์ค„์—ฟ๋‹ค. ๊ธฐ๋ณธ์ ์œผ๋กœ๋Š” *binaries์— ์œ„์— binary๋ฅผ ๋‹ค ๋„ฃ์–ด์ฃผ๋ฉด ๋œ๋‹ค.

binaries darwin/amd64 ์ด๊ฒŒ ์ž‘์—… ์ด๋ฆ„์ธ๋ฐ ์ด๊ฒƒ์ค‘์š” darwin/amd64๋ฅผ ๊ฐ€์ ธ์™€์„œ ๊ทธ๊ฑธ make์— ๋ณด๋‚ด์ฃผ๋ฉด make๊ฐ€ ๋นŒ๋“œ๋ฅผ ํ•˜๋Š” ๊ตฌ์กฐ์ด๋‹ค.

artifact๋ฅผ ์ด์šฉํ•˜์—ฌ ์ €์žฅ์„ ํ•ด๋‘๋Š”๊ฒƒ์ด๋‹ค. ์ด๋ ‡๊ฒŒ ํ•ด๋‘๋ฉด ui์—์„œ ๋‹ค์šด๋กœ๋“œ๋ฅผ ๋ฐ›์„์ˆ˜ ์žˆ๋‹ค.

upload artifact to package & registries

vi .gitlab-ci.yml

upload binaries to generic package for tag:
  stage: publish
  image: curlimages/curl:latest
  needs:
    - 'binaries darwin/amd64'
    - 'binaries darwin/arm64'
    - 'binaries freebsd/386 freebsd/amd64 freebsd/arm'
    - 'binaries linux/386 linux/amd64 linux/arm linux/arm64 linux/ppc64le'
    - 'binaries windows/386 windows/amd64'
  rules:
    - if: '$CI_COMMIT_TAG'
  script:
    - cd app/bin/binaries/
    - |
      for FILE in *; do
        curl --header "JOB-TOKEN: ${CI_JOB_TOKEN}" --upload-file ${FILE} ${PACKAGE_REGISTRY_URL}/${CI_COMMIT_TAG}/${FILE} ;
      done

์•„๊นŒ ์„ค์ •ํ•ด๋‘” variable ์„ ์‚ฌ์šฉํ•œ๋‹ค.

PACKAGE_REGISTRY_URL: '$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/generic/jiractl'

for๋ฌธ์„ ๋Œ๋ฉด์„œ ํŒŒ์ผ์„ ์—…๋กœ๋“œํ•œ๋‹ค.

์‹คํ–‰ํ•˜๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํŒจํ‚ค์ง€์— ์—…๋กœ๋“œ ๋จ์„ ์•Œ์ˆ˜์žˆ๋‹ค.

release

vi .gitlab-ci.yml

์ผ๋‹จ git์— ๋กœ๊ทธ๋ฅผ ์ฝ์–ด์™€์„œ description์ด๋ผ๋Š” ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์‚ฌ์šฉํ•ด์•ผํ•˜๋ฏ€๋กœ ํŒŒ์ผ์— ์ ์–ด๋‘”ํ›„ artifact์— ์ถ”๊ฐ€ํ•ด์ค€๋‹ค. ๋‚˜์ค‘์— $DESCRIPTION ์ด๋Ÿฌ๋ฉด ๋‹ค๋ฅธ ์ž‘์—…์—์„œ ์‚ฌ์šฉํ• ์ˆ˜ ์žˆ๋‹ค.

generate_description:
  # generate_description needs to run in a previous stage before release
  stage: publish
  rules:
    - if: '$CI_COMMIT_TAG'
  script:
    # generate description from annotated tag's subject
    - echo "DESCRIPTION=$(git log $(git describe --tags --abbrev=0 HEAD^)..HEAD --pretty=format:'At %ci, %cN committed %h - %s' --decorate --graph)" > description.env
    - cat description.env
  artifacts:
    reports:
      dotenv: description.env

์ด์ œ release๋ฅผ ์ƒ์„ฑํ•˜์ž file์€ ๋งํฌ๋กœ ์žก์•„์„œ ์˜ฌ๋ ค์ฃผ๋ฉด ๋œ๋‹ค.

release-from-tag:
  image: registry.gitlab.com/gitlab-org/release-cli
  stage: release
  needs:
    - 'upload binaries to generic package for tag'
    - 'generate_description'
  rules:
    - if: '$CI_COMMIT_TAG' # Run this job when a tag is created manually
  script:
    - echo "Creating a release for $CI_COMMIT_TAG"
    - echo "$DESCRIPTION"
  release:
    name: 'Release $CI_COMMIT_TAG'
    description: '$DESCRIPTION'
    tag_name: '$CI_COMMIT_TAG'
    ref: '$CI_COMMIT_TAG'
    assets:
      links:
        - name: 'darwin/amd64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-darwin-amd64'
          filepath: '/app/bin/binaries/jiractl-darwin-amd64'
        - name: 'darwin/arm64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-darwin-arm64'
          filepath: '/app/bin/binaries/jiractl-darwin-arm64'
        - name: 'freebsd/386'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-freebsd-386'
          filepath: '/app/bin/binaries/jiractl-freebsd-386'
        - name: 'freebsd/amd64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-freebsd-amd64'
          filepath: '/app/bin/binaries/jiractl-freebsd-amd64'
        - name: 'freebsd/arm'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-freebsd-arm'
          filepath: '/app/bin/binaries/jiractl-freebsd-arm'
        - name: 'linux/386'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-linux-386'
          filepath: '/app/bin/binaries/jiractl-linux-386'
        - name: 'linux/amd64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-linux-amd64'
          filepath: '/app/bin/binaries/jiractl-linux-amd64'
        - name: 'linux/arm'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-linux-arm'
          filepath: '/app/bin/binaries/jiractl-linux-arm'
        - name: 'linux/arm64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-linux-arm64'
          filepath: '/app/bin/binaries/jiractl-linux-arm64'
        - name: 'linux/ppc64le'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-linux-ppc64le'
          filepath: '/app/bin/binaries/jiractl-linux-ppc64le'
        - name: 'windows/386'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-windows-386.exe'
          filepath: '/app/bin/binaries/jiractl-windows-386.exe'
        - name: 'windows/amd64'
          url: '$PACKAGE_REGISTRY_URL/$CI_COMMIT_TAG/jiractl-windows-amd64.exe'
          filepath: '/app/bin/binaries/jiractl-windows-amd64.exe'

๋‹ค์Œ์ฒ˜๋Ÿผ release๊ฐ€ ์ƒ๊ธด๊ฒƒ์„ ์•Œ์ˆ˜ ์žˆ๋‹ค.

์™„์„ฑ

Last updated

Was this helpful?