Tutorial Rocky Linux 10 / Memigrasikan layanan dari Rocky Linux 9 ke 10 dengan instalasi baru
Saat berpindah dari Rocky Linux 9 ke 10, Anda menyiapkan dengan menginstal server Rocky Linux 10 baru dan memigrasikan konfigurasi dan data yang diperlukan. Proyek Rocky Linux secara resmi tidak mendukung upgrade in-place antar versi utama yang berbeda. Dengan memvalidasi lingkungan baru sambil mempertahankan server yang ada, lebih mudah menemukan masalah sebelum melakukan pemindahan dan menentukan kondisi rollback.
Membedakan pembaruan minor dari migrasi Rocky 9 ke 10
Memperbarui ke versi minor terbaru dalam 9.x dan mengubah versi mayor dari 9 ke 10 adalah tugas yang berbeda. Dokumen resmi migrasi versi Rocky Linux memandu melalui alur instalasi baru, menyiapkan akun yang diperlukan, repositori, paket, dan mengembalikan cadangan. Sekadar mengubah angka dalam alamat repositori atau menggunakan dnf --releasever=10 tidak dianggap sebagai metode migrasi resmi yang standar.
Tujuan menyiapkan server baru bukanlah untuk mereplikasi seluruh sistem yang ada. Ini tentang menyesuaikan data dan pengaturan yang dibutuhkan oleh layanan di atas pengaturan default dan kebijakan keamanan dari sistem operasi baru. Pindah begitu saja kernel, pustaka, dan RPM dari server lama ke server baru dapat menyebabkan ketidakcocokan dependensi dan cakupan dukungan.
| Target Migrasi | Tugas di Server Baru | Kriteria Verifikasi |
|---|---|---|
| Akun Pengguna dan Layanan | Buat akun yang diperlukan dan tentukan UID dan GID yang sesuai. | Akun yang dimaksud harus dapat membaca dan menulis data yang dimigrasikan. |
| Paket dan Lingkungan Runtime | Instal versi yang diperlukan dari repositori Rocky 10. | Program dan modul ekstensi harus bekerja pada runtime baru. |
| Konfigurasi | Terapkan kembali perubahan yang diperlukan berdasarkan file default yang baru. | Pemeriksaan konfigurasi dan pemulaian layanan harus berhasil. |
| File·Data DB | Pulihkan cadangan yang konsisten ke jalur terpisah. | Periksa konten, izin, dan fungsi bisnis bersama-sama. |
| Akses target·Tugas terjadwal | Tentukan urutan konversi dan metode untuk mencegah eksekusi ganda. | Permintaan pengguna harus diarahkan ke server yang dimaksud, dan tugas hanya diproses sekali saja. |
Jika sebuah perangkat tunggal perlu diinstal ulang, Anda tidak dapat mempertahankan server yang ada pada waktu yang sama, sehingga lebih penting memiliki cadangan eksternal yang telah menyelesaikan uji pemulihan dan cara untuk kembali sebelum instalasi ulang. Jika memungkinkan, latih terlebih dahulu pada VM baru atau server terpisah, dan tentukan waktu henti serta kriteria kegagalan untuk konversi sebenarnya.
Amankan daftar konfigurasi yang diperlukan dari server yang ada
Pada server Rocky 9 yang ada, pertama-tama selidiki status instalasi dan ketergantungan layanan. Berikut ini adalah contoh pembuatan direktori investigasi baru dari shell administrator. Daftar akun dan konfigurasi jaringan mungkin mengandung informasi operasional, sehingga akses harus dibatasi dan tidak langsung disalin ke log atau postingan publik.
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
Daftar ini bukan skrip instalasi yang harus dijalankan di server baru secara langsung. Ini adalah referensi untuk memilih item yang diperlukan untuk layanan dan memeriksa nama, ketersediaan dukungan, dan paket alternatif di Rocky 10. Untuk layanan di Rocky 9 yang menggunakan aliran modul, sangat penting untuk menyelidiki versi eksekusi dan tidak berasumsi bahwa pilihan tersebut dapat langsung diterapkan pada perintah modul di Rocky 10.
Untuk layanan web dan DB, selain jalur data, periksa akun DB dan metode dump, file yang diunggah, API eksternal, email, penyimpanan, sertifikat, tugas terjadwal, dan tugas cadangan. Menjalankan tugas terjadwal yang sama pada server baru dan server lama secara bersamaan dapat mengakibatkan pengiriman email atau pemrosesan data yang duplikat. Kata sandi operasional dan kunci rahasia harus disampaikan melalui prosedur yang terlindungi secara terpisah dan tidak boleh disalin ke file untuk perbandingan konfigurasi tanpa alasan yang diperlukan.
Persiapan server baru dan ruang lingkup praktik
Instal Rocky Linux 10 di server baru, lakukan pembaruan, buat akun manajemen, periksa akses SSH, dan verifikasi pengaturan dasar firewall dan SELinux terlebih dahulu. Jika lingkungan adalah x86-64, juga periksa persyaratan CPU untuk Rocky 10. Jangan menganggap persyaratan versi baru terpenuhi hanya karena server yang ada menjalankan Rocky 9.
Saat mentransfer program yang sebenarnya, daripada menyalin lingkungan virtual Python atau direktori modul ekstensi yang telah dikompilasi begitu saja, buat ulang di server baru menggunakan runtime dan dependensi yang didukung di sana. Untuk format file DB dan kompatibilitas plugin, ikuti prosedur migrasi untuk setiap versi produk. Jangan mencampur pengaturan default dan file sistem dengan menimpa /etc, /usr, dan /var sepenuhnya di server baru.
Laboratorium sumber memindahkan layanan kecil yang hanya-baca dari ruang pengguna kontainer Rocky 9.8 ke Python di VM Rocky 10.2 . Python sumber adalah 3.9.25 dan Python tujuan adalah 3.12.15. Kedua lingkungan berbagi kernel host Rocky 10, sehingga pengujian tidak memigrasikan kernel Rocky 9, proses boot, atau systemd. Sebuah file alamat lokal mensimulasikan perpindahan target koneksi dan rollback tanpa mengubah database produksi atau DNS publik.
Jalankan latihan sebagai pengguna biasa lfstudent dan membutuhkan Podman, Python, tar, dan curl. UID dan GID akun lfstudent pada VM latihan ini masing-masing adalah 1000. Bangun image terpisah dari image resmi docker.io/library/rockylinux yang dijelaskan dalam panduan Rocky Linux Podman . Layanan produksi nyata harus mengelola siklus hidup kontainer dan efek logout secara terpisah; di sini, latihan dilakukan dalam sesi login yang sama dari awal hingga selesai.
Mempersiapkan Ruang Pengguna di Rocky 9
Jalankan perintah di shell VM latihan Rocky 10 yang khusus sebagai pengguna biasa, bukan di server yang ada. Gunakan jalur baru dan nama image lokal yang terpisah. Jika Anda memiliki materi latihan yang ada, hentikan dan periksa terlebih dahulu status yang disimpan.
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'
Jangan mengasumsikan versi sebenarnya hanya dengan melihat tag. Gambar berbasis :9 yang diterima dalam praktik diberi label 9.3, dan setelah pembaruan seri 9 penuh di dalam image sumber, lab mengonfirmasi versi 9.8 dan Python 3.9.25. Pembaruan ini dilakukan hanya di dalam image yang terisolasi. Catat digest dari image dasar di base.ref, dengan mencatat bahwa tag yang sama mungkin nanti merujuk ke image yang berbeda.
Di dalam sebuah container, uname -r menunjukkan kernel dari host Rocky 10. Konfirmasikan versi ruang pengguna sistem operasi menggunakan /etc/rocky-release atau /etc/os-release, dan bedakan dari versi kernel. Persiapan image atau pemetaan pengguna pertama mungkin memerlukan waktu, jadi jangan membuat container berulang kali dengan nama yang sama. Jika terhenti, pertama-tama periksa keadaan sebenarnya menggunakan podman ps -a dan podman inspect.
Membuat layanan asli hanya-baca dan cadangan migrasi
Berikut adalah program praktik lengkap yang menyediakan satu file konfigurasi JSON dan satu file data JSON yang berisi dua item. /health mewakili lingkungan eksekusi, dan /items mengembalikan data yang akan ditransfer. Fungsi-fungsi seperti POST tidak disediakan, dan direktori asli juga terhubung sebagai hanya-baca. Dalam layanan tulis yang sebenarnya, bagian ini harus diubah ke mode pemeliharaan dan prosedur cadangan konsisten akhir.
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 memungkinkan ID numerik pengguna biasa untuk dipertahankan bahkan di dalam kontainer. :ro,Z menghubungkan versi asli dalam mode read-only dan menerapkan label SELinux khusus. Perubahan label ini tidak diterapkan secara luas pada direktori data publik. Jika respons awal gagal, podman inspect "$source_id" dan podman logs "$source_id" diperiksa, dan verifikasi ID kontainer yang tercatat sebelum melanjutkan. Proses tidak berlanjut ke langkah berikutnya tanpa memeriksa versi asli yang berjalan.
Jika respons dan versi asli dikonfirmasi normal, backup jalur relatif dibuat di dalam kontainer dan disalin ke host. Backup hanya mencakup program kecil ini, pengaturan, dan data.
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
Checksum seharusnya adalah OK, dan daftar file seharusnya menunjukkan app.py, config.json, dan data/items.json. Backup tar standar dalam contoh ini menargetkan isi file dan izin dasar. Jika Anda ingin mempertahankan ACL dan atribut yang diperluas, Anda harus menambahkan pemeriksaan untuk opsi dan atribut tersebut seperti tutorial cadangan dan verifikasi pemulihan konfigurasi serta data pengguna. Secara khusus, label SELinux yang didedikasikan untuk kontainer tidak boleh digunakan begitu saja untuk kebijakan penyebaran server baru.
Memulihkan di Rocky 10 dan membandingkan hasil eksekusi
Setelah memeriksa lagi bahwa target yang disiapkan kosong, pulihkan hanya cadangan yang Anda buat sendiri. Karena pemulihan dilakukan dengan akun umum yang sama di host yang sama, pemetaan kepemilikan numerik dalam contoh ini sama. Jika itu adalah server nyata yang berbeda, Anda perlu terlebih dahulu menyelaraskan UID dan GID dari akun baru atau merencanakan konversi kepemilikan yang diperlukan.
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
Jika isi dan izin dari ketiga file sama dan cmp keluar dengan status 0 tanpa output, respons data dalam contoh ini cocok. Pada tujuan /health, ruang pengguna baru dan versi runtime muncul sebagai berikut.
{"os": "10.2", "python": "3.12.15"}
/items Respon harus menyertakan baik alpha maupun beta dan memiliki nilai site yang sama. Jika respon adalah 500, periksa target-service.log, jalur file, sintaksis JSON, dan izin akun eksekusi. Server kecil ini digunakan untuk latihan untuk memverifikasi fungsionalitas pada loopback dan tidak digunakan sebagai server web produksi eksternal.
Keberhasilan dalam contoh kecil tidak berarti bahwa semua dependensi dari layanan yang sebenarnya kompatibel. Di lingkungan produksi, login, operasi lihat/tulis, unggahan file, set karakter DB dan zona waktu, tugas terjadwal, integrasi eksternal, sertifikat, dan operasi cadangan harus diperiksa untuk setiap layanan. Jika memungkinkan, verifikasi bahwa hasil yang sama terjadi bahkan setelah melakukan reboot pada server baru, dan periksa pada alamat dan jalur di mana pengguna biasanya terkoneksi.
Uji pergantian target koneksi dan rollback dengan data yang sama
Dalam latihan ini, client.url adalah file acuan yang menyimpan alamat untuk mengirim permintaan. Tanpa mengubah DNS publik atau lalu lintas pengguna yang sebenarnya, Anda dapat mengamati urutan dari lingkungan yang ada → lingkungan baru → lingkungan yang ada → lingkungan baru.
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
Laboratorium sumber memverifikasi asal 9.8/3.9.25, tujuan 10.2/3.12.15, dan kemudian asal 9.8/3.9.25 lagi, dan respons untuk setiap data adalah sama. Karena yang asli diatur sebagai hanya-baca dan lingkungan baru tidak memiliki fungsi tulis, dalam contoh ini, perbandingan hanya dapat mengembalikan target koneksi tanpa perlu menggabungkan data lagi.
Dalam layanan penulisan yang sebenarnya, data yang masuk ke server baru setelah transisi sangat penting. Jika Anda hanya mengembalikan alamat tanpa mencerminkannya di server yang ada, Anda bisa kehilangan pesanan baru, unggahan, perubahan akun, dll. Sebelum migrasi, atur waktu penangguhan penulisan, titik sinkronisasi terakhir, kondisi di mana penulisan diperbolehkan di server baru, dan metode untuk mengambil data jika terjadi rollback. Juga, verifikasi apakah pemulihan balik memungkinkan antara versi DB yang berbeda.
Perubahan transisi operasional mengubah pengaturan DNS, proxy/load balancer, atau koneksi sesuai dengan metode yang dipilih. Karena caching DNS dan koneksi yang ada, tidak semua pengguna berpindah ke server baru secara bersamaan. Setelah transisi, amati tingkat kesalahan, log, dan pemeriksaan bisnis utama, dan jangan melanjutkan penulisan atau tugas terjadwal secara berulang di server yang ada.
Bersihkan lab dan tentukan kapan akan memensiunkan server lama.
Hanya hentikan dua proses yang dimulai dalam praktik. target_pid dan source_id di bawah ini adalah target yang dimulai langsung dalam sesi saat ini. Jika sesi telah terputus, periksa ID kontainer yang disimpan dan proses/port aktual untuk memastikan itu adalah target yang sama sebelum pembersihan, dan jangan hentikan proses Python lain secara sembarangan.
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 menempatkan proses awal kecil di dalam kontainer yang bertanggung jawab atas transmisi sinyal, antara lain. Dalam pemeriksaan terminasi terpisah yang diterapkan pada ini, exited 143 muncul tanpa peringatan terminasi paksa, dan dalam latihan ini, itu adalah status terminasi menurut SIGTERM. Ini juga memeriksa apakah kedua port ditutup dan apakah checksum cadangan adalah OK. Pemulihan konteks SELinux hanya berlaku untuk jalur asli dari latihan ini yang sudah selesai digunakan oleh kontainer, sambil mempertahankan konten dan izin default.
Server yang benar-benar ada akan dimatikan setelah server baru menyelesaikan verifikasi fungsi bisnis, akses operasional, pencadangan dan pemulihan, serta tugas terjadwal, dan setelah memenuhi periode pengamatan dan kondisi rollback yang telah ditetapkan. Sebelum dimatikan, lokasi dan metode pemulihan cadangan terakhir, perbedaan konfigurasi server baru, dan item yang belum diverifikasi diserahkan. Penilaian penyelesaian migrasi dilakukan berdasarkan perilaku layanan yang telah diverifikasi dan integritas data, bukan berdasarkan tanggal pemasangan server baru.




