コンテンツへスキップ

GitHub ActionsでGoを高速化する

最終更新

GitHub Actions で Go を高速化するには、組み込みキャッシュ付きの actions/setup-go を使い、GOCACHE を温かい状態に保って変更のないパッケージの再コンパイルを避け、go test -p でパッケージを並列実行し、レースディテクターは別のジョブで実行します。Go はコンパイルが高速なため、無駄な時間の大半はモジュールの再ダウンロードと、変更のないものの再ビルドに費やされています。

このガイドは、GitHub Actions を高速化する一般ガイドの Go 版です。

モジュールとビルドのキャッシュ

actions/setup-go はデフォルトでキャッシュを行います。README によると cache 入力のデフォルトは true で、cache-dependency-path で別のファイル (glob 指定可) を設定しない限り、キャッシュキーは依存関係ファイル (go.sum または go.mod) に基づきます。キャッシュにはモジュールのダウンロードキャッシュと Go のビルドキャッシュの両方が保存されるため、ヒット時には go mod download とコンパイル済みパッケージの両方が復元されます。

- uses: actions/checkout@v7
- uses: actions/setup-go@v7
  with:
    go-version-file: go.mod
    cache-dependency-path: |
      go.sum
      tools/go.sum

go-version-file は go.mod、go.work、.go-version からバージョンを読み取るため、CI とローカル環境を揃えられます。go-version も設定した場合は、そちらが優先されます。

GitHub Actions ではキャッシュエントリは変更できません。また、このキーは go.sum が変わった時だけ更新されます。つまり、ある go.sum について最初に保存した後は、ソースの編集によってビルドキャッシュが更新されることはありません。大規模なリポジトリでは、これは実際の制約になります。復元されたビルドキャッシュが数週間のうちに古くなるためです。対策としては、cache: false を指定し、コミットを含むキーと restore-keys のプレフィックスを使って ~/.cache/go-build を自分で管理する方法があります。

- uses: actions/setup-go@v7
  with:
    go-version-file: go.mod
    cache: false
- uses: actions/cache@v6
  with:
    path: |
      ~/go/pkg/mod
      ~/.cache/go-build
    key: go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}-${{ github.sha }}
    restore-keys: |
      go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}-
      go-${{ runner.os }}-

この方法ではコミットごとに新しいエントリが作成されるため、クォータに注意してください。詳しくは キャッシュの制限 を参照してください。ストレージが逼迫している場合は、main でのみ actions/cache/save で保存し、それ以外の場所では復元のみを行うとよいでしょう。

テストの並列化: -p と -parallel

2 つの異なる設定項目があります。

  • go test -p N は、同時にテストするパッケージの数を指定します。デフォルトは GOMAXPROCS (CPU 数) です。パッケージはそれぞれ別のプロセスとして実行されます。
  • go test -parallel N は、1 つのパッケージ内で同時に実行してよいテストの数を指定します。対象は t.Parallel() を呼び出すテストのみです。デフォルトは GOMAXPROCS です。

そのため、パッケージ数が多ければ、コア数を増やすだけで Go のテストスイートは自動的に高速化されます。大半のテストが t.Parallel() を使わない 1 つの大きなパッケージに含まれている場合、そのパッケージではコアを増やしても効果はありません。独立したテストには t.Parallel() を追加してください。ただし、同じデータベースの行やグローバル変数を共有するテストには追加しないでください。

CI で役立つフラグ:

go test ./... -count=1 -shuffle=on -timeout=10m

-count=1 は Go のテスト結果キャッシュを無効にします。外部と通信するテストでは、CI で通常これが望ましい設定です。テストが純粋な処理のみの場合は、キャッシュを有効のままにしておくと、温かい GOCACHE によって変更のないパッケージを丸ごとスキップでき、大きな時間短縮になります。

-race のコスト

レースディテクターはメモリアクセスを計測します。Go のレースディテクターのドキュメントによると、実行時間は 2 倍から 20 倍、メモリ使用量は 5 倍から 10 倍に増える可能性があるため、-race を付けたテストスイートは数倍遅くなることがよくあります。実際のバグを見つけられるため省略すべきではありませんが、マトリクスで 3 回実行するのも避けてください。

よくある構成は、プッシュのたびに -race なしの高速なジョブを実行し、マージの必須条件として並列で実行される -race ジョブを用意する方法です。

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - run: go test ./... -count=1
  race:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - run: go test ./... -race -count=1

両方のジョブは遅い方のペースで完了しますが、最初のジョブのログで素早くフィードバックを確認できます。レースビルドには cgo が必要なため、通常のビルドとは異なるコンパイルを行い、別のビルドキャッシュを使用します。そのため、-race なしのジョブのキャッシュは役立ちません。

golangci-lint による Lint

大規模なリポジトリでは、golangci-lint の実行がテストより長くかかることがあります。公式の golangci/golangci-lint-action を使用し、現在の入力値とバージョンは README で確認してください。そのうえで、テストと重なるように独立したジョブとして実行します。このアクションは、解析結果をデフォルトでキャッシュします。

一度ビルドし、一度だけ配布する

Dockerfileでキャッシュマウントを使ってコンパイルし(RUN --mount=type=cache,target=/root/.cache/go-build go build ...)、BuildKitのレイヤーキャッシュを使ってイメージをビルドしてください。詳しくはCIでのDockerレイヤーキャッシュをご覧ください。複数のターゲット向けにクロスコンパイルする場合は、エミュレーションではなくGOOS/GOARCHのマトリックスを使用してください。Goはネイティブにクロスコンパイルできるためです。

CPU コア数を増やす効果

Goはコンパイルとテストの両方で全コアを使用するため、より大きなランナーに適したツールの一つです。当社のベンチマークには、go test -raceを使用するReact + Go + Postgresのスタックが含まれています。GitHubホステッドランナーでは6m13s、compiler.devでは2m42s(2.3x)でした。これは10個のテストシャードと実際のデータベースを使用したCIの完全な実行で、2026年10月8日に計測しています。Next.js + Go + Kafka + Redisのスタックでは、1m16sから0m44s(1.7x)に短縮されました。これらはパイプライン全体の結果ですので、高速化の比率は実行時間のうちGoのコンパイルとテストが占める割合によって異なります。

ジョブを compiler.dev に切り替えるには、runs-on: [self-hosted, Linux, compiler-ci] に変更します。マシンのサイズと料金は 料金ページ に掲載されており、ランナーサイズの選択ツール で適切なサイズを選べます。あわせて Go テンプレート と テストシャーディング も参照してください。

よくある質問

setup-go は Go のモジュールを自動的にキャッシュしますか?

はい。cache 入力のデフォルトは true で、モジュールとビルドのキャッシュを保存します。cache-dependency-path を設定しない限り、キャッシュキーは依存関係ファイルに基づきます。

go test -p と -parallel の違いは何ですか?

-p は同時にテストするパッケージの数です。-parallel はパッケージ内で同時に実行される t.Parallel() テストの数です。どちらもデフォルトは CPU 数です。

go test -race はどのくらい遅くなりますか?

Go のドキュメントでは 2 倍から 20 倍遅くなるとされています。実際には、I/O 待ちが多いスイートでは影響が小さくなります。別のジョブで実行してください。

CI で -count=1 を使うべきですか?

テストがデータベースやネットワークにアクセスする場合は、キャッシュされた結果を再利用しないように使用してください。純粋な単体テストの場合は、キャッシュを有効のままにしてください。

compiler.dev でこの Go ビルドを実行 カード登録不要 · 200 無料分

無料で試す