Perché un servizio Compose usa il file Env sbagliato solo dopo il riavvio dell'host?

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Dopo il riavvio, un servizio Compose può usare valori d’ambiente diversi se il programma di avvio risolve una directory di progetto, un file env o una fonte di precedenza diversa.

Un comando manuale può essere eseguito dalla cartella prevista con un determinato ambiente della shell, mentre systemd, un pianificatore NAS o Portainer avvia lo stesso file Compose da un altro contesto dopo il riavvio. Inoltre, il servizio potrebbe riavviare un container esistente, il cui ambiente è stato definito al momento della creazione, anziché rileggere il file modificato. Prima di modificare più file contemporaneamente, confronta il modello Compose renderizzato e l’ambiente del processo in esecuzione nei percorsi manuale e di avvio.

Confronta l’ambiente in esecuzione con il file previsto

Registra l’ID del container, l’ora di creazione, l’immagine, le etichette Compose, il nome del progetto e i valori effettivamente visibili all’interno del processo principale. Confrontali con il file env previsto senza riportare segreti nei log condivisi.

L’ambiente del processo Linux espone i valori forniti al momento dell’esecuzione, una prova più attendibile della lettura di un file env che potrebbe non essere mai stato usato dal container attuale.

Se il container contiene i vecchi valori ed è stato creato prima della distribuzione eseguita al riavvio, il servizio potrebbe averlo soltanto riavviato. Se il container è nuovo, continua a verificare la precedenza e la risoluzione dei percorsi.

Applica nell’ordine corretto la precedenza dell’ambiente Compose

Elenca tutte le fonti di una variabile innocua: flag CLI, valori della shell, environment:, env_file:, file .env predefinito o specificato esplicitamente ed ENV dell’immagine.

Docker definisce un formale ordine di precedenza dell’ambiente, quindi anche un file env corretto può perdere la precedenza rispetto a un valore con priorità maggiore, inserito dal servizio di avvio o dal gestore dello stack.

Non cercare soltanto nomi di file duplicati. Cerca il nome della variabile nel modello Compose renderizzato, nel file unit, nelle impostazioni del gestore, nell’ambiente della shell e nei valori predefiniti dell’immagine.

Controlla la directory del progetto e i percorsi relativi dei file env

Confronta la directory di lavoro del comando manuale con quella del programma di avvio all’avvio, gli argomenti dei file Compose, la directory di progetto e i riferimenti relativi a env_file.

La specifica Compose definisce il modello dell’applicazione usato per risolvere i servizi e la configurazione, quindi la definizione di progetto selezionata e i relativi percorsi sono parametri di distribuzione, non proprietà ricavate nuovamente dal container in esecuzione.

Usa percorsi assoluti per i file env essenziali all’avvio, se lo strumento di distribuzione lo consente, oppure imposta una directory di progetto e una directory di lavoro esplicite, così che gli avvii manuali e automatici individuino gli stessi file.

Verifica la directory di lavoro e i file di ambiente di systemd

Esamina l’unità effettiva, tutti i drop-in, WorkingDirectory=, Environment=, EnvironmentFile= e ExecStart=. Confronta l’unità caricata all’avvio con il comando eseguito manualmente.

Le impostazioni di esecuzione di systemd definiscono la directory di lavoro del servizio e i file di ambiente, che non ereditano automaticamente la directory corrente o le variabili esportate di una shell di accesso interattiva.

Dopo aver modificato un’unità o un drop-in, ricarica il gestore systemd e verifica di nuovo l’unità effettiva. Modificare un modello o un file inutilizzato non cambia il servizio che viene effettivamente avviato.

Verifica le variabili dello stack e lo stato della distribuzione salvato

Se Portainer o l’interfaccia utente del NAS gestisce lo stack, confronta le variabili salvate, il file env caricato, il percorso di distribuzione Git, il comportamento di aggiornamento del webhook e il modello Compose visualizzato.

Portainer distingue il comportamento di .env e stack.env, quindi i valori inseriti nel gestore possono differire da quelli di un file modificato direttamente sull’host.

Scegli un’unica fonte di verità. Uno stack gestito da Git o da un editor web non dovrebbe essere avviato manualmente anche da un’altra copia locale dopo ogni riavvio.

Ricrea il container invece di limitarti a riavviarlo

Confronta l'ora di creazione del container con quella della modifica del file env. Renderizza la configurazione Compose prevista, quindi ricrea in modo controllato solo il servizio interessato.

La guida di Red Hat su systemd consiglia di verificare i file e le sostituzioni effettivamente usati da un servizio prima di riavviarlo, per evitare che un'unità obsoleta o uno script wrapper ricrei il container con valori precedenti.

Il riavvio di un container non ricostruisce il suo ambiente a partire da Compose. Ricrealo solo dopo aver protetto i dati persistenti e aver verificato che il modello renderizzato faccia riferimento ai volumi e ai segreti previsti.

Fai in modo che l'avvio manuale, il riavvio e la ridistribuzione producano lo stesso modello

Fissa i file Compose, il nome del progetto, la directory del progetto, il percorso del file env, il proprietario dello stack e la dipendenza di avvio. Salva una configurazione renderizzata priva di dati sensibili e un'impronta digitale innocua dell'ambiente.

L'articolo di ZimaSpace sull'ambito del backup di Docker illustra la regola correlata: i file di ambiente e le definizioni di distribuzione devono essere conservati insieme ai dati persistenti.

Il problema è risolto quando la ricreazione manuale, il riavvio dell'host, l'aggiornamento pianificato e il ridistribuzione dallo stack manager creano tutti il servizio con la stessa impronta digitale dell'ambiente, priva di dati sensibili.

Domande frequenti

Qual è la differenza tra .env ed env_file?

Un file .env di progetto fornisce comunemente a Compose i valori per l'interpolazione, mentre un env_file del servizio fornisce variabili al container. La loro interazione e precedenza dipendono dal modello Compose completo.

Il riavvio di un container ricarica un file env modificato?

No. I valori dell'ambiente vengono impostati quando il container viene creato. Di norma, il servizio deve essere ricreato usando la configurazione Compose corretta.

Perché il problema si presenta solo dopo il riavvio?

Il percorso di riavvio potrebbe usare un'unità systemd, uno scheduler, variabili memorizzate dal gestore, un'altra directory di lavoro o una copia precedente di Compose, diversa da quella usata per l'avvio manuale.

Assistenza e consigli

Altre letture

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.