[[PageOutline]] = Getting Started = hoge.src.rpmからVine Linux 5.1/i386用のバイナリパッケージを作成する方法。 {{{ # vbuilder --version 5.1 --arch i386 clean build # vbuilder --version 5.1 --arch i386 --unionfs clean build build-rpm /path/to/hoge.src.rpm }}} はじめにVine Linux 5.1/i386の環境を用意し、次にunionfs上でhoge.src.rpmのビルドを実施。 = vbootstrap - bootstrap a basic Vine Linux system = Vine Linux 上で Vine Linux のベースシステムを作成するためのスクリプト。 vbootstrap パッケージをインストールすると、利用可能になります。 {{{ # apt-get install vbootstrap }}} == Features == * chroot 環境の構築や Xen の DomainU 構築など * まずは Vine Linux 上で作成できるように。 他のシステム上でも作成できるようにするのは将来。 {{{ #!comment == bootstrap == Vine Linux 上で Vine Linux のベースシステムを作成するためのスクリプト。 * chroot 環境の構築や Xen の DomainU 構築など * まずは Vine Linux 上で作成できるように。 他のシステム上でも作成できるようにするのは将来。 * 同様の仕組みをもつものとして plus に tiny-buildfarm があるが現状では 動作しない状態になっている。 == 開発の選択肢 == 選択肢としては以下のもの。 1. ~~tiny-buildfarm をメンテナンスする~~ 2. 独自スクリプト(vbootstrap)を用意する a. __ホストの apt を利用した簡便なシステムにする__ b. ~~bootstrap 用の static な apt を用意してつかう~~ c. ~~apt に頼らないで bootstrapping できるようにする~~ 3. ~~[http://rpmstrap.pimpscript.net/ rpmstrap] を Vine Linux に対応させる~~ 4. ~~[http://code.erisian.com.au/Wiki/debootstrap debootstrap] ベースで改造する~~ 5. ~~[http://xen-tools.org/software/rinse/ rinse] を調整~~ 2.a. 案で現在 VineSeed に vbootstrap-0.0.3 投入済み。 }}} == chroot環境作成手順 == vbootstrap は大雑把には以下のような手順で chroot 環境を用意している。 詳しくはスクリプトを参照してほしい。(実際には前処理後処理なども含まれる) {{{ INSTALLDIR=/path/to/root # rpmdb の初期化 mkdir -p $INSTALLDIR/var/lib/rpm rpm --initdb --root $INSTALLDIR # apt データベースの更新 apt-get -o RPM::RootDir=$INSTALLDIR update # 基本のパッケージをインストール for i in setup glibc coreutils bash rpm apt rootfiles do apt-get -y -o RPM::RootDir=$INSTALLDIR install $i done # vine-keyring を再インストール(上でいれた apt に再度読み込ませる) apt-get -y -q --reinstall -o RPM::RootDir=$INSTALLDIR install vine-keyring # resolv.conf をホストからコピー cp -a /etc/resolv.conf $INSTALLDIR/etc/ }}} 違うバージョンの chroot を作る場合は、apt に別の sources.list を読み込ませる。 * {{{/tmp/sources.list.4.2}}} {{{ rpm http://updates.vinelinux.org/apt 4.2/i386 main plus updates }}} * apt-get の追加オプション {{{ -o Dir::Etc::sourcelist=/tmp/sources.list.4.2 }}} * 完了後に rpmdb を再構築 {{{ rm -f $INSTALLDIR/var/lib/rpm/__db.00* chroot $INSTALLDIR rpm --rebuilddb }}} == 参考: 関連 bootstrap 機構 == * Debian: [http://code.erisian.com.au/Wiki/debootstrap debootstrap] * RPMベースシステム: [http://rpmstrap.pimpscript.net/ rpmstrap] (dead?) * RPMベースシステム: [http://xen-tools.org/software/rinse/ rinse] * ALT Linux: apt-rpm (rpm) [http://en.altlinux.org/Hasher Hasher] * Fedora: yum (rpm) [http://people.redhat.com/~rjones/febootstrap/ febootstrap] = vbuilder = vbootstrap を利用して chroot 環境の構築をサポートするスクリプトです。 特に、vbuilder に src.rpm を投げると、 chroot 環境上に Vine Linux のベースシステムを構築し、 投げた src.rpm をビルドし、生成された rpm をインストールします。 主な用途としては、ある src.rpm が必要とする BuildRequires: や Requires: の漏れを検証するために利用できます。 例えば、self-build パッケージのような、 ほとんどの環境でビルド可能なパッケージを作成するときに、 BuildRequires: 検証を強力にサポートします。 簡単な実行例をヘルプで出すようにしていますが、 [vbootstrap-0.0.22 に同梱されている vbuilder] {{{ $ vbuilder Usage: vbuilder {--version [version]} {--arch [arch]} {--dist-upgrade} {--target [target]} {--with-compat32} {--bootstrap-dir [directory]} {--cache-dir [directory]} {--built-rpms-dir [directory]} {clean|build|build-rpm [src.rpm]|install-rpm [arch.rpm|package]|remove-rpm [package]|show-info} Options: --version: set [version] (default: VineSeed) --arch: set [arch] (default: x86_64) --dist-upgrade: make VineSeed bootstrap via 5.1 --unionfs cover a bootstrap with unionfs --target: build rpms with [target] --with-compat32: build rpms with compat32 on boostrap --bootstrap-dir: set a bootstrap directory (default: /var/local/vbootstrap) --cache-dir: set a directory to cache rpms (default: /var/local/vbootstrap/cache) --built-rpms-dir: set a directory to store built rpms in chroot (default: /home/munepi/rpm/vbuilder) Actions: clean: clean the boostrap of [version] build: build a boostrap of [version] build-rpm: build [src.rpm] on a boostrap install-rpm: install [arch.rpm|package] on a boostrap remove-rpm: remove [package] on a boostrap show-info: show basic informations and logs in chroot For example, * make a clean/plain build environment on the current archtecture: vbuilder --clean --build * build rpms from the specified source rpm: vbuilder --build-rpm [src.rpm] * make a plain build environment for Vine Linux 4.2: vbuilder --version 4.2 --clean --build * make a i386 chroot on x86_64: vbuilder --arch i386 --clean --build * build a kernel package with target i686 vbuilder --target i686 --build-rpm [kernel src.rpm] * build a compat32 package: vbuilder --arch i386 --with-compat32 --build-rpm [src.rpm] supported version: 4.2 4.2_i386 5.1 5.1_i386 VineSeed VineSeed_i386 }}} 基本的な流れは以下の通りです。 {{{ $ sudo vbuilder clean ← 必要であれば、あらかじめ chroot 環境を削除する。 $ sudo vbuilder build $ sudo vbuilder build-rpm hoge.src.rpm }}} これらは一度に渡すこともできて、 以下のようにすれば、順次 clean → build → build-rpm のように実行します。 {{{ $ sudo vbuilder clean build build-rpm hoge.src.rpm }}} == 実用例 == 例えば、hoge.src.rpm を vbuilder へ投げます。 {{{ $ sudo vbuilder clean build build-rpm hoge.src.rpm }}} ところが、すでにリポジトリにある foo-devel, bar-devel パッケージと、 まだリポジトリに上がっていないが手元にビルド済みの fuga.arch.rpm が ビルド依存に必要だったために、 hoge.src.rpm のビルドが失敗してしまいました。 foo-devel, bar-devel, fuga.arch.rpm を chroot 環境へインストールしてから、 hoge.src.rpm のビルドを再度実行してみます。 {{{ $ sudo vbuilder install-rpm foo-devel install-rpm bar-devel install-rpm /some/where/fuga.arch.rpm build-rpm hoge.src.rpm }}} また、fuga.arch.rpm に別の修正を加えたために、 hoge.src.rpm のリビルドが再度チェックする必要が出てきました。 fuga.src.rpm の検証も兼ねて、vbuilder でテストしてみます。 {{{ $ sudo vbuilder clean build build-rpm /some/where/fuga.src.rpm build-rpm hoge.src.rpm }}} など。 == vbuilder の引数の補完 == === bash === {{{${HOME}/.bashrc}}} などに、以下の行を追加します。 {{{ . /etc/bash_completion.d/vbuilder }}} 以後、bash を起動するたびに、この vbuilder の補完が有効になります。 === zsh === http://trac.vinelinux.org/browser/projects/zsh-completion にすごく大雑把に書かれた「_vbuilder」の補完用ファイルがある。これをパッケージングしたものがzsh-completion-vineパッケージなのでそれをインストールする。 あるいは、それを直接取ってきて適切なディレクトリに置く。 例えば、{{{${HOME}/.zsh.d/functions/Completion}}}を作成し、{{{${HOME}/.zshrc.local}}}に次のように追記する。 {{{ fpath=(~/.zsh.d/functions/Completion ${fpath}) autoload -U compinit compinit }}} == Tips == === --dist-upgrade === VineSeed 上の一時的な依存関係などの不具合により、 {{{ $ sudo vbuilder clean build }}} を実行しても、VineSeed の bootstrap を構築できない場合がありました。 そのような場合は、このオプションを指定して {{{ $ sudo vbuilder dist-upgrade clean build }}} を実行すると、 現在リリースされている最新の安定版の bootstrap を一旦構築してから、 apt-line を VineSeed へ切り替えた後、apt-get dist-upgrade することにより、 VineSeed の bootstrap を構築します。 === build-rpm === {{{ $ sudo vbuilder clean build build-rpm hoge.src.rpm }}} のうち、build-rpm hoge.src.rpm は、 事前に vbuilder を当てる chroot 環境の / の存在をチェックしています。 そのとき、vbuilder を当てる chroot 環境の / が無ければ、 あらかじめ build と同等の処理をしますので、 実は、build は省略して以下のように実行しても構いません。 {{{ $ sudo vbuilder clean build-rpm hoge.src.rpm }}} === --target === 特定の target を指定し、rpmbuild --target に渡せます。 例えば、 {{{ $ sudo vbuilder --target i686 build-rpm hoge-1.0-1vl6.src.rpm }}} を実行すると、hoge-1.0-1vl6.i686.rpm がビルドされます。 === chroot 環境で生成された rpm === ユーザ foo が hoge-1.0-1vl5.src.rpm を vbuilder に投げたとします。 {{{ $ sudo vbuilder clean build-rpm hoge.src.rpm }}} このとき、chroot 環境で生成された hoge-1.0-1vl6.{i386,src}.rpm は、 foo の $HOME/rpm/vbuilder 以下の場所に、 hoge-1.0-1vl5.src.rpm と同じ所有者、同じグループとしてコピーされます。 {{{ /home/foo/rpm/vbuilder/ /home/foo/rpm/vbuilder/RPMS /home/foo/rpm/vbuilder/RPMS/i386/hoge-1.0-1vl6.i386.rpm /home/foo/rpm/vbuilder/RPMS/ppc /home/foo/rpm/vbuilder/RPMS/noarch /home/foo/rpm/vbuilder/RPMS/x86_64 /home/foo/rpm/vbuilder/SRPMS/hoge-1.0-1vl6.src.rpm }}} === --unionfs === unionfsを使うと、一度構築した最小のブートスラップに変更を加えずに、 その上に変更のみを被せることができます。 まず、最小のブーツストラップを構築します。 {{{ $ sudo vbuilder clean build }}} 以後、unionfsでブートスラップをカバーし、 hoge-1.0-1vl6.src.rpmのビルドを行います。 {{{ $ sudo vbuilder --unionfs build-rpm hoge-1.0-1vl6.src.rpm }}} --unionfs を保ったまま clean を実行すると、最小のブートスラップは消えません。 {{{ $ sudo vbuilder --unionfs clean }}} 引き続き、foo-1.0-1vl6.src.rpm をすぐさまビルドできます。 {{{ $ sudo vbuilder --unionfs build-rpm foo-1.0-1vl6.src.rpm }}} == TODO == * vbootstrap に例外処理とかエラー処理を入れる * ~~vbuilder のオプションの制御~~ (done) * ~~別途 conf などの設定ファイルを作成~~ (done) * ~~chroot 内で build user つくって、そいつに rpmbuild させる~~ (done) * BaseSystem の構築方法をいくつか増やす * tarball * ~~unionfs~~ (done) * ~~安定版からの dist-upgrade(VineSeed のみ)~~ (done) * vchroot を作成 * 複数の bootstrap 管理 * /var/lib/vbootstrap 以下に、name, version, arch , workdir データを保存 * --name, --workdir オプションの検討 * 実行したコマンド履歴を保存、閲覧 * fakeroot, fakechroot への対応 * stable/old-stableバージョンのmainカテゴリのみの環境構築 (security fix/proposed-updateなどのパッケージ作成に有用) == 既知の問題 == * RPMパッケージでProvidesされたパッケージ名を (2010年3月7日現在の) aptがハンドリングしないので、BuildRequiresにそのようなパッケージ名を指定したときにエラーがでる。 * [workaround] install-rpmオプションで実パッケージ名を指定する