オフライン搬入バンドルを作る
目標
パッケージ1つとその依存関係の全体を「持ち込みバンドル」にまとめ、チェックサムのマニフェストで検証したうえで、そのバンドルだけでインストールを再現します。エアギャップ環境への持ち込み手順の縮小版です。最後に、他人が作ったバンドルが内側で失敗したとき、内側で直すものと次の持ち込みに回すものを切り分けます。
なぜ重要なのか
エアギャップ環境で最もよくある失敗は、「取得して持っていったのに依存関係が足りず、再び外に出なければならない」ことです。持ち込みの審査が1日に1回しかない組織では、1往復が1日です。そのため熟練者は、外側で依存関係グラフを丸ごと解いた結果を持って入ります。そして、媒体を通過したファイルが無傷かを確認する方法が必要です。チェックサムは転送中の破損を捉え、署名は出どころを保証します。このラボは、その手順の骨格を身につけます。
最後のステップのインシデントは、その手順が1か所ずつ抜けたときの姿です。バンドルはファイル・マニフェスト・インデックスの3層なので、「インストールできない」という同じ症状が、どの層が間違っているかによって「内側でインデックスだけ作り直せば済むこと」にもなれば、「次の持ち込みまで1週間待たなければならないこと」にもなります。その判断を誤ると、往復が1回増えます。
ステップ
/root/offlineディレクトリを作成し、cowsayをインストールするときに取得が必要なファイルのURI一覧を、/root/offline/uris.txtに保存してください。(実際にインストールしてはいけません。)cowsayとその依存関係をダウンロードだけして、取得した.debファイルを/root/offline/pool/に集めてください。最低でも2つ以上ある必要があります。/root/offline/poolの中のすべての.debについて、SHA-256のマニフェストを/root/offline/manifest.sha256として作成してください。- そのマニフェストで検証を行い、結果を
/root/offline/verify.txtに保存してください。すべての行が正常(OK)である必要があります。 /root/offline/poolをリポジトリにするために、PackagesとPackages.gzを生成してください。/etc/apt/sources.list.d/labhub-airgap.listでこのリポジトリを登録し、インデックスを更新してください。cowsayを再インストールして、持ち込んだものでもインストールできることを確認し、インストール後のcowsay labhubの実行結果を/root/offline/run.txtに保存してください。- インシデント —
incident pk-bundle-brokenを実行してチケットを読んでください。持ち込みバンドルの4つのパッケージのうち3つがインストールできません。内側で直せるものは直してインストールし、/root/incident/pk-bundle-broken/report.txtに、パッケージごとに原因コード(corrupt-file・missing-dep・stale-index・unsigned・wrong-arch)、次の持ち込みで持ってくるもの(refetch:)、evidence:の行を1行書きます。
参考
- 取得したファイルは、通常
/var/cache/apt/archives/に溜まります。事前にキャッシュを空にしておくと、今回取得したものだけが残るので、区別しやすくなります。 - よくある間違い1: ステップ3のマニフェストを絶対パスで作ると、ステップ4の検証が別のディレクトリで壊れます。poolディレクトリに入ってから相対パスで作るほうが安全です。
- よくある間違い2: ステップ1で実際にインストールしてしまうと、ステップ2で「すでに最新」と言われて、何も取得されません。
- よくある間違い3: ステップ6で
Permission deniedが出てインデックスの更新が失敗する場合です。aptは、ファイルを取得するときだけ_aptという非特権ユーザーに権限を落としますが、/rootが700なので、そのユーザーが通過できません。その他のユーザーに「入る」(x)ための1マスだけを開ければよいのです — 一覧の表示(r)は、依然として閉じたままです。 - よくある間違い4: インシデントで、壊れたファイルを残したままインデックスを作り直す場合です。インデックスツールはファイルの先頭部分(制御情報)だけを読んでもエントリを書いてしまうので、壊れたファイルが「インストール可能」に化けます。
- インシデントツール:
incident listで一覧を、incident show <이름>でチケット(同僚からの報告)を再確認します。同じインシデントをもう一度発生させると、最初の故障状態に戻ります。 - レポートは
/root/incident/<이름>/report.txtに書きます。対象ごとに<이름>: <원인 코드>を1行、そしてevidence: <관찰한 출력 한 줄>を書きます。証拠の行は、インシデントで実際に見た出力と照合されます。 - 採点はレポートだけを見るわけではありません。dpkgの状態DB・aptの候補・署名検証といった実際の状態が正しい必要があり、症状だけを消す回避策(強制インストール・削除・署名の無効化)は失敗です。
何を取得すべきかを先に計算
/root/offlineディレクトリを作成し、cowsayをインストールするときに取得が必要なファイルのURI一覧を、/root/offline/uris.txtに保存してください。(実際にインストールしてはいけません。)
apt-get installには、実際には取得せず、取得するURIの一覧だけを出力するオプションがあります。シミュレーション系のオプションを探してみてください。
パッケージのダウンロード
cowsayとその依存関係をダウンロードだけして、取得した.debファイルを/root/offline/pool/に集めてください。最低でも2つ以上ある必要があります。
インストールまではせず、ダウンロードだけを行うオプションがあります。取得したファイルは、aptのキャッシュディレクトリに溜まります。
チェックサムのマニフェスト生成
/root/offline/poolの中のすべての.debについて、SHA-256のマニフェストを/root/offline/manifest.sha256として作成してください。
sha256sumを複数のファイルに一度にかけると、「ハッシュ 空白 ファイル名」の形式が出力されます。あとで検証するときに、そのまま使える形式です。
マニフェストで検証
そのマニフェストで検証を行い、結果を/root/offline/verify.txtに保存してください。すべての行が正常(OK)である必要があります。
sha256sumには、ファイルの代わりにマニフェストを読んで検査するオプションがあります。検証は、マニフェストがあるディレクトリで実行しないと、パスが合いません。
持ち込んだものでリポジトリのインデックスを作る
/root/offline/poolをリポジトリにするために、PackagesとPackages.gzを生成してください。
前のラボと同じ方法です。ただし、今回はファイルが複数あるので、インデックスのPackageエントリの数を確認してみてください。
持ち込みリポジトリの登録
/etc/apt/sources.list.d/labhub-airgap.listでこのリポジトリを登録し、インデックスを更新してください。
リポジトリ名を前のラボと違うものにしてください。2つのリポジトリが同時に有効でも問題ありません。
持ち込みリポジトリから再インストール
cowsayを再インストールして、持ち込んだものでもインストールできることを確認し、インストール後のcowsay labhubの実行結果を/root/offline/run.txtに保存してください。
すでにインストール済みのパッケージを同じバージョンでもう一度インストールするには、再インストールのオプションが必要です。
インシデント — 持ち込みバンドルで4つのうち3つがインストールできない
incident pk-bundle-brokenを実行すると、エアギャップ環境に持ち込んだバンドル(/srv/airgap/bundle-2026-11)をaptリポジトリとして追加したサーバーになります(先にチケットを読んでください)。症状: ttdata・ttfmt・ttplot・ttcliの4つのうち、ttdataだけがインストールされました。内側で直せるものは直してインストールし、外側からもう一度持ってくる必要があるものは、次の持ち込みリストとして残してください。バンドルには承認されたマニフェストとハッシュが一致するファイルだけが残っている必要があり、インデックスはそれらのファイルと正確に一致していなければなりません。マニフェストを書き換えたり、依存関係を無視して押し込んだりすると失敗です。/root/incident/pk-bundle-broken/report.txtに<패키지>: <코드>の3行(ttfmt・ttplot・ttcli)、refetch: <다음 반입에 가져올 패키지 이름들>、evidence: <관찰한 출력 한 줄>を書きます。コードはcorrupt-file(媒体を通る途中でファイルが壊れた)・missing-dep(依存パッケージがバンドルにない)・stale-index(インデックスがバンドルの内容より古い)・unsigned(署名がなく拒否された)・wrong-arch(アーキテクチャが異なる)のいずれかです。
方針: バンドルは「ファイル + マニフェスト + インデックス」の3層です。パッケージごとにどの層が間違っているかを切り分ければ、内側で直せるものと、外側からもう一度持ってくるべきものが自然に分かれます。 ツール: 持ち込み記録(/var/log/airgap-install.log)、sha256sumのマニフェスト検査、バンドルのPackages、dpkg-deb -f(制御フィールド)、dpkg-scanpackages。 具体: マニフェスト検査で失敗した行、インデックスのPackage一覧とpoolの.deb一覧の差、ttplotのDependsが指す名前がバンドル内にあるかを見てください。インデックスを作り直すとき、壊れたファイルがpoolに残っていると、それまでインデックスに入ってしまいます。