第6章 パッケージのビルド

完全なパッケージの（再）ビルドを行うには、以下を確実にインストールして下さい。

ソースディレクトリーで以下のコマンドを実行してください:

$ dpkg-buildpackage -us -uc

このコマンドはバイナリーパッケージとソースパッケージをビルドする作業をすべて行ってくれます。これには以下の作業が含まれます:

満足なビルド結果の場合には、debsign コマンドを用いてあなたの秘密 GPG 鍵で .dsc と .changes ファイルを署名します。秘密フレーズを２回入力する必要があります。 ^[62]

ノンネイティブパッケージの場合、パッケージビルド後の親ディレクトリー (~/gentoo) に以下のファイルが生成されているはずです:

Debain FTP アーカイブ にアップロードする前に、~/.gnupg/ ディレクトリー中にあるあなたの秘密 GPG 鍵で debsign コマンドを用いてgentoo_0.9.12-1.dsc と gentoo_0.9.12-1_i386.changes ファイルを署名しなければいけません。

以下の ~/.devscripts ファイルを用いると、debsign コマンドはあなたが指定した秘密 GPG キー ID (パッケージをスポンサーする際に便利) で署名できます:

DEBSIGN_KEYID=Your_GPG_keyID

.dsc と .changes ファイルに記載されている長い数字の羅列は各ファイルの MD5/SHA1/SHA256 チェックサムです。パッケージをダウンロードした人は、sha1sum(1)、sha256sum(1)を使って整合性をテストすることができます。もし、数字が一致しない場合には、ファイルが壊れているか、あるいは何者かによって改ざんされていると分かるわけです。

Debian は、様々なアーキテクチャー上で buildd デーモンを走らせているオートビルダーネットワークによって、色々な 移植版 をサポートしています。あなたがそれらを明示的に使う必要はありませんが、パッケージがどうなるのかを知っておくと良いでしょう。それでは、あなたのパッケージがどのように異なるアーキテクチャー向けに再ビルドされるのかを見ていきましょう。^[64]

Architecture: any のパッケージは、オートビルダーシステムによって再ビルドされます。それは、以下を確実にインストールします。

そして、ソースディレクトリーで次のコマンドを実行します:

$ dpkg-buildpackage -B

これは、別のアーキテクチャー上で、アーキテクチャー依存のバイナリーパッケージを生成する作業をすべて行ってくれます。これには以下の作業が含まれます:

あなたのパッケージが他のアーキテクチャー用にも存在するのは、このためです。

Build-Depends-indepフィールドのパッケージは、通常のパッケージの場合はインストールを要求されますが (参照 「完全な（再）ビルド」)、オートビルダーシステムでは、アーキテクチャー依存のパッケージのみをビルドするのでこれらのインストールは必須ではありません。^[65] オートビルダーを使用した場合と普通のパッケージングとのこの違いにより、debian/control ファイルの Build-Depends か Build-Depends-indep のどちらにパッケージを記載するかが決定されます。(参照 「control」)

dpkg-buildpackageによるビルドプロセス周辺は、debuildによりさらに自動化できます。debuild(1)を参照してください。

debuild コマンドは、Debian パッケージをビルドのあと静的チェックをする lintian コマンドを実行します。lintian コマンドは ~/.devscripts を用いて以下のようにカスタマイズできます:

DEBUILD_DPKG_BUILDPACKAGE_OPTS="-us -uc -I -i"
DEBUILD_LINTIAN_OPTS="-i -I --show-overrides"

以下のようにすれば一般ユーザーアカウントから、簡単にソースをクリーンしパッケージを再ビルドできます:

$ debuild

ソースツリーのクリーンも簡単です:

$ debuild -- clean

ビルド依存を確認するためのクリーンルーム (chroot) ビルド環境として、pbuilder パッケージが非常に便利です。^[66] これを使うことで、異なるアーキテクチャー向けに sid 環境オートビルダーの下でのソースからのクリーンなビルドが保証され、常に RC (リリースクリティカル) に分類される重要度が serious (深刻)の FTBFS (Fails To Build From Source、ソースからのビルド失敗) バグを防ぎます。^[67]

それでは、pbuilder をカスタマイズしてみましょう:

それでは、ローカルpbuilder の chroot システムを以下のようにして初期化しましょう:

$ sudo pbuilder create

既に完全なソースパッケージがあれば、foo.orig.tar.gzファイル、foo.debian.tar.gzファイル、foo.dscファイルが存在するディレクトリーで、ローカルの pbuilder の chrootシステムをアップデートし、バイナリーパッケージをその中でビルドしましょう:

