Rocky Linux 10 講座 / Rocky Linux 9から10へ新規インストールで移行し、切り戻しを確認する

Rocky Linux 9 から 10 に移行する際は、新しい Rocky Linux 10 サーバーをインストールし、必要な設定およびデータを移行することで準備します。Rocky Linux プロジェクトは、異なるメジャーバージョン間のインプレースアップグレードを公式にはサポートしていません。既存のサーバーを維持しながら新しい環境を検証することで、切り替え前に問題を見つけやすく、ロールバック条件を定義しやすくなります。

Rocky 9 から 10 への移行とマイナーアップデートを区別する

9.x 内で最新のマイナーバージョンに更新することと、メジャーバージョンを 9 から 10 に変更することは異なる作業です。 公式の Rocky Linux バージョン移行ドキュメント では、新規インストールの手順、必要なアカウント、リポジトリ、パッケージの準備、およびバックアップの復元方法の流れが案内されています。リポジトリアドレスの数字を単に変更したり、dnf --releasever=10 を使用するだけでは、標準的な公式移行方法とは見なされません。

新しいサーバーを準備する目的は、既存のシステムをそのまま複製することではありません。これは、新しいオペレーティングシステムのデフォルト設定とセキュリティポリシーの上で、サービスに必要なデータや設定を適応させることに関するものです。古いサーバーのカーネル、ライブラリ、RPMを新しいサーバーに単純に移動すると、依存関係やサポート範囲が一致しない可能性があります。

移行対象 新しいサーバーでの作業 確認基準
ユーザーおよびサービスアカウント 必要なアカウントを作成し、対応するUIDおよびGIDを定義します。 対象のアカウントは、移行されたデータを読み書きできる必要があります。
パッケージとランタイム環境 必要なバージョンをRocky 10リポジトリからインストールします。 プログラムおよび拡張モジュールは、新しいランタイムで動作する必要があります。
構成 新しいデフォルトファイルに基づいて必要な変更を再適用します。 構成チェックおよびサービスの起動は成功しなければなりません。
ファイル・DBデータ 一貫したバックアップを別のパスに復元します。 コンテンツ、権限、および業務機能を一緒に確認します。
アクセス対象・スケジュールされたタスク 変換の順序と重複実行を防ぐ方法を決定します。 ユーザーの要求は意図したサーバーに送信されるべきであり、タスクは一度だけ処理される必要があります。

単一のデバイスを再インストールする必要がある場合、既存のサーバーを同時に維持することはできないため、事前に復元テストを完了した外部バックアップと、再インストール前の状態へ戻す手段を確保することの方が重要です。可能であれば、まず新しいVMまたは別のサーバーで練習し、実際の変換におけるダウンタイムと失敗基準を決定してください。

既存サーバーの構成と依存関係を記録する

既存のRocky 9サーバー上で、まずインストール状況とサービス依存関係を調査してください。以下は、管理者シェルから新しい調査ディレクトリを作成する例です。アカウントリストやネットワーク構成には運用上の情報が含まれる可能性があるため、アクセスは制限し、公開ログや投稿に直接コピーしないでください。

sudo -i
set -euo pipefail
umask 077
test ! -e /root/migration-inventory
mkdir /root/migration-inventory
cd /root/migration-inventory
cat /etc/rocky-release > release.txt
getent passwd > users.txt
getent group > groups.txt
rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' | sort > packages.txt
dnf repolist --enabled > repositories.txt
dnf module list --enabled > modules.txt
systemctl list-unit-files --state=enabled > enabled-units.txt
ss -lntup > listening-ports.txt
ip -br address > addresses.txt
ip route > routes.txt
exit

このリストは、新しいサーバー上でそのまま実行するインストールスクリプトではありません。サービスに必要な項目を選定し、Rocky 10での名前、サポート可用性、代替パッケージを確認するための参考です。モジュールストリームを使用しているRocky 9上のサービスについては、実行バージョンを確認する必要が特にあり、その選択をRocky 10のモジュールコマンドに直接移行できると想定してはいけません。

ウェブおよびDBサービスについては、データパスに加えて、DBアカウントやダンプ方法、アップロードされたファイル、外部API、メール、ストレージ、証明書、スケジュールタスク、バックアップタスクを確認してください。新旧サーバーで同じスケジュールタスクを同時に実行すると、メールの二重送信やデータ処理の重複が発生する可能性があります。運用パスワードや秘密鍵は、別の保護された手順を通じて提供されるべきであり、設定比較のために不必要にファイルにコピーするべきではありません。

新サーバーの準備と作業範囲

新しいサーバーに Rocky Linux 10 をインストールし、アップデートを実行し、管理用アカウントを設定し、SSH アクセスを確認し、ファイアウォールおよび SELinux の基本設定を最初に確認してください。x86-64 環境の場合は、Rocky 10 の CPU 要件も確認してください。既存のサーバーが Rocky 9 を実行しているからといって、新しいバージョンの要件が満たされていると仮定しないでください。

