Contents
Spring BootアプリのDockerデプロイの基礎と重要性
Spring BootアプリケーションをDockerでデプロイするには、なぜそれが有効なのかを理解することが大切です。Dockerは環境差異や依存関係の管理に悩まされることなく、一貫した開発から本番への移行を可能にするため、DevOpsエンジニアやアプリケーションデプロイ担当者にとって不可欠なツールとなっています。
なぜDockerでSpring Bootをデプロイするのか
Dockerは「開発環境と本番環境の不一致」に苦しむ開発者の悩みを解決します。JavaベースのSpring Bootアプリケーションでは、ライブラリバージョンや依存関係がローカルとサーバーで異なることで、起動失敗や動作不具合が生じるケースが多く見られます。Dockerはこれらの問題をコンテナ内に閉じ込めることで、開発から本番までの環境の一致を保証します。
また、Dockerイメージは軽量化可能で、マルチステージビルドにより不要なファイルや依存関係を削除できるため、イメージサイズの削減と高速な起動が実現されます。
Dockerによる開発・本番環境の一貫性
Spring Bootアプリケーションの場合、ローカル開発環境で動作するものの、本番では異なる設定や依存関係が必要になることが頻繁にあります。Dockerはこれらの差異を抽象化し、コンテナ内での一貫した実行環境を作成することで、手動の設定変更やエラーの再現を防ぎます。
具体的には、以下のような利点があります：
- 開発環境で作成したイメージをそのまま本番に流用可能
- 複数コンテナ連携を容易に実装できるDocker Composeの活用
- セキュアな環境変数管理とプロファイル切り替えのサポート
ローカル開発環境構築と必要なツールの導入
Spring BootアプリケーションをDockerでデプロイするには、ローカル環境にDockerエンジンとSpring Boot CLIをインストールしておく必要があります。ここでは、Java開発者向けに具体的な手順を解説します。
Docker Desktopのインストール手順
- 公式サイトからDocker Desktopをダウンロード
- Windowsユーザーはhttps://www.docker.com/products/docker-desktop、macOSユーザーはDocker Hubで入手可能です。
- インストーラーを実行してDockerエンジンを起動
- インストール後、ターミナルで
docker --versionを入力し、インストールが成功しているか確認します。
重要：Docker Desktopは最新版を使用することを推奨します。古いバージョンではマルチステージビルドやセキュリティ設定に不備がある可能性があります。
Spring Boot CLIの導入方法
Spring Boot CLIは、コマンドラインからSpring Bootプロジェクトを素早く作成できるツールです。インストール手順は以下の通りです：
- 公式サイトからバージョンを確認
- https://spring.io/tools/cli にアクセスし、OSごとのパッケージを選択します。
- パッケージのダウンロードとインストール
- Linuxの場合：
sudo apt install spring-boot-cli（リポジトリ登録が必要な場合あり）。 - macOS / Windows：ZIPファイルをダウンロードし、PATHに追加します。
- コマンド確認
- ターミナルで
spring --versionを実行し、インストールが成功しているか確認します。
例：
spring init myapp --dependencies web,data-jpaコマンドでプロジェクトを一括生成可能です。
Spring Bootプロジェクトの初期設定
Spring Bootプロジェクトの作成には、公式ツールであるSpring Initializr（https://start.spring.io/）が最適です。
- 必要なライブラリを選択
- WebやJPAなど、アプリケーションに必要なライブラリをチェックします。
- プロジェクトを作成し、ローカルにダウンロード
- ZIPファイルを展開し、IDE（IntelliJ IDEA、VS Codeなど）で読み込みます。
例：
mvn clean packageコマンドでビルドすると、target/your-app.jarが生成され、Dockerイメージ作成に使用します。
Dockerfileの作成とマルチステージビルドの最適化
Spring Bootアプリケーションを効率的にDocker化するには、マルチステージビルド（Multi-Stage Build）による画像サイズの削減が不可欠です。ここでは、Dockerfileの基本構造と最適化手法を解説します。
マルチステージビルドの仕組みと効果
マルチステージビルドは、1つのDockerfile内で複数のベースイメージを使用し、不要なファイルや依存関係を排除する技術です。これにより、以下のようなメリットがあります：
- イメージサイズの大幅削減（例：50MB未満に圧縮）
- セキュリティリスクの低減（開発環境用ツールは本番に含めない）
- ビルドプロセスの効率化（レイヤーキャッシュを活用した再利用）
Dockerfileの例（マルチステージ）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# 第一段階: Mavenでのビルド FROM maven:3.8.6 AS builder WORKDIR /app COPY pom.xml . RUN mvn dependency:resolve COPY src ./src RUN mvn package -Pprod # 第二段階: 最小限のベースイメージで実行 FROM openjdk:17-jre-slim WORKDIR /app COPY --from=builder /app/target/*.jar app.jar ENTRYPOINT ["java", "-jar", "app.jar"] |
レイヤーキャッシュの活用：
mvn packageは一度だけ実行し、再ビルド時にキャッシュを活用することで効率が向上します。ステージごとに変更箇所が明確なため、不要な再ビルドが避けられます。
本番用イメージサイズ削減の実践
| 対策 | 説明 | 結果 |
|---|---|---|
| openjdk:17-jre-slimを使用 | 最小限のベースイメージでアプリケーションを動作させる | イメージサイズが50MB未満に縮小 |
| COPY --from=builder | 依存関係やビルドツールは開発環境に限定して保持 | 不要なファイルが本番イメージに含まれない |
ポイント：マルチステージビルドでは、開発環境で使用する
mavenやgradleを本番に含めないことで、セキュリティリスクとサイズの両方に配慮できます。
Docker Composeによる複数コンテナ設定の実践
Spring Bootアプリケーションが外部サービス（データベースやキャッシュ）に依存する場合、Docker Composeで複数コンテナを連携させる必要があります。ここではPostgreSQLとの連携例を解説します。
データベース連携時のネットワーク構成
Docker Composeはコンテナ間の通信を自動的に管理しますが、ネットワーク設定に注意が必要です。
-
docker-compose.ymlの基本構造
yaml
version: '3.8'
services:
app:
build: .
ports:
- "8080:8080"
depends_on:
- dbdb:
image: postgres:15
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: pass
POSTGRES_DB: mydb
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
注意点：
depends_onはコンテナの起動順序を保証するだけで、データベースが準備完了しているとは限らないため、アプリケーション側で接続エラーのハンドリングが必要です。
サービス依存関係の管理
| サービス | 説明 | 推奨設定 |
|---|---|---|
| app | Spring Bootアプリケーション | depends_onでデータベースの起動を待機 |
| db | PostgreSQLコンテナ | バックアップ用ボリュームを使用 |
トラブルシューティングのコツ：
docker-compose logs -f appでリアルタイムログを確認し、接続エラーの原因を特定します。
環境変数管理とプロファイル切り替え手法
Spring Bootアプリケーションでは、開発環境と本番環境で異なる設定（DB接続情報やセキュリティ設定など）が必要なケースが多く、その管理がデプロイのポイントとなります。ここでは、environment variablesとSpring Cloud Configを使った実践方法を解説します。
.envファイルの活用
.envファイルを使用することで、環境変数を一括で管理し、Docker Composeに渡すことができます。
- 例：
.envファイル
env
SPRING_PROFILES_ACTIVE=prod
DB_URL=jdbc:postgresql://db:5432/mydb
DB_USER=user
DB_PASSWORD=pass
注意点：本番環境では
.envファイルをリポジトリにコミットしないようにし、セキュリティリスクを防ぎます。
Spring Cloud Configとの連携
Spring Cloud Configは、外部の設定サーバーから環境変数を読み込む仕組みです。これにより、複数環境での管理が容易になります。
- 設定ファイルを作成（
application-prod.ymlなど） - Docker ComposeでConfig Serverコンテナを追加
yaml
services:
config-server:
image: springcloudconfigserver
ports:
- "8888:8888"
environment:
SPRING_APPLICATION_NAME: config-server
SERVER_PORT: 8888
重要：
springcloudconfigserverは非公式イメージの可能性があるため、公式リポジトリ（例:spring-cloud-config-server）を使用するか、カスタムビルドが必要です。
デプロイ後のトラブルシューティングとモニタリング
DockerでSpring Bootアプリケーションをデプロイした後も、起動失敗やパフォーマンス低下などの問題が発生する可能性があります。ここでは、具体的な調査手順とログ確認方法を解説します。
ログ確認のコマンド一覧
| コマンド | 説明 | 例 |
|---|---|---|
docker logs <コンテナID> |
実行中のアプリケーションログを表示 | docker logs my-spring-boot-app |
docker inspect <コンテナID> |
コンテナの設定やステータス情報を確認 | docker inspect my-spring-boot-app |
docker ps -a |
全てのコンテナの状態を一覧表示 | 起動失敗したコンテナが含まれる |
トラブルシューティングの手順：
- ログでエラー内容を確認 →
docker logsを使用して起動時のエラーメッセージを特定します。 - コンテナのステータスを調査 →
docker inspectでポート設定や環境変数が正しく適用されているかをチェックします。
コンテナステータスの監視方法
| ツール | 説明 | 利点 |
|---|---|---|
| Prometheus + Grafana | コンテナのメトリクス（CPU使用率、メモリ消費量など）を可視化 | 実時間でのパフォーマンス監視が可能 |
| ELK Stack | ログを集約・分析し、異常検知に活用 | 大規模なシステムでも安定した運用が可能 |
本番環境では、監視ツールの自動化とアラーム設定を推奨します。
まとめ
- DockerはSpring Bootアプリケーションを一貫してデプロイするための不可欠な技術です。
- マルチステージビルドやDocker Composeを使うことで、開発から本番までの環境差異を最小限に抑えられます。
- 環境変数管理とセキュリティ設定は本番デプロイ時に特に重要で、適切なツール選びが求められます。
記事で解説したDockerfileテンプレートをダウンロードし、自社アプリケーションへの適用を試してください。