Warum verwendet ein Compose-Dienst erst nach einem Neustart des Hosts die falsche Env-Datei?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Ein Compose-Dienst kann nach einem Neustart andere Umgebungswerte verwenden, wenn der Launcher beim Systemstart ein anderes Projektverzeichnis, eine andere env-Datei oder eine andere Quelle mit Vorrang auflöst.

Ein manueller Befehl kann im vorgesehenen Ordner mit einer bestimmten Shell-Umgebung ausgeführt werden, während systemd, ein NAS-Scheduler oder Portainer dieselbe Compose-Datei nach dem Neustart aus einem anderen Kontext startet. Der Dienst kann außerdem einen vorhandenen Container neu starten, dessen Umgebung bei der Erstellung festgelegt wurde, anstatt die bearbeitete Datei erneut einzulesen. Vor dem gleichzeitigen Bearbeiten mehrerer Dateien das gerenderte Compose-Modell und die Prozessumgebung des manuellen Starts mit denen des Boot-Starts vergleichen.

Laufende Umgebung mit der vorgesehenen Datei vergleichen

Container-ID, Erstellungszeitpunkt, Image, Compose-Labels, Projektnamen und die tatsächlichen Werte im Hauptprozess erfassen. Diese mit der vorgesehenen env-Datei vergleichen, ohne Geheimnisse in gemeinsam genutzte Logs zu schreiben.

Die Prozessumgebung unter Linux zeigt die bei der Ausführung bereitgestellten Werte und ist damit aussagekräftiger als das Lesen einer env-Datei, die der aktuelle Container möglicherweise nie verwendet hat.

Wenn der Container die alten Werte enthält und bereits vor der Bereitstellung beim Neustart existierte, hat der Dienst ihn möglicherweise nur neu gestartet. Wenn der Container neu ist, mit der Prüfung der Priorität und Pfadauflösung fortfahren.

Die Priorität von Compose-Umgebungsvariablen in der richtigen Reihenfolge anwenden

Alle Quellen für eine unkritische Variable auflisten: CLI-Flags, Shell-Werte, environment:, env_file:, Standard- oder explizite .env-Datei und Image-ENV.

Docker definiert eine formale Prioritätsreihenfolge für Umgebungsvariablen, daher kann eine korrekte env-Datei trotzdem von einem höher priorisierten Wert überschrieben werden, den der Boot-Dienst oder Stack-Manager bereitstellt.

Nicht nur nach doppelten Dateinamen suchen. Den Variablennamen im gerenderten Compose-Modell, in der Unit-Datei, den Manager-Einstellungen, der Shell-Umgebung und den Image-Standardeinstellungen suchen.

Projektverzeichnis und relative Umgebungsvariablenpfade prüfen

Vergleichen Sie das Arbeitsverzeichnis des manuell ausgeführten Befehls mit dem des Startprogramms beim Systemstart sowie die Compose-Dateiargumente, das Projektverzeichnis und relative env_file-Verweise.

Die Compose Specification definiert das Anwendungsmodell zur Auflösung von Diensten und Konfiguration. Daher sind die ausgewählte Projektdefinition und ihre Pfade Eingaben für die Bereitstellung und keine Eigenschaften, die anhand des laufenden Containers erneut ermittelt werden.

Verwenden Sie für beim Systemstart benötigte Env-Dateien absolute Pfade, sofern das Bereitstellungstool dies unterstützt, oder legen Sie ein explizites Projekt- und Arbeitsverzeichnis fest, damit manuelle und automatisierte Starts dieselben Dateien auflösen.

Single board computer zimaboard2

Prüfen Sie das Arbeitsverzeichnis und die Umgebungsdateien von systemd

Lesen Sie die tatsächlich wirksame Unit, alle Drop-ins, WorkingDirectory=, Environment=, EnvironmentFile= und ExecStart=. Vergleichen Sie die beim Systemstart geladene Unit mit dem manuell verwendeten Befehl.

