Contents
Consul Docker Compose 使い方：実践ガイドで環境構築をマスターしよう
Consul Docker Compose 使い方について悩んでいませんか？本記事では、Docker ComposeでConsulを構成する手順とベストプラクティスをステップバイステップで解説します。実際にサンプルコードを活用した環境構築の流れを確認することで、開発・運用の効率化に直結する知識が得られます。
Docker ComposeとConsulの概要
サービス発見と構成管理の役割
Consulはサービス発見や構成管理を行うツールで、マイクロサービスアーキテクチャにおいて非常に重要です。コンテナが起動時に自動的に他のサービスを検出・登録できれば、運用負担が大きく減ります。
なぜDocker ComposeでConsulを扱うのか
Docker Composeは複数のコンテナを一括で管理できるため、Consulを簡単に起動・設定可能です。これにより、開発環境やステージング環境の構築がスピーディーになります。
docker-compose.ymlの基本構造
docker-compose.ymlの適切な記述は、Consulとの連携に不可欠です。以下にサービス定義とネットワーク設定のポイントを整理します。
サービス定義のポイント
Docker ComposeでConsulを起動する際には、環境に応じた設定が重要です。 特に本番環境では開発用コマンドconsul agent -devを使用しないことが推奨されます。
- サービス名：一意かつ意味を持つ名前（例:
consul-server） - イメージ：公式イメージを指定（例:
hashicorp/consul） - ポート設定：Consulが提供するAPIやクライアント通信に必要なポートを開く
以下は基本的なサービス定義の例です。
|
1 2 3 4 5 6 7 8 |
version: '3.8' services: consul-server: image: hashicorp/consul container_name: consul-server ports: - "8500:8500" |
ネットワークとボリュームの設定
ネットワークは、サービス間通信を安定させるために重要です。Dockerデフォルトネットワークではなく、独自のブリッジネットワークを作成することをお勧めします。
| 項目 | 値 | 補足 |
|---|---|---|
| ネットワークモード | bridge |
デフォルト設定。外部通信を制限可能 |
| ボリュームマウント | /consul/data |
サービスの永続化に必要 |
サービス登録設定方法
Consulエージェントを使ってサービスを登録するには、以下のような手順が必要です。
Consulエージェントの初期化
まずはコンテナ内でConsulエージェントを起動します。consul agent -devコマンドは開発環境専用であり、本番環境では使用不可です。本番環境ではconsul agentを複数ノードでクラスタ構成する必要があります。
|
1 2 |
docker exec consul-server consul agent -dev |
サービス登録の実装手順
サービス登録は、Consul APIにHTTPリクエストを送信することで行えます。以下はサービス登録の例です。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "service": { "name": "example-service", "tags": ["primary"], "port": 8080, "check": { "http": "http://localhost:8080/health", "interval": "10s" } } } |
このコードをPOSTリクエストでhttp://localhost:8500/v1/agent/service/registerに送信することで、サービスが登録されます。
注意：
localhost:8080/healthはコンテナ内でのみ有効です。外部サービスに対しては、Docker Composeのネットワーク設定に依存するサービス名（例:http://example-service:8080/health）を使用してください。
健康チェックのカスタマイズ
Consulの健康チェックはデフォルトでは一定間隔で行われますが、必要に応じてパラメータを調整できます。
デフォルト設定と変更点
- interval: チェック実行間隔（デフォルト: 10秒）
- timeout: リクエストタイムアウト（デフォルト: 5秒）
以下はカスタムチェックの例です。
|
1 2 3 4 5 6 7 8 |
{ "check": { "http": "http://example-service:8080/health", "interval": "30s", "timeout": "15s" } } |
カスタムヘルスチェッカーの例
独自の健康チェックロジックを実装するには、サービス自身にエンドポイントを設置し、ConsulがそのURLにアクセスして応答を確認します。
ネットワーク設定の注意点
Docker Composeでネットワークを構成する際は、以下の点に注意が必要です。
Dockerデフォルトネットワークとの違い
- デフォルトネットワーク：簡単だがセキュリティリスクあり
- 独自ネットワーク：通信経路の制御が可能で、運用向き
以下はネットワーク設定の比較表です。
| 項目 | デフォルトネットワーク | 独自ネットワーク |
|---|---|---|
| セキュリティ | 低 | 高 |
| 設定柔軟性 | 低 | 高 |
セキュリティ境界の設定
コンテナ間通信を安全にするには、ファイアウォールルールやACL（アクセス制御リスト）を有効にします。Docker Composeではnetworksセクションでネットワークを指定できます。
コンテナ間通信のベストプラクティス
Consulを通じたコンテナ間通信は、動的な環境適応が可能です。
サービスディスカバリーの活用
サービス名をホスト名として使用することで、IPアドレスの変化に自動対応できます。以下は例です。
|
1 2 |
curl http://example-service:8080/health |
VIPによる負荷分散
ConsulはVIP（仮想IP）を使ってサービスのロードバランシングを自動実施します。これにより、スケーリングが容易になります。具体的な実装方法としては、consul service registerコマンドでVIPを指定するか、サービス定義にvipフィールドを追加します。
|
1 2 3 4 5 6 7 8 |
{ "service": { "name": "example-service", "port": 8080, "vip": "192.168.1.100" } } |
docker-compose.ymlのセキュリティ設定
ポートマッピングのリスク
docker-compose.ymlでポートを公開する際、開発環境特有のlocalhost:8500のようなポートマッピングは本番環境では避けるべきです。 セキュリティリスクを軽減するために、以下の対策が推奨されます。
- 外部アクセス制限: ポートマッピングを
127.0.0.1:8500などに限定し、インターネット経由でのアクセスを防ぐ - リバースプロキシ利用: NginxやTraefikなどを用いてConsulのAPIアクセスを制御
- ACL設定: Consulの認証・認可機能を活用したアクセス制限
まとめ
- docker-compose.ymlの構成でConsulを起動・設定可能
- サービス登録と健康チェックはJSON API経由で行える
- ネットワーク設定に注意し、セキュリティリスクを軽減する
- VIP利用でコンテナ間通信の負荷分散が実現可能
記事内のサンプルコードを基に環境構築を試してみましょう。実践的な手順を理解することで、DevOpsワークフローの効率化が期待できます。