実際のプログラムを移行する場合、Python の仮想環境やコンパイル済み拡張モジュールディレクトリをそのままコピーするのではなく、新しいサーバー上でサポートされているランタイムと依存関係を使用して再構築します。DB ファイル形式やプラグインの互換性については、各バージョンの製品の移行手順に従ってください。デフォルト設定やシステムファイルを混在させないように、/etc、/usr、および /var を新しいサーバー上で完全に上書きしないでください。

元の検証環境は、小さな読み取り専用サービスを Rocky 9.8コンテナのユーザースペースからRocky 10.2 VM上のPythonに移動しました。移行元のPythonは3.9.25で、移行先のPythonは3.12.15でした。両方の環境はRocky 10のホストカーネルを共有していたため、テストではRocky 9のカーネルやブートプロセス、systemdは移行されませんでした。ローカルアドレスファイルを使用して、運用データベースや公開DNSを変更することなく切替とロールバックをシミュレートしました。

通常ユーザーlfstudentとして演習を行ってください。Podman、Python、tar、および curl が必要です。この演習用VMで使用した通常ユーザーのUIDとGIDはいずれも1000でした。公式 docker.io/library/rockylinux イメージ( Rocky Linux Podman ガイド に記載)から別のイメージを構築してください。実際の本番サービスでは、コンテナのライフサイクルとログアウトの影響を別々に管理する必要がありますが、ここでは演習は開始から終了まで同じログインセッション内で行われます。

Rocky 9コンテナのユーザースペースを準備する

既存のサーバーではなく、専用の Rocky 10 演習 VM のシェルで通常のユーザーとしてコマンドを実行してください。新しいパスと別のローカルイメージ名を使用してください。既存の演習資料がある場合は中断し、まず保存された状態を確認してください。

set -euo pipefail
umask 077
test ! -e "$HOME/lf-course31"
mkdir -m 700 "$HOME/lf-course31"
cd "$HOME/lf-course31"
if podman image exists localhost/lf-course31-source9-updated:20261112; then
  printf 'The local lab image tag already exists. Stop and inspect it.\n' >&2
  exit 1
else
  image_status=$?
  test "$image_status" -eq 1
fi
podman pull docker.io/library/rockylinux:9
base=$(podman image inspect docker.io/library/rockylinux:9 \
  --format '{{index .RepoDigests 0}}')
printf '%s\n' "$base" > base.ref
printf 'FROM %s\nRUN dnf -y upgrade && dnf -y install python3 tar && dnf clean all\n' \
  "$base" > Containerfile
podman build --tag localhost/lf-course31-source9-updated:20261112 \
  --file Containerfile .
podman run --rm localhost/lf-course31-source9-updated:20261112 \
  /bin/bash -lc 'cat /etc/rocky-release; python3 --version; uname -r'

タグを見ただけで実際のバージョンを推測しないでください。実際に受け取った :9 ベースのイメージは 9.3 とラベルされていましたが、ソースイメージ内での完全な 9 シリーズのアップデート後、ラボは 9.8 と Python 3.9.25 を確認しました。このアップデートは隔離されたイメージ内でのみ実施されました。ベースイメージのダイジェストを base.ref に記録してください。同じタグが後で異なるイメージを指す場合があることに注意してください。

コンテナ内で、uname -r はホスト Rocky 10 のカーネルを示します。/etc/rocky-release または /etc/os-release を使用してオペレーティングシステムのユーザースペースのバージョンを確認し、カーネルバージョンと区別してください。イメージの準備や最初のユーザーマッピングには時間がかかる場合があるため、同じ名前でコンテナを繰り返し作成しないでください。中断された場合は、まず podman ps -a と podman inspect を使って実際の状態を確認してください。

読み取り専用の移行元サービスとバックアップを作成する

以下は、一つの設定ファイルと、二件の項目を含むJSONデータを扱う完全な練習用プログラムです。/health は実行環境を表し、/items は転送されるデータを返します。POSTなどの書き込み関数は提供されておらず、オリジナルのディレクトリも読み取り専用として接続されています。実際の書き込みサービスでは、この部分はメンテナンスモードに変更し、最終的な一貫性のあるバックアップ手順を行う必要があります。

