エンジニア諸君、ようこそ。開発環境という名の「戦場」において、武器を研ぐことを怠る者は敗北する。
今日は、Java開発の聖域であるIntelliJ IDEAと、現代のインフラの標準であるDockerを、単に「連携させる」というレベルを超えて、「一つの生命体のように同期させる」ためのアーキテクチャを伝授しよう。
多くの初心者は、Dockerを「コマンドで起動するだけの隔離環境」と捉える。だが、それはあまりにも勿体ない。IntelliJとDockerを融合させれば、ローカルのOSを一切汚さず、本番環境と寸分違わぬ挙動をIDEのGUI上で完全に掌握できるのだ。
—
1. なぜ「IDE×Docker」の融合が必要なのか？
開発環境がPCのローカル環境に依存する（いわゆる「環境依存バグ」）という事態は、現代の開発現場では「罪」に近い。
IntelliJ IDEAのDockerプラグインを使う最大のメリットは、「コンテナ内のJavaプロセスを、ローカルのIDEでそのままデバッグできる」という点にある。IDEのブレークポイントで止まり、変数を覗き込み、ステップ実行を行う。これがコンテナ内で動くアプリケーションに対してシームレスに行える。
これにより、「動いたコードをコンテナに積んだ途端に動かなくなる」という絶望的なデバッグ作業から解放されるのだ。
—
2. 魂のセットアップ：IntelliJとDockerの架け橋
まずは、IntelliJにDockerの「眼」を授ける。
1. プラグインの確認: `Settings` > `Plugins` から「Docker」を検索し、有効化する。
2. 接続の確立: `Settings` > `Build, Execution, Deployment` > `Docker` を開く。
- ここで `Docker Desktop` を選べば、IntelliJは自動的にローカルのDocker Engineと通信を開始する。
- 画面下部の「Services」タブにDockerアイコンが現れたら成功だ。ここが、君の新しい司令塔となる。
—
3. HelloWorldを超える：デバッグ可能なJavaコンテナ構成
単なるコンテナ起動ではなく、「デバッグ接続を待機するJavaプロセス」をコンテナ内で立ち上げるのがコツだ。
以下は、`Dockerfile` と `docker-compose.yml` の構成案だ。
Dockerfile (コンテナの設計図)
軽量で高速なEclipse Temurinを採用
FROM eclipse-temurin:17-jdk-jammy
コンテナ内の作業ディレクトリ
WORKDIR /app
デバッグポートを公開（5005番）
EXPOSE 8080 5005
コンテナ起動時にデバッグモードを有効にする設定
address= はあらゆるIPからの接続を許可する設定
CMD [“java”, “-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=:5005”, “-jar”, “app.jar”]
docker-compose.yml (コンテナの指揮官)
version: ‘3.8’
services:
java-app:
build: .
ports:
- “8080:8080” # Webアクセス用
- “5005:5005” # IntelliJからのデバッグ接続用
volumes:
- ./target:/app # ローカルのビルド成果物をマウントして即時反映
—
4. デバッグフローの極意：IDEからの介入
ここからが本題だ。IntelliJで「リモートデバッグ」の設定を行う。
1. 構成作成: `Run/Debug Configurations` > `+` > `Remote JVM Debug` を選択。
2. 設定値:
- Host: `localhost`
- Port: `5005`
- Command line arguments: `-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=:5005`
3. 実行:
- まず `docker-compose up` でコンテナを立ち上げる。
- IntelliJのデバッグボタン（虫アイコン）を押す。
これだけで、君がIDEで書いたコードと、コンテナ内で動いているJavaプロセスが、メモリ空間を超えて繋がる。コードを修正し、リビルドしてコンテナにマウントすれば、ホットスワップ（動的なクラス置換）すら可能になる。
—
5. 最後に：なぜこの構成なのか
初心者は往々にして、「とりあえず動く」設定を求める。しかし、プロは「再生産可能な開発体験」を求める。
この環境構築の真の利益は、「PCを買い替えても、OSをクリーンインストールしても、数分で同じ開発環境が再現できる」ことにある。ローカルにはJavaをインストールする必要すらない。IntelliJとDockerさえあれば、君の脳内のコードは、どこでも同じように動く。
この環境をマスターすれば、開発スピードはこれまでの数倍に跳ね上がるだろう。さあ、今すぐコンテナを立ち上げ、IDEのデバッガを接続してくれ。その瞬間、君は「環境」という足枷から解放された開発者になれるはずだ。
何か詰まったら、いつでも聞きに来るといい。道は常に、コードの中に拓かれている。