Rocky Linux 10 Kurs / Rootless Podman mit Quadlet und systemd automatisch starten

Um Podman-Container als Dienst unter Rocky Linux 10 zu betreiben, können Sie Ausführungsbedingungen in einer Quadlet-Datei deklarieren und systemd das Starten, Stoppen und Neustarten verwalten lassen. Für den automatischen Start regulärer Benutzercontainer beim Hochfahren müssen Sie das Ziel des Quadlets für den Start und die Linger-Einstellung prüfen, die den Benutzermanager auch ohne Anmeldung aufrechterhält.

Beziehung zwischen Quadlet- und Benutzerdiensten

Quadlet ist eine Podman-Funktion, die Containerbedingungen wie Images, Ports und Volumes in einer Datei beschreibt. Der von systemd aufgerufene Podman-Quadlet-Generator liest diese Datei und erzeugt daraus eine Service-Unit, die Sie anschließend mit systemctl verwalten. Über das Aufzeichnen langer podman run-Befehle hinaus kann es die Neustart-Richtlinie des Dienstes und das Startziel zusammen verwalten.

Das Quelllabor nutzte den regulären Benutzer lfstudent auf Rocky Linux 10.2 mit Podman 5.8.2, systemd 257, cgroups v2 Ressourcenverwaltung und SELinux im Enforcing-Modus. Verwenden Sie das offizielle Nginx-Image, das in der Rootless-Podman-Lektion überprüft wurde, sowie lokale Inhalte, die nur auf 127.0.0.1:18028 veröffentlicht werden. Dieser Quadlet läuft als Benutzerdienst; unterscheiden Sie seine Befehle von sudo systemctl-Befehlen, die Systemdienste verwalten.

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

Der rootlose Wert sollte true sein, und cgroups sollten v2 sein. Wenn es bereits vorhandene Dienste, Container oder Materialien mit demselben Namen gibt, überschreiben Sie diese nicht mit neuen Einstellungen, sondern überprüfen Sie sie zuerst. Die ursprüngliche Linger-Einstellung dieser VM war no, und für die Praxis wurde er nur für diesen Benutzer auf ja geändert und am Ende wiederhergestellt.

Bestätigen Sie die unterstützten Optionen gemäß der installierten Version. Podman 5.8 Serien Quadlet-Dokumentation erklärt den Benutzersuchpfad, die Erstellungsmethode und die Zuordnung jeder Einstellung. Gehen Sie nicht davon aus, dass neue Optionen in der neuesten Dokumentation in Paketen für frühere Distributionen unterstützt werden.

Nach Überprüfung der vom Benutzer verwalteten Dienste, setzen Sie Linger nur für den jeweiligen Benutzer. Dies ist keine Option für einen einzelnen Container, sondern betrifft die Lebensdauer des Benutzermanagers für dieses Konto. Konten, die zuvor auf Ja gesetzt wurden, werden am Ende der Praxis nicht willkürlich auf Nein geändert.

sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

Das Loginctl-Handbuch erklärt, dass Linger eine Funktion ist, die den Benutzermanager beim Booten startet und ihn auch nach dem Logout aktiv hält.

Dokumentenpfad und Vorbereitung der vollständigen Quadlet-Datei

Das Folgende wird in einer normalen Benutzershell ausgeführt. Das Datenverzeichnis lf-course28 wurde neu erstellt, wobei die in Lektion 27 aufgezeichneten Image-Referenzen wiederverwendet werden. Wenn Lektion 27 nicht durchgeführt wurde, müssen Sie das offizielle Image herunterladen und die Quelle sowie den Digest überprüfen, um zuerst dieselbe Referenzdatei vorzubereiten.

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"

Speichern Sie den folgenden vollständigen Inhalt in ~/.config/containers/systemd/lf-course28.container. Der Home-Pfad hier ist der tatsächliche Pfad des Übungsbenutzers. Wenn Sie mit einem anderen Konto ausführen, ändern Sie den Quellpfad des Volumes, um zu diesem Konto zu passen, und geben Sie die Image-Referenz mit dem Wert an, den Sie bestätigt haben.

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
Abschnitt · Einstellungen Rolle in diesem Dienst
[Container] Dies sind die Podman-Ausführungsanforderungen wie Image, Name, Port und Mount.
Pull=never Es verwendet ein lokal gespeichertes Image, das bereits überprüft wurde. Wenn es nicht im Cache ist, schlägt der Start fehl, daher bereiten Sie es im Voraus vor.
Volume=…:ro,Z Stellen Sie neue dedizierte Dokumente im Nur-Lese-Modus bereit und wenden Sie den für den Container geeigneten SELinux-Kontext an.
Restart=on-failure Starten Sie den Dienst neu, wenn er abnormal beendet wird. Dies unterscheidet sich von einem expliziten Stopp.
WantedBy=default.target Verknüpfen Sie den Dienst mit dem Standard-Startziel des Benutzermanagers.