SOURCE_LISTENERS=$(ss -H -lnt 'sport = :18031')
TARGET_LISTENERS=$(ss -H -lnt 'sport = :18032')
test -z "$SOURCE_LISTENERS"
test -z "$TARGET_LISTENERS"
mkdir -m 700 source target
mkdir -m 700 source/data
printf '{"site":"LF31 migration lab"}\n' > source/config.json
printf '[{"id":1,"name":"alpha"},{"id":2,"name":"beta"}]\n' > source/data/items.json
cat > source/app.py <<'PY'
import json, platform, sys
from pathlib import Path
from http.server import BaseHTTPRequestHandler, HTTPServer
root = Path(sys.argv[1])
class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        try:
            if self.path == '/health':
                release = dict(line.split('=', 1) for line in
                    Path('/etc/os-release').read_text().splitlines() if '=' in line)
                data = {'os': release['VERSION_ID'].strip('"'),
                        'python': platform.python_version()}
            elif self.path == '/items':
                config = json.loads((root/'config.json').read_text())
                data = {'site': config['site'],
                        'items': json.loads((root/'data/items.json').read_text())}
            else:
                self.send_error(404)
                return
            body = (json.dumps(data, sort_keys=True) + '\n').encode()
            self.send_response(200)
            content_type = 'application/json'
        except (OSError, ValueError, KeyError):
            body = b'Cannot read migration data\n'
            self.send_response(500)
            content_type = 'text/plain; charset=utf-8'
        self.send_header('Content-Type', content_type)
        self.end_headers()
        self.wfile.write(body)
HTTPServer((sys.argv[2], int(sys.argv[3])), Handler).serve_forever()
PY
chmod 640 source/app.py source/config.json source/data/items.json
uid=$(id -u)
gid=$(id -g)
source_id=$(podman run -d --init --name lf-course31-source --label lf.course=31 \
  --userns=keep-id --user "$uid:$gid" \
  -p 127.0.0.1:18031:8080 -v "$PWD/source:/work:ro,Z" \
  localhost/lf-course31-source9-updated:20261112 \
  python3 /work/app.py /work 0.0.0.0 8080)
printf '%s\n' "$source_id" > source-container.id
sleep 2
podman exec "$source_id" id
curl --fail --silent --max-time 10 http://127.0.0.1:18031/health
curl --fail --silent --max-time 10 http://127.0.0.1:18031/items > source-response.json

--userns=keep-id は、通常ユーザーの数値IDをコンテナ内でも維持できるようにします。:ro,Z は元のデータに読み取り専用モードで接続し、専用のSELinuxラベルを適用します。このラベル変更を、既存の公開データディレクトリ全体に広く適用しないでください。初期応答が失敗した場合、podman inspect "$source_id" と podman logs "$source_id" がチェックされ、再開する前に記録されたコンテナIDが確認されます。このプロセスは、実行中の元のデータを確認せずに次のステップに進みません。

応答と元のデータが正常であることが確認された場合、コンテナ内に相対パスのバックアップが作成され、ホストにコピーされます。このバックアップには、この小さなプログラム、設定、データのみが含まれます。

podman exec "$source_id" tar --numeric-owner -cpf /tmp/lf31-migration.tar -C /work .
podman cp "$source_id":/tmp/lf31-migration.tar backup.tar
sha256sum backup.tar > backup.tar.sha256
sha256sum -c backup.tar.sha256
tar --numeric-owner -tvf backup.tar

チェックサムは OK であるべきであり、ファイルリストには app.py、config.json、data/items.json が表示されるべきです。この例の基本的なtarバックアップは、ファイルの内容と基本的な権限を対象としています。ACL や拡張属性を保持したい場合は、それらのオプションや属性に対するチェックを追加する必要があります。設定・ユーザーデータのバックアップと復元検証の講座で説明したように、特にコンテナ専用の SELinux ラベルは、新しいサーバーのデプロイポリシーとしてそのまま使用すべきではありません。

Rocky 10 での復元と実行結果の比較

準備した target が空であることを再確認した後、自分で作成したバックアップだけを復元してください。同じホストの同じ一般アカウントで復元を行うため、この例の数値による所有権マッピングは同じです。もし別の実際のサーバである場合は、新しいアカウントの UID と GID をまず揃えるか、必要な所有権変換を計画する必要があります。

TARGET_ENTRIES=$(find target -mindepth 1 -print -quit)
test -z "$TARGET_ENTRIES"
sha256sum -c backup.tar.sha256
tar -xpf backup.tar -C target
python3 - <<'PY'
from pathlib import Path
import hashlib, stat
source, target = Path('source'), Path('target')
for p in sorted(source.rglob('*')):
    if not p.is_file():
        continue
    q = target/p.relative_to(source)
    if p.read_bytes() != q.read_bytes():
        raise SystemExit('FAIL: content differs')
    if (p.stat().st_uid != q.stat().st_uid or
        p.stat().st_gid != q.stat().st_gid or
        stat.S_IMODE(p.stat().st_mode) != stat.S_IMODE(q.stat().st_mode)):
        raise SystemExit('FAIL: owner or mode differs')
    print(p.relative_to(source), hashlib.sha256(q.read_bytes()).hexdigest())
