初めに

必要に迫られて自前のDebianリポジトリを構築してみたので、そのための手順と構築したリポジトリからパッケージをインストールする方法をまとめてみました。

背景

そもそもきっかけはDebian 11(コードネーム bullseye)でpyspf-milterを利用しようとして異常終了するバグに直面したことでした。この問題を解決するためには、stableのものより新しいtesting/unstableのパッケージをカスタマイズした上でバックポートする必要があります。このあたりの詳細については以下の記事にまとめました。

作成したパッケージを直接インストールしても良かったのですが、どうせなら通常のパッケージと同様にapt installでインストールできるようにしたかったので、自前のリポジトリを構築してみることにしました。

前提

リポジトリに関する前提

構築するリポジトリに関する前提は以下の通りになります。

リポジトリはパッケージをビルドを行ったシステム上に構築する。
リポジトリはWebサーバを用いてHTTPでアクセスできるようにする。

前者に関しては、作成したパッケージとそれに署名する際に用いたGnuPGの鍵を持っていけば、別のシステム上でも構築は可能ですが、話を簡単にするために同じシステム上で構築することとします。

パッケージに関する前提

パッケージに関しては、前述の記事で作成したパッケージを利用するということになりますが、一応具体的に条件を挙げると以下のようになります。

パッケージはstableより新しいバージョンのunstable(sid)のものをカスタマイズしたうえで、stable(bullseye)にバックポートしたものである。
パッケージはdebuildを使ってビルドされたもので、GnuPGの鍵で署名されている。

以下の説明では、パッケージは~/work/debian/spf-engine/にあるものとします。

% ls -1F ~/work/debian/spf-engine
postfix-policyd-spf-python_2.9.3-1.1~bpo11+1_all.deb
pyspf-milter_2.9.3-1.1~bpo11+1_all.deb
python3-spf-engine_2.9.3-1.1~bpo11+1_all.deb
spf-engine/
spf-engine_2.9.3-1.1~bpo11+1.debian.tar.xz
spf-engine_2.9.3-1.1~bpo11+1.dsc
spf-engine_2.9.3-1.1~bpo11+1_amd64.build
spf-engine_2.9.3-1.1~bpo11+1_amd64.buildinfo
spf-engine_2.9.3-1.1~bpo11+1_amd64.changes
spf-engine_2.9.3.orig.tar.gz

準備

リポジトリの構築にはrepreproというコマンドを用います。同じ名前のパッケージで提供されているので

apt install reprepro

とすればインストールすることが出来ます。

リポジトリの構築

リポジトリのトップディレクトリの作成

前提条件で書いたように、リポジトリはWebサーバを用いてHTTPでアクセスできるようにするので、/var/www/debianに構築することとします。リポジトリのトップディレクトリを

mkdir -p /var/www/debian

で作成します。パッケージを追加する際にパッケージへの署名に用いたGnuPG鍵を使用するので、このディレクトリはGnuPG鍵を所有するアカウントが読み書き可能である必要があります。今回はディレクトリの所有者をGnuPG鍵を所有するアカウントに変更します。

chown taro /var/www/debian

リポジトリの構成ファイルの作成

構成ファイルはリポジトリのトップディレクトリの下にconfというディレクトリを作成して、そこにdistributionsという名前で作成します。

cd /var/www/debian
mkdir conf
cd conf
vi distributions

構成ファイルの内容は以下の通りです。

Codename: bullseye-backports
Architectures: amd64 source
Components: main
Origin: deb.example.org
Label: deb.example.org
Description: Example.org Debian repository
SignWith: 7F4DBC5AFC3010FF

各項目の意味は以下の通りです。

Codename: 配布されるパッケージのコードネームの一覧(必須項目)。パッケージに関する前提のところで説明した通り、今回用いるパッケージはunstableのバージョンをstable(bullseye)にバックポートしたものなので、bullseye-backportsになります。
Architectures: 配布するパッケージのアーキテクチャの一覧(必須項目)。sourceはパッケージのソースを配布することを意味します。
Components: リポジトリが提供するコンポーネントの一覧(必須項目)。Debianの公式リポジトリだとmain,contrib,non-freeなどがありますが、それ以外にも任意の値を指定できます。
Origin: このリポジトリの配布元を表す文字列。配布元のホスト名やURLなどを用いるのが良いでしょう。aptの設定ファイルでここで指定された値を条件として指定する場合があります。
Label: このリポジトリに対するラベル。Originと同様に、aptの設定ファイルでここで指定された値を条件として指定する場合があります。
Description: このリポジトリの説明文。
SignWith