Docker エンジンと docker-compose.yml のバージョン

Docker エンジンと Compose ファイルのバージョン対応表

Compose file version	Docker Engine
1.0	1.9.1.+
2.0	1.10.0+
2.1	1.12.0+
2.2	1.13.0+
2.3	17.06.0+
2.4	17.12.0+
3.0	1.13.0+
3.1	1.13.1+
3.2	17.04.0+
3.3	17.06.0+
3.4	17.09.0+
3.5	17.12.0+
3.6	18.02.0+
3.7	18.06.0+
3.8	19.03.0+

• version を指定しない場合は レガシーフォーマット である version: '1.0' となる
• マイナーバージョンを指定しない(version: '2')場合はマイナーバージョン0(version: '2.0')とみなされる

各バージョンでの主な変更・追加内容は以下

Version 2.0

• volumes キーと networks キーの追加
• デフォルトで全てのコンテナがアプリケーション全体のデフォルトネットワークに参加
• depends_on オプションによるサービス起動順序の制御
• 変数の展開

Version 2.1

• link_local_ips
• isolation (ビルド構成とサービス定義)
• labels (volumes, networks, build)
• name (volumes)
• userns_mode
• healthcheck
• sysctls
• pids_limit
• oom_kill_disable
• cpu_period

Version 2.2

• init
• scale
• cpu_rt_runtime , cpu_rt_period
• network (ビルド構成)

Version 2.3

• target , extra_hosts , shm_size (ビルド構成)
• start_period (healthchecks)
• “Long syntax” (volumes)
• runtime (サービス定義)
• device_cgroup_rules

Version 2.4

• platform (サービス定義)
• サービス、ネットワーク、およびボリューム定義のルートでの拡張フィールドのサポート

Version 3.0

• deploy
• 削除: volume_driver , volumes_from , cpu_shares , cpu_quota , cpuset , mem_limit , memswap_limit , extends , group_add

Version 3.1

• secrets

Version 3.2

• cache_from (ビルド構成)
• “Long syntax” (ports, volume mounts)
• attachable
• endpoint_mode (deploy)
• preference (deploy placement)

Version 3.3

• labels (build)
• credential_spec
• configs

Version 3.4

• target network (ビルド構成)
• start_period (healthchecks)
• order (update configurations)
• name (volumes)

Version 3.5

• isolation (サービス定義)
• name (networks, secrets, configs)
• shm_size (ビルド構成)

Version 3.6

• tmpfs サイズ(tmpfs-type mounts)

Version 3.7

• init (サービス定義)
• rollback_config (デプロイ構成)
• サービス、ネットワーク、ボリューム、シークレット、構成定義のルートでの拡張フィールドのサポート

Docker/Kubernetes 実践コンテナ開発入門

Docker実践ガイド 第2版 (impress top gear)