$ sudo pbuilder --update
$ sudo pbuilder --build foo_version.dsc

新しくビルドした GPG 署名の無いパッケージは非ルート所有権で /var/cache/pbuilder/result/ に置かれます。

.dsc ファイルや .changes ファイルへのGPG 署名は次のようにするとできます:

$ cd /var/cache/pbuilder/result/
$ debsign foo_version_arch.changes

更新されたソースツリーが既にあるが一致するソースパッケージを生成していない場合は、この代わりに、debian ディレクトリーが存在するディレクトリーで、以下のコマンドを発行します:

$ sudo pbuilder --update
$ pdebuild

pbuilder --login --save-after-loginコマンドで、chroot環境にログインし、好きに設定することができます。シェルプロンプトから^D (Control-D)で抜けると、その環境を保存しておくことができます。

最新のlintianコマンドはchroot環境から次のように設定されたフックスクリプト/var/cache/pbuilder/hooks/B90lintianを使用して実行することができます: ^[68]

#!/bin/sh
set -e
install_packages() {
        apt-get -y --allow-downgrades install "$@"
        }
install_packages lintian
echo "+++ lintian output +++"
su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
# use this version if you don't want lintian to fail the build
#su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
echo "+++ end of lintian output +++"

sid 環境向けのパッケージを正しくビルドするには最新の sid 環境が必要です。sid にはあなたの環境全てを移行するには望ましくない問題を抱えていることが少なくありません。pbuilder パッケージはそのような状況への対処の助けとなります。

stable/updatesやstable-proposed-updatesがリリースされた後、stableパッケージのアップデートが必要な場合があります。^[69]そのような場合に、即座にアップデートしない言い訳として sid を使っているからというのは不十分です。pbuilderパッケージは、同じアーキテクチャーのほぼ全ての Debian 派生であるディストリビューションへのアクセスを手助けします。

http://www.netfort.gr.jp/~dancer/software/pbuilder.html と pdebuild(1) と pbuilderrc(5) と pbuilder(8) を参照下さい。

アップストリームがソースコード管理システム (VCS) ^[70] を使っているのであれば、同様に使用することを考えるべきです。それによって、マージとアップストリームパッチの取捨選択がより簡単になります。各 VCS 毎に Debian パッケージをビルドするための特別なラッパースクリプトのパッケージもいくつかあります。

Debian デベロッパーが alioth.debian.org 上の Git サーバーを用い Debian パッケージを管理するのに git-buildpackage を使うことがよくあります。^[71] このパッケージはパッケージ活動を自動化する多くのコマンドを提供します。

これらのコマンドはパッケージング活動を追跡する 3 つのブランチを使用します:

git-buildpackage は ~/.gbp.conf で設定できます。gbp.conf(5) を参照下さい。 ^[73]

大規模なパッケージの場合には、debian/rules をちょっといじるたびに、毎回最初からパッケージの再ビルドをやりなおすのは手間です。テスト目的であれば、以下の方法でアップストリームソースを再ビルドをせずに .deb ファイルを生成することができます。 ^[74]:

$ fakeroot debian/rules binary

また、以下の方法を使えば生成可能かどうかをチェックすることができます:

$ fakeroot debian/rules build

最終的にきちんとテストが完了したら、正しい手順に従ってパッケージを最初から再ビルドすることを忘れないでください。この方法でビルドした .deb ファイルをアップロードしようとしても、おそらくうまくアップロードできないでしょう。

パッケージ作成に用いる多くのコマンドが、コマンド階層の中でお互いいかなる関係にあるかの簡単なまとめを以下に記します。同じ事をするのに多くの方法があります。

• debian/rules = パッケージビルド用のメンテナースクリプト

• dpkg-buildpackage = パッケージビルドツールの核

• debuild = dpkg-buildpackage + lintian (サニタイズした環境変数下でのビルド)

• pbuilder = Debian の chroot 環境ツールの核

• pdebuild = pbuilder + dpkg-buildpackage (chroot 中でビルド)

• cowbuilder = pbuilder 実行の加速

• git-pbuilder = pdebuild の使いやすいコマンドラインシンタックス (gbp buildpackge が使用)

• gbp = Debian ソースを git レポ下で管理

• gbp buildpackge = pbuilder + dpkg-buildpackage + gbp

gbp buildpackge や pbuilder 等のよりハイレベルなコマンドを用いることは完全なパッケージビルド環境を保証しますが、debian/rules や dpkg-buildpackage 等のよりローレベルのコマンドがそれらの下で実行されるかを理解することは必須です。