Die Ausführungseinstellungen von systemd legen das Arbeitsverzeichnis des Dienstes und die Umgebungsdateien fest. Diese übernehmen nicht automatisch das aktuelle Verzeichnis oder exportierte Variablen einer interaktiven Login-Shell.

Laden Sie nach einer Änderung an einer Unit oder einem Drop-in den systemd-Manager neu und prüfen Sie die tatsächlich wirksame Unit erneut. Das Bearbeiten einer Vorlage oder einer nicht verwendeten Datei ändert den Dienst, der tatsächlich gestartet wird, nicht.

Stack-Manager-Variablen und gespeicherten Bereitstellungsstatus prüfen

Wenn Portainer oder eine NAS-Benutzeroberfläche den Stack verwaltet, vergleichen Sie die gespeicherten Variablen, die hochgeladene Env-Datei, den Git-Bereitstellungspfad, das Aktualisierungsverhalten des Webhooks und das angezeigte Compose-Modell.

Portainer unterscheidet das Verhalten von .env und stack.env, sodass sich die im Manager eingegebenen Werte von einer direkt auf dem Host bearbeiteten Datei unterscheiden können.

Wählen Sie eine einzige verlässliche Quelle. Ein Stack, der über Git oder einen Web-Editor verwaltet wird, sollte nach jedem Neustart nicht zusätzlich manuell aus einer anderen lokalen Kopie gestartet werden.

Den Container neu erstellen, statt ihn nur neu zu starten

Vergleiche den Erstellungszeitpunkt des Containers mit dem Änderungszeitpunkt der env-Datei. Rendere die vorgesehene Compose-Konfiguration und erstelle dann kontrolliert nur den betroffenen Dienst neu.

Die systemd-Anleitung von Red Hat empfiehlt, vor einem Neustart die tatsächlich von einem Dienst verwendeten Dateien und Überschreibungen zu prüfen. So wird verhindert, dass eine veraltete Unit oder ein Wrapper den Container mit alten Werten neu erstellt.

Bei einem Neustart des Containers wird seine Umgebung nicht erneut aus Compose erstellt. Erstelle ihn nur dann neu, wenn die persistenten Daten geschützt sind und du bestätigt hast, dass das gerenderte Modell auf die vorgesehenen Volumes und Geheimnisse verweist.

Manuellen Start, Neustart und erneute Bereitstellung auf dasselbe Modell bringen

Lege Compose-Dateien, Projektnamen, Projektverzeichnis, Pfad zur env-Datei, Stack-Verantwortliche und Startabhängigkeiten fest. Speichere eine gerenderte Konfiguration ohne sensible Angaben und einen unbedenklichen Umgebungsfingerabdruck.

Der ZimaSpace-Artikel zum Umfang von Docker-Backups erläutert die ergänzende Regel: Umgebungsdateien und Bereitstellungsdefinitionen müssen zusammen mit persistenten Daten gesichert werden.

Das Problem ist behoben, wenn bei einer manuellen Neuerstellung, einem Neustart des Hosts, einem geplanten Update und einer erneuten Bereitstellung über den Stack-Manager jeweils ein Dienst mit demselben redigierten Umgebungsfingerabdruck erstellt wird.

Häufig gestellte Fragen

Was ist der Unterschied zwischen .env und env_file?

Eine Projektdatei .env stellt Compose üblicherweise Werte für die Variableninterpolation bereit, während eine service env_file Variablen an den Container übergibt. Wie beides zusammenwirkt und welche Werte Vorrang haben, hängt vom vollständigen Compose-Modell ab.

Lädt ein Neustart des Containers eine geänderte env-Datei neu?

Nein. Umgebungsvariablen werden beim Erstellen des Containers festgelegt. Normalerweise muss der Dienst anhand der korrigierten Compose-Konfiguration neu erstellt werden.

Warum tritt das Problem nur nach einem Neustart auf?

Der Neustartpfad verwendet möglicherweise eine systemd-Unit, einen Scheduler, im Manager gespeicherte Variablen, ein anderes Arbeitsverzeichnis oder eine ältere Compose-Kopie, die sich vom manuellen Start unterscheidet.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.