Da dies keine Konfiguration ist, die automatisch temporäre Tags des Images verfolgt, beinhaltet das Aktualisieren das Überprüfen des neuen Digests, das Ändern der Datei und anschließend das erneute Überprüfen. Es werden nur neue dedizierte Pfade für Mounts verwendet, und das gesamte Home-Verzeichnis darf nicht gemountet oder neu beschriftet werden.

Dienst-Erstellung, Ausführung und tatsächliche HTTP-Überprüfung.

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

Der tatsächlich erstellte Dienst befand sich in /run/user/1000/systemd/generator/lf-course28.service, und sein Status war generated. Die erstellte Datei enthielt Container-Ausführungsbefehle und Stopp-/Aufräumbefehle. Bearbeiten Sie diese Datei nicht direkt; ändern Sie die ursprüngliche .container-Datei und erstellen Sie sie durch Ausführen von daemon-reload neu.

Dieser Dienst war aktiv/lief und gab LF28 Quadlet service works zurück. Der Standardtyp des erstellten Dienstes ist notify, und das Container-Überwachungsprogramm conmon signalisiert seinen Start, aber dies allein wird nicht als ausreichend angesehen, um festzustellen, dass die Webanwendung korrekt reagiert. Die tatsächliche HTTP-Antwort und der erwartete Inhalt werden separat überprüft. Ein Verbindungsabbruch wurde einmal direkt nach dem Start beobachtet, daher wurden nur begrenzte Wiederholungen verwendet.

Die Methode, systemctl --user enable lf-course28.service auf den erstellten Dienst wie eine normale Datei anzuwenden, wird nicht verwendet. Der Quadlet-Generator verarbeitet die [Install]-Einstellungen aus der Originaldatei. Bedingungen, unter denen der Benutzermanager selbst beim Booten startet, müssen separat überprüft werden.

Vergleichen Sie eine abnormale Beendigung mit einem expliziten Stop.

Die Tests zielen nur auf den in diesem Tutorial erstellten Container ab. Die Container-ID und die Anzahl der Neustarts werden vor dem Start aufgezeichnet, und ein abnormaler Abbruch wird mit dem SIGKILL-Signal reproduziert, das eine erzwungene Beendigung darstellt. Der gleiche Befehl wird nicht direkt auf Produktionsservices angewendet.

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/

Im Quelllabor änderte sich die Container-ID von 01951ad831a1… zu 610769498aeb… , der Servicezähler wurde NRestarts=1 , und eine separate HTTP-Anfrage gab den erwarteten Inhalt zurück. Unmittelbar nach dem Stoppen können Abfragen fehlschlagen, da auf einen Neustart oder den Austausch des Containers gewartet wird, daher sollten die Ergebnisse zusammen mit den Serviceprotokollen und dem Status nach der Stabilisierung verglichen werden. Diese Einstellung bewahrt nicht nur Prozesse innerhalb desselben Containers, sondern ermöglicht auch das Erstellen eines neuen Containers unter den generierten Ausführungsbedingungen.

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

Nach explizitem Stoppen war es inaktiv, und die Überprüfung der Container-Existenz lieferte den Exit-Code 1. Selbst nach 3 Sekunden wurde es nicht automatisch neu erstellt und reagierte erneut erst nach manuellem Start. Während des Dienstbetriebs erfolgt die Verwaltung basierend auf den Richtlinien und dem Status von systemd, anstatt redundant eine separate Neustart-Richtlinie für Podman anzuwenden. Dokument systemd.service erklärt das Verhalten der Neustartbedingungen und manuellen Stopps.

Überprüfen Sie die Persistenz nach dem Abmelden und dem Hochfahren vor der Anmeldung.

Starten Sie den Dienst, beenden Sie die SSH-Sitzung und verbinden Sie sich erneut, ohne einen weiteren Startbefehl auszuführen. Im Quelllabor funktionierte HTTP um 02:32:48 immer noch, wobei die Startzeit des Dienstes unverändert bei 02:30:56 lag. Der Vergleich der Startzeiten hilft, zwischen Persistenz und einem Dienst, der beim nächsten Login neu gestartet wird, zu unterscheiden.

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

Ein Neustart trennt die SSH-Verbindung. Führen Sie dies nur auf einer dedizierten Übungs-VM durch, auf der Konsolenzugang verfügbar ist, und überprüfen Sie nach dem erneuten Verbinden die neue Boot-ID und den Status, bevor Sie den Dienst manuell starten. Der folgende Befehl ist eine Abfrage, um zu vergleichen, ob der Dienst vor dem ersten Login gestartet wurde.

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

