Waarom gebruikt een Compose-service pas na een herstart van de host het verkeerde env-bestand?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een Compose-service kan na het opnieuw opstarten andere omgevingswaarden gebruiken als de opstartlauncher een andere projectmap, een ander env-bestand of een andere bron met voorrang kiest.

Een handmatige opdracht kan vanuit de beoogde map met één shellomgeving worden uitgevoerd, terwijl systemd, een NAS-planner of Portainer na het opstarten hetzelfde Compose-bestand vanuit een andere context start. De service kan ook een bestaande container opnieuw starten, waarvan de omgeving bij het aanmaken is vastgelegd, in plaats van het bewerkte bestand opnieuw in te lezen. Vergelijk het gerenderde Compose-model en de omgeving van het actieve proces vanuit zowel de handmatige als de opstartomgeving voordat je meerdere bestanden tegelijk bewerkt.

Vergelijk de actieve omgeving met het beoogde bestand

Noteer de container-ID, aanmaaktijd, image, Compose-labels, projectnaam en de daadwerkelijke waarden die zichtbaar zijn in het hoofdproces. Vergelijk deze met het beoogde env-bestand zonder geheimen in gedeelde logs te zetten.

De procesomgeving van Linux toont de waarden die bij het starten zijn aangeleverd, en vormt daarmee sterker bewijs dan het uitlezen van een env-bestand dat de huidige container mogelijk nooit heeft gebruikt.

Als de container de oude waarden bevat en ouder is dan de implementatie tijdens het opnieuw opstarten, heeft de service hem mogelijk alleen opnieuw gestart. Is de container nieuw, ga dan verder met de voorrang en padresolutie.

Pas de voorrangsvolgorde voor Compose-omgevingsvariabelen in de juiste volgorde toe

Vermeld alle bronnen voor één onschadelijke variabele: CLI-opties, shellwaarden, environment:, env_file:, standaard- of expliciete .env en image-ENV.

Docker hanteert een formele voorrangsvolgorde voor omgevingsvariabelen, dus een correct env-bestand kan alsnog worden overschreven door een waarde met hogere prioriteit die door de opstartservice of stackmanager wordt ingesteld.

Zoek niet alleen naar dubbele bestandsnamen. Zoek naar de variabelenaam in het gerenderde Compose-model, het unitbestand, de managerinstellingen, de shellomgeving en de standaardwaarden van de image.

Controleer de projectmap en relatieve paden naar env-bestanden

Vergelijk de werkmap van de handmatige opdracht met die van de opstartprocedure, evenals de Compose-bestandsargumenten, projectmap en relatieve verwijzingen in env_file.

De Compose-specificatie definieert het applicatiemodel waarmee services en configuratie worden bepaald. De geselecteerde projectdefinitie en de paden daarin zijn dus invoer voor de implementatie, geen eigenschappen die opnieuw worden afgeleid van de draaiende container.

Gebruik absolute paden voor env-bestanden die nodig zijn bij het opstarten, als de implementatietool dat ondersteunt, of stel expliciet een projectmap en werkmap in zodat handmatige en geautomatiseerde starts dezelfde bestanden vinden.

Single board computer zimaboard2

Controleer de werkmap en omgevingsbestanden van systemd

Lees de effectieve unit, alle drop-ins en de waarden van WorkingDirectory=, Environment=, EnvironmentFile= en ExecStart=. Vergelijk de unit die bij het opstarten wordt geladen met de opdracht die handmatig wordt gebruikt.

De uitvoeringsinstellingen van systemd bepalen de werkmap en omgevingsbestanden van de service, die niet automatisch de huidige map of geëxporteerde variabelen van een interactieve aanmeldshell overnemen.

Laad na het wijzigen van een unit of drop-in de systemd-manager opnieuw en controleer de effectieve unit nogmaals. Het bewerken van een sjabloon of ongebruikt bestand verandert niet de service die daadwerkelijk wordt gestart.

Controleer stackbeheervariabelen en opgeslagen implementatiestatus

Als Portainer of de NAS-interface de stack beheert, vergelijk dan de opgeslagen variabelen, het geüploade env-bestand, het Git-implementatiepad, het gedrag van webhookupdates en het weergegeven Compose-model.

Portainer maakt onderscheid tussen het gedrag van .env en stack.env, waardoor waarden die in de beheerinterface zijn ingevoerd kunnen verschillen van waarden in een bestand dat rechtstreeks op de host is bewerkt.

Kies één bron van waarheid. Een stack die vanuit Git of een webeditor wordt beheerd, moet niet na elke herstart ook handmatig vanuit een andere lokale kopie worden gestart.

Maak de container opnieuw aan in plaats van deze alleen opnieuw te starten

Vergelijk de aanmaaktijd van de container met het wijzigingstijdstip van het env-bestand. Render de bedoelde Compose-configuratie en maak vervolgens alleen de betreffende service gecontroleerd opnieuw aan.

De systemd-richtlijnen van Red Hat raden aan om de bestanden en overschrijvingen te controleren die een service daadwerkelijk gebruikt voordat je deze opnieuw start. Zo voorkom je dat een verouderde eenheid of wrapper de container opnieuw aanmaakt met oude waarden.

Een container herstarten bouwt de omgeving niet opnieuw op vanuit Compose. Maak de container pas opnieuw aan nadat je de persistente gegevens hebt veiliggesteld en hebt bevestigd dat het gerenderde model naar de bedoelde volumes en geheimen verwijst.

Zorg dat handmatig starten, herstarten en opnieuw implementeren hetzelfde model opleveren

Leg de Compose-bestanden, projectnaam, projectmap, het pad naar het env-bestand, de eigenaar van de stack en de opstartafhankelijkheid vast. Sla een geredigeerde gerenderde configuratie en een onschadelijke omgevingsvingerafdruk op.

Het artikel van ZimaSpace over de back-upomvang van Docker geeft de aanvullende regel: omgevingsbestanden en implementatiedefinities moeten samen met de persistente gegevens worden bewaard.

Het probleem is opgelost wanneer een handmatige nieuwe aanmaak, een herstart van de host, een geplande update en een nieuwe implementatie via de stackbeheerder de service allemaal met dezelfde geredigeerde omgevingsvingerafdruk aanmaken.

Veelgestelde vragen

Wat is het verschil tussen .env en env_file?

Een projectbestand .env levert doorgaans interpolatiewaarden aan Compose, terwijl een env_file voor een service variabelen aan de container levert. Hoe ze samenwerken en welke voorrang ze hebben, hangt af van het volledige Compose-model.

Laadt een container opnieuw starten een gewijzigd env-bestand in?

Nee. Omgevingswaarden worden ingesteld wanneer de container wordt aangemaakt. Normaal gesproken moet de service opnieuw worden aangemaakt met de gecorrigeerde Compose-configuratie.

Waarom doet het probleem zich alleen na een herstart voor?

Het herstartpad gebruikt mogelijk een systemd-eenheid, planner, door de beheerder opgeslagen variabelen, een andere werkmap of een oudere Compose-kopie die afwijkt van de handmatige start.

Ondersteuning en tips

Meer om te lezen

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.