エンジニアを目指す初学者に向けて、わかりやすく解説したブログです。

Docker Composeによるローカル環境構築をやめた理由5選

概要

データベース、API、フロントエンドサーバーという標準的な三層アーキテクチャの構成のアプリケーションにおいて
Docker Composeを使って一発でローカル環境構築ができるようにしていたが、それをやめた理由を紹介する。

前提

  • チーム開発である
  • このデータベース、API、フロントエンドサーバーは他のシステムと連携を想定しておらず独立している
  • 本番環境はAWSやPaaSなど利用している
  • データベースは対象外であり、Docker Composeをやめた対象はAPIとフロントエンドサーバーである

結論

  1. デバッガーの設定が煩雑になるため
  2. 本番環境で設定が活かせないため
  3. ホットリロードの設定が煩雑なため
  4. Dockerのネットワーク設定の知識が必要なため
  5. 重い、遅い

1. 本番環境で設定が活かせないため

1番大きな理由はこれである。

まず、Docker Composeを用いて本番環境を運用することは稀である。

AWSを例に取ると、1つのDockerfileを使って1つのECSにデプロイすることがほとんどである。

つまり
Docker Composeをいくら頑張って作ったとしても、本番環境でその設定を活かすことができない

後述するコストがかかるにも関わらず、
本番環境の運用や品質に何も貢献することがないので、無駄だと判断した。

※本番環境でDocker Composeを使う構成は可能だが、無停止リリース作業が複雑になるなど他の問題があるのであまり実用的ではない。

2. デバッガーの設定が複雑になるため

普通にローカル環境で立ち上げたアプリケーションと、ローカル環境にDockerコンテナを使って立ち上げたアプリケーションでは
デバッガーの設定に関して複雑さが全く異なる

ローカル環境で npm run devして起動するようなアプリケーションでは
複雑な設定は不要でVSCodeからブレークポイントを貼ることができる。
(せいぜい拡張機能のインストールくらい)

一方で、コンテナ内で起動しているアプリケーションにブレークポイントを貼るためには

  • アプリケーション実行時にデバッグ用のポートも設定する
  • VSCode側の設定でそのデバッグ用ポートにつなぐ設定を行う

という新たな追加手順が必要になる。

「ローカル開発時にブレークポイントを貼る」という作業は
全エンジニアが開発時にやりたい作業だと思うが、それに対して追加の手間が必要になるわけである。

3. ホットリロードの設定が複雑になるため

Dockerコンテナの前提として「コンテナ上で動いているコードは、ローカルPCにあるコードのコピー」である。

つまり、何も設定しない状態では
ローカルのコードを修正してもDockerコンテナで動いているアプリケーションには反映されない

これによって、ホットリロードを行うためにはどちらかの工夫が必要になる。

  1. ソースコードを丸ごとVolumeとしてDockerコンテナと共有する
  2. Docker Compose Watchの機能を用いてコンテナとローカルPCのコードを共有する

ただし、それぞれ以下のような課題がある。

  1. もともとVolumeはデータの永続化が目的であるため、その目的にそぐわない
  2. 「何を共有して、何を共有しないか」という細かな設定が必要→適当にやると不要なリロードが発生し重い

4. Dockerのネットワーク設定の知識が必要なため

Docker Composeでは

  • コンテナ同士の通信
  • コンテナとホストマシンの通信

を行うためには、専用の設定が必要である。

ローカルで npm run devして立ち上げたアプリケーションには、 localhostで大体接続可能であるが
Docker Composeを使っている場合はそうはいかない。

コンテナ同士の通信を行うためには、 Docker Compose.yml に公開ポートの明記が必要であり、
コンテナからホストマシンへ接続する場合は host.docker.internalを用いて接続する必要がある。

5. 重い、遅い

普通にアプリケーションを立ち上げることと比較して
Dockerイメージのダウンロードやコンテナの起動などが発生するため、処理が重くなることは当然である。

開発中に必ずPCのファンの音が聞こえる状態である。

例外:データベース

上記の理由が適用されるのはアプリケーションに関してであり、
データベースに関してはDocker単体もしくはDocker Composeを使っている。

理由は以下の通りだ。

  • データベースはローカル環境構築に手間がかかる
  • 複数プロジェクトを並行で進めても、データベースの管理が煩雑にならない
  • データのクリーンアップが楽に行える

プログラミング言語のバージョン管理ツールを扱うのが面倒な人へ

とはいえ、
「Dockerコンテナを使うとpyenv、nvm、rbenv、sdkmanなどの環境構築や、
それを使ったバージョン切り替えをわざわざ行わなくていいので、それが嬉しいんだ!」という人もいると思う。

そんな人は Icon in a page linkHome | mise-en-place を使ってみてはいかがだろうか。

まとめ

Docker Composeは複数コンテナをまとめて取り扱える素晴らしい技術であるが、
ローカル環境構築のために利用するには、費用対効果が見合っていないと感じた。