Rocky Linux 10: guida / Gestire container come servizi Quadlet e verificarne l’avvio automatico
Per far funzionare i container Podman come servizio su Rocky Linux 10, è possibile dichiarare le condizioni di esecuzione in un file Quadlet e lasciare a systemd la gestione dell'avvio, dell'arresto e del riavvio. Per l'avvio automatico dei container di un utente normale all'accensione, è necessario controllare l'obiettivo di avvio del Quadlet e l'impostazione di linger che mantiene il gestore utente attivo anche senza effettuare il login.
Relazione tra Quadlet e servizi utente
Quadlet è una funzionalità di Podman che descrive le condizioni del contenitore, come immagini, porta e volumi, in un file. Il generatore di Podman, invocato da systemd, legge questo file per creare un normale file di servizio, dopodiché viene gestito da systemctl. Oltre a registrare comandi lunghi podman run, può gestire insieme la politica di riavvio del servizio e il target di avvio.
Il laboratorio di origine ha utilizzato l'utente normale lfstudent su Rocky Linux 10.2 con Podman 5.8.2, systemd 257, gestione delle risorse cgroups v2 e SELinux Enforcing. Riutilizzare l'immagine ufficiale di Nginx verificata nella lezione di Podman senza root e contenuti locali, pubblicando solo su 127.0.0.1:18028. Questo Quadlet funziona come servizio utente; distinguere i suoi comandi dai comandi sudo systemctl che gestiscono i servizi di sistema.
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
Il valore rootless dovrebbe essere true, e cgroups dovrebbe essere v2. Se esistono servizi, container o materiali con lo stesso nome, non sovrascriverli con le nuove impostazioni ma controllali prima. Il linger esistente di questa VM era no, e per l'esercizio è stato cambiato in sì solo per quell'utente, e ripristinato alla fine.
Conferma le opzioni supportate in base alla versione installata. Documentazione Podman serie 5.8 Quadlet spiega il percorso di ricerca dell'utente, il metodo di creazione, e la corrispondenza di ciascuna impostazione. Non presumere che le nuove opzioni nella documentazione più recente siano supportate nei pacchetti delle distribuzioni precedenti.
Dopo aver controllato i servizi utente gestiti da questo account, imposta il linger solo per l'utente rispettivo. Questa non è un'opzione per un singolo container ma influisce sulla durata del gestore utenti per quell'account. Gli account precedentemente impostati su sì non vengono arbitrariamente cambiati in no alla fine della pratica.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
Il manuale di loginctl spiega che il linger è una funzione che avvia il gestore utenti all'avvio e lo mantiene attivo anche dopo il logout.
Percorso del documento e preparazione del file Quadlet completo
Quanto segue viene eseguito in una shell utente normale. La directory dati lf-course28 è stata appena creata, riutilizzando i riferimenti alle immagini registrati nella Lezione 27. Se la Lezione 27 non è stata eseguita, è necessario scaricare l'immagine ufficiale e controllare la sorgente e il digest per preparare prima lo stesso file di riferimento.
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"
Salvare il seguente contenuto completo in ~/.config/containers/systemd/lf-course28.container. Il percorso home qui è il percorso effettivo dell'utente di pratica. Se si esegue con un altro account, modificare il percorso sorgente del Volume per corrispondere a quell'account e specificare il riferimento dell'immagine con il valore che si è confermato.
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
| Sezione · Impostazioni | Ruolo in questo servizio |
|---|---|
[Container] |
Questi sono i requisiti di esecuzione di Podman come immagine, nome, porta e mount. |
Pull=never |
Utilizza un'immagine salvata localmente che è già stata verificata. Se non è nella cache, l'avvio fallirà, quindi preparala in anticipo. |
Volume=…:ro,Z |
Fornisci nuovi documenti dedicati in modalità di sola lettura e applica il contesto SELinux adatto per il container. |
Restart=on-failure |
Riavvia il servizio quando termina in modo anomalo. Questo viene distinto da un arresto esplicito. |
WantedBy=default.target |
Collega il servizio al target di avvio predefinito del gestore utente. |
Poiché questa non è una configurazione che traccia automaticamente i tag mutabili dell’immagine, l'aggiornamento comporta la revisione del nuovo digest, la modifica del file e quindi la verifica di nuovo. Vengono utilizzati solo nuovi percorsi dedicati per i mount e non montare né etichettare l'intera directory home.
Creazione del servizio, esecuzione e verifica effettiva HTTP.
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
Il servizio effettivamente creato era in /run/user/1000/systemd/generator/lf-course28.service, e il suo stato era generated. Il file creato conteneva comandi per l'esecuzione del container e comandi di stop/pulizia. Non modificare direttamente questo file; modifica il file originale .container e ricrealo eseguendo il daemon-reload.
Questo servizio era attivo/in esecuzione e ha restituito LF28 Quadlet service works. Il tipo predefinito del servizio creato è notify, e il programma di monitoraggio del contenitore conmon segnala il suo avvio, ma questo da solo non è considerato sufficiente per determinare che l'applicazione web risponda correttamente. La risposta HTTP effettiva e il contenuto previsto vengono controllati separatamente. Un reset della connessione è stato osservato una volta subito dopo l'avvio, quindi sono stati usati tentativi limitati.
Il metodo di applicare systemctl --user enable lf-course28.service al servizio creato come un normale file non viene utilizzato. Il generatore Quadlet gestisce le impostazioni [Install] dal file originale. Le condizioni in cui il gestore degli utenti stesso si avvia all'avvio devono essere controllate separatamente.
Confrontare la terminazione anomala con un arresto esplicito.
Il test riguarda solo il container creato in questo tutorial. L'ID del container e il numero di riavvii vengono registrati prima dell'avvio, e la terminazione anomala viene riprodotta utilizzando il segnale SIGKILL, che è una terminazione forzata. Lo stesso comando non viene applicato direttamente ai servizi in produzione.
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/
Nel laboratorio di origine, l'ID del container è cambiato da 01951ad831a1… a 610769498aeb…, il contatore del servizio è diventato NRestarts=1, e una richiesta HTTP separata ha restituito il contenuto previsto. Subito dopo l'arresto, le query possono fallire a causa dell'attesa per il riavvio o la sostituzione del container, quindi confronta i risultati insieme ai log dei servizi e allo stato dopo la stabilizzazione. Il recupero può creare un nuovo container con le condizioni di esecuzione generate; non conserva i processi interni del container precedente.
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
Dopo l'arresto esplicito, era inattivo e il controllo dell'esistenza del container ha restituito il codice di uscita 1. Anche dopo 3 secondi, non è stato ricreato automaticamente e ha risposto nuovamente dopo l'avvio manuale. Durante il funzionamento del servizio, la gestione si basa sulle politiche e sullo stato di systemd piuttosto che sull'applicazione ridondante di una politica di riavvio separata per Podman. il documento systemd.service spiega il comportamento delle condizioni di Restart e degli arresti manuali.
Verificare la persistenza dopo il logout e l'avvio prima del login
Avvia il servizio, termina la sessione SSH e riconnettiti senza emettere un altro comando di avvio. Nel laboratorio di origine, HTTP funzionava ancora alle 02:32:48 con l'orario di avvio del servizio invariato alle 02:30:56. Confrontare gli orari di avvio aiuta a distinguere la persistenza da un servizio avviato di nuovo dal login successivo.
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
Il riavvio disconnetterà la connessione SSH. Eseguilo solo su una VM di pratica dedicata dove è disponibile l'accesso alla console e, dopo la riconnessione, controlla il nuovo ID di avvio e lo stato prima di avviare manualmente il servizio. Il comando seguente è una query per confrontare se il servizio è stato avviato prima del primo login.
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
Nella verifica della sorgente, l'ID di avvio era cambiato e il servizio era attivo/in esecuzione. Il timestamp di attivazione del servizio, misurato in microsecondi da quel boot, era di 319329250 microsecondi, e l'inizio della prima sessione SSH era a 361617018 microsecondi. Il confronto all'interno dello stesso avvio mostra che il servizio è stato avviato circa 42 secondi prima del login. Gli hash del documento e del file Quadlet erano gli stessi e il corpo HTTP è stato preservato.
Il riavvio di questa VM ha richiesto un totale di circa 5 minuti e 22 secondi, inclusi circa 4 minuti e 57 secondi nella fase del kernel, e cbc-aes-aesni il controllo automatico ha lasciato rc=-110 avvisi. Il primo tentativo SSH durante il ritardo di avvio è fallito, e la verifica è stata effettuata dopo aver confermato le risposte della console e che il sistema era pronto per la connessione. È stato confermato l'avvio automatico di Quadlet, ma questo risultato non deve essere interpretato come un ambiente che ha superato normalmente il controllo automatico della crittografia. Non confondere la causa del ritardo di avvio con le impostazioni di avvio automatico del servizio.
Distinzione tra servizi che non sono stati creati e servizi che non si avviano
Unit not found La creazione potrebbe essere fallita prima dell'esecuzione del contenitore. Per prima cosa, controlla l'estensione del file .container , il percorso di ricerca dell'utente, il nome della sezione e le chiavi supportate dalla versione installata. Se esiste un file creato ma l'esecuzione fallisce, controlla la cache delle immagini, la sorgente del mount, le porte e i log dell'applicazione.
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
Il laboratorio sorgente ha posto un NotARealKey errato in una cartella di test separata al di fuori del percorso di ricerca effettivo e ha effettuato solo una simulazione del generatore. Il generatore ha restituito il codice di uscita 1 e unsupported key e non ha creato il comando di esecuzione. La simulazione limitata alle sorgenti normali ha restituito codice di uscita 0, e il servizio è rimasto attivo durante l'esecuzione. Puoi diagnosticare la sintassi in un percorso separato senza corrompere volontariamente i file operativi.
Dopo aver modificato le impostazioni originali, daemon-reload è il compito di rileggere la definizione del servizio. Per ricreare un container già in esecuzione con le nuove impostazioni, è necessario eseguire systemctl --user restart lf-course28.service considerando i tempi di inattività necessari e ricontrollare lo stato, la risposta effettiva e i dati. Qualsiasi modifica errata deve essere ripristinata all'originale memorizzato e verificata nuovamente nello stesso ordine.
Disabilitare l'avvio automatico e pulire la pratica.
Quando si rimuove la configurazione della pratica, prima arrestare il servizio utente. Dopo aver spostato il Quadlet originale fuori dal percorso di ricerca ed eseguito daemon-reload, anche i file generati e le connessioni di destinazione all'avvio vengono puliti. Se si tratta di un servizio che continuerà a operare, non eseguire questo comando di pulizia.
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'
Il risultato della pulizia della sorgente è stato LoadState=not-found, codice di uscita del controllo dell'esistenza del contenitore 1, e nessun listener sulla porta 18028. I documenti sono rimasti intatti e il contesto SELinux del percorso dedicato che aveva terminato l'uso è stato riportato al contesto generale dei file della home. Sono state rimosse solo le directory di configurazione vuote che non esistevano prima dell'operazione, e le impostazioni originali dell'utente sono state mantenute.
Esegui il blocco seguente solo se Linger era inizialmente no e l’account non richiede altri servizi utente persistenti. Se era già yes, conserva quel valore.
sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
Dopo la pulizia nel laboratorio di origine, è stato ripristinato su no e le impostazioni locali esistenti di SSH, firewall, Nginx, hosts, fstab, mappatura ID utente e SELinux sono state preservate. Le definizioni dei servizi e i materiali rimangono nella directory dei record dedicata per il ripristino e la revisione.




