🐳

Docker Compose V2で変わったdocker-compose.ymlの書き方

2022/03/19に公開

Docker

docker-compose

tech

概要

2021年の後半にDocker Compose V2がリリースされました
Docker Compose V2はCompose Spec^[1]に準拠しているため、docker-compose.ymlもその仕様に則った書き方ができるようになっています

services:app1:image: awesome/webappconfigs:- my_configsecrets:- server-certificateapp2:image: awesome/databaseextends:service: app1configs:my_config:file: ./my_config.txtsecrets:server-certificate:file: ./server.cert

展開後のyaml

services:app1:configs:-source: my_configimage: awesome/webappnetworks:default:nullsecrets:-source: server-certificateapp2:configs:-source: my_configextends:service: app1image: awesome/databasenetworks:default:nullsecrets:-source: server-certificatenetworks:default:name: sample_defaultsecrets:server-certificate:name: sample_server-certificatefile: /home/nkagami/repository/sample/server.certconfigs:my_config:name: sample_my_configfile: /home/nkagami/repository/sample/my_config.txt

前提

Docker Compose V2 とは

Compose Specificationに準拠した新しいdocker composeコマンドです

大雑把に以下のような違いがあります

	v1	v2
形式	スタンドアロンバイナリ	docker cli plugin
実装	Python	Golang
Compose Spec	準拠していない	準拠している

https://qiita.com/tearoom6/items/b06118acb801bd918f35

Compose Spec とは

現在のComposeファイルの最新の仕様と考えて良さそうです

Compose仕様は、クラウドやプラットフォームに依存しないコンテナベースのアプリケーションを定義するための、開発者向けの標準仕様です。

https://www.compose-spec.io/

Compose Spec の実装はほかにも

具体的に何が変わったのか

気になったものをいくつか取り上げていきます。
仕様はすべてspec.mdにまとまっているので、詳しくはそちらを参照してください。

Composeファイルの名前^[2]

--fileオプションを指定せずにdocker-composeコマンドを実行したときに読み込まれるComposeファイルのデフォルトパスに違いがあります

# V1$docker-compose up# V2$docker compose up

V1

v1では作業ディレクトリに以下のファイルが存在すればそれが読み込まれます

docker-compose.yaml
docker-compose.yml

V2

一方v2では、基本的に作業ディレクトリにあるcompose.yamlを読み込みます
ただし、後方互換を維持するために、これまでと同じくdocker-compose.yamlも読み込んでくれます

compose.yaml
compose.yml
docker-compose.yaml（後方互換のためサポート）
docker-compose.yml（後方互換のためサポート）

両方のファイルが存在する場合、compose.yamlの方が優先される

.├── compose.yaml# ←こっちが優先される└── docker-compose.yaml

version^[3]

version:3.9# ←非推奨services:foo:image: busybox

Compose V1では、このversionの値を見てComposeファイルの検証が行われていました
Compose Specでは後方互換性のために仕様として定義されてはいるものの、このversionの値を見てComposeファイルの検証を行うべきではないとされており、Compose V2を使う限りにおいてはもはや不要な項目となっています

configs^[4]

設定ファイルのマウントを行うconfigsセクションが設定できるようになりました
configsは、コンテナ・ファイルシステムにマウントされるため、動きとしてはこれまでのマウントと同等です
（このように抽象化されてふつうのマウントと区別されることで、Compose Specに準拠したプラットフォームごとにconfigsを扱う方法を柔軟に変更できるというメリットが有るようです）

短い構文と長い構文の2種類の構文がサポートされています

short syntax

コンテナ内の/<config_name>に読み取り専用でマウントされます

services:redis:image: redis:latestconfigs:- my_configconfigs:my_config:file: ./my_config.txt

long syntax

services:redis:image: redis:latestconfigs:-source: my_configtarget: /redis_config# コンテナ内にマウントされるパスuid:"103"gid:"103"mode:0440# ファイルのパーミッションconfigs:my_config:file: ./my_config.txt

secrets^[5]

機密情報のマウントを想定したsecretsセクションが設定できます
プラットフォームの実装がconfigsと大きく異なる可能性があるため、専用のsecretsセクションとして分けられているようです
短い構文と長い構文の2種類の構文がサポートされています

short syntax

コンテナ内の/run/secrets/<secret_name>に読み取り専用でマウントされる

services:frontend:image: awesome/webappsecrets:- server-certificatesecrets:server-certificate:file: ./server.cert

long syntax

services:frontend:image: awesome/webappsecrets:-source: server-certificatetarget: server.cert# コンテナ内の/run/secrets/にマウントされるファイル名uid:"103"gid:"103"mode:0440# ファイルのパーミッションsecrets:server-certificate:file: ./server.cert

configsもそうですが、この辺はKubernetesのマニフェストファイルの書き方に近くなった気がします

extends^[6]

Composeファイルに定義された別のサービスを拡張し、オプションで設定を上書きするこができるextendsが利用出るようになりました
extendsをうまく活用することでスッキリとしたcompose.ymlを書くことができそうです

こういう`compose.yml`があるとき

services:common:image: busyboxsecurity_opt:- label:role:ROLEcli:extends:service: commonsecurity_opt:- label:user:USER

このように展開されます

# 余談ですが、v2からconfigコマンドはconvertコマンドに置き換わっています#（configはconvertのaliasとして設定されている）$docker compose convert

services:cli:extends:service: commonimage: busyboxnetworks:default:nullsecurity_opt:- label:role:ROLE- label:user:USERcommon:image: busyboxnetworks:default:nullsecurity_opt:- label:role:ROLEnetworks:default:name: sample_default

まとめ

Compose Specに準拠して実装されたDocker Compose V2によって新しく使えるようになったcompose.ymlの書き方を紹介してきました
V2には後方互換性があるため、既存のdocker-compose.ymlをわざわざ修正するほどのコストをかけるべきでは無いかもしれませんが、新しく作る場合はCompose Specに準拠した書き方にしていくのが良さそうです