git-buildpackage を用いた Debian パッケージのソースコード管理

はじめに

Debian パッケージを作成するということは，要するに，上流ソースのディレクトリ内に debian/ ディレクトリを作り，その中にいろいろなファイルを用意することである．このようなディレクトリ構成のせいで，debian/ 以下のコードのバージョン管理をどのようにすればよいかが直感的にわかりにくい．

このため，debian/ 以下のコードのバージョン管理を git で簡単に行うためのパッケージ git-buildpackage が用意されている．git-buildpackage では２つのブランチ，すなわち upstream ブランチ（デフォルトでは upstream）と debian ブランチ（デフォルトでは master）を用意し，以下のような手順で管理する．

1. 上流の新しいバージョンをインポートする．これは upstream にコミットされた後，master にマージされる．
2. パッケージ管理者は master で作業し，debian/ 以下を作成・変更し，コミットする．
3. 手元でうまくいったらリリースする．リリースしたポイントを記録するためにタグが付けられる．
4. debian/ 以下にバグが発見されたら 2 に戻る．
5. 上流がバージョンアップしたら 1 に戻る．

今回は既に Debian リポジトリにあるパッケージを git-import-dsc でインポートする方法には触れず，最初から git-buildpackage を用いるとどうなるかを説明する．

準備

例としてパッケージ foo を管理することとする．foo の上流は git でバージョン管理されていて，それは ssh://www.example.com/srv/git/foo.git にあるとする．

$ cd /tmp
$ git clone -b release0.0.1 ssh://www.example.com/srv/git/foo
$ cd foo
$ git archive --prefix=foo/ HEAD | gzip > ../foo-0.0.1.tar.gz

最初のインポート

git-import-orig コマンドを用いる．

$ mkdir -p ~/debian-foo/foo
$ cd ~/debian-foo/foo
$ git init
$ git-import-orig /tmp/foo-0.0.1.tar.gz
Upstream version is 0.0.1
Warning: Can't symlink orig tarball due to missing debian/changelog
Initial import of '/tmp/foo-0.0.1.tar.gz' ...
Succesfully imported version 0.0.1 of /tmp/foo-0.0.1.tar.gz
$ git branch
* master
  upstream
$ git tag
upstream/0.0.1

debian ブランチである master で debian/ ディレクトリを作成する．

$ DEBFULLNAME='Your Name' dh_make -e yourname@example.com -p foo_0.0.1 -f /tmp/foo-0.0.1.tar.gz
$ git add debian
$ git commit
$ vi debian/control
$ vi debian/rules
$ vi debian/changelog
$ debuild -i -us -uc -tc  # test build

うまくいったら git-buildpackage を用いてパッケージを生成する．ここで dh_make が作った .orig. ファイルを消しておかないと後で変なことになるので注意．

$ git commit
$ rm ../foo_0.0.1.orig.tar.gz
$ git-buildpackage --git-tag -us -uc -tc

下流のバージョンアップ

debian/ 以下にバグが見つかった場合．

$ vi debian/...
$ git commit
$ DEBFULLNAME='Your Name' DEBEMAIL='yourname@example.com' git-dch --release
$ git commit
$ git-buildpackage --git-tag -us -uc -tc

上流のバージョンアップ

git-import-orig でインポートしたら，dch でバージョンを 0.0.2 に上げておかなければならない点に注意．あいかわらず orig ファイルは消しておいた方が無難．

$ cd /tmp/foo
$ git pull
$ git archive --prefix=foo/ HEAD | gzip > ../foo-0.0.2.tar.gz
$ cd ~/debian-foo/foo
$ git-import-orig /tmp/foo-0.0.2.tar.gz
$ rm ../foo_0.0.2.orig.tar.gz
$ dch -i
$ git commit
$ git-buildpackage --git-tag -us -uc -tc