Debian 13 講座 / Debian 12から13へ更新し動作を検証する
Debian 12 から 13 にアップグレードする際は、リポジトリを trixie に切り替え、その後、最小限のアップグレードと完全なアップグレードを順番に実行します。完了の判断は、APT の終了メッセージだけでなく、新しいカーネルの起動、新しい SSH 接続、ネットワークおよびサービスのデータ、テンポラリファイルとカーネル設定の動作確認によっても行います。
アクセスと永続的なターミナルセッションを準備する
対象は、アップグレード前の点検と復旧準備を終えたamd64 Debian 12サーバーです。バックアップの復元、コンソールログイン、または適切な再起動がまだ確認されていない場合は、まず準備を完了してください。外部リポジトリ、他のアーキテクチャ、またはデータベース/メールサーバーを持つ環境については、これらの製品の移行ガイドラインも追加で確認してください。
検証環境は、Debian 12.15、カーネル 6.1.0-55-amd64、メモリ 3 GiB、仮想ディスク 30 GiB を実行する別の VirtualBox VM でした。二段階のインストールと再起動を実施しました。Python サービスのコードとデータはバックアップされ、HTTP 応答はベースラインとして記録され、この環境は稼働中のデータベースのメジャーバージョンアップグレードのテストには使用されませんでした。
もしbookwormにtmuxがインストールされていない場合は、リポジトリを切り替える前にsudo apt install tmuxでインストールしてください。別のコンソールを開いて、次のセッションを作成し、記録を開始します。ログには機密設定が含まれる可能性があるため、非公開にしてください。tmuxはネットワーク切断後もターミナルセッションを保持し、scriptはターミナル出力を記録します。
開始する前に、トランスクリプトのパスがすでに存在するか確認してください:script -aは既存のファイルに追記します。関連のない実行が混ざらないように、新しいタスク専用のファイル名を選んでください。scriptで開かれたシェル内で、以降のアップグレードコマンドを実行します。
tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"
SSH接続が切断された場合、再接続してtmux attach-session -t debian13-upgradeに戻ることができます。まず、APTが実行中か確認し、同じアップグレードを繰り返さないようにしてください。tmuxはSSH切断に備えるためのツールであり、タスクが再起動や電源障害を生き残ることを保証するものではありません。
リポジトリを確認し、完全なdeb822構成を書き込む
この例は、公式のbookwormエントリが1つのファイル/etc/apt/sources.listにのみ存在し、sources.list.dにはファイルが全く存在しない練習用サーバー向けです。まず、実際のファイルを読み取り、既存の外部リポジトリ、バックポート、ピン設定を個別に処理してください。以下の前提条件が満たされていない場合は、一括文字列置換を行うのではなく、実際のリポジトリ構成に従って修正してください。
sudo cat /etc/apt/sources.list
sudo find /etc/apt/sources.list.d -maxdepth 1 -type f -print
sudo bash <<'ROOT'
set -euo pipefail
. /etc/os-release
test "$VERSION_ID" = 12
test -z "$(dpkg --audit)"
test -z "$(find /etc/apt/sources.list.d -maxdepth 1 -type f -print -quit)"
test -f /usr/share/keyrings/debian-archive-keyring.gpg
dest=/var/backups/debian13-upgrade
test ! -e "$dest"
install -d -m 700 "$dest"
cp -a /etc/apt/sources.list "$dest/sources.list.bookworm"
mv /etc/apt/sources.list "$dest/sources.list.disabled"
cat > /etc/apt/sources.list.d/debian.sources <<'SOURCES'
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
SOURCES
ROOT
sudo apt update
apt-cache policy apt systemd linux-image-amd64 openssh-server
main non-free-firmware は、この VM で使用される構成です。既存のサーバーが contrib や non-free を必要とする場合は、パッケージとポリシーを確認し、コンポーネントを追加してください。deb-src を必要とする開発環境も別途検討する必要があります。Signed-By は実際の Debian アーカイブキーリングを指しており、署名エラーを無視するオプションを追加してはいけません。deb822 は空行で区切られたフィールドベースのスタンザを使用します。.sources ファイルもこの形式を使用します。この形式は Debian sources.list マニュアル に記載されています。
ガードされたルートブロックが失敗した場合は、apt update の前で停止し、どのファイルが移動または作成されたかを確認してください。複数コマンドの例が部分的な変更を自動的に元に戻すと仮定しないでください。リポジトリや署名のエラーがあれば停止してください。古い、または信頼できないメタデータを使ってインストールを続けないでください。
リストの更新がエラーなく完了し、候補バージョンがTrixieシリーズから来ていることを確認してください。この時点では、Debian 13のパッケージはまだインストールされていないため、リポジトリ選択が誤っていることに気付いた場合は、新しいファイルを無効化し、アーカイブされたBookwormのファイルを復元して再度更新することができます。インストールを開始した後は、リポジトリを単に元に戻すだけでシステムが完全に復元されると仮定しないでください。
最小限のアップグレードを完了し、完全なアップグレードの変更を確認する
apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade
最初のステップは、新しいパッケージをインストールしたり既存のパッケージを削除したりせずに可能なものを更新することです。残りのパッケージがあるからといって、直ちに失敗を意味するわけではありません。検証用VMでは、最小限のステップで222項目が更新され、新規インストールや削除はありませんでした。完全なステップで必要となるライブラリの置き換えは、次のステップで処理されます。
シミュレーションで削除予定のパッケージ名を、その置き換えパッケージと比較してください。例えば、このVMでは、libssl3などの25個の項目が削除候補として表示され、その後libssl3t64のようなパッケージが新たにインストールされました。これはすべての削除を自動的に正当化するものではありません。SSH、ネットワーク、ストレージ、またはアプリケーションをサポートするパッケージが置き換えなしに消える場合は、手順を中止してください。APTマニュアル に説明されているように、完全アップグレードは削除を伴うことがあります。
レビューには、削除リストだけでなく、ダウンロードサイズ、インストール後に増えるディスク使用量、保留中のパッケージ、外部依存関係も含まれます。別のAPT操作が実行中の場合は、その終了を待ってください。ロックファイルを削除したり、パッケージプロセスを強制終了したりしないでください。
フルアップグレードを実行し、設定ファイルの選択を確認する
sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager
実際の変更概要が検討済みの内容と一致するか読んでから承認してください。apt-listchangesが開いたら内容を読み、閉じて処理を続けます。dpkgやucfが変更済み設定ファイルの扱いを尋ねたら、対象ファイルと自分の変更内容を先に確認してください。
| 選択状況 | 判断とその後の検証 |
|---|---|
| 認証、ポート、ネットワークなど意図されたローカルの変更がある | 差分を確認し、必要な変更を維持する。維持された構文が新しいバージョンでも有効かどうかを確認する。 |
| 配布のデフォルト設定を変更していないか、新しいバージョンで重要な変更があります | パッケージガイドと新しいデフォルトを確認してください。既存のファイルを保持することを自動的に正しい答えと見なさないでください。 |
| 重要な設定の違いを判断できません | コンソールとバックアップを保持しながら説明と差分を確認してください。再起動を急がないでください。 |
| 自動インストール環境 | 事前に選択ポリシーをテストしてください。単一の非対話型変数では、すべての問題と互換性を解決できません。 |
このコース用の検証VMは、ログと終了コードを別のtmuxセッションに保存し、変更なしの最小サーバー構成に基づいて既存のカスタム設定を保持するポリシーを設定しました。上記の読者向け手順はインタラクティブな実行であり、質問を読み選択を行うものです。演習の自動承認オプションを本番サーバ全体に直接適用する方法は案内していません。
インストールがエラーで終了した場合、まずログ、ディスク容量、パッケージの状態を確認してください。進行中のAPT操作がない場合かつ原因が解決された場合に限り、sudo dpkg --configure -a や sudo apt --fix-broken install による変更提案を確認してください。インストール途中での再起動や大量削除/強制上書きを一般的な解決策として使用しないでください。
再起動前にカーネル・インターフェース・SSHを確認する
dpkg-query -W linux-image-amd64 'linux-image-*'
ls -l /vmlinuz /initrd.img
sudo ls -lh /boot
sudo /usr/sbin/sshd -t
ip -brief link
sudo udevadm test-builtin net_setup_link /sys/class/net/enp0s3
sudo efibootmgr -v
enp0s3 は検証用VMのインターフェースです。実際の名前に変更し、ID_NET_NAME および現在のネットワーク設定のインターフェースと比較してください。一部のハードウェアでは名前が変更される場合があるため、コンソールが必要です。BIOSシステムでは efibootmgr を使用せず、ブート方法およびGRUBのインストール状況を確認します。
新しいカーネルとinitramfsがインストールされても、現在のuname -r には再起動前のカーネルが表示されます。実際に認証とsudoアクセスを確認するために新しいSSHウィンドウを開き、開かれた接続だけで全てが正常だと仮定しないでください。検証用VMのインターフェース名は変更されておらず、再起動前の新しいSSH接続は成功しました。
sudo reboot
起動が遅れる場合は、コンソールでどのステップにいるか確認してください:ブートローダー、カーネル、またはサービス。すぐに電源を切ったりホストキーの検証を無効にしたりするのではなく、実際のブート状況および元のフィンガープリントを確認してください。
更新後のOSでサービスとデータを検証する
cat /etc/os-release
uname -r
sudo dpkg --audit
sudo apt-get check
ip -brief address
ip route
getent ahostsv4 deb.debian.org
systemctl --failed --no-pager
sudo /usr/sbin/sshd -t
再接続されたVM上で、Debian 13.7とカーネル6.12.117+deb13-amd64が確認されました。既存のサービスは有効でアクティブであり、HTTPコンテンツは設定済みの参照値と比較され、プログラムとデータのSHA-256も一致していました。自身のサービスについては、実際の名前、アドレス、ファイルを用いて次のように検証してください。正しいサービスおよび基準ファイルに対して読み取り専用でチェックを行い、サンプルを適用する際に本番データを削除または上書きしないでください。
systemctl is-enabled lf-upgrade33.service
systemctl is-active lf-upgrade33.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
sudo sha256sum -c /var/backups/lf-debian13-upgrade33/service-files-before.sha256
上記のサービスは、事前チェック用の検証VM上でのみ存在します。通常のサーバーでは、実際のサービスのステータス、ポート、読み取り応答、およびデータベース接続が比較されます。書き込み機能を持つサービスについては、実際の書き込みを再開する前に、書き込みと再クエリも隔離されたテストデータを使用して確認されます。
/tmpとsysctlの変更を確認する
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit
再起動後、検証用VMは/tmpがtmpfs(メモリを利用するファイルシステム)になりました。tmpfsのサイズ制限は、その分のメモリがあらかじめ予約されていることを意味するわけではありません。以前のルートファイルシステム上の/tmpにあったファイルは、新しいマウントの下で隠されている可能性があります。以前のファイルを見つける必要がある場合は、一時的な空のマウントポイントを作成し、通常のバインドマウントを使用してルートのみを確認してください。元のディレクトリを覆っているtmpfsなどのサブマウントも再現してしまう--rbindは使用しないでください。
sudo bash <<'ROOT'
set -euo pipefail
view=$(mktemp -d /mnt/old-root-view.XXXXXX)
trap 'mountpoint -q "$view" && umount "$view"; rmdir "$view"' EXIT
mount --bind / "$view"
find "$view/tmp" -mindepth 1 -maxdepth 2 -printf '%p\n'
umount "$view"
rmdir "$view"
trap - EXIT
ROOT
このコマンドはリストのみを表示します。実際のサーバーでは、一度に一時ディレクトリ全体を削除しないでください。代わりに、ファイルの所有者と必要性を判断してください。検証用VMの以前のマーカーは、ルートの通常のbindマウントから見ても存在せず、アップグレード前の最後の起動直後の存在も記録されなかったため、アップグレードがファイル消失の原因だとは判断できません。隠蔽の原理自体は、tmpfsが既存のファイルを覆う別のマウント名前空間を持つ小さな練習用ディレクトリで確認され、通常のrootバインドビューではファイルが見えました。その可視性の制御テストは、実際のリリースアップグレードを通じて事前アップグレードマーカーを追跡することとは別です。
Debian 13のsystemd-sysctlは/etc/sysctl.confを直接読みません。個々の/etc/sysctl.d/ファイルでローカル設定を管理し、設定意図と実際のランタイム値を比較します。実際には、新しいカーネル起動後でも別のドロップインのkernel.printk_ratelimit=7が適用されることが確認され、検証後、専用のラボドロップインのみが削除され、元のランタイム値も明示的に復元しました。ドロップインを削除するだけでは、現在の値が自動で元に戻るわけではありません。設定全体を不注意に再適用すると、ネットワークなど他の値に影響を与える可能性があるため、適用範囲を定義してください。systemd-sysctlマニュアルには、ファイルの選択と適用方法が説明されています。
検証を完了し、復旧が必要かどうかを判断する
検証後、スクリプト記録シェルを閉じ、トランスクリプトが保存されていることを確認するために exit と入力してください。パッケージタスクがまだ実行中でないことを確認してから、tmux セッションを閉じるか、デタッチしてください。
監視、スケジュールタスク、または中断された APT タイマーがある場合は、それらを元の記録された状態に戻してください。検証用 VM では、2 つの APT タイマーが有効かつアクティブな状態に戻されました。不要なパッケージは完全な検証後に apt -s autoremove で確認され、以前のカーネルや通常の起動に必要なサービス依存関係を急いで削除しないでください。
サービスやデータの検証に失敗した場合は、新しい書き込みを再開せずに失敗のログと証拠が保存されます。パッケージがすでに置き換えられている場合、単にbookwormリポジトリに切り替えるだけでは復旧は達成されません。事前に検証済みの状態とサービスのバックアップを使用して修復範囲を判断し、切り替え後に新しいデータがある場合は、別途保存と再適用の計画を立ててください。公式Debianアップグレード手順 と trixieでの既知の変更点、ならびに関連サービスの移行ドキュメントを確認してください。




