環境変数は、プログラムから読み取れる名前付きの値です。Compose では、ファイルを読み込むときに値を設定へ埋め込むことも、コンテナ内のプログラムに値を渡すこともできます。
Docker Compose · レッスン 5
環境変数
Compose ファイルに展開する値と、コンテナに渡す値の違いを学びます。
ファイル内の式を値に置き換える
練習用フォルダーに compose.env.yaml として保存します。このファイルの ${PAGE_MODE:-demo} は、PAGE_MODE が設定されていて値が空でなければその値を使い、それ以外の場合は demo を使うという指定です。
services:
toolbox:
image: busybox:1.36
environment:
PAGE_MODE: "${PAGE_MODE:-demo}"
Compose はコンテナを作成する前に式を解決します。これを変数展開と呼びます。別の設定ファイルでは、同じ仕組みを使ってホスト側のポートやイメージのタグを選ぶこともあります。
PAGE_MODE が未設定の場合、展開後の設定にはどの値が表示されますか?
展開された値を確認する
コマンドの前に変数への代入を書くと、その一回の実行にだけ値を設定できます。別の値を使うと設定がどう変わるかを試してみます。config は展開後の設定を表示するコマンドで、コンテナを作成することはありません。
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config
サービスの環境設定で PAGE_MODE: review を探します。review は動作確認用の値です。設定のサンプルや画面に表示される出力には、秘密情報を含めないようにします。
展開後の設定に review が表示されました。この時点で何が行われましたか?
コンテナへ値を渡す
environment セクションは、展開後の値を新しいコンテナに渡します。printenv を使って、この実行のために作ったコンテナ内から値を出力します。
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE
review と表示されるはずです。変数展開で値が決まり、環境設定によってコンテナへ渡されました。ホスト側のポートを選ぶためだけに使った変数は、プログラムの環境に自動で追加されるわけではありません。
ツール用コンテナ内のプログラムが受け取る値は、どう確認しますか?
レッスン完了
環境変数 を完了しました
環境変数の二つの使い方を区別できるようになりました。
Compose ファイルでデフォルト値を指定する式を読みます。
コンテナを起動する前に展開後の設定を確認します。
起動したプログラムの環境で値を確認します。