Debian 13 講座 / deb822形式のリポジトリとSigned-Byを設定する
Debian 13 は、Advanced Package Tool (APT) のリポジトリ定義を /etc/apt/sources.list と /etc/apt/sources.list.d 以下のファイルに保存します。deb822 形式の .sources ファイルは、各リポジトリ定義を名前付きフィールドにグループ化します。既存の設定を変換する際は、その配布元のアドレス、対象リリース、アーカイブの構成要素、署名検証に使う鍵の範囲を維持し、古い重複エントリを無効にしてから、リストを更新し、パッケージ候補を比較してください。
現在のリポジトリ形式を確認する
APT パッケージのインストールおよび削除ラボ で使用する Debian 13 VM を使用してください。リポジトリ定義は、パッケージのソースと信頼の両方を制御します。Ubuntu リポジトリや他の Debian リリースの設定を貼り付けないでください。
cat /etc/os-release
ls -l /etc/apt/sources.list
find /etc/apt/sources.list.d -maxdepth 1 -type f -print
cat /etc/apt/sources.list
apt-cache policy bash
既に .sources ファイルが存在する場合は、有効なリポジトリを確認するためにファイルを読み取ります。プライベートリポジトリのアドレスに認証情報が含まれる環境では、ファイル全体を外部に共有しないでください。/etc/apt/sources.list がなくても設定が存在することがあるため、ファイルが存在しないからといってリポジトリがないとは仮定しないでください。
実際の検証環境は Debian 13.7、APT 3.0.3 です。インストーラーは sources.list に単一行の deb および deb-src エントリを作成し、sources.list.d は空でした。ここで説明する変換手順はその状態を対象としています。適切な deb822 設定が既に存在する場合は、新しい重複ファイルを作成せず、代わりに現在のファイルのフィールドを確認してください。
deb822 フィールドとアーカイブコンポーネントを読む
deb822は、リポジトリをフィールド名と値のセットとして書き込む形式です。1セットは空行で区切られます。YAMLでもシェルスクリプトでもないため、.sourcesファイルをbashで実行することはありません。sources.list マニュアル は、.listの単一行形式と.sourcesのdeb822形式の両方を説明しています。
| フィールド | 役割 | 例の選択 |
|---|---|---|
| Types | バイナリおよびソースパッケージリストの種類 | debはバイナリパッケージのインデックスを要求し、deb-srcはソースパッケージのインデックスを要求します。 |
| URIs | リポジトリの基本アドレス | 一般アーカイブとセキュリティリポジトリを区別します。 |
| Suites | リリース/更新ブランチ | trixie、trixie-updates、trixie-securityを使用します。 |
| Components | 照会するアーカイブ領域 | 既存のmainとnon-free-firmwareを維持します。 |
| Signed-By | このリポジトリを検証するために使用するキーリング | インストールされたDebianアーカイブキーリングの絶対パス。 |
複数のフィールド値は、カンマではなく空白で区切ってください。例えば、2つの Suites の値は1つの空白で区切られたフィールドを共有します。Enabled: no を追加すると、.sources ファイル内のそのスタンザ全体が無効になり、定義されているすべてのスイートも無効になります。そのフィールドを削除するか yes に変更して、スタンザを再有効化してください。すべてのアクティブな定義を確認し、セキュリティリポジトリが誤って無効になっていないことを確認してください。
Debian 13 を維持するには、stable のような移動する名前を使うのではなく、トリクシー(trixie)というコードネームを指定する設定により意図が明確になります。新しい Debian が stable になった後でも、trixie は同じリリースを指します。trixie-updates は stable リリースのアップデートブランチで、trixie-security はセキュリティアップデートブランチです。コードネームの変更はディストリビューションアップグレード計画に関連しているため、リポジトリエラーを避けるために勝手に変更しないでください。
| エリア | 分類基準 | 選択時の確認 |
|---|---|---|
| main | Debianフリーソフトウェアガイドライン(DFSG:Debian Free Software Guidelines)に準拠しているこのディストリビューションのエリア | デフォルトパッケージ構成のコア部分。 |
| contrib | ソフトウェア自体は自由ソフトウェアの指針に準拠しているが、main外のコンポーネントに依存する可能性がある領域 | 必要なプログラムと依存関係を確認してください。 |
| non-free | フリーソフトウェアガイドラインに準拠していないソフトウェア | ライセンスと組織の方針を確認してください。 |
| non-free-firmware | 個別に分離された非フリーのファームウェア領域 | デバイスに必要なファームウェアと配布条件を確認してください。 |
エリアを区別するための基準は、Debianポリシーアーカイブエリアの説明 にあります。ファームウェアが必要だからといって、すべての非フリーエリアを自動的に追加する必要はありません。この例では、インストーラーの既存選択をそのまま保持しています。
定義をバックアップし、パッケージ候補を記録する
バックアップディレクトリは既に存在してはいけません。存在する場合は、新しい名前を選び、すべての回復パスを一貫して調整してください。最初の1行だけを先に実行し、成功してから残りの行へ進んでください。コピーやターゲットファイルのチェックが失敗した場合も中止してください。使用可能なバックアップなしで編集を進めないでください。
sudo test ! -e /var/backups/lf-debian13-10 && sudo install -d -m 700 /var/backups/lf-debian13-10
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.d /var/backups/lf-debian13-10/
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-before.txt
sudo test ! -e /etc/apt/sources.list.d/debian.sources
ls -l /usr/share/keyrings/debian-archive-keyring.gpg
sudo -u _apt test -r /usr/share/keyrings/debian-archive-keyring.gpg && printf 'APT account can read the keyring\n'
もし debian.sources がすでに存在する場合は、上書きしないでください。キーリングは debian-archive-keyring パッケージによって提供され、この VM では .gpg パスが .pgp ファイルを指すリンクになっていました。重要なのは、指定された公開キーリングが _apt アカウントによって実際に読み取れるかどうかです。キー ファイルが存在しない、または破損している場合は、未検証のキーを受け取って回避せず、適切なパッケージやリカバリ資料を確認してください。
bash の候補検索は、変換によってパッケージ選択が意図せず変更されたかどうかを確認するための比較データです。たとえ 1 つのパッケージが同じであっても、すべてのパッケージポリシーが同一であることを証明するわけではないため、リポジトリのアドレス、ブランチ、コンポーネントも比較してください。
deb822ファイル全体を記述し、元の定義を無効にする
次のコマンドで新しいファイルを開きます。先行の存在確認とバックアップが完了している場合にのみ進めてください。
sudo nano /etc/apt/sources.list.d/debian.sources
以下の内容をすべて入力し、Ctrl+O と Enter で保存してから、Ctrl+X で終了します。通常および更新されたエントリは同じアドレスの下にまとめ、セキュリティリポジトリは別のグループに配置します。2つのグループの間には空行を入れてください。
Types: deb deb-src
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb deb-src
URIs: http://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types に deb-src を含める理由は、既存のソースリスト機能を保持するためです。ソースをダウンロードしてビルドしないサーバーは、必要に応じて deb のみを使用できますが、その選択はフォーマット変換とは別です。リポジトリのアドレスはURIsに、適切なキーリングのパスは Signed-By に置き、他のディストリビューションのキーリングを代用しないでください。
sudo chmod 644 /etc/apt/sources.list.d/debian.sources
sudo nano /etc/apt/sources.list
既存の sources.list から新しいファイルに移動した Debian の deb および deb-src 行をコメントアウトして無効化します。他の目的のエントリは、別途レビューなしに削除しないでください。例えば、既存の deb http://deb.debian.org/debian trixie main non-free-firmware をコメントに変更します。既存の cdrom エントリがすでにコメントアウトされている場合は、そのままにしておきます。
同じリポジトリが .list ファイルと .sources ファイルの両方で同時に有効化されている場合、重複警告や Signed-By 値の競合が発生する可能性があります。ファイル名を .sources.txt として保存すると、APT は期待する形式として読み込まないため、拡張子も確認してください。
リストを更新し、パッケージ候補を比較する
次の操作はインストールされているパッケージをアップグレードしません。最初に、リポジトリの定義と署名の検証が正しく処理されているかどうかを確認します。
sudo apt update
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-after.txt
sudo diff -u /var/backups/lf-debian13-10/bash-policy-before.txt /var/backups/lf-debian13-10/bash-policy-after.txt
sudo apt-get -s install tree
検証用VM上では、trixie、trixie-updates、および trixie-securityのInRelease(署名付きのリリース情報)がすべて検証されました。bash の候補および優先度の比較は違いなく通過し、tree のシミュレーションインストールも正常に計画が作成されました。比較している間にリポジトリ側が更新された場合、新しいバージョンにより違いが生じる可能性があるため、変更されたソースとバージョンを確認して判断します。
アップデートは部分的に失敗することがあり、その後のコマンドは古いパッケージリストを使い続けることがあります。最後の行だけを見ずに、署名エラー、ダウンロードの失敗、重複警告を確認してください。失敗したリポジトリがセキュリティリポジトリである場合、既存のパッケージを検索できても、セキュリティ用のリスト取得が失敗していれば作業完了とは判断できません。
Signed-Byとリポジトリの信頼を理解する
Signed-By は、リポジトリのメタデータを検証するために使用される公開鍵の範囲を制限します。キー ファイルが存在するという事実と、リポジトリの署名が正しく検証されるという事実は異なります。apt-secure マニュアル では、署名付き Release 情報とパッケージハッシュを使用した検証システムについて説明しています。リポジトリの信頼もすべてのパッケージ操作が安全であるという保証とは異なります。
この例では、インストーラーの公式 HTTP アドレスを保持し、署名検証を使用しています。HTTPS は通信経路の暗号化など、署名検証とは別の保護を提供しますが、署名検証の代替にはなりません。HTTPS を使用する組織は、証明書の信頼性とプロキシポリシーを確認することで、一貫して適用する必要があります。
外部プロバイダのリポジトリを追加する際には、Debian 13 がサポートされているか、公式の配布 URL、キーのフィンガープリント、および配布パスを確認してください。管理者によって保存されたキーは /etc/apt/keyrings に分けて配置でき、パッケージで管理されるキーは /usr/share/keyrings に配置される場合があります。外部キーをグローバルに信頼するために任意に追加したり、問題を回避するために Trusted: yes や署名検証を無効にするオプションを使用したりしないでください。また、Debian 13 のデフォルトリポジトリ用のキーを取得するために、古い apt-key add 手順をコピーする必要もありません。
署名キーのエラーについては、Signed-Byパス、読み取り権限、正確なキー、およびリポジトリを確認してください。リリースの有効期間のエラーについては、サーバーの時計とリポジトリの状態を確認してください。時刻の確認方法は、「タイムゾーンの区別と実際の同期」で説明されている基準に従うことができます。原因を特定せずに日付や有効性チェックを無効にしないでください。
元のリポジトリ定義を復元する
この記事のように、元の sources.list のみが使用され、新しい debian.sources が追加された場合は、以下の方法で復元します。復元する前に、バックアップと比較してほかの管理者による正当な変更が加わっていないことを確認してください。すでに運用中の .sources ファイルが変更されていた場合、そのファイルのバックアップを個別に復元する必要があります。
sudo cp -a /var/backups/lf-debian13-10/sources.list /etc/apt/sources.list
sudo rm -- /etc/apt/sources.list.d/debian.sources
sudo apt update
apt-cache policy bash
新しい debian.sources ファイルのみを削除し、sources.list.d の残りはそのままにします。ラボでは、復元された sources.list が元の内容とバイト単位で一致し、その後のリストの更新が成功しました。リポジトリ形式を変換しても、インストール済みパッケージが以前のバージョンに戻ることはありません。その後に行われるパッケージのアップグレードには、別途回復計画が必要です。




