**Bazelでコンテナイメージを作成する高速化手法**

タイトル： Bazel がビルド時に数ギガバイトのベースイメージデータをダウンロードする理由
サブタイトル：

rules_img

問題点

• Bazel でウェブアプリをビルド（すでに Bazel によってコンパイル済み）します。
• それを Docker イメージにパッケージ化し、適切なベースレイヤーと設定を持たせる必要があります。
• コンテナイメージ構築を追加すると：
  • CI が遅くなる（毎回大きなベースイメージをダウンロードするため）。
  • プッシュ操作が遅いと感じられる。

主な関係者

bazel build

bazel run

コアの葛藤

ベースイメージを拡張したイメージをビルドするには、そのベースに関する情報が必要です：

• どれだけの情報？
• それはどこにある？

現在の方法：

rules_oci

データフロー

# ベースイメージをプル
pull(
    name = "ubuntu",
    image = "index.docker.io/library/ubuntu:24.04",
    digest = "...",
)

# イメージをビルド
oci_image(
    name = "app_image",
    base = "@ubuntu",      # 完全なローカルディレクトリ
    tars  = [":app_layer.tar"],
    entrypoint = ["/app/bin/server"],
)

# レジストリへプッシュ
oci_push(
    name = "push",
    image = ":app_image",
    repository = "gcr.io/my-project/app",
)

転送の概要

改善された方法：

rules_img

データフロー

# ベースイメージをメタデータだけでプル
pull(
    name = "ubuntu",
    registry   = "index.docker.io",
    repository = "library/ubuntu",
    tag        = "24.04",
    digest     = "...",
)

# レイヤーをビルド
image_layer(
    name = "app_layer",
    srcs = {
        "/app/bin/server": "//cmd/server",
        "/app/config"     : "//configs:prod",
    },
)

# イメージを組み立て（メタデータのみ）
image_manifest(
    name   = "app",
    base   = "@ubuntu",       # メタデータだけ
    layers = [":app_layer"],
    entrypoint = ["/app/bin/server"],
)

# 実行時にプッシュ
image_push(
    name      = "push_app",
    image     = ":app",
    registry  = "ghcr.io",
    repository= "my-project/app",
    tag       = "latest",
)

転送の概要

ベースレイヤーはほとんどローカルマシンやリモート実行者を通過しません。

重要性

• イメージの組み立ては主に JSON と数個のチェックサムです。
• 本当に大切なのは 正しいタイミングでバイト列を適切な場所へ移動させる ことです。

• rules_img

  はまずメタデータを転送し、バイト列は境界（エッジ）だけで転送するため、不必要なダウンロードとアップロードを排除します。

歴史的背景

1. rules_docker

   – すべての言語を統合しようとして保守が難しくなる。

2. rules_oci

   – ディスク上で完全な OCI レイアウトを使用。ローカルでは動くが、リモート実行時に問題が生じる。

3. rules_img

   – まずメタデータを扱い、必要に応じてバイト列のみストリームする。

主な設計決定

追加のパフォーマンス向上

• ハードリンクによる重複除去（レイヤー内）。
• オプションで eStargz を使用しシーク可能レイヤー化。
• Containerd と統合して incremental

  docker load

  が実現。

すぐに始める例

# MODULE.bazel
bazel_dep(name = "rules_img", version = "<latest>")

pull = use_repo_rule("@rules_img//img:pull.bzl", "pull")

pull(
    name = "ubuntu",
    registry   = "index.docker.io",
    repository = "library/ubuntu",
    tag        = "24.04",
    digest     = "...",
)

# BUILD.bazel
load("@rules_img//img:layer.bzl", "image_layer")
load("@rules_img//img:image.bzl", "image_manifest")

image_layer(
    name   = "app_layer",
    srcs   = {
        "/app/bin/server": "//cmd/server",
        "/app/config"     : "//configs:prod",
    },
    compress = "zstd",
)

image_manifest(
    name   = "app_image",
    base   = "@ubuntu",
    layers = [":app_layer"],
)

高速化のため

.bazelrc

common --@rules_img//img/settings:compress=zstd
common --@rules_img//img/settings:estargz=enabled
common --@rules_img//img/settings:push_strategy=lazy

まとめ

• メタデータ優先 + バイトオンデマンド = CI の高速化、ノートパソコンの負荷低減、ビルドグラフのスケーラビリティ。

• rules_img

  はベースイメージのダウンロードを数分から数秒へ短縮し、プッシュ時の不要な往復通信を排除します。
• プロジェクトに導入してみてください。うまくいった点やまだ課題が残る点を共有しましょう。

始め方: https://github.com/bazel-contrib/rules_img