Debian 13 講座 / サーバー移行と切り替え・復帰を検証する
新しいDebianサーバーにサービスを移行する際は、まずランタイム環境とアカウントを準備し、その後、書き込みが停止している間に取得した最終バックアップを復元し、最後に機能やデータを比較する必要があります。アクセスを切り替えるだけでは移行は完了せず、安全に元のサーバーに戻すためには、新しいサーバーで生成されたデータをどのように保持するかを決定する必要があります。
移行範囲を定義し、各サーバーを特定する
この演習では、Pythonで作成された小規模な読み取り専用HTTPサービスを、2つのDebian 13仮想マシン(VM)間で移行します。プログラム、データ、およびsystemdユニットが提供され、127.0.0.1:8085でのみ応答します。Python http.server のドキュメント に記載されているように、これはインターネット向けの本番サーバーとして使用するための例ではありません。データベーススキーマの移行、実際のDNS(Domain Name System)変更、および外部向けTLS(Transport Layer Security)設定の移行は、この演習には含まれていません。
| 役割 | 演習接続 | 確認事項 |
|---|---|---|
| ソース旧サーバー | ホスト 127.0.0.1:22212 → 元のVM SSH | 参照応答、最終バックアップ、停止および再起動 |
| ターゲット新サーバー | ホスト 127.0.0.1:22213 → ターゲット VM SSH | 専用アカウント・復元・サービス応答・再起動 |
| 作業用コンピューター | 2つのサーバーのホストキーを個別に検証するSSH/SCP | バックアップ転送、ハッシュ比較、接続対象の選択 |
同じ 10.0.2.15 アドレスが NAT(Network Address Translation:アドレス変換) を使用して 2 つの VM 内に表示されても、それらは同じサーバーではありません。この例では、異なるホストループバックポートが VirtualBox Network → NAT → Advanced → Port Forwarding を経由して接続されました。実際のサーバーアドレスとポートに置き換え、各サーバーの識別情報とホストキーを個別に確認してください。演習中、ターゲット VM の起動が停止したため、通常の ACPI シャットダウンの後に再起動し、ターゲットが正常に接続できることを確認した後に復元を実施しました。
作業用の Linux コンピュータ上では、 ~/.ssh/configに以下の接続先エイリアスを設定できます。秘密鍵のパスは自身のものに置き換え、パスワードや秘密鍵の内容をテキストやログにコピーしないでください。
Host old-server
HostName 127.0.0.1
Port 22212
User lfstudent
IdentityFile ~/.ssh/id_ed25519
Host new-server
HostName 127.0.0.1
Port 22213
User lfstudent
IdentityFile ~/.ssh/id_ed25519
各サーバーには Python 3、curl、tar が必要です。インストールされていない場合は sudo apt install python3 curl tar で準備し、作業用コンピュータに SSH および SCP クライアントをインストールしてください。以下の元の例は、チュートリアルの既存の lfstudent アカウント(UID(User ID:ユーザーID)およびGID(Group ID:グループID)が1000)を前提としています。異なるアカウントを使用する場合は、User と Group および所有権の指定も変更してください。同じ名前の既存のディレクトリやサービスを上書きしない新しい練習用環境を使用してください。
完全なソースサービスを作成し、停止中にバックアップする
ソースサーバーで実行します。 このブロックはプログラム、データ、ユニットを作成し、応答を比較した後、サービスを停止します。最後にtarを作成する時点では、この例の読み取り用サービスも停止済みです。他のサービスや既存のアップグレード実習ファイルは対象ではありません。
sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path != '/':
self.send_error(404)
return
try:
body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
status = 200
except OSError:
body = b'data unavailable\n'
status = 503
self.send_response(status)
self.send_header('Content-Type', 'text/plain; charset=utf-8')
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT
短い起動待ち時間では足りず、curl が失敗する場合は、sudo systemctl status lf-migrate35.service および sudo journalctl -u lf-migrate35.service -n 30 を確認してください。パス、所有権、ポートの競合をチェックし、準備完了後に失敗したリクエストと比較を再試行してください。部分的に作成されたリソースの上で作成ブロックを再実行したり、ソースを停止する前に最終アーカイブを作成したりしないでください。ローカルの curl リクエストが設定されたプロキシをバイパスすることを確認してください。
期待される結果は service.tar: OK とバックアップ準備メッセージです。通常の応答は 1 行の migration payload 35 です。データがない場合や読み取れない場合、このサービスは 503 を返し、ファイルリストを公開したり他のパスを読み取ったりすることはありません。
実際のデータベースまたはファイルアップロードサービスの場合、単一のプロセスを停止するだけで十分かどうか判断する必要があります。バッチジョブ、キューコンシューマ、他のサーバでの書き込みを停止するか、製品の一貫したダンプまたはオンラインバックアップ手法を使用してください。初回の一括コピー後に最終変更を再同期する場合、2 つの時点と書き込み停止期間を記録してください。
ワークステーションを通じてバックアップを転送する
ソースサーバーで lfstudent としてエクスポートブロックを実行します。 エクスポートディレクトリがすでに存在する場合やコピーが失敗した場合は停止します。ワークステーションでは、mkdir migration35、チェックサム検証、またはターゲットインポートディレクトリの作成が失敗した場合に停止します。後の scp コマンドで古いディレクトリを再利用しないでください。
作成したばかりの実習用アーカイブとチェックサムの2ファイルのみをコピーし、ソースのルート専用バックアップを露出させずに、練習用アカウントの専用ディレクトリに配置します。実際のサービスバックアップの場合、機密情報が含まれているかどうかに応じて、別々の暗号化および保存ポリシーを適用します。
test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"
Linux ワークステーションで実行します。 SSH エイリアスが意図したサーバーを指していることを確認し、ファイルを新しい専用ローカルディレクトリに受信します。
ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/
ハッシュは一致する必要があり、リストには opt/lf-migrate35、var/lib/lf-migrate35、および関連するサービスユニットのみを含めるべきです。復元権限は、自分が作成した信頼できるアーカイブにのみ付与し、絶対パス、親ディレクトリへ移動する..のパス、または予期しないリンクがある場合は中止してください。チェックサムは転送中の破損を確認するためのものであり、ソースの信頼性に代わるものではありません。SCPのオプションや転送方法は OpenSSH scpマニュアル に記載されています。
専用アカウントでターゲットに復元する
ターゲットサーバーで実行します。 まず、/opt/lf-migrate35、/var/lib/lf-migrate35、/var/backups/lf-migrate35、/etc/systemd/system/lf-migrate35.service が存在しないことを確認し、getent passwd lf-migrate35 が既存のアカウントを見つけないことを確認します。sudo ss -ltn によってポート8085が使用中であることが示された場合は、中止して調査してください。
すべての前段のターゲット不在チェックは必須です:復元ブロックはそれらが通過したことを前提としています。また、getent group lf-migrate35 が既存のグループを見つけないことを確認してください。インポートパスはログインアカウントのホームが /home/lfstudent であることを前提としています;あなたの環境が異なる場合は一貫して置き換えてください。最終的な UID-not-1000 のアサーションは、このラボで ID が異なることを示しています;成功した本番マッピングは普遍的に要求される数値の差ではなく、意図されたターゲットの識別によって定義されます。
これによりステージングディレクトリに抽出され、必要なファイルがインストールされますので、元サーバーの/etc全体やサービス設定を無差別に上書きしません。先に対象ユニットの不存在を確認した上で、この実習用ユニットだけを作成します。元の数値UIDをコピーする代わりに、ターゲット専用のアカウント名にデータ所有権をリセットします。
sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target
[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT
検証VMの元のデータ所有者はUID 1000で、対象の専用アカウントはUIDおよびGID 988でした。データ権限はlf-migrate35:lf-migrate35:640に設定されており、コードバイト、HTTPレスポンス、およびサービス再起動後のレスポンスは同じでした。NoNewPrivilegesおよび読み取り専用システム保護は、この例におけるsystemdランタイム環境設定による制限です。同じユニットを直接書き込みサービスに適用すると、必要なデータ書き込みもブロックされる可能性があるため、権限は各パスごとに別々に設計する必要があります。
実際の運用環境では、ランタイムのバージョン、拡張モジュール、DBクライアント、環境変数、証明書、アップロードパスも比較されます。OSのバージョンが同じだからといって、ファイル形式や動作が同じだと仮定しないでください。対象に対して、製品がサポートする検証ツールおよび機能リクエストを実行してください。
切り替え・ロールバック・再切り替えを確認する
現在、元のサービスは停止しており、対象サービスが応答しています。作業用のコンピュータで、接続先を選択する変数を使用して読み取りを確認してください。これはSSHの宛先を選択するためのもので、DNS、ロードバランサー、または公開ウェブアドレスを変更する操作ではありません。
active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
- 対象で
sudo systemctl stop lf-migrate35.serviceを実行してください。 - オリジナルに対して
sudo systemctl start lf-migrate35.serviceを実行します。 - 作業用コンピュータで、以下のようにオリジナルの読み取りを行い、応答が同じかどうかを確認します。
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
再度ターゲットに切り替えるには、まずソースを停止し、次にターゲットサービスを起動して active=new-server で確認します。ターゲットの復元/再起動時の応答、ソースのロールバック、ターゲットの切り替えをすべて参照ファイルと比較しました。この小さなサービスは読み取り専用のため、切り替え後に新しい書き込みの競合が発生するシナリオは反映されません。
実際の本番切り替え前に決定する追加事項
| 項目 | 判定基準 |
|---|---|
| DNS およびロードバランサ | 現在のキャッシュ、既存の接続、ヘルスチェック、および伝播遅延を考慮してください。DNSのTTL(Time To Live)を下げるだけでは、すべてのリクエストが即座にルーティングされるわけではありません。 |
| 書き込みの再開とロールバック | 最終同期の前に、ソースへの書き込みをブロックし、ターゲットで生成されたデータがソースに再適用可能かを確認します。スキーマが後方互換性を持たない場合、単純なロールバックは避けてください。 |
| スケジュールされたタスク、メール、キュー | 両方のサーバーが同時に稼働する場合、重複する可能性があるタスクはどちらか一方のみを有効にしてください。Webリクエストの切り替えとは別に確認します。 |
| 成功判定 | プロセス、ポート、レスポンス、データ、主な機能、およびエラー率を個別に比較します。読み取りに成功しただけでは正常な書き込みとは見なされません。 |
ソースやバックアップを削除する前に、ロールバックウィンドウと保持期間を設定します。数値所有権および抽出動作については Debian GNU tar マニュアル を参照し、データベースやメジャーバージョンデータ移行については製品固有の公式手順に従ってください。
実習用リソースだけを片付ける
検証後、各サーバーで作成した実習用リソースだけを片付ける。サービスを停止して無効にし、正確に3つのファイルを削除し、空のディレクトリのみを削除します。バックアップは保持し、ソースサーバーの既存 lfstudent アカウントはそのままにします。
sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload
対象では、プロセスが終了し、ラボデータが削除された後にのみ、sudo userdel lf-migrate35 を使用して新しく作成された専用アカウントを削除してください。ソースおよびワークステーション上の2つの正確な転送ファイルに対して保持ポリシーを適用してください。本番移行の場合は、検証済みの最終バックアップおよび切替記録を、リカバリウィンドウが終了するまで保持してください。




