Go 開発者環境のコンテナー化 – パート 3

この 一連のブログ投稿では、最適化されたコンテナー化された Go 開発環境を導入する方法について説明します。 パート 1 では、ローカルの Go 開発用にコンテナ化された開発環境を開始する方法を説明し、さまざまなプラットフォーム用のサンプル CLI ツールを構築しました。第 2 回 では、Go の依存関係を追加する方法、ビルドと単体テストを高速化するためのキャッシュについて説明しました。 この最後の 3 番目の部分では、コード リンター、GitHub アクション CI、およびいくつかの追加のビルド最適化を追加する方法を示します。

リンターの追加

優れたプログラミングプラクティスのチェックを可能な限り自動化したいので、セットアップにリンターを追加しましょう。 最初のステップは、ドッカーファイルを変更することです。

# syntax = docker/dockerfile:1-experimental

FROM --platform=${BUILDPLATFORM} golang:1.14.3-alpine AS base
WORKDIR /src
ENV CGO_ENABLED=0
COPY go.* .
RUN go mod download
COPY . .


FROM base AS build
ARG TARGETOS
ARG TARGETARCH
RUN --mount=type=cache,target=/root/.cache/go-build \
  GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -o /out/example .


FROM base AS unit-test
RUN --mount=type=cache,target=/root/.cache/go-build \
  go test -v .


FROM golangci/golangci-lint:v1.27-alpine AS lint-base

FROM base AS lint
COPY --from=lint-base /usr/bin/golangci-lint /usr/bin/golangci-lint
RUN --mount=type=cache,target=/root/.cache/go-build \
  --mount=type=cache,target=/root/.cache/golangci-lint \
  golangci-lint run --timeout 10m0s ./...


FROM scratch AS bin-unix
COPY --from=build /out/example /
...

これで、使用したいリンターを含むゴランチリント画像のエイリアスであるリントベースステージができました。 次に、lintを実行するlintステージを用意し、キャッシュを正しい場所にマウントします。

単体テストに関しては、リンティング用のリントルールをMakefileに追加できます。 テストルールにエイリアスを付けて、リンターテストと単体テストを実行することもできます。

all: bin/example
test: lint unit-test

PLATFORM=local

.PHONY: bin/example
bin/example:
    @docker build . --target bin \
    --output bin/ \
    --platform ${PLATFORM}

.PHONY: unit-test
unit-test:
    @docker build . --target unit-test

.PHONY: lint
lint:
    @docker build . --target lint

CI の追加

開発プラットフォームをコンテナ化したので、プロジェクトにCIを追加するのは本当に簡単です。 Dockerビルドを実行するか、CIスクリプトからコマンドを実行するだけで済みます。 これを実証するために、GitHub アクションを使用します。 これを設定するには、次の .github/workflows/ci.yaml ファイルを使用できます。

name: Continuous Integration

on: [push]

jobs:
  ci:
    name: CI
    runs-on: ubuntu-latest
    env:
       DOCKER_BUILDKIT: "1"
    steps:
     - name: Checkout code
       uses: actions/checkout@v2
     - name: Run linter
       run: make lint
     - name: Run unit tests
       run: make unit-test
     - name: Build Linux binary
       run: make PLATFORM=linux/amd64
     - name: Build Windows binary
       run: make PLATFORM=windows/amd64

CIで実行するコマンドは、ローカルで使用するコマンドと同じであり、すべてがDockerfileですでに定義されているため、ツールチェーンの構成を行う必要がないことに注意してください。

最後の最適化

COPYを実行すると、コンテナイメージに追加のレイヤーが作成され、処理が遅くなり、余分なディスク容量が使用されます。 これは、ビルドコンテキスト、ステージ、またはイメージからマウントを使用して RUN --mount バインドすることで回避できます。 このパターンを採用すると、結果の Dockerfile は次のようになります。

# syntax = docker/dockerfile:1-experimental

FROM --platform=${BUILDPLATFORM} golang:1.14.3-alpine AS base
WORKDIR /src
ENV CGO_ENABLED=0
COPY go.* .
RUN go mod download

FROM base AS build
ARG TARGETOS
ARG TARGETARCH
RUN --mount=target=. \
  --mount=type=cache,target=/root/.cache/go-build \
  GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -o /out/example .


FROM base AS unit-test
RUN --mount=target=. \
  --mount=type=cache,target=/root/.cache/go-build \
  go test -v .


FROM golangci/golangci-lint:v1.27-alpine AS lint-base

FROM base AS lint
RUN--mount=target=. \
  --mount=from=lint-base,src=/usr/bin/golangci-lint,target=/usr/bin/golangci-lint \
  --mount=type=cache,target=/root/.cache/go-build \
  --mount=type=cache,target=/root/.cache/golangci-lint \
  golangci-lint run --timeout 10m0s ./...


FROM scratch AS bin-unix
COPY --from=build /out/example /

FROM bin-unix AS bin-linux
FROM bin-unix AS bin-darwin

FROM scratch AS bin-windows
COPY --from=build /out/example /example.exe

FROM bin-${TARGETOS} AS bin

デフォルトのマウントタイプは、コマンドで docker build 渡すコンテキストからの読み取り専用バインドマウントです。 これは、 COPY . .RUN --mount=target=. コマンドを実行するためにコンテキストからのファイルが必要であるが、最終的なイメージに保持する必要がない場合。

Goモジュールのダウンロードを分離する代わりに、これを削除して、の /go/pkg/modキャッシュマウントを使用できます。

結論

この 一連の投稿 では、最適化されたコンテナー化された Go 開発環境を導入する方法と、CI でこれと同じ環境を使用する方法について説明しました。 そのようなプロジェクトで開発したい人にとっての唯一の依存関係はDockerとmakeです-後者はオプションで別のスクリプト言語に置き換えられます。

この例のソースは、私のGitHubにあります https://github.com/chris-crone/containerized-go-dev

実験的なDockerfile構文の詳細については、こちらをご覧ください。 https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/experimental.md

Docker でのビルドに興味がある場合は、Buildx リポジトリをご覧ください。 https://github.com/docker/buildx