ホストの再起動後だけ、Composeサービスが間違ったenvファイルを使うのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

Composeサービスでは、ブート時の起動処理が別のプロジェクトディレクトリ、envファイル、優先順位の設定元を参照することで、再起動後に異なる環境変数が使われることがあります。

手動コマンドは意図したフォルダから特定のシェル環境で実行される一方、systemd、NASのスケジューラー、Portainerは、再起動後に別のコンテキストから同じComposeファイルを起動することがあります。また、サービスが既存のコンテナを再起動する場合、環境変数は作成時に固定されているため、編集済みのファイルを読み直しません。複数のファイルを一度に編集する前に、手動起動時とブート時の経路で、レンダリングされたComposeモデルと実行中のプロセス環境を比較してください。

実行中の環境を意図したファイルと比較する

コンテナID、作成日時、イメージ、Composeラベル、プロジェクト名、メインプロセス内で確認できる実際の値を記録してください。秘密情報を共有ログに出力せずに、意図したenvファイルと比較してください。

Linuxのプロセス環境には、実行時に渡された値が表示されます。現在のコンテナが実際には使っていない可能性のあるenvファイルを読むより、確かな証拠になります。

コンテナに古い値が残っていて、再起動時のデプロイより前に作成されている場合、サービスはコンテナを再起動しただけかもしれません。コンテナが新しい場合は、優先順位とパスの解決を確認してください。

Composeの環境変数の優先順位を正しい順序で適用する

1つの無害な変数について、すべての設定元を列挙してください。CLIフラグ、シェルの値、environment:、env_file:、デフォルトまたは明示的に指定された.env、イメージのENVです。

Dockerには正式な環境変数の優先順位があるため、ブートサービスやスタックマネージャーから優先度の高い値が注入されると、正しいenvファイルを使っていてもその値が適用されないことがあります。

重複するファイル名だけを探してはいけません。レンダリングされたComposeモデル、ユニットファイル、マネージャーの設定、シェル環境、イメージのデフォルト設定を通して、変数名を検索してください。

プロジェクトディレクトリと相対パスの環境変数を確認する

手動コマンドの作業ディレクトリと、起動ランチャーの作業ディレクトリ、Composeファイルの引数、プロジェクトディレクトリ、相対パスで指定されたenv_fileを比較します。

Compose仕様では、サービスと設定の解決に使用されるアプリケーションモデルを定義します。そのため、選択したプロジェクト定義とそのパスはデプロイ時の入力であり、実行中のコンテナから再検出されるプロパティではありません。

デプロイツールが対応している場合は、起動に不可欠なenvファイルに絶対パスを使用します。または、プロジェクトディレクトリと作業ディレクトリを明示的に設定し、手動起動と自動起動で同じファイルが参照されるようにします。

systemdの作業ディレクトリと環境ファイルを確認する

有効なユニット、すべてのドロップイン、WorkingDirectory=、Environment=、EnvironmentFile=、ExecStart=を確認します。起動時に読み込まれるユニットと手動で実行するコマンドを比較します。

Systemd’s execution settings define the service working directory and environment files, which do not automatically inherit an interactive login shell’s current directory or exported variables.

ユニットまたはドロップインを変更した後は、systemdマネージャーを再読み込みし、有効なユニットをもう一度確認します。テンプレートや未使用のファイルを編集しても、実際に起動するサービスは変わりません。

スタックマネージャーの変数と保存済みのデプロイ状態を確認する

PortainerまたはNASのUIがスタックを管理している場合は、保存済みの変数、アップロードしたenvファイル、Gitのデプロイ先、Webhookによる更新動作、表示されるComposeモデルを比較します。

Portainerでは.envとstack.envの動作が異なるため、管理画面で入力した値とホスト上で直接編集したファイルの値が異なる場合があります。

信頼できる情報源を1つ選びます。Gitまたはウェブエディターで管理するスタックを、再起動のたびに別のローカルコピーから手動で起動してはいけません。

コンテナを再起動するのではなく、再作成する

コンテナの作成日時とenvファイルの編集日時を比較します。意図したCompose設定をレンダリングしたうえで、対象のサービスのみを制御しながら再作成します。

Red Hatのsystemdガイドでは、古いユニットやラッパーが古い値でコンテナを再作成するのを防ぐため、サービスの再起動前に実際に使用されているファイルとオーバーライドを確認することを推奨しています。

コンテナを再起動しても、Composeから環境が再構築されることはありません。永続データを保護し、レンダリングされたモデルが意図したボリュームとシークレットを参照していることを確認してから、コンテナを再作成してください。

手動起動、再起動、再デプロイで同じモデルを使う

Composeファイル、プロジェクト名、プロジェクトディレクトリ、envファイルのパス、スタックの管理者、起動時の依存関係を固定します。マスキング済みのレンダリング設定と、機密情報を含まない環境フィンガープリントを保存してください。

ZimaSpaceの記事Dockerのバックアップ範囲では、環境ファイルとデプロイ定義を永続データとともに保持するという関連ルールを紹介しています。

手動での再作成、ホストの再起動、スケジュールされた更新、スタックマネージャーからの再デプロイのいずれでも、同じマスキング済み環境フィンガープリントでサービスが作成されれば、問題は解決しています。

よくある質問

.envとenv_fileの違いは何ですか?

プロジェクトの.envファイルは一般にComposeへの値の展開に使われ、サービスのenv_fileはコンテナに渡す変数を指定します。両者の相互作用と優先順位は、Composeモデル全体によって異なります。

コンテナを再起動すると、変更したenvファイルが再読み込みされますか?

いいえ。環境変数はコンテナの作成時に設定されます。通常は、修正したCompose設定からサービスを再作成する必要があります。

なぜ再起動後にだけ問題が発生するのですか?

再起動時の起動経路では、systemdのユニット、スケジューラー、マネージャーに保存された変数、別の作業ディレクトリ、または手動起動時とは異なる古いComposeファイルが使われている可能性があります。

サポートとヒント

続きを読む

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.