docker-compose で数日めちゃくちゃハマったので、メモしておきます。たぶん、ハマったのは私だけではないはず。
環境変数を設定しても反映されない場合がある？！
docker-compose.ymlのenvironmentに環境変数を設定できるとみんな言っています。そして、その通り、反映されます。
しかし、docker-compose.ymlの中で別途Dockerfileをビルドする場合、その環境変数は設定されません。
なぜなら…
Dockerfileは、Dockerイメージを構築するために使用される設定ファイルです。 Dockerfileには、イメージに含まれるファイルやアプリケーションの設定などが記述されます。 Docker Composeは、複数のDockerコンテナを組み合わせてアプリケーションを実行するためのツールです。docker-compse.ymlは、Docker Composeのための設定ファイルです。
つまり、docker-compose.ymlに指定する環境変数は、イメージをビルドする際、有効になるのではなく、コンテナで有効になるからです。こんな簡単なことに気付くのに、数日かかってしまうとは…。
Dockerfileのビルドで環境変数を指定する場合
Dockerfileの中で環境変数を使いたい場合には、素直に、DockerfileのENVを使って環境変数を指定するのが良いです。
# ベースイメージの指定
FROM python:3.9-slim-buster
# 環境変数を指定(ただし、以下のコマンド実行時には参照できるが他のコンテナからは参照できない)
ENV HOGE dockerfile
ENV FUGA bbb
ENV APP_DIR /app
# ローカルのファイルをコピー
COPY ./app /app
# 作業ディレクトリを設定
WORKDIR ${APP_DIR}
RUN python3 ${APP_DIR}/print_hoge.py > hoge1.txt
- Dockerfileの中でENVを指定すると環境変数を定義できる
- この場合、このイメージから作ったコンテナでは環境変数が有効
docker-compose.ymlに書く場合
docker-compose.ymlのenviromentに環境変数を列挙できます。ただし、前述のように、Dockerfileのビルド時には反映されません。
version: '1'
services:
test_service:
# Dockerfileをビルドする
build:
context: .
dockerfile: Dockerfile
container_name: python39_test
image: python39_test_image
# 環境変数を設定する
environment:
- HOGE=docker-compose.yml
- bbb=bbb
- ccc=30
# 複数のコマンドを実行する
command: >
/bin/sh -c "
python3 /app/print_hoge.py > hoge2.txt
while true; do
sleep 3600
done
"
- envirmentに環境変数を列挙できる
- ただし、Dockerfileのビルド時に環境変数を指定できない(もし指定したい場合は以下を参照)
docker-compose.ymlからDockerfileに変数を与える場合
docker-compose.ymlの中で、Dockerfileに値を与えたい場合、以下のように、buildのargsに値を指定し、Dockerfileの中でARGを宣言することにより、使うことができます。
version: "2"
services:
test_service:
# 環境変数を定義
enviroment:
- HOGE=Dockerfile
# Dockerfileをビルドする
build:
context: .
dockerfile: Dockerfile
# Dockerfile に渡す変数を指定✨✨✨
args:
- FUGA=fuga
# 上記で宣言した環境変数も渡せる
- HOGE=${HOGE}
container_name: python39_test
image: python39_test_image
そして、Dockerfileの中でARGを定義
# ベースイメージとしてAlpineを使用
FROM python:3.9-slim-buster
# 変数を明示的に定義 --- これが必須✨✨✨
ARG HOGE
COPY ./app /app
# 作業ディレクトリを設定
WORKDIR /app
RUN python3 print_hoge.py > hoge1.txt
環境変数にダブルクォートをつけていた
docker-compose.ymlのenvironmentに環境変数を設定できるとみんな言っています。そして、その通り、反映されます。しかし、値を指定するとき、シェルコマンドのようにNAME="VALUE"と書くと、ダブルクォートを含めて環境変数に設定されます。
例えば...
version: '1'
services:
test_service:
# Dockerfileをビルドする
build:
context: .
dockerfile: Dockerfile
container_name: python39_test
image: python39_test_image
# 環境変数を設定する
environment:
# ダブルクォート付きの値を指定した --- (※1)
- HOGE="HOGE"
- FUGA=FUAG
上記(※1)で、echo $HOGE すると、"HOGE"が設定されているのを確認できます。