Text
Page: 1
DebianでBazelを 利用したビルドを 楽にしたい dh-bazelというdebhelperによる汎用的な解決策の提案 Kentaro Hayashi ClearCode Inc. 2026年11月 東京エリア・関西合同Debian勉強会(オンライン開催)
Page: 2
スライドは Rabbit Slide Showにて公開済み DebianでBazelを利用したビルドを楽にしたい https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-dh-bazel-202611
Page: 3
今日の発表のまとめ dh-bazelを開発しました 🎉 Bazelに対応したdebhelperのbuildsystem 従来の課題: Bazelを採用したソフトウェアをDebianパッケージ化する際、既存の debhelperのビルドワークフローに乗せにくい 解決手法: dhのbuildsystemへBazelを統合し、dhを活用できるようにした メリット: Bazelを採用したパッケージをDebianに投入しやすくなる
Page: 4
今日の発表内容 Bazelとは? DebianにおけるBazelの利用状況 なぜBazel対応がすすまないのか? なぜBazel対応がDebianに必要なのか? Bazelをdebhelperにどう組み込むか
Page: 5
Bazelとは? Googleが開発したオープンソースのビルドツール(元はBlaze) 巨大なコードベースを持つプロジェクトで採用されている/いた TensorFlow Kubernetes(Bazel廃止済み) 再現性を重視したビルドツール 必要な依存ライブラリー等をダウンロードしてビルドする
Page: 6
参考: Bazelの基本 依存関係やビルド手順をレシピとして記述する MODULE.bazel 該当モジュールが何に依存しているのかを明示する ダウンロード先などもここで明示したりする(再現性の担保) BUILD.bazel 該当モジュールをどうやってビルドするのかを明示する
Page: 7
DebianにおけるBazelの利用状況 採用パッケージはbazel-*系を除くとかなり限定的(codesearch.d.n調べ) mozc (3.33.6133+ds1-0.1から) android-cuttlefish (仮想Androidデバイス) Bazelが課題になっている事例 tensorflowはfull版ではなくlite版(CMake)がDebianパッケージ化されている
Page: 8
Bazel対応が Debianですすまないのはなぜか? Bazelがそもそも古かった 従来Bazel (bazel-bootstrap)は4.2.3までしかなかった(最新は9.3.x) より新しいBazelを必要とするソフトウェアはパッケージ化できない 😢 Bazel 7.7.1がDebian unstableで利用可能になったのは最近(2026/06/29) testing(forky)でも利用可能に(2026/07/20) ただし7.xはSecurity Supportが2026/12/31終了
Page: 9
今日の発表の内容 Bazelとは? DebianにおけるBazelの利用状況 なぜBazel対応がすすまないのか? なぜBazel対応強化がDebianに必要なのか? Bazelをdebhelperにどう組み込むか
Page: 10
なぜBazel対応強化が Debianに必要なのか? MozcをDebianの流儀でBazelに対応させるのがしんどかったから Bazel対応パッケージが少ないうちに整備しておく必要性を痛感
Page: 11
事例: MozcのBazel対応 より新しいMozcをDebianで採用できなかった (2024/12-2026/07) MozcはビルドシステムをGYPからBazelに移行済みでGYP維持することに先は ない Bazelに追従できない場合、あえてGYPにとどまるか、2.29.5160.102に塩漬け する未来 どちらもメンテナンスコスト増大を招く。誰がそのコストを払えるのか?
Page: 12
参考: 他のディストリビューションの事例 Fedora Mozc 2.29.5111.102 (GYPパッチを当てて維持) openSUSE Mozc 3.34.6239 bcr.tar.gz(77KB), dependencies.tar(77MB)といった依存関係のメタデータ/ソース コードを事前に抱え込む(Mozc自体は21MB) (Debianの)システムライブラリーをリンクさせる戦い方とは違う
Page: 13
DebianでBazelを利用する場合の課題 Bazelは(基本的に)ビルド中のネットワークアクセス前提 Debianパッケージのビルドでは禁止 Bazelのオフライン化はDebianポリシーになじまない 依存関係を事前にまるっと抱え込むということ いわゆるvendorライブラリーを使う方向性 Debianでは推奨されない 結局どうするのか?
Page: 14
Debianでは無効化ハックが必要 依存情報の解決 Bazel Central Registry( https://registry.bazel.build/ )にアクセスさせない 使わないモジュールは無効化する 依存ライブラリーの解決 システムライブラリーをリンクするように改変
Page: 15
Mozcの事例 (指定しているオプションの抜 粋) # Override module and repository to disable network access completely BAZEL_OPTIONS= \ --announce_rc \ --color=no \ --compilation_mode=opt \ --config=oss_linux \ --curses=no \ --features=-compiler_param_file \ --lockfile_mode=off \ --noenable_workspace \ --override_module=abseil-cpp=../debian/third_party/abseil-cpp \ --override_module=apple_support=../debian/third_party/apple_support \ --override_module=buildozer=../debian/third_party/buildozer \ --override_module=gazelle=../debian/third_party/gazelle \ --override_module=googletest=../debian/third_party/gtest \ --override_module=platforms=../debian/third_party/platforms \ --override_module=protobuf=../debian/third_party/protobuf \ --override_module=rules_android=../debian/third_party/rules_android \ --override_module=rules_android_ndk=../debian/third_party/rules_android_ndk \ --override_module=rules_apple=../debian/third_party/rules_apple \ --override_module=rules_go=../debian/third_party/rules_go \ --override_module=rules_pkg=/usr/share/bazel/rules/pkg \ --override_module=zlib=../debian/third_party/zlib \ --override_repository=_main~_repo_rules~ja_usage_dict=third_party/ja_usage_dict \ --override_repository=_main~_repo_rules~material_icon_dictionary_png=third_party/material_icon_dictionary_png \ --override_repository=_main~_repo_rules~material_icon_dictionary_svg=third_party/material_icon_dictionary_svg \ --override_repository=_main~_repo_rules~material_icon_properties_png=third_party/material_icon_properties_png \ --override_repository=_main~_repo_rules~material_icon_properties_svg=third_party/material_icon_properties_svg \ --override_repository=_main~_repo_rules~material_icon_tool_png=third_party/material_icon_tool_png \ --override_repository=_main~_repo_rules~material_icon_tool_svg=third_party/material_icon_tool_svg \ --override_repository=_main~_repo_rules~zip_code_jigyosyo=third_party/zip_code_jigyosyo \ --override_repository=_main~_repo_rules~zip_code_ken_all=third_party/zip_code_ken_all \ --repo_env=BAZEL_CXXOPTS=-std=c++20 \ --repository_disable_download \ --sandbox_add_mount_pair=/usr \ --strip=never \ --subcommands
Page: 16
Q. 依存関係を一部無効化する方法 --override_module と空のアダプタによる依存関係の一部無効化 bazel_dep( name = "apple_support", version = "1.23.1", repo_name = "build_bazel_apple_support", ) ● name: モジュール本来の識別名(override対象) ● 未使用なら中身が空でもビルドエラーにならない モジュール名 (name) で一致 空のアダプタディレクトリへ置換
Page: 17
Q. システムのライブラリーを 使わせる方法 --override_module とアダプタによるシステムライブラリ参照 bazel_dep( name = "zlib", version = "1.3.1", ) ● name: モジュール本来の識別名(override対象) ● @zlib//:zlib への依存はアダプタ側へリダイレクト ● ソースの再ビルドを省略し -lz でシステム側へリンク モジュール名 (name) で一致 アダプタディレクトリへ置換
Page: 18
Bazel利用時の面倒くささ Bazelの起動オプションと、ビルドオプションの調整(パッケージに依存し ない部分) 🤔どのパッケージでも必要な共通部分をdebian/rulesに記述するのは無駄では? パッケージ固有の依存関係の調整 --override_moduleで使わないモジュールは無効化 --override_moduleでシステムライブラリーをリンク debian/rulesが複雑化しがち
Page: 19
共通化できるビルドオプション このオプションの必要性にすぐたどりつける? # Override module and repository to disable network access completely BAZEL_OPTIONS= \ --announce_rc \ --color=no \ --compilation_mode=opt \ --curses=no \ --features=-compiler_param_file \ --lockfile_mode=off \ --noenable_workspace \ --repository_disable_download \ --sandbox_add_mount_pair=/usr \ --strip=never \ --subcommands ビルドシステムの改善が必要ではないか?
Page: 20
今日の発表内容 Bazelとは? DebianにおけるBazelの利用状況 なぜBazel対応がすすまないのか? なぜBazel対応強化がDebianに必要なのか? Bazelをdebhelperにどう組み込むか
Page: 21
debhelperでサポートする方法 debhelperを拡張する方法 buildsystem dh_auto_*が裏で実行するコマンドを制御する debian/rulesに--buildsystem=を指定する (e.g. cmake,meson,pybuild) Bazelをdebhelperに統合するならこの方法 addon ビルド途中に追加のdh_*フックを割り込ませる (e.g. autoreconf) dh-sequence-xxxをdebian/controlのBuild-Dependsに追加して有効化 昔はdh --with=で指定していたやつ
Page: 22
Debianのbuildsystemのしくみ 実装言語はPerl /usr/share/perl5/Debian/Debhelper/Buildsystem/にPerlモジュールを配 置する Bazelサポートならbazel.pm を配置すればよい sub configure, sub build, sub clean等を実装する --buildsystem=bazelを指定するとdh_auto_*が上記を呼び出す
Page: 23
最終的にBazelをdebhelperへ 統合したときの理想 debian/rulesを簡潔に記述できること! ターゲット(以下の例だと//:hello)指定すればビルドできる世界 #!/usr/bin/make -f # -*- makefile -*- # %: dh $@ --buildsystem=bazel override_dh_auto_build: dh_auto_build -- //:hello
Page: 24
dh-bazelのコンセプトとその実現 debian/rulesを簡潔に記述できること! bazelコマンドをあまり意識しないで使えること(よくある起動オプションやビ ルドオプションは省略できる) →Bazelの起動オプションとビルドオプションの整理が必要 段階的な依存解決の仕組み(優先順位) →アダプタモジュールによる差し替え対応 →pkgconfによる自動生成対応 →Build-Dependsからのfallback対応
Page: 25
dh-bazel アダプタモジュールによる差し替え対応 システムライブラリーを参照しやすいように定義ファイルを用意 使い方:debian/rulesでexport DH_BAZEL_OVERRIDE_MODULES=zlibする or buildozerにより自動検出 dh-bazelのアダプタモジュールを定義したファイル (MODULE.bazel,BUILD.bazel)を参照して勝手に解決 裏で--override_module=...定義に自動変換してbazelを実行する あらゆるライブラリーに対応するにはコストがかかりすぎる欠点
Page: 26
dh-bazel pkgconfによる自動生成対応 pkgconfを利用するパッケージ向けにdh-bazelが自動生成 使い方:debian/rulesでexport DH_BAZEL_PKGCONF_MODULES=lz4=liblz4 する lz4=liblz4は必要なモジュールがlz4で、pkgconfがliblz4.pcを探すという意味 dh-bazelのアダプタモジュールを定義したファイル (MODULE.bazel,BUILD.bazel)を自動生成して勝手に解決 裏で--override_module=...定義に自動変換してbazelを実行する C/C++に限定されるがより汎用的に対処可能
Page: 27
dh-bazel Build-Dependsのfallback対応 dh-bazelがdebian/controlのBuild-Depends:をみて自動的に推測と変換 DH_BAZEL_OVERRIDE_MODULESやDH_BAZEL_PKGCONF_MODULESが指定 されていないときの最終手段 debian/controlのBuild-Dependsから-devパッケージを探して、それに紐づい ている.pcからリンク対象等を見つけて勝手に解決 裏で--override_module=...定義に自動変換してbazelを実行する 🤔 ただし現状では精度は低いし、誤爆もすることもある
Page: 28
現在のdh-bazel開発状況 https://salsa.debian.org/bazel-team/dh-bazel Debian unstableにはアップロードしていない 依存しているbazel-buildtoolsをITP, 最近unstableでも利用可能に https://bugs.debian.org/1151519 MODULE.bazelから依存関係をbuildozerで抽出する(Build-Dependsの推測結果と モジュール名のマッピング)のに使用 🎉 Mozcをdh-bazelを使ってビルドする実証実験は成功
Page: 29
DEMO DH_BAZEL_OVERRIDE_MODULES DH_BAZEL_PKGCONF_MODULES fallback
Page: 30
今日の発表のまとめ dh-bazelを開発しました 🎉 Bazelに対応したdebhelperのbuildsystem 従来の課題: Bazelを採用したソフトウェアをDebianパッケージ化する際、既存の debhelperのビルドワークフローに乗せにくい 解決手法: dhのbuildsystemへBazelを統合し、既存のワークフローを活用できる ようにした Bazelを採用したパッケージをDebianに投入しやすくなるメリット 次のステップ: dh-bazelをDebian入りさせてMozcをdh-bazelを使うようにす る