環境変数
100%

Docker Compose · レッスン 5

環境変数

Compose ファイルに展開する値と、コンテナに渡す値の違いを学びます。

環境変数は、プログラムから読み取れる名前付きの値です。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 ファイルでデフォルト値を指定する式を読みます。

  • コンテナを起動する前に展開後の設定を確認します。

  • 起動したプログラムの環境で値を確認します。

学習進捗を保存

無料アカウントを作成してこのレッスンを保存し、どのデバイスからでも学習を続けられます。

無料アカウントを作成
次のレッスン
Docker Compose に戻る