Warum behält ein laufender Container sein altes Speicherlimit bei, nachdem die Compose-Datei geändert wurde?

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 laufender Container behält sein altes Speicherlimit bei, wenn die bearbeitete Compose-Konfiguration nicht auf die aktive cgroup dieses Containers angewendet wurde.

Eine Änderung an YAML verändert einen vorhandenen Container nicht von selbst, und ein gewöhnlicher Neustart startet denselben Container mit derselben Konfiguration, die bei seiner Erstellung galt. Verwirrung entsteht außerdem, wenn ein hartes Speicherlimit mit einer Reservierung, einem Swap-Kontingent, dem übergeordneten systemd-Scope oder einer Heap-Einstellung der Anwendung verglichen wird. Ermitteln Sie den effektiven cgroup-Wert und die Container-ID, bevor Sie zu dem Schluss kommen, dass Docker die Änderung ignoriert hat.

Lesen Sie das aktive cgroup-Limit aus, statt dem YAML zu vertrauen

Protokollieren Sie die Container-ID, den Erstellungszeitpunkt, die Docker-Inspektionsausgabe, die cgroup-Version und die Speichersteuerungsdateien, die der laufende Prozess verwendet.

Der Linux-Kernel definiert memory.max als hartes Limit der cgroup, während memory.high Rückgewinnungsdruck ausübt, ohne als dieselbe absolute Obergrenze zu fungieren.

Enthält die aktive cgroup weiterhin den alten Wert, wurde die Konfiguration nicht übernommen. Enthält sie den neuen Wert, aber die Überwachung zeigt etwas anderes an, prüfen Sie Einheiten, die Speicherabrechnung des Caches, Swap und Metriken auf Anwendungsebene.

Neustart und Neuerstellung eines Containers unterscheiden

Vergleichen Sie die Container-ID vor und nach dem Befehl, mit dem die Änderung bereitgestellt wurde. Protokollieren Sie, ob der Befehl restart, up, create, eine NAS-Benutzeroberflächenaktion oder ein direktes Docker-Update war.

Laut Docker übernimmt Compose restart keine Konfigurationsänderungen, da dabei die vorhandenen Dienstcontainer neu gestartet werden.

Führen Sie ein kontrolliertes Compose-Update aus, bei dem der Dienst neu erstellt wird, oder verwenden Sie gegebenenfalls ein unterstütztes Live-Update der Ressourcen. Bewahren Sie die alte Inspektionsausgabe auf, damit sich das geänderte Feld überprüfen lässt.

Prüfen Sie das endgültige Compose-Modell und das Speicherfeld

Rendern Sie die effektive Compose-Konfiguration, nachdem alle Dateien, Profile und Umgebungsvariablen-Ersetzungen angewendet wurden. Prüfen Sie, ob das Limit zum aktiven Dienst gehört.

Die Compose-Spezifikation definiert mem_limit als Speicherlimit eines Dienstes und verlangt Übereinstimmung, wenn entsprechende deploy-Limits ebenfalls angegeben sind.

Ein Wert in einer nicht verwendeten Override-Datei, einem inaktiven Profil, einem falsch geschriebenen Dienst oder einer anderen Stack-Benutzeroberfläche ändert das bereitgestellte Modell nicht. Vergleichen Sie die gerenderte Konfiguration mit der Docker-Inspektion.

Hartes Limit, Reservierung und Swap unterscheiden

Protokollieren Sie das harte Speicherlimit, die Reservierung oder das weiche Limit, das Swap-Limit, die aktuelle und die maximale Auslastung sowie OOM-Ereignisse. Behandeln Sie nicht jeden speicherbezogenen Wert als dieselbe Obergrenze.

Die Dokumentation zur Ressourcensteuerung von systemd unterscheidet MemoryHigh von MemoryMax und zeigt, dass übergeordnete cgroups zusätzliche Limits für Dienste und Container festlegen können.

Ein Container kann scheinbar eine Reservierung überschreiten, weil eine Reservierung nicht dasselbe ist wie eine harte Obergrenze. Außerdem kann er Swap oder den Seiten-Cache nutzen, den manche Dashboards ausschließen oder separat anzeigen.

Prüfen Sie, ob für den Heap der Laufzeitumgebung ein eigenes Limit gilt

Erfassen Sie bei Java-Anwendungen die containerbewusste JVM-Erkennung, den maximalen Heap, den direkten Speicher, den Metaspace, die Thread-Stacks und die vom Image oder der App-Konfiguration übergebenen Flags.

Oracle dokumentiert, dass die JVM ihren Heap anhand der verfügbaren Speicherbeschränkungen dimensioniert und mit MaxRAMPercentage den Heap-Anteil festlegen kann.

Eine Änderung des Container-Limits führt möglicherweise nicht zum erwarteten Anwendungs-Heap, wenn ein explizites -Xmx oder ein Prozentsatz weiterhin gilt. Der Heap-Speicher entspricht außerdem nicht dem gesamten Speicherverbrauch des Prozesses.

Überprüfen Sie Node.js- und andere anwendungsspezifische Limits

Überprüfen Sie Laufzeit-Flags, Umgebungsvariablen, Worker-Anzahl, Caches und interne Speicherziele. Vergleichen Sie sie mit dem Betriebssystemlimit.

Node.js dokumentiert max-old-space-size als V8-Heap-Limit, das unverändert bleiben kann, selbst wenn der Container ein größeres oder kleineres cgroup-Kontingent erhält.

Ein Container-Limit schützt den Host; es passt nicht automatisch jede Anwendung an. Legen Sie das Laufzeitlimit unterhalb der Container-Obergrenze fest und lassen Sie ausreichend Spielraum für native Speicherzuweisungen und den Dateisystem-Cache.

Nehmen Sie eine Änderung vor und überprüfen Sie sie unter kontrollierter Last

Rendern Sie das endgültige Compose-Modell, erstellen Sie nur den betroffenen Dienst neu, bestätigen Sie die neue Container-ID und die aktive cgroup und führen Sie anschließend eine begrenzte Arbeitslast aus, während Sie die Nutzung und OOM-Ereignisse beobachten.

Der Artikel im ZimaSpace Tech & AI Hub erklärt, was passiert, wenn ein Container sein aktives Limit erreicht; dieser Artikel konzentriert sich darauf, nachzuweisen, dass ein geändertes Limit tatsächlich bereitgestellt wurde.

Das Problem ist behoben, wenn die gerenderte Konfiguration, die Container-Inspektion, die cgroup-Dateien, der Heap der Laufzeitumgebung und die beobachtete Ausfallgrenze nach einem Neustart übereinstimmen.

Häufig gestellte Fragen

Wird ein geändertes Compose-Speicherlimit durch einen Neustart des Containers übernommen?

Nein. Bei einem Neustart wird normalerweise dieselbe vorhandene Container-Konfiguration verwendet. Erstellen Sie den Dienst neu oder verwenden Sie eine unterstützte Live-Aktualisierung.

Kann ein Container sein hartes Speicherlimit vorübergehend überschreiten?

Die Kernel-Abrechnung und das Zurückfordern von Speicher können kurzzeitig Werte nahe oder leicht über einem Grenzwert anzeigen. Anhaltende, nicht zurückforderbare Speichernutzung am harten Limit führt jedoch zur OOM-Behandlung durch cgroups.

Warum meldet die App weiterhin die alte Heap-Größe?

Die Anwendungs-Laufzeitumgebung kann ein explizites Heap-Flag verwenden oder einen Prozentsatz nur beim Start berechnen. Erstellen Sie den Container neu oder starten Sie ihn neu, nachdem Sie das Container-Limit überprüft haben.

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.