Tutorial Rocky Linux 10 / Mengelola kontainer Podman sebagai layanan Quadlet
Untuk mengoperasikan kontainer Podman sebagai layanan di Rocky Linux 10, Anda dapat menyatakan kondisi jalankan dalam file Quadlet dan membiarkan systemd mengatur mulai, berhenti, dan memulai ulang. Untuk startup otomatis kontainer pengguna biasa saat booting, Anda perlu memeriksa target Quadlet untuk memulai dan pengaturan linger yang mempertahankan manajer pengguna meskipun tanpa login.
Hubungan antara Quadlet dan layanan pengguna
Quadlet adalah fitur Podman yang mengimagekan kondisi kontainer seperti image, port, dan volume dalam sebuah berkas. Generator milik Podman, yang dipanggil oleh systemd, membaca berkas ini untuk membuat berkas layanan biasa, dan kemudian dikelola oleh systemctl. Selain mencatat perintah panjang podman run, Quadlet dapat mengelola kebijakan restart layanan dan target awal secara bersamaan.
Laboratorium sumber menggunakan pengguna biasa lfstudent pada Rocky Linux 10.2 dengan Podman 5.8.2, systemd 257, pengelolaan sumber daya cgroups v2 dan SELinux Enforcing. Gunakan kembali image Nginx resmi yang sudah diverifikasi dalam pelajaran Podman tanpa root dan konten lokal, diterbitkan hanya pada 127.0.0.1:18028. Quadlet ini dijalankan sebagai layanan pengguna; bedakan perintahnya dari perintah sudo systemctl yang mengelola layanan sistem.
podman version
podman info --format '{{.Host.Security.Rootless}}'
podman info --format '{{.Host.CgroupsVersion}}'
systemctl --user list-unit-files
podman ps -a
ss -lnt 'sport = :18028'
loginctl show-user "$(id -un)" -p Linger
Nilai rootless seharusnya true, dan cgroups seharusnya v2. Jika ada layanan, kontainer, atau materi yang sudah ada dengan nama yang sama, jangan menimpanya dengan pengaturan baru tetapi periksa terlebih dahulu. Linger yang ada pada VM ini adalah tidak, dan untuk latihan, diubah menjadi ya hanya untuk pengguna tersebut, dan dikembalikan pada akhirnya.
Konfirmasikan opsi yang didukung sesuai dengan versi yang terpasang. Dokumentasi Quadlet Podman seri 5.8 menjelaskan jalur pencarian pengguna, metode pembuatan, dan korespondensi masing-masing pengaturan. Jangan menganggap bahwa opsi baru dalam dokumentasi terbaru didukung dalam paket untuk distribusi sebelumnya.
Setelah memeriksa layanan pengguna yang dikelola oleh akun ini, atur linger hanya untuk pengguna yang bersangkutan. Ini bukan opsi untuk satu kontainer saja tetapi memengaruhi masa aktif pengelola pengguna untuk akun tersebut. Akun yang sebelumnya diatur ke ya tidak diubah sembarangan menjadi tidak di akhir praktik.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
Manual loginctl menjelaskan bahwa linger adalah fitur yang memulai pengelola pengguna saat boot dan menjaga tetap aktif bahkan setelah logout.
Jalur dokumen dan persiapan file Quadlet lengkap
Berikut ini dijalankan di shell pengguna biasa. Direktori data lf-course28 baru dibuat, menggunakan kembali referensi image yang tercatat di Pelajaran 27. Jika Pelajaran 27 belum dilakukan, Anda perlu mengunduh image resmi dan memeriksa sumber serta digest untuk menyiapkan file referensi yang sama terlebih dahulu.
LAB28="$HOME/lf-course28"
test ! -e "$LAB28" || { printf 'Inspect the existing lab directory and stop.\n' >&2; exit 1; }
mkdir -m 0755 "$LAB28"
mkdir -m 0755 "$LAB28/site"
printf 'LF28 Quadlet service works\n' > "$LAB28/site/index.html"
chmod 0644 "$LAB28/site/index.html"
mkdir -p "$HOME/.config/containers/systemd"
cat "$HOME/lf-course27/image.ref"
Simpan seluruh isi berikut di ~/.config/containers/systemd/lf-course28.container. Jalur home di sini adalah jalur pengguna praktik yang sebenarnya. Jika menjalankan dengan akun lain, ubah jalur sumber Volume agar sesuai dengan akun tersebut dan tentukan referensi image dengan nilai yang telah Anda konfirmasi.
test ! -e "$HOME/.config/containers/systemd/lf-course28.container" || { printf 'Inspect the existing Quadlet file and stop.\n' >&2; exit 1; }
cat > "$HOME/.config/containers/systemd/lf-course28.container" <<'EOF'
[Unit]
Description=Course28 rootless web service
[Container]
Image=docker.io/library/nginx@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311
ContainerName=lf-course28-web
Label=lf.course=28
PublishPort=127.0.0.1:18028:80
Volume=/home/lfstudent/lf-course28/site:/usr/share/nginx/html:ro,Z
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=90
[Install]
WantedBy=default.target
EOF
| Bagian · Pengaturan | Peran dalam layanan ini |
|---|---|
[Container] |
Ini adalah persyaratan eksekusi Podman seperti image, nama, port, dan mount. |
Pull=never |
Ini menggunakan image yang disimpan secara lokal yang sudah diperiksa. Jika tidak ada dalam cache, start akan gagal, jadi siapkan terlebih dahulu. |
Volume=…:ro,Z |
Sediakan dokumen baru yang didedikasikan dalam mode baca-saja dan terapkan konteks SELinux yang sesuai untuk container. |
Restart=on-failure |
Restart layanan ketika berhenti secara abnormal. Ini dibedakan dari berhenti secara eksplisit. |
WantedBy=default.target |
Hubungkan layanan ke target startup default dari user manager. |
Karena ini bukan konfigurasi yang secara otomatis melacak tag sementara dari image, pembaruan melibatkan meninjau digest baru, mengubah file, dan kemudian memverifikasinya lagi. Hanya jalur khusus baru yang digunakan untuk mount, dan jangan mount atau relabel seluruh direktori home.
Pembuatan layanan, eksekusi, dan verifikasi HTTP yang sebenarnya.
systemctl --user daemon-reload
systemctl --user cat lf-course28.service
systemctl --user start lf-course28.service
systemctl --user show lf-course28.service -p ActiveState -p SubState -p FragmentPath -p UnitFileState -p NRestarts
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
journalctl --user -u lf-course28.service -b -n 30 --no-pager
Layanan yang benar-benar dibuat berada di /run/user/1000/systemd/generator/lf-course28.service, dan statusnya adalah generated. File yang dibuat berisi perintah eksekusi kontainer dan perintah stop/pembersihan. Jangan mengedit file ini secara langsung; ubah file .container asli dan buat kembali dengan menjalankan daemon-reload.
Layanan ini aktif / berjalan dan mengembalikan LF28 Quadlet service works. Tipe default dari layanan yang dibuat adalah notify, dan program pemantau container conmon memberi sinyal saat mulai, tetapi ini saja tidak dianggap cukup untuk menentukan bahwa aplikasi web merespons dengan benar. Respons HTTP sebenarnya dan konten yang diharapkan diperiksa secara terpisah. Terjadi reset koneksi sekali tepat setelah startup, jadi percobaan ulang terbatas digunakan.
Metode penerapan systemctl --user enable lf-course28.service pada layanan yang dibuat seperti file normal tidak digunakan. Generator Quadlet menangani pengaturan [Install] dari file asli. Kondisi di mana manajer pengguna itu sendiri mulai saat boot perlu diperiksa secara terpisah.
Bandingkan penghentian abnormal dengan berhenti secara eksplisit.
Pengujian hanya menargetkan container yang dibuat dalam tutorial ini. ID container dan jumlah restart dicatat sebelum startup, dan penghentian abnormal direproduksi menggunakan sinyal SIGKILL, yang merupakan penghentian paksa. Perintah yang sama tidak diterapkan langsung pada layanan produksi.
podman inspect lf-course28-web --format '{{.Id}}'
systemctl --user show lf-course28.service -p NRestarts
podman kill --signal KILL lf-course28-web
systemctl --user show lf-course28.service -p ActiveState -p SubState -p NRestarts
podman inspect lf-course28-web --format '{{.Id}}'
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
Di lab sumber, ID container berubah dari 01951ad831a1… menjadi 610769498aeb… , penghitung layanan menjadi NRestarts=1 , dan permintaan HTTP terpisah mengembalikan konten yang diharapkan. Segera setelah dihentikan, kueri mungkin gagal karena menunggu restart atau penggantian container, jadi bandingkan hasil bersama dengan log layanan dan status setelah stabilisasi. Pengaturan ini tidak hanya mempertahankan proses dalam container yang sama tetapi juga memungkinkan pembuatan container baru di bawah kondisi eksekusi yang dihasilkan.
systemctl --user stop lf-course28.service
systemctl --user is-active lf-course28.service
podman container exists lf-course28-web
systemctl --user start lf-course28.service
Setelah dihentikan secara eksplisit, itu menjadi tidak aktif, dan pemeriksaan keberadaan container mengembalikan kode keluar 1. Bahkan setelah 3 detik, itu tidak dibuat ulang secara otomatis, dan merespons kembali setelah dimulai secara manual. Selama operasi layanan, manajemen didasarkan pada kebijakan dan status systemd daripada secara berlebihan menerapkan kebijakan restart terpisah untuk Podman. dokumen systemd.service menjelaskan perilaku kondisi Restart dan penghentian manual.
Verifikasi keberlanjutan setelah logout dan startup sebelum login
Mulai layanan, akhiri sesi SSH dan sambungkan kembali tanpa menjalankan perintah start lainnya. Di laboratorium sumber, HTTP masih berfungsi pada 02:32:48 dengan waktu mulai layanan tetap pada 02:30:56. Membandingkan waktu mulai membantu membedakan antara layanan yang tetap berjalan dan layanan yang baru dimulai oleh login berikutnya.
systemctl --user show lf-course28.service -p ActiveState -p ActiveEnterTimestamp -p ActiveEnterTimestampMonotonic
loginctl show-user "$(id -un)" -p Linger
curl -fsS http://127.0.0.1:18028/
cat /proc/sys/kernel/random/boot_id
sha256sum "$HOME/lf-course28/site/index.html"
sudo systemctl reboot
Melakukan reboot akan memutus koneksi SSH. Lakukan ini hanya pada VM latihan khusus yang memiliki akses ke konsol, dan setelah tersambung kembali, periksa ID boot baru dan status sebelum memulai layanan secara manual. Perintah berikut adalah kueri untuk membandingkan apakah layanan dimulai sebelum login pertama.
cat /proc/sys/kernel/random/boot_id
systemctl --user show lf-course28.service -p ActiveState -p SubState -p ActiveEnterTimestampMonotonic -p UnitFileState
loginctl show-session "$XDG_SESSION_ID" -p TimestampMonotonic
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
sha256sum "$HOME/lf-course28/site/index.html"
journalctl --user -u lf-course28.service -b -n 30 --no-pager
Dalam verifikasi sumber, ID boot telah berubah dan layanan aktif/melakukan eksekusi. Cap waktu aktivasi layanan, diukur dalam mikrodetik sejak boot tersebut, adalah 319329250 mikrodetik, dan awal sesi SSH pertama adalah 361617018 mikrodetik. Perbandingan dalam boot yang sama menunjukkan bahwa layanan dimulai sekitar 42 detik sebelum login. Hash dokumen dan file Quadlet sama, dan isi HTTP tetap terjaga.
Reboot VM ini memakan waktu total sekitar 5 menit 22 detik, termasuk sekitar 4 menit 57 detik pada fase kernel, dan cbc-aes-aesni pemeriksaan mandiri meninggalkan rc=-110 peringatan. Upaya SSH pertama selama penundaan boot gagal, dan verifikasi dilakukan setelah memastikan respons konsol dan bahwa sistem siap untuk koneksi. Auto-start Quadlet dikonfirmasi, tetapi hasil ini tidak boleh diartikan sebagai lingkungan yang lulus pemeriksaan mandiri enkripsi secara normal. Jangan mencampuradukkan penyebab penundaan boot dengan pengaturan auto-start layanan.
Perbedaan antara layanan yang tidak dibuat dan layanan yang gagal untuk memulai
Unit not found Pembuatan mungkin gagal sebelum eksekusi kontainer. Pertama, periksa ekstensi file .container , jalur pencarian pengguna, nama bagian, dan kunci yang didukung oleh versi yang terinstal. Jika ada file yang dibuat tetapi eksekusi gagal, periksa cache image, sumber mount, port, dan log aplikasi.
QUADLET_UNIT_DIRS="$HOME/.config/containers/systemd" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user cat lf-course28.service
systemctl --user status lf-course28.service --no-pager
journalctl --user -u lf-course28.service -b -n 40 --no-pager
podman ps -a
Lab sumber menempatkan NotARealKey yang salah di folder uji terpisah di luar jalur pencarian sebenarnya dan hanya melakukan dry-run generator. Generator mengembalikan kode keluar 1 dan unsupported key dan tidak membuat perintah eksekusi. Dry-run yang dibatasi pada sumber normal memiliki kode keluar 0, dan layanan tetap aktif selama eksekusi. Anda dapat mendiagnosis sintaks di jalur terpisah tanpa dengan sengaja merusak file operasional.
Setelah mengubah pengaturan asli, daemon-reload adalah tugas untuk membaca ulang definisi layanan. Untuk membuat ulang container yang sudah berjalan dengan pengaturan baru, Anda perlu melakukan systemctl --user restart lf-course28.service dengan mempertimbangkan waktu henti yang diperlukan dan memeriksa kembali status, respons aktual, dan data. Setiap modifikasi yang salah harus dikembalikan ke versi asli yang disimpan dan diverifikasi ulang dalam urutan yang sama.
Menonaktifkan auto-start dan membersihkan praktik.
Saat menghapus pengaturan praktik, pertama hentikan layanan pengguna. Setelah memindahkan Quadlet asli ke luar jalur pencarian dan melakukan daemon-reload, file yang dihasilkan dan koneksi target startup juga dibersihkan. Jika itu adalah layanan yang akan terus beroperasi, jangan jalankan perintah pembersihan ini.
systemctl --user stop lf-course28.service
mv "$HOME/.config/containers/systemd/lf-course28.container" "$HOME/lf-course28/lf-course28.container.saved"
systemctl --user daemon-reload
systemctl --user show lf-course28.service -p LoadState
podman container exists lf-course28-web
restorecon -RFv "$HOME/lf-course28/site"
ss -lnt 'sport = :18028'
Hasil pembersihan sumber adalah LoadState=not-found, kode keluar pemeriksaan keberadaan kontainer 1, dan tidak ada lagi listener di port 18028. Dokumen dibiarkan utuh, dan konteks SELinux dari jalur khusus yang telah selesai digunakan dikembalikan ke konteks file home umum. Hanya direktori konfigurasi kosong yang tidak ada sebelumnya yang dihapus, dan pengaturan pengguna asli dipertahankan.
Jalankan blok berikut hanya jika nilai awal Linger adalah no dan akun latihan ini tidak memerlukan layanan pengguna lain yang harus tetap berjalan. Jika nilai awalnya yes, pertahankan pengaturan tersebut.
sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
Setelah pembersihan di laboratorium sumber, itu dikembalikan ke tidak, dan pengaturan lokal SSH, firewall, Nginx, hosts, fstab, pemetaan ID pengguna, dan SELinux yang ada dipertahankan. Definisi layanan dan materi tetap berada di direktori catatan khusus untuk pemulihan dan peninjauan.