In der Quellüberprüfung hatte sich die Boot-ID geändert und der Dienst war aktiv/lief. Der Zeitstempel der Dienstaktivierung, gemessen in Mikrosekunden seit diesem Boot, betrug 319329250 Mikrosekunden, und der Beginn der ersten SSH-Sitzung war 361617018 Mikrosekunden. Der Vergleich innerhalb desselben Boots zeigt, dass der Dienst etwa 42 Sekunden vor der Anmeldung gestartet wurde. Die Dokument- und Quadlet-Datei-Hashes waren identisch, und der HTTP-Body wurde erhalten.

Der Neustart dieser VM dauerte insgesamt etwa 5 Minuten und 22 Sekunden, einschließlich ungefähr 4 Minuten und 57 Sekunden in der Kernel-Phase, und cbc-aes-aesni Selbstprüfung ergab rc=-110 Warnungen. Der erste SSH-Versuch während der Startverzögerung schlug fehl, und die Überprüfung wurde nach Bestätigung der Konsolenreaktionen und der Einsatzbereitschaft des Systems für die Verbindung durchgeführt. Der automatische Start von Quadlet wurde bestätigt, aber dieses Ergebnis sollte nicht als Umgebung interpretiert werden, die die Verschlüsselungsselbstprüfung normal bestanden hat. Mischen Sie nicht die Ursache der Startverzögerung mit den automatisch gestarteten Diensteinstellungen.

Unterscheidung zwischen Diensten, die nicht erstellt wurden, und Diensten, die nicht gestartet werden konnten

Bei Unit not found kann bereits die Unit-Erzeugung vor der Containerausführung fehlgeschlagen sein. Überprüfen Sie zunächst die Dateierweiterung .container , den Benutzersuchpfad, den Abschnittsnamen und die vom installierten Versionsstand unterstützten Schlüssel. Wenn eine Datei erstellt wurde, die Ausführung jedoch fehlschlägt, überprüfen Sie den Image-Cache, die Mount-Quelle, die Ports und die Anwendungsprotokolle.

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

Das Quelllabor hat eine falsche NotARealKey in einen separaten Testordner außerhalb des eigentlichen Suchpfads gelegt und nur einen Generator-Trockenlauf durchgeführt. Der Generator gab den Exit-Code 1 und unsupported key zurück und erstellte nicht den Ausführungsbefehl. Der auf normale Quellen beschränkte Trockenlauf hatte den Exit-Code 0, und der Dienst blieb während der Ausführung aktiv. Sie können die Syntax in einem separaten Pfad diagnostizieren, ohne absichtlich operative Dateien zu beschädigen.

Nach dem Ändern der ursprünglichen Einstellungen ist daemon-reload die Aufgabe des erneuten Einlesens der Servicedefinition. Um einen bereits laufenden Container mit den neuen Einstellungen neu zu erstellen, müssen Sie systemctl --user restart lf-course28.service ausführen, wobei die notwendige Ausfallzeit berücksichtigt und Status, tatsächliche Antwort und Daten erneut überprüft werden. Alle fehlerhaften Änderungen sollten auf das gespeicherte Original zurückgesetzt und in derselben Reihenfolge erneut überprüft werden.

Autostart entfernen und die Übung bereinigen

Beim Entfernen der Übungskonfiguration stoppen Sie zuerst den Benutzerdienst. Nachdem Sie den ursprünglichen Quadlet außerhalb des Suchpfads verschoben und daemon-reload ausgeführt haben, werden auch die generierten Dateien und die Verbindungen zu den Startzielen bereinigt. Wenn es sich um einen Dienst handelt, der weiterhin betrieben wird, führen Sie diesen Bereinigungsbefehl nicht aus.

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' 

Das Ergebnis der Quellenbereinigung war LoadState=not-found, der Exit-Code der Container-Existenzprüfung war 1, und auf Port 18028 war kein Listener mehr vorhanden. Dokumente wurden unverändert belassen, und der SELinux-Kontext des dedizierten Pfads, der beendet worden war, wurde auf den allgemeinen Home-Datei-Kontext zurückgesetzt. Nur leere Konfigurationsverzeichnisse, die vor der Ausführung nicht existierten, wurden entfernt, und die ursprünglichen Benutzereinstellungen wurden beibehalten.

Führen Sie den folgenden Befehl nur aus, wenn Linger vor der Übung no war und dieses Konto keine anderen dauerhaft laufenden Benutzerdienste benötigt. Eine ursprüngliche Einstellung yes bleibt erhalten. Prüfen Sie diese Bedingungen vor dem Deaktivieren.

sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

Nach der Bereinigung im Quelllabor wurde sie wieder auf nein gesetzt, und bestehende SSH-, Firewall-, Nginx-, Hosts-, fstab-, Benutzer-ID-Zuordnungen und SELinux-Lokaleinstellungen wurden beibehalten. Dienstdefinitionen und Materialien bleiben im dedizierten Verzeichniseintrag für Wiederherstellung und Überprüfung erhalten.