🦀

Kaniko が開発停止されてしまったので docker buildx + docker-container driver に乗り換えた話

gecko655

2025/09/05に公開

 3行でkaniko ( https://github.com/GoogleContainerTools/kaniko ) は docker のレイヤーキャッシュを使ってビルドを高速化するツールだが、2025年6月からメンテモードに入ってしまい、使用が非推奨になった
docker buildx build によるレイヤーキャッシュ付きビルドで高速化に成功した
公式ドキュメントではデフォルトの docker driver でもレイヤーキャッシュが使えると書いてあるが、どうやっても使えず、 docker-container driver を使うようにした

 Kaniko とはKaniko ( https://github.com/GoogleContainerTools/kaniko ) とは、 Docker image の CI でのビルドをレイヤーキャッシュによって高速化することができるツールです。

通常、 CI で Docker image をビルドすると毎回キレイまっさらなビルドマシンが用意される[1]のですが、 kaniko は Docker のレイヤーキャッシュをキャッシュ用 docker registry に保存して勝手に再利用してくれるので、キャッシュが再利用できるときはビルド時間が短縮できます。
Kaniko は Google Cloud Build のドキュメントからも使用例が示されており、この記事の執筆時点（2025年9月2日）では、以下の「ビルドを高速化する際のベスト プラクティス」のページに説明が残っています。


https://cloud.google.com/build/docs/optimize-builds/speeding-up-builds?hl=ja から引用[2][3]
Cloud Build のドキュメントがあったからという理由で、Cloud Build での CI に Kaniko を導入したという方も多いのではないかと思います。
Cloud Build での設定例:
steps:
  - name: gcr.io/kaniko-project/executor:latest
    args:
      # 出力先（Artifact Registry）
      - --destination=${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO}/${_IMAGE}:$SHORT_SHA
      # ビルド対象
      - --dockerfile=Dockerfile
      # キャッシュ有効化（キャッシュ用リポジトリを指定）
      - --cache=true
      # cache-repo に指定した docker registry にキャッシュが保存され、使用される
      - --cache-repo=${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO}/cache

substitutions:
  _REGION: asia-northeast1   # 例: asia-northeast1 / us-central1 など
  _REPO: my-repo             # Artifact Registry のリポジトリ名
  _IMAGE: myapp              # イメージ名

 Kaniko の開発停止しかし、2025年6月、 Kaniko の GitHub リポジトリがアーカイブされ、これ以上の開発が行われないことが発表されます。


https://github.com/GoogleContainerTools/kaniko の README.md
というわけで、いまのところまだ元気に動いている Kaniko ですが、いつ動かなくなってもおかしくはないので、他の「CI 上でも Docker レイヤーキャッシュが使える」ような新たなビルド方法を探す必要がありました。

 docker buildx build + docker-container driver に移行する通常の docker build コマンドでは、ローカルで起動している Docker デーモンにバンドルされたBuildKit によってビルドされます。この Docker デーモンにバンドルされた BuildKit は、 docker build driverと呼ばれています。

build driver は docker だけではなく、以下の4種類が存在します。

docker: Docker デーモンにバンドルされた BuildKit ライブラリを使用する

docker-container: Docker を使って専用の BuildKit コンテナを作成する

kubernetes: Kubernetes クラスター内に BuildKit の Pod を作成する

remote: 手動で管理された BuildKit デーモンに直接接続する
これらのうち、 docker 以外の3種はキャッシュをエクスポート・インポートすることが可能で、 docker build 時に  --cache-from --cache-to というオプションを使うことができます。


https://docs.docker.com/build/builders/drivers/ より引用
ドキュメントには docker build driver でも一部の cache backend では cache export が使えると書いてあります。

The default docker driver supports the inline, local, registry, and gha cache backends

https://docs.docker.com/build/cache/backends/
このドキュメントは 2024年6月に追加されている https://github.com/docker/docs/pull/20322

しかし、 docker を最新バージョンにしたりして試行錯誤しても、 「Cache export は docker build driver でサポートされてない」旨のエラーが出てうまく動きませんでした……

ERROR: failed to build: Cache export is not supported for the docker driver.


docker build driver で cache export を 動作検証していたときの cloudbuild.yaml の一部  - id: build-image
    name: docker:28.3.3-cli
    entrypoint: 'docker'
    args:
      - buildx
      - build
      - --cache-from
      - type=registry,ref=${_REGION}-docker.pkg.dev/$PROJECT_ID/[cache_image_name]
      - --cache-to
      - type=registry,ref=${_REGION}-docker.pkg.dev/$PROJECT_ID/[cache_image_name]
      - --tag
      - ${_REGION}-docker.pkg.dev/$PROJECT_ID/[image_name]:${COMMIT_SHA}
      - --push
      - .
↓

こんなエラーが出る
Status: Downloaded newer image for docker:28.3.3-cli
docker.io/library/docker:28.3.3-cli
ERROR: failed to build: Cache export is not supported for the docker driver.
Switch to a different driver, or turn on the containerd image store, and try again.
Learn more at https://docs.docker.com/go/build-cache-backends/
というわけで、 docker ビルドでキャッシュをエクスポート・インポートするためには、以下の手順を踏む必要がありました。
ビルドに使う build driver を、デフォルトの docker から docker-container に変更する
ビルドコマンドを docker build から docker buildx build --builder docker-container に変更する

--cache-from --cache-to オプションを使い、キャッシュ先 docker registry を指定する

 完成した cloudbulid.yamlここまで文字だらけで説明してきましたが、この節だけ読む方もいらっしゃると思うので、 docker buildx build によるビルドへの移行前後の cloudbuild.yaml の内容を示します。
Before:
  - id: build-app
    name: gcr.io/kaniko-project/executor:latest
    args:
      - --destination=${_REGION}-docker.pkg.dev/$PROJECT_ID/app:${COMMIT_SHA}
      - --cache-repo=${_REGION}-docker.pkg.dev/$PROJECT_ID/app/buildcache
      - --cache=true
      - --cache-ttl=168h
    waitFor: ['-']
After:
   # docker buildx build --cache-from と --cache-to を使うための準備
  - id: setup-buildx
    name: gcr.io/cloud-builders/docker:latest
    entrypoint: docker
    args:
      - buildx
      - create
      - --use
      - --name=docker-container
      - --driver=docker-container
    waitFor: ['-']

  - id: build-app
    name: gcr.io/cloud-builders/docker:latest
    entrypoint: 'docker'
    args:
      - buildx
      - build
      - --builder
      - docker-container
      - --cache-from
      - type=registry,ref=${_REGION}-docker.pkg.dev/$PROJECT_ID/app:buildcache
      - --cache-to
      - type=registry,ref=${_REGION}-docker.pkg.dev/$PROJECT_ID/app:buildcache,mode=max # mode=max: 全レイヤをキャッシュする
      - --tag
      - ${_REGION}-docker.pkg.dev/$PROJECT_ID/app:${COMMIT_SHA}
      - --push
      - .
    waitFor: ['setup-buildx']

--cache-from, --cache-to  で、 type=registry のときに設定すべき値は https://docs.docker.com/build/cache/backends/registry/ を参照してください。
Kaniko にあった --cache-ttl のようなオプションは、  --cache-from, --cache-to にはありません。別途自分で registry を定期的に掃除するなりなんなりする必要があります。
docker buildx build への移行により、  setup-buildx ステップが増えてしまいましたが、このステップは2〜3秒で終わり、 docker buildx build 部分は Kaniko と同じくらいのビルド時間でビルドできるようになったので、全体ではほとんどビルド時間が増えずに済みました。

脚注
cf: CircleCI にはビルドマシン自身に Docker レイヤーキャッシュをあらかじめ積んでおいてくれる機能があります。この機能は可能なら非同期に動作するらしいので、この記事で説明する docker buildx build より優秀かもしれません（未検証） https://circleci.com/docs/guides/optimize/docker-layer-caching/ ↩︎
魚拓 https://megalodon.jp/2025-0902-1908-38/https://cloud.google.com:443/build/docs/optimize-builds/speeding-up-builds?hl=ja ↩︎
記事執筆時点では、この記事にある「Kaniko キャッシュの利用」のリンクは切れています。また、英語版ドキュメントではそもそも「ビルドを高速化する際のベスト プラクティス」のページに Kaniko に関する記述は残っていませんでした。 https://cloud.google.com/build/docs/optimize-builds/speeding-up-builds?hl=en ↩︎

GitHubで編集を提案

MIXI DEVELOPERS Tech Blog

株式会社MIXIのZenn版テックブログです。実務で得た技術知見や個人的に調べたことなどを紹介しています。

Discussion

namipay

deafultのdockerドライバーでもcontainerd image storeを有効化すれば一部のCache storage backendが使えるようです。
The default docker driver supports the inline, local, registry, and gha cache backends, but only if you have enabled the containerd image store. Other cache backends require you to select a different driver.
以下記載の通りdockerのdaemon.jsonで有効化すれば良さそうです。
https://docs.docker.com/engine/storage/containerd/