IntelliJ IDEA 2026.1 Help

チュートリアル:アプリケーションを minikube クラスターにデプロイする。

このチュートリアルでは、IntelliJ IDEA から直接 minikube を使ってローカル Kubernetes クラスターを起動し、サンプルアプリケーションをデプロイする方法を学ぶ。 このプロセスの一環として、アプリケーションをビルドし、Docker イメージを作成して、それを minikube にデプロイする。

Kubernetes をローカルで実行することは、プロトタイピング、デプロイのテスト、および Kubernetes のワークフローを学ぶのに特に便利。 IntelliJ IDEA の Docker と Kubernetes サポートを使えば、クラスターの起動、リソースのデプロイ、アプリケーションの確認などを IDE から簡単に行える。

始める前に

開始する前に、次のものがインストールおよび設定されていることを確認してください。

必要なプラグインを有効にする

このチュートリアルで使う機能は、次のプラグインに依存しています。

これらのプラグインはデフォルトで IntelliJ IDEA にバンドルおよび有効化されています。 関連する機能が利用できない場合は、プラグインが無効になっていないか確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. インストール済み タブを開き、必要なプラグインを見つけて、プラグイン名の横にあるチェックボックスを選択して有効にします。

サンプルプロジェクトのクローンを作成する

はじめに、 Spring PetClinic アプリケーションを GitHub からクローンするか、すでにマシンにある場合は IntelliJ IDEA でこのプロジェクトを開いてください。

アプリケーションのソースコードは、GitHub の https://github.com/spring-projects/spring-petclinic でホストされています。

  1. メインメニューで ファイル(F) | 新規(N) | バージョン管理からプロジェクト… へ移動します。

  2. リポジトリの URL を指定して、 クローン をクリックします。

  3. プロジェクトを開くまたはインポートする ダイアログで Gradle プロジェクト を選択し、このプロジェクトのメインビルドシステムとして Gradle を使用します。

  4. 必要に応じて、クローンプロジェクトを新しいウィンドウで開くことに同意します。

アプリケーションをビルドする

アプリケーションを Kubernetes にデプロイする前に、ビルドしてコンテナイメージにパッケージ化する必要があります。 このチュートリアルでは、Gradle タスクを使用してアプリケーションのソースコードをコンパイルし、テストを実行し、実行可能 JAR ファイルを作成します。 この JAR ファイルは後で Docker イメージ作成時に使われます。

  1. Gradle ツールウィンドウを開きます。

  2. プロジェクトノード( spring-petclinic )を展開し、次に タスク ノードを展開して、 ビルド タスクをダブルクリックして実行します。

    Gradle ツールウィンドウ

    IntelliJ IDEA がタスクを完了するのを待ちます。 その結果、IDE はプロジェクトルートに ビルド ディレクトリを作成し、アーティファクトを配置します。

    Gradle がビルドタスクを正常に完了しました。

アプリケーションをコンテナ化する

このステップでは、ビルドしたアプリケーションを Docker イメージにパッケージ化します。 Kubernetes は、このイメージを後で Pod 内のコンテナとして実行します。

Dockerfile を作成する

  1. プロジェクト ツールウィンドウ Alt+1 でプロジェクトルートを右クリックし、 新規 をポイントして ファイル をクリックします。

  2. 新規ファイル… ダイアログで、 Dockerfile と入力し、 Enter を押します。

  3. 次のコードを新しい Dockerfile に貼り付けます。

    FROM eclipse-temurin:17-jre WORKDIR /app COPY build/libs/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "app.jar"]

作成された Dockerfile には、 eclipse-temurin:17-jre イメージをベースにした Docker イメージのビルド手順が記述されています。このイメージは軽量な Java 17 ランタイム環境を提供します。

イメージをビルドすると、Docker は Gradle のビルドで作成された実行可能 JAR ファイルをプロジェクトの build/libs ディレクトリから、コンテナ内の /app ディレクトリにコピーします。

このイメージからコンテナを起動すると、Docker は java -jar app.jar コマンドを実行し、Spring Petclinic アプリケーションを起動します。

Dockerイメージをビルドする

  1. Dockerfile 内のガターで、 The Run on Docker icon をクリックし、 新しい実行構成 を選択します。

    エディターから新しい Dockerfile 実行/デバッグ構成を作成する
  2. 実行構成の編集 ダイアログで、 イメージタグ フィールドに petclinic-app を、 コンテナー名 フィールドに petclinic を指定します。 次に、 実行 をクリックします。

IntelliJ IDEA は Dockerfile実行構成 を作成します。これにより、Dockerfile からイメージをビルドし、そのイメージに基づいてコンテナーを実行します。 全体のプロセスを確認するには、 サービス ツールウィンドウの ログ タブを開きます。

サービスツールウィンドウのログタブを押す

minikube に接続する

アプリケーションを含む Docker イメージができたので、デプロイ先となるローカル Kubernetes クラスターを起動する必要があります。 minikube を使って、IntelliJ IDEA からローカルのシングルノード Kubernetes クラスターを実行します。

Docker ドライバーで minikube を開始する

  1. ターミナル ツールウィンドウを開き、 表示 | ツールウィンドウ | ターミナル に移動するか、 Alt+F12 を押します。

  2. 次のコマンドを実行してローカル Kubernetes クラスターを起動し、仮想化ドライバーとして Docker を利用するよう minikube に指示します。

    minikube start --driver=docker
  3. コマンドを使ってクラスターが正しく稼働していることを確認します。

    minikube status

Docker ドライバーを使用すると、minikube クラスターが Docker コンテナー内で実行され、ローカル開発に適した軽量な環境を提供します。

minikube クラスターを IntelliJ IDEA に追加する

  1. サービスツールウィンドウを開きます: 表示(V) | ツールウィンドウ(T) | サービス または Alt+8

  2. Kubernetes ノードを選択し、 クラスターの追加 ボタンをクリックして、コンテキストメニューから デフォルトディレクトリから を選択します。

    サービスツールウィンドウの Kubernetes ウェルカム画面から新しいクラスターを追加する
  3. コンテキストの追加 ダイアログで minikube を選択し、 コンテキストの追加 をクリックします。

    追加されたクラスターは サービス ツールウィンドウで利用できるようになります。

  4. サービス ツールウィンドウで minikube クラスターを右クリックし、 クラスターの接続 を選択します。

    minikube クラスターに接続する

この時点で、IntelliJ IDEA は実行中の minikube クラスターに接続され、Kubernetes リソースを表示できます。 サービス ツールウィンドウから、名前空間、ノード、その他のクラスターオブジェクトを直接調べることができます。

アプリケーションをデプロイする

このチュートリアルの前半で、アプリケーションイメージをローカルで ビルドしました。 ただし、minikube クラスターはローカルの Docker デーモンから自動的にイメージへアクセスできません。 イメージを minikube に読み込む必要があります。

Dockerイメージを minikube に読み込む

  1. ターミナル ツールウィンドウを開き、 表示 | ツールウィンドウ | ターミナル に移動するか、 Alt+F12 を押します。

  2. 次のコマンドを実行して、minikube 内でコンテナイメージをビルドします。

    minikube image load petclinic-app
  3. petclinic-app イメージがクラスターで利用可能であることを次のコマンドで確認してください。

    minikube image ls | grep petclinic-app

    出力に docker.io/library/petclinic-app:latest が表示されるはずです。

イメージが minikube で利用可能になったので、次は Kubernetes でどのように実行するかを定義します。 Kubernetes マニフェストを 2 つ作成しましょう。Deployment はコンテナを Pod で実行するためのもので、Service はアプリを外部からアクセス可能にします。

Deployment マニフェストを作成する

  1. プロジェクト ツールウィンドウ(Alt+1 )でプロジェクト名を右クリックし、 新規|Kubernetes リソース を選択します。

  2. 新規 Kubernetes リソース ダイアログで デプロイ ファイルタイプを選択し、 petclinic-deployment をマニフェスト名として指定し、 Enter を押します。

    新しいデプロイを作成する
  3. 生成された petclinic-deployment.yaml ファイルの内容を次のコードに置き換えます。

    apiVersion: apps/v1 kind: Deployment metadata: name: petclinic spec: replicas: 1 selector: matchLabels: app: petclinic template: metadata: labels: app: petclinic spec: containers: - name: petclinic image: petclinic-app:latest imagePullPolicy: IfNotPresent ports: - containerPort: 8080
  4. フローティングツールバーで現在のクラスターと名前空間を選択し、 Apply icon適用 をクリックしてローカルクラスターに変更を反映します。

    フローティングツールバーの適用ボタン

Service マニフェストを作成する

  1. プロジェクト ツールウィンドウ(Alt+1 )でプロジェクト名を右クリックし、 新規|Kubernetes リソース を選択します。

  2. 新規 Kubernetes リソース ダイアログで サービス ファイルタイプを選択し、 petclinic-service をマニフェスト名として指定し、 Enter を押します。

  3. 生成された petclinic-service.yaml ファイルの内容を次のコードに置き換えます。

    apiVersion: v1 kind: Service metadata: name: petclinic spec: type: NodePort selector: app: petclinic ports: - port: 8080 targetPort: 8080
  4. フローティングツールバーで現在のクラスターと名前空間を選択し、 Apply icon適用 をクリックしてローカルクラスターに変更を反映します。

アプリケーションにアクセスする

  1. エディターで petclinic-deployment.yaml ファイルを開きます。

  2. - containerPort: 8080 プロパティの隣にある ポートの転送 インレイヒントをクリックします。

    ポートフォワーディングインレイヒント
  3. ポートの転送 ダイアログで、デフォルト値のままにして 転送 をクリックします。

  4. petclinic-deployment.yaml ファイルで、 ブラウザーで開く インレイヒントをクリックします。

    サービスツールウィンドウで新しいポートフォワーディングセッションを開始

    IntelliJ IDEA はデフォルトのブラウザーへリダイレクトし、ローカル minikube クラスターにデプロイされた Spring Petclinic アプリケーションを確認できます。

minikube と IntelliJ IDEA を使って、Spring アプリケーションをローカルの Kubernetes クラスターにデプロイする方法を学びました。 この方法によって、リモートクラスターを用意しなくても、Kubernetes の素早いローカルテストや検証が可能です。

次のステップ

次のトピックで Kubernetes の活用方法を学ぶことができます。

利用可能なチュートリアルの一覧は、 IntelliJ IDEA チュートリアル を参照してください。

2026 年 3 月 30 日