Docker Composeで実現！本番環境級の開発環境構築ガイド

Docker Composeで実現する、本番環境に近い開発環境構築術

「ローカル環境でウェブアプリケーションを動かす」というのは、単にdocker runを何回も叩く作業で終わることが多くなりました。しかし、実際のアプリケーションは、Webサーバー、データベース、キャッシュストアなど、複数のサービスが連携して動作することが一般的です。

この複数のサービスを、毎回の手動コマンドで立ち上げるのは非常に手間がかかり、再現性も低くなりがちです。ここで強力な出番となるのが、Docker Composeです。

本記事では、単に「Docker Composeとは何か」という説明にとどまらず、実際に多層的なアプリケーション（例えば、Webアプリケーション、PostgreSQLデータベース、Redisキャッシュを連携させる構成）を、どのようにdocker-compose.ymlという一つのファイルで管理し、実践的に運用するかを解説します。

そもそも、Docker Composeが解決することとは？

Docker Composeは、複数のコンテナを一つにまとめて、ネットワークやボリューム、環境変数といった複雑な設定を一元的に記述・管理するためのツールです。YAMLファイルに定義したサービス群を、docker-compose upという単一のコマンドで起動し、連携させるのが最大の利点です。

これが実現できる仕組みの核心は、単なるコンテナの集合ではなく、「サービスとしての依存関係」を定義できる点にあります。

実践例：Web API + DB + Cacheの構築

今回は、ユーザー認証を行うシンプルなWeb APIを想定し、以下の3つのサービスで構成される環境を立ち上げてみます。

  • web_api: アプリケーション本体（Pythonなど）
  • db: データベース（PostgreSQL）
  • cache: キャッシュストア（Redis）

Step 1: docker-compose.ymlの設計

全ての設定は、docker-compose.ymlファイルに記述します。このファイルこそが、開発環境の「設計図」となります。

docker-compose.yml: version: '3.8' services: web_api: build: . ports: - "8000:8000" depends_on: - db - cache environment: DATABASE_URL: postgres://user:password@db:5432/appdb REDIS_HOST: cache db: image: postgres:14 environment: POSTGRES_USER: user POSTGRES_PASSWORD: password POSTGRES_DB: appdb volumes: - db_data:/var/lib/postgresql/data cache: image: redis:latest ports: - "6379:6379" volumes: db_data:

ポイント解説

  1. build: .: web_apiはカレントディレクトリ（.）にあるDockerfileを使ってイメージをビルドすることを指定しています。
  2. depends_on:: web_apiが起動する前に、dbとcacheが最低限起動していることを保証しています。
  3. environment:: アプリケーションに必要な環境変数を設定しています。ここでは、サービス名（例：dbやcache）をホスト名として利用できるのがDocker Composeの強力な点です。
  4. volumes:: データベースのデータ永続化（コンテナが消えてもデータが残るように）を実現しています。

Step 2: サービスの実行とライフサイクル管理

環境構築は、以下の単一コマンドで行えます。

docker-compose up -d

これは、全ての設定に基づき、必要なイメージのダウンロード、ネットワークの構築、コンテナの起動を自動で行います。`-d`はデタッチドモード（バックグラウンド）で実行するという意味です。

アプリケーションの実行状況を確認したい場合は、以下のコマンドが便利です。

docker-compose logs -f web_api

サービスを全て停止・削除する際は、必ずこのコマンドを使います。

docker-compose down

より実践的な応用テクニック

1. サービスの依存関係の明示 (Restart Policy)

もしdbサービスが一時的に利用不能になった場合、web_apiはエラーを吐き出し続けるかもしれません。サービス定義にrestart: alwaysを追加することで、コンテナが異常終了した場合に、Composeが自動で再起動を試みるように設定できます。

2. ポートマップの利用と調整

複数のサービスで同じポート番号を使いたい場合（例えば、ローカルのNginxとコンテナ内のNginx）、ポートを公開するportsの設定を工夫する必要があります。あるいは、特定のサービス（例：Web API）だけを外部に公開し、他のサービス（DBやCache）は内部通信専用にすることが重要です。

3. 開発専用のボリュームマウント

もしWeb APIのソースコード自体をローカルのPCからコンテナ内に反映させたい場合（開発時よくあるケース）は、ボリュームマウントを利用します。これにより、ローカルのコードを編集するだけで、コンテナ内のサービスが即座にその変更を読み込むことができます。

# web_api サービス部分に追記する例 web_api: # ... (省略) volumes: - ./src:/app/src - /app/logs:/var/log/app

まとめ

Docker Composeの真価は、「記述の簡潔さ」と「再現性の保証」にあります。本番環境と同じ構成を、docker-compose.ymlという単一の定義ファイルに落とし込むことで、開発チーム全体が「どの環境で何が動いているか」について迷うことがなくなり、開発効率と品質が格段に向上します。

まずは、自分が現在運用している最も複雑なローカル環境を、docker-compose.ymlファイルとして定義し直すことから試してみてはいかがでしょうか。

前の記事 次の記事

コメント

コメントを投稿

このブログの人気の投稿

モノレポ vs マルチレポ 徹底比較

