Docker Compose - docker-compose.yml リファレンス
原文：Compose file version 3 reference
https://docs.docker.com/compose/compose-file/
docker-compose.yml で定義される各々のサービスは、特定の image か build を指定する必要があります。その他のキーはオプションであり、docker run コマンドラインのものと似ています。
docker run と同様に、Dockerfile で指定されたオプションがデフォルトとして尊重されます（例：CMD,EXPOSE,VOLUME,ENV）。そのため、docker-compose.yml で再び定義する必要はありません。
image
タグや image ID の一部です。ローカルでもリモートでも構いません。ローカルに存在しなければ、Compose はイメージを取得（pull）します。
image: ubuntu
image: orchardup/postgresql
image: a4bc65fd
build
Dockerfile のあるディレクトリのパスを指定します。この値が相対パスで指定された場合は、yml ファイル自身がある場所からの相対パスになります。また、ディレクトリは内容構築のため、Docker デーモンにも送られます。
Compose は構築し、生成した名前をタグ付けし、以後のイメージでも使われます。
build: /path/to/build/dir
dockerfile
代替用の Dockerfile です。
Compose は構築時に指定されたファイルを使います。
dockerfile: Dockerfile-alternate
command
デフォルトのコマンドを上書きします。
command: bundle exec thin -p 3000
links
コンテナを他のサービスにリンクします。サービス名とリンク・エイリアス（サービス:エイリアス）を指定できるだけでなく、あるいは、サービス名（エイリアスとしても使われます）でも指定できます。
links:
- db
- db:database
- redis
エイリアス名を記述すると、コンテナ内の /etc/hosts の中にサービス名が追加されます。例：
172.17.2.186 db
172.17.2.186 database
172.17.2.187 redis
環境変数も作成されます。詳細は環境変数リファレンスをご覧ください。
external_links
この docker-compose.yml や、とりわけ Compose の外にある共有ないし共通サービスが提供するコンテナとリンクします。external_links はコンテナ名やリンク・エイリアス（CONTAINER:ALIAS）の指定時に links と似たような意味あいを持ちます。
external_links:
- redis_1
- project_db_1:mysql
- project_db_1:postgresql
extra_hosts
ホスト名のマッピングを追加します。docker クライアントの --add-host パラメータと同じ値です。
extra_hosts:
- "somehost:162.242.195.82"
- "otherhost:50.31.209.229"
入力した IP アドレスとホスト名は、コンテナ内の /etc/hosts にサービスと記載されます。例：
162.242.195.82 somehost
50.31.209.229 otherhost
ports
ポートを公開（expose）します。ホストとポートを指定（ホスト:コンテナ）するか、コンテナのポートのみ指定します（ホスト側のポートはランダムに選ばれます）。
メモ：ポートのマッピングに ホスト:コンテナ の形式を使うとき、コンテナのポートが 60 以下の場合はエラーが表示されるでしょう。これは YTML がxx:yy 形式を60進数と認識するためです。そのため、常に明確なポートのマッピングを文字列で指定することを推奨します。
ports:
- "3000"
- "8000:8000"
- "49100:22"
- "127.0.0.1:8001:8001"
expose
ホストマシン上にポートを露出（expose）しますが、公開はしません。リンクされたサービスのみアクセスできます。内部ポートのみ指定できます。
expose:
- "3000"
- "8000"
volumes
パスをボリュームとしてマウントします。オプションとしてホスト側のパスを指定（ホスト:コンテナ）したり、アクセスモードを指定します（ホスト:コンテナ:ro）。
volumes:
- /var/lib/mysql
- cache/:/tmp/cache
- ~/configs:/etc/configs/:ro
volumes_from
他のサービスやコンテナから、全てのボリュームをマウントします。
volumes_from:
- service_name
- container_name
environment
環境変数を追加します。配列や dictionary（訳注；YAML のハッシュ）を使えます。
キーだけの環境変数は、Compose 起動時に用いられる値があてられますので、秘密にしたい値やホスト固有の値を指定しやすいです。
environment:
RACK_ENV: development
SESSION_SECRET:
environment:
- RACK_ENV=development
- SESSION_SECRET
env_file
ファイルから環境変数を追加します。リストには１つの値です。
Compose でファイルを docker-compose -f ファイル名 で指定した場合は、env_file のパスはそのファイルがあるディレクトリからの相対パスになります。
environment で指定した環境変数は、これらの値に上書きされます。
env_file: .env
env_file:
- ./common.env
- ./apps/web.env
- /opt/secrets.env
Compose は環境変数で指定されたファイルの各行が 変数=値 の形式とみなします。#` で始まる行は無視され（例：コメント）、空白行として扱われます。
# 環境変数 Rails/Rack の設定
RACK_ENV=development
extends
現在のファイルや別のファイルから、他のサービスを拡張します。オプションで設定を上書きします。
以下は簡単な例です。２つのファイル common.yml と development.yml があります。extends を使って development.yml のサービスを定義します。このサービスとは common.yml で定義されているものです：
webapp:
build: ./webapp
environment:
- DEBUG=false
- SEND_EMAILS=false
web:
extends:
file: common.yml
service: webapp
ports:
- "8000:8000"
links:
- db
environment:
- DEBUG=true
db:
image: postgres
ここでは、development.yml の web サービスは、common.yml の webapp サービスの設定を継承します。build、environment のキーと、ports と links 設定を追加します。新しい値を持つ環境変数（DEBGUG）が定義されると、既存のものを上書きします。
他の環境変数（SEND_EMAILS）はそのままです。
extends の詳細は、チュートリアルやリファレンスをご覧ください。
labels
Docker labels を使ってコンテナにメタデータを追加します。配列やハッシュが使えます。
逆引き DNS の概念を使い、他のソフトウェアが使うラベルと衝突しないようにすることをお勧めします。
labels:
com.example.description: "Accounting webapp"
com.example.department: "Finance"
com.example.label-with-empty-value: ""
labels:
- "com.example.description=Accounting webapp"
- "com.example.department=Finance"
- "com.example.label-with-empty-value"
log driver
docker 実行時のオプションで（ドキュメントはこちら(英語)です） --log-driver を使い、ログ記録用のドライバを指定します。
現時点で使える値は json-file、syslog、none です。暫くすると Docker エンジンにドライバが更に追加され、一覧が変わる可能性があります。
デフォルトの値は json-file です。
log_driver: "json-file"
log_driver: "syslog"
log_driver: "none"
net
ネットワーキング・モードを指定します。Docker クライアントで --net パラメータを指定したときと同じです。
net: "bridge"
net: "none"
net: "container:[name or id]"
net: "host"
pid
pid: "host"
PID モードを host PID モードにセットします。これにより、コンテナとホスト・オペレーティング・システム上の PID アドレス空間を共有します。ベアメタルマシンの名前空間などで、他のコンテナにアクセス・操作できるように、コンテナ起動時にこのフラグを使います。
dns
DNS サーバーを設定します。１つまたはリストで記述します。
dns: 8.8.8.8
dns:
- 8.8.8.8
- 9.9.9.9
cap_add, cap_drop
コンテナの性能を追加したり下げたりします。man 7 capabilities で詳細をご覧ください。
cap_add:
- ALL
cap_drop:
- NET_ADMIN
- SYS_ADMIN
dns_search
DNS の search ドメインを設定します。１つまたはリストで記述します。
dns_search: example.com
dns_search:
- dc1.example.com
- dc2.example.com
devices
デバイス・マッピングの一覧です。Docker クライアントで作成時のオプション --device と同じ形式の使い方です。
devices:
- "/dev/ttyUSB0:/dev/ttyUSB0"
security_opt
それぞれのコンテナ毎に、デフォルトのラベリング・スキーマを上書きします。
security_opt:
- label:user:USER
- label:role:ROLE
working_dir, entrypoint, user, hostname, domainname, mem_limit, privileged, restart, stdin_open, tty, cpu_shares, cpuset, read_only
それぞれ単一の値を持つもので、docker runの対となります。
cpu_shares: 73
cpuset: 0,1
working_dir: /code
entrypoint: /code/entrypoint.sh
user: postgresql
hostname: foo
domainname: foo.com
mem_limit: 1000000000
privileged: true
restart: always
stdin_open: true
tty: true
read_only: true