docker-compose.ymlは起動時に複数指定すると差分を上書き適用できる

docker-syncを使う環境と使わない環境2つ用意する場合は、docker-compose.ymlにはdocker-syncなしの設定を定義し、docker-compose.with-docker-sync.ymlのような別ファイルにdocker-sync用の差分だけを定義することでダブルメンテを避けつつ異なる環境を用意できる。

version: "3"
services:
  web:
    volumes:
      - web-native-osx-sync:/app:nocopy
volumes:
  web-native-osx-sync:
    external: true

docker-syncを使わない環境

$ docker-compose up

docker-syncを使う環境

$ docker-sync start
$ docker-compose　-f docker-compose.yml -f　docker-compose.with-docker-sync.yml　up

困っていたこと

普段MacでDocker Desktopを使って開発してるんですが、そのままだとファイルの同期にかなり時間がかかるのでdocker-syncを使っています。
ただチームにはWindowsを使って開発しているメンバーもいて、そのメンバーは同期の遅さに苦しんでいない、かつ安定性を重視してdocker-syncを使っていません。

これまではほぼ同じ構成のファイルを2つ用意して、docker-sync用にvolumesのところだけ書き換えて使っていました。
docker-compose.ymlに変更を加えるときにはdocker-compose.with-docker-sync.ymlにも同じ変更を適用して…とめちゃめちゃダブルメンテでたまに変更漏れが起こったりしていました。

docker-sync使わないメンバー

$ docker-compose up

docker-compose.ymlを参照して起動

docker-sync使うメンバー

$ docker-sync start
$ docker-compose　-f　docker-compose.with-docker-sync.yml　up

docker-sync.ymlの設定にしたがってdocker-compose.with-docker-sync.ymlを使って起動

解決策

ダブルメンテどうにかしたいな〜と思ってDocker Composeのドキュメントを眺めていたら、どうやら複数ファイルを起動時に指定することで差分を上書き適用してくれるということを知りました。

サービスの定義が両方のファイルに存在した場合、Compose は 設定の追加と上書き に示すルールに従って定義設定をマージします。

version: "3"
services:
  web:
    volumes:
      - web-native-osx-sync:/app:nocopy
volumes:
  web-native-osx-sync:
    external: true

$ docker-sync start
$ docker-compose　-f docker-compose.yml -f　docker-compose.with-docker-sync.yml　up

version: "2"

options:
  compose-file-path: ['docker-compose.yml', 'docker-compose.with-docker-sync.yml']  
syncs:
  web-native-osx-sync:
    src: './app'

$ docker-sync-stack start