print('PASS: file content, numeric ownership and modes match')
PY
python3 target/app.py "$PWD/target" 127.0.0.1 18032 > target-service.log 2>&1 &
target_pid=$!
sleep 1
curl --fail --silent --max-time 10 http://127.0.0.1:18032/health
curl --fail --silent --max-time 10 http://127.0.0.1:18032/items > target-response.json
cmp source-response.json target-response.json

3つのファイルの内容と権限が同じで、cmp が出力なしでステータス 0 で終了する場合、この例でのデータ応答は一致します。宛先の /health では、新しいユーザースペースとランタイムバージョンが次のように表示されました。

{"os": "10.2", "python": "3.12.15"}

/items レスポンスには alpha と beta の両方を含め、同じ site の値を持つ必要があります。レスポンスが 500 の場合は、target-service.log、ファイルパス、JSON 構文、および実行アカウントの権限を確認してください。この小さなサーバーはループバック上で機能を確認するための練習用であり、外部の本番ウェブサーバーとして使用されることはありません。

小さな例での成功は、実際のサービスのすべての依存関係が互換性があることを意味するわけではありません。本番環境では、各サービスごとにログイン、閲覧/書き込み操作、ファイルアップロード、DBの文字セットとタイムゾーン、スケジュールタスク、外部連携、証明書、およびバックアップ操作を確認する必要があります。可能であれば、新しいサーバーを再起動した後でも同じ結果が得られることを確認し、ユーザーが通常接続するアドレスやパスでもチェックしてください。

接続先の切り替えと同じデータでのロールバックをテストする

この演習では、client.urlはリクエストを送信するアドレスを保存する標準ファイルです。パブリックDNSや実際のユーザートラフィックを変更せずに、既存の環境→新しい環境→既存の環境→新しい環境というシーケンスを観察することができます。

printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json

元の検証環境は、移行元9.8/3.9.25、移行先10.2/3.12.15、再び移行元9.8/3.9.25を確認し、各データの応答は同じであることを検証しました。元の環境は読み取り専用として固定されており、新しい環境には書き込み機能がなかったため、この例ではデータを再度マージする必要がなく、比較によって接続先のみを戻すことができました。

実際の書き込みサービスでは、移行後に新しいサーバーに入るデータが重要です。既存のサーバーにこれを反映せずにアドレスだけを戻すと、新しい注文、アップロード、アカウントの変更などを失う可能性があります。移行前に、書き込み停止時間、最終同期ポイント、新しいサーバーで書き込みが許可される条件、ロールバック時のデータ取得方法を設定してください。また、異なるDBバージョン間で逆方向の復元が可能かどうかも確認してください。

運用移行は、選択された方法に従って DNS、プロキシ/ロードバランサー、または接続設定を変更します。DNS キャッシュや既存の接続のため、すべてのユーザーが同時に新しいサーバーへ移行するわけではありません。移行後は、エラー率、ログ、主要な業務チェックを観察し、既存サーバーでの書き込みやスケジュールされたタスクを重複して再開しないでください。

演習を片付けて旧サーバーを停止する条件を確認する

演習で起動した 2 つのプロセスのみを終了してください。以下の target_pid と source_id は、現在のセッションで直接起動された対象です。セッションが切断されている場合、保存されたコンテナ ID と実際のプロセス/ポートを確認して同じ対象であることを確認してからクリーンアップし、他の任意の Python プロセスを終了しないでください。

kill "$target_pid"
wait "$target_pid" || test "$?" = 143
podman stop "$source_id"
podman inspect "$source_id" --format '{{.State.Status}} {{.State.ExitCode}}'
podman rm "$source_id"
ss -lnt 'sport = :18031'
ss -lnt 'sport = :18032'
sudo restorecon -RF "$HOME/lf-course31/source"
sha256sum -c backup.tar.sha256

--init は、信号伝達などを担当する小さな初期プロセスをコンテナに配置します。これに対して別途終了チェックを実施すると、exited 143 は強制終了の警告なしで表示され、この演習では SIGTERM による終了状態でした。また、両方のポートが閉じているかどうか、およびバックアップのチェックサムが OK であるかどうかも確認します。SELinux のコンテキスト復元は、コンテナが使用を終了したこの演習の元のパスにのみ適用され、内容やデフォルトの権限は保持されます。

実際に存在するサーバーは、新しいサーバーが業務機能、運用アクセス、バックアップと復元、スケジュールタスクの検証を完了し、確立された観察期間とロールバック条件を満たした後にシャットダウンされます。シャットダウン前には、最後のバックアップの場所と復元方法、新しいサーバーの構成の違い、まだ検証されていない項目が引き継がれます。移行完了は、新しいサーバーの設置日ではなく、検証済みのサービス動作とデータの完全性によって判断します。