Rabbit Slide Show

Tokyo Debian Local Meeting - What is dh-bazel?

2026-11-21

Description

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を使うようにす
る

Other slides

DebConf20 DebConf20
2020-08-25