モノレポ vs マルチレポ：開発の選択肢を徹底比較 モノレポ vs マルチレポ：開発の選択肢を徹底比較 ソフトウェア開発において、コードの管理方法には様々な選択肢がある。その中でも特に議論を呼んでいるのが「モノレポ（Monorepo）」と「マルチレポ（Multirepo）」の対比だ。それぞれのメリットとデメリットを理解し、プロジェクトに適した方法を選択することが重要となる。本記事では、その両方を比較検討し、より深く理解を深めていく。 モノレポ（Monorepo）とは？ モノレポとは、複数のプロジェクトやアプリケーションのコードを単一のレポジトリ（リポジトリ）に格納する開発手法である。従来の複数個のレポジトリを使い分ける代わりに、すべてのコードを一つの場所にまとめて管理する。これには、GitHub、GitLab、Bitbucket などのバージョン管理システムと組み合わせて使用されることが多い。 モノレポのメリット 依存性の管理が容易： 複数のプロジェクト間で共有されるライブラリや依存関係を、単一の場所で管理できるため、バージョン競合などの問題を軽減できる。 コードの再利用が促進される： 異なるプロジェクト間でコードを簡単に共有・再利用できるため、開発効率が向上する。 コードの可読性が向上する： プロジェクト全体を把握しやすくなるため、開発者間のコミュニケーションが円滑になる。 リファクタリングが容易： 複数のプロジェクトに関わるコードをまとめて変更できるため、大規模なリファクタリングが容易になる。 モノレポのデメリット レポジトリのサイズが肥大化しやすい： 複数のプロジェクトが同じレポジトリに格納されるため、レポジトリのサイズが大きくなり、clone や fetch などの操作に時間がかかることがある。 アクセス権限の管理が複雑になる： 複数のプロジェクトにアクセスする必要があるため、アクセス権限の設定が複雑になることがある。 開発環境の構築が難しい場合がある： 複数のプロジェクトを同時に...
続きを読む

KiCadでPCB作成入門

回路図からプリント基板を作るまで（KiCad 入門） 回路図からプリント基板を作るまで（KiCad 入門） 電子工作を始める上で、回路図からプリント基板（PCB）を作成することは重要なステップです。本記事では、KiCadというオープンソースの基板設計ソフトウェアを使って、そのプロセスを分かりやすく解説します。KiCadは使いやすく、無料で利用できるため、電子工作の初心者にもおすすめです。 KiCadとは？ KiCadは、基板設計に必要なツールを全て揃えた、統合された環境です。回路図作成、シミュレーション、PCBレイアウトなど、あらゆる工程をKiCad内で完結させることができます。また、Windows、macOS、Linuxに対応しており、お使いのOSに合わせて利用できます。 KiCadの主要な機能 KiCadには、以下の主要な機能があります。 回路図エディタ: 回路図を作成するためのソフトウェアです。部品の配置や接続線を簡単に行うことができます。 PCBレイアウトエディタ: 回路図に基づいて、PCBの形状や部品の配置を決定します。部品の配置、配線、シルク印刷などを行います。 シミュレータ: 回路の動作をシミュレーションし、設計の妥当性を確認できます。 基本的なワークフロー KiCadを使ったPCB作成の基本的なワークフローは以下の通りです。 回路図の作成: 回路図エディタを使って、回路図を作成します。部品を選定し、部品間の接続線を記述します。 PCBレイアウトの作成: PCBレイアウトエディタを使って、回路図に基づいてPCBの形状や部品の配置を決定します。部品の配置、配線、シルク印刷などを行います。 ドリルファイルの生成: PCB製造業者にPCBの製造を依頼する際に必要なドリルファイル（部品の穴のサイズや位置の情報）を生成します。 製造データの準備: PCB製造業者に送付するデータをまとめます。 製造依頼: 製造業者にPCBの製造を依頼します。 よくある質問 質問: 回路図から直接PCBレイアウトを作成できますか？ 回答: はい、KiCadでは回路図から直接PCBレイアウトを作成...
続きを読む

ESP32 Wi-Fi 接続ガイド

ESP32でWi-Fi通信を行う方法と注意点 ESP32でWi-Fi通信を行う方法と注意点 ESP32は、Wi-FiとBluetoothを内蔵しているため、IoT（Internet of Things）デバイスのプロトタイプ作成や、既存のデバイスをインターネットに接続するのに非常に適しています。本記事では、ESP32とWi-Fi通信を行う基本的な方法と、開発者が注意すべき点を解説します。 ESP32のWi-Fi機能概要 ESP32のWi-Fi機能は、IEEE 802.11 b/g/nに対応しています。これにより、様々なWi-Fiネットワークに接続し、データを送受信することができます。ESP32には、Wi-FiのSSID（ネットワーク名）やパスワードを設定するための機能、そしてWi-Fiネットワークへの接続状態を監視するための機能が備わっています。 Wi-Fi通信の基本的な流れ ESP32でWi-Fi通信を行う場合、以下のステップで進めていくのが一般的です。 Wi-Fiネットワークへの接続： ESP32をWi-Fiネットワークに接続します。これは、SSIDとパスワードを設定し、Wi-Fiネットワークに接続するプロセスです。 データの送受信： Wi-Fiネットワークに接続後、HTTP、TCP、UDPなどのプロトコルを使用してデータを送受信します。 データの解析と処理： 受信したデータを解析し、必要な処理を行います。 Wi-Fi接続の設定方法 ESP32のWi-Fi接続設定は、Arduino IDEを使用するのが一般的です。以下の手順で設定を行います。 Arduino IDEにESP32ボードを認識させます。 ESP32ボードのWi-Fi設定を行います。 `station.begin(ssid, password)` 関数を使用して、Wi-Fiネットワークに接続します。 ネットワーク接続状態を監視し、接続が確立されたことを確認します。 Wi-Fi通信における注意点 ESP32でWi-Fi通信を行う際には、以下の点に注意する必要があります。 セキュリティ： Wi-Fiネットワークはセキュリティで保護されていることを確認してください。 暗号化されて...
続きを読む