GitHub Actionsで「Dockerビルド地獄」を終わらせる：極限の高速化と堅牢なGHCR運用戦略
現場で「CIが遅い」「Dockerのビルドが終わらない」という悲鳴を聞くたびに、私は思う。それはツールが悪いのではなく、戦略が欠けているだけだと。
CI/CDは単なる自動化ではない。「開発者の脳のコンテキストスイッチを最小化するための投資」だ。今日は、Dockerビルドを数分から数秒へ縮め、GHCR（GitHub Container Registry）を最大限に活用するための、現場直結の「解」を伝授する。
—
1. キャッシュ戦略：レイヤーの再利用を極める
Dockerビルドの最大の敵は「無駄なレイヤーの再構築」だ。`docker/build-push-action` を使う際、単にキャッシュを有効にするだけでは不十分。GitHub Actionsの `gha` キャッシュバックエンドを正しく設定することが鍵となる。
極限のビルド設定例
- name: Build and push
uses: docker/build-push-action@v5
with:
context: .
push: true
tags: ${{ steps.meta.outputs.tags }}
# 【神のハック】ghaバックエンドによるGitHub Actions専用キャッシュの活用
cache-from: type=gha
cache-to: type=gha,mode=max # mode=maxは中間レイヤーまで全て保存する。ビルド速度は劇的に上がる
platforms: linux/amd64,linux/arm64 # マルチプラットフォーム対応もセットで
ポイント: `mode=max` はビルド結果だけでなく、ビルド過程の全中間レイヤーを保存する。ディスク容量を食うが、ビルド時間は確実に短縮される。
—
2. GHCR運用：タグ付けの自動化と堅牢なメタデータ
手動でのタグ付けや管理はミスを誘発する。`docker/metadata-action` を使い、ブランチ戦略やコミットハッシュに連動させるのが鉄則だ。
- name: Docker meta
id: meta
uses: docker/metadata-action@v5
with:
images: ghcr.io/${{ github.repository }}
tags: |
type=ref,event=branch
type=semver,pattern={{version}}
type=sha,format=long # 追跡可能性を最大化する
現場の知見: 運用が長くなるとGHCRのストレージが溢れる。GitHubの「Packageの保持ポリシー」を必ず設定し、古いタグ（特にSHAタグ）を自動削除するルールを適用せよ。これができないチームは、半年後にストレージ料金と管理コストで首を絞めることになる。
—
3. 生産性を加速させる「隠れた」テクニック
開発者が絶対入れるべきプラグイン・ツール
1. [act](https://github.com/nektos/act): GitHub Actionsをローカルで走らせる。YAMLをコミットして「失敗しました」→「修正してプッシュ」という無駄な往復をゼロにする。
2. GitHub CLI (`gh`): ターミナルからワークフローの実行状況確認 (`gh run watch`) やログ取得が可能。ブラウザへ切り替える時間は無駄だ。
チーム開発の「設定共有化」ルール
GitHub ActionsのYAMLファイルが散乱してはならない。
- Composite Actionsの活用: よく使うビルド手順は `actions/composite` リポジトリへ切り出し、社内で共通化せよ。
- 環境変数の標準化: `env` セクションを安易に使いすぎず、GitHub Secretsと環境定義を分離すること。
—
4. 現場で使える「至高のワークフロー」構成例
以下は、最適化の全てを詰め込んだ実戦的なYAML構成だ。
name: CI/CD Pipeline
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
docker-build:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write # GHCRへの書き込み権限を明示
steps:
- uses: actions/checkout@v4
- name: Set up QEMU
uses: docker/setup-qemu-action@v3 # マルチプラットフォームビルドの必須ツール
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
- name: Login to GHCR
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- name: Build and push
uses: docker/build-push-action@v5
with:
context: .
push: ${{ github.event_name != ‘pull_request’ }} # PR時はビルドのみ実行（プッシュはしない）
tags: ${{ steps.meta.outputs.tags }}
cache-from: type=gha
cache-to: type=gha,mode=max
—
テックリードからのメッセージ
優秀なエンジニアは「ツールを動かす」ことではなく、「どうすれば開発者がコードを書くことに集中できる環境を作れるか」を考える。
今日紹介したキャッシュ戦略や自動化は、単なるテクニックではない。CI/CDパイプラインを「待たされる時間」から「信頼できる品質ゲート」へと昇華させるための第一歩だ。
まずは今すぐ、手元のワークフローで `cache-to: type=gha,mode=max` を試してほしい。ビルド時間が短縮されたとき、あなたのチームの生産性は確実に一段階上のステージへ到達するはずだ。
さあ、次のコミットで差を見せつけろ。