quartz-research-note/content/Mastodonのアップデートでいちいちdocker-compose.ymlを一時的に書き換えない.md

#tips #self-hosted #mastodon

普通、dockerで運用するときはMastodonのリポジトリをクローンしてきて、docker-compose.ymlのbuildをコメントアウトすることで、リポジトリからコンテナイメージをpullするように変える。

ただこの場合、バージョンアップデートの際にgit stash && git fetch && git checkout <version> するとこんな感じにconflictが発生する。(ここでは4.2６から4.2.5にダウングレードしてる)

  web:
<<<<<<< Updated upstream
    build: .
    image: ghcr.io/mastodon/mastodon:v4.2.5
=======
    # build: .
    image: ghcr.io/mastodon/mastodon:v4.2.6
>>>>>>> Stashed changes
    restart: always

そこで、docker-compose.ymlとは別にdocker-compose.override.ymlというのを置いておくと、特定のキーを上書きしてくれる。

Merge Compose files | Docker Docs

最近まで、この上書き機能では特定のエントリをコメントアウトするような操作はできなかったが、docker-compose v2.18.0以降で!resetというのを置いておくとできるようになった。

docker-compose.override.yml で 打ち消し定義 ができるようになった。

そこでsudo apt-get upgrade docker-compose-pluginをやった上でこんなdocker-compose.override.ymlを作る。

web:
	image: ghcr.io/mastodon/mastodon:latest
	build: !reset
	#depends_on: #必要に応じて
	#	- es
streaming
	image: ghcr.io/mastodon/mastodon:latest
	build: !reset
sidekiq
	image: ghcr.io/mastodon/mastodon:latest
	build: !reset

（実際のファイルではpostgresの設定とかでもうちょっといろんなエントリが入っている。）

こうすれば、大概のマイナーな更新時はdocker compose pull&& docker compose down && docker compose up -d1つでよくなる。(compose自体に更新が入ったり、.env.productionとかに変更があったり、rake:db migrateする必要がある場合もあるので、基本はリリースノートを読んでから、必要に応じてgit pullすること！)

（そもそもきちんとリポジトリをmergeで更新していく運用の方がいいのかもしれないが）

注意点として、ハイフン付きのdocker-composeコマンドはv1コンパチで動くので!resetが効かずパースエラーになる。もう実質deprecatedになるのでサブコマンドのdocker composeで使うこと！（これに気づかず30分ぐらいハマった）