Enterprise Distributed Application Service:IntelliJ IDEA から Kubernetes クラスターへのアプリケーションデプロイ

ステップ 1：Alibaba Cloud Toolkit のインストール

1. IntelliJ IDEA を起動します。

2. プラグインの設定を開きます。

   • macOS の場合：IntelliJ IDEA ＞ Preferences ＞ Plugins を選択します。

   • Windows の場合：File ＞ Settings ＞ Plugins を選択します。

3. 検索ボックスに Alibaba Cloud Toolkit を入力し、検索アイコンをクリックします。

4. Install をクリックします。

   

   

5. IntelliJ IDEA を再起動します。再起動後、ツールバーに Alibaba Cloud Toolkit アイコン が表示されます。

すでにプラグインがインストール済みの場合は、同じ Plugins 設定ページから最新バージョンへアップグレードしてください。

ステップ 2：Alibaba Cloud アカウントの構成

プラグインがお客様の代わりに EDAS へアクセスできるよう、AccessKey ペアを設定します。

1. IntelliJ IDEA で、Tools ＞ Alibaba Cloud ＞ Preferences を選択します。

2. 左側のナビゲーションウィンドウで、Alibaba Cloud Toolkit ＞ Accounts を選択します。

3. Access Key ID および Access Key Secret を入力し、OK をクリックします。

   

AccessKey ペアの取得方法：

• Alibaba Cloud アカウントをお持ちの場合、Accounts ページで 既存の AK/SK を取得 をクリックします。ログイン後、AccessKey 管理ページから AccessKey ID および AccessKey Secret を取得してください。

• アカウントをお持ちでない場合は、Sign up をクリックして新規作成し、その後 AccessKey ペアを取得してください。

EDAS サービスが Apsara Stack Enterprise 上で実行されている場合は、続行する前にエンドポイントを構成してください。「Apsara Stack Enterprise 向けエンドポイントの構成」をご参照ください。

ステップ 3：アプリケーションのデプロイ

1. IntelliJ IDEA で、Tools ＞ Alibaba Cloud ＞ Deploy to EDAS ＞ EDAS for Kubernetes Application を選択します。あるいは、Run ＞ Edit Configurations を選択します。Run/Debug configurations ダイアログボックスで、Templates ＞ EDAS on Alibaba Cloud ＞ EDAS for Kubernetes Application を選択します。

2. Deploy to EDAS ダイアログボックスの Settings タブで、以下のパラメーターを設定します。

   重要

   アプリケーションが一覧に表示されない場合は、「EDAS 用 RAM ユーザーの権限付与」をご参照ください。

   パラメーター	説明
   リージョン	アプリケーションがデプロイされるリージョンです。
   Namespace	アプリケーションがデプロイされるマイクロサービス namespace です。
   アプリケーション	アプリケーションの名称です。

   

3. デプロイ方法を選択します。

   方法	説明
   Maven Build	デプロイメントパッケージを作成する Maven ビルドジョブを追加します。マルチモジュールプロジェクトの場合は、「マルチモジュールプロジェクトのデプロイ」をご参照ください。
   Upload File	WAR または JAR パッケージをアップロードしてデプロイします。
   Build Image	Dockerfile からコンテナイメージをビルドします。Context Directory、Dockerfile のパス、およびイメージの Version を設定します。
   Select Image	Select Image のドロップダウンリストから既存のコンテナイメージを選択してデプロイします。

   

4. （任意）Advanced タブをクリックして、追加のデプロイパラメーターを構成します。全パラメーターの詳細については、DeployK8sApplication API リファレンスをご参照ください。

   • アプリケーション環境：実行環境を設定します。デプロイごとに新しい PackageVersion を指定します。

   • 起動コマンド：コンテナ起動時に実行するコマンドおよび引数を指定します。

   • [環境]: アプリケーションの環境変数を定義します。

   • 永続化ストレージ：永続ストレージボリュームを構成します。

   • ローカル記憶域：ローカル記憶域を構成します。

   • アプリケーション管理：ライフサイクルフックおよびヘルスプローブを設定します。

     設定項目	説明
     Poststart	コンテナライフサイクルフックの 1 つで、コンテナ作成後にトリガーされます。ハンドラが失敗した場合、コンテナは停止され、再起動ポリシーに基づいて再起動が行われます。
     PreStop	コンテナライフサイクルフックの 1 つで、コンテナ削除前にトリガーされます。ハンドラは、削除リクエストが Docker デーモンに到達する前に実行されます。デーモンはハンドラの結果に関係なく SIGTERM 信号を送信します。
     Liveness	ヘルスプローブの 1 つで、アプリケーションの健全性をチェックします。不健全と判定された場合、Kubernetes はコンテナを削除し、再作成します。
     Readiness	ヘルスプローブの 1 つで、アプリケーションが正常に起動し、期待通りに実行中であるかをチェックします。アプリケーションが期待通りに動作しない場合、コンテナのステータスが更新されます。

   

5. Apply をクリックし、次に Run をクリックします。IntelliJ IDEA の Console タブでデプロイログを確認し、結果を検証します。

マルチモジュールプロジェクトのデプロイ

Maven マルチモジュールプロジェクトでは、Before launch セクション内の最後の Maven ジョブが、デプロイ対象のサブモジュールをビルドする必要があります。

例：CarShop プロジェクトには以下の構造があります。

carshop
├── itemcenter-api
├── itemcenter
├── detail

itemcenter および detail は、ともに itemcenter-api に依存しています。itemcenter サブモジュールをデプロイするには、Before launch セクションに以下の 2 つの Maven ジョブを追加します。

1. 親プロジェクト CarShop で mvn clean install を実行します。

2. mvn clean package を itemcenter サブモジュールで実行します。

Maven ビルドジョブの管理

Deploy to EDAS ダイアログボックスの Before launch セクションでは、Maven ビルドジョブの作成、削除、変更、並べ替えが可能です。

Select Maven Goal ダイアログボックスで、Working directory フィールド横のフォルダアイコンをクリックしてモジュールを選択し、Command line フィールドにビルドコマンドを入力します。

EDAS 用 RAM ユーザーの権限付与

RAM ユーザーがデプロイ一覧にアプリケーションを表示できない場合、そのユーザーは EDAS へ同期されていないか、必要な権限が付与されていません。以下のいずれかの方法でアクセス権限を付与してください。

Apsara Stack Enterprise 向けエンドポイントの構成

EDAS サービスが Apsara Stack Enterprise 上で実行されている場合、デプロイ前に Alibaba Cloud Toolkit でエンドポイントを構成する必要があります。エンドポイント値については、EDAS テクニカルサポートまでお問い合わせください。

1. Preference (Filtered) ダイアログボックスで、Appearance & Behavior ＞ Endpoint を選択します。

2. エンドポイント値を入力し、Apply and Close をクリックします。