クイック スタート: IntelliJ IDEA を使用して Azure Container Apps にデプロイする

この記事では、Azure Toolkit for IntelliJ IDEA を使用して、コンテナ化されたアプリケーションを Azure Container Apps にデプロイする方法について説明します。 この記事では、音楽アルバムの静的コレクションを返すサンプルのバックエンド Web API サービスを使用します。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
• サポートされている Java Development Kit (JDK)。 Azure での開発時に使用可能な JDK の詳細については、「Java の Azure および Azure Stack に関するサポート」 を参照してください。
• IntelliJ IDEA の Ultimate または Community エディション。
• Maven 3.5.0 以降。
• Docker クライアント。
• Azure Toolkit for IntelliJ。 詳細については、Azure Toolkit for IntelliJ のインストールに関するページをご覧ください。 また、Azure Toolkit for IntelliJ を利用するには、Azure アカウントにサインインする必要があります。 詳細については、「Azure Toolkit for IntelliJ のサインイン手順」をご覧ください。

プロジェクトの複製

1. 以下のコマンドを使用してサンプル アプリを複製し、IDE ブランチをチェックします。

   git clone https://github.com/Azure-Samples/containerapps-albumapi-java
   cd containerapps-albumapi-java
   git checkout IDE
   

2. [開く] を選択して、IntelliJ IDEA でプロジェクトを開きます。

プロジェクトをローカルで構築して実行する

1. 次のコマンドを使用して、Maven プロジェクトをビルドします。

   mvn clean package -DskipTests
   

2. アプリケーションが実行されていることを確認し、ブラウザーを開いて http://localhost:8080/albums に移動します。 このページでは、次のコマンド出力のような JSON オブジェクトの一覧が返されます。

   java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
   

Azure Container Registry にイメージをプッシュする

プロジェクトを Azure Container Apps にデプロイするには、まずコンテナー イメージをビルドし、Azure Container Registry にプッシュする必要があります。

1. Azure エクスプローラー ビューで、[Azure ノード] を展開して、[コンテナー レジストリ] を右クリックし、[Azure Portal で作成] を選択します。

2. コンテナー レジストリの作成ページで、次の情報を入力します。

   • [サブスクリプション]: コンテナー レジストリに使用する Azure サブスクリプションを指定します。
   • [リソース グループ]: コンテナー レジストリ用のリソース グループを指定します。 以下のオプションの 1 つを選択します。
     • [新規作成]: 新しいリソース グループを作成することを指定します。
     • [既存のものを使用]: Azure アカウントに関連付けられているリソース グループの一覧から選択する必要があることを指定します。
   • [レジストリ名]: 新しいコンテナー レジストリの名前を指定します。
   • [場所]: コンテナー レジストリを作成するリージョン (米国西部など) を指定します。
   • [SKU]: コンテナー レジストリのサービス階層を指定します。 このチュートリアルでは、[Basic]\(ベーシック\) を選択します。

3. [確認と作成] を選択し、情報が正しいことを確認します。 そのうえで [Create](作成) を選択します。

4. [プロジェクト] タブで、プロジェクトに移動し、Dockerfile を開きます。

5. Azure アイコンを選択し、[イメージを Azure Container Registry にプッシュ] を選択します。

6. 前の手順で作成したレジストリを選択し、以下の情報を入力して、[実行] を選択します。

   • [リポジトリ名]: リポジトリの名前を指定します。
   • [タグ名]: イメージまたはその他の成果物のバージョンを指定します。

   

環境とコンテナー アプリを作成する

次の手順を使用して、環境を設定し、コンテナー アプリを Azure にデプロイします。

1. Azure エクスプローラー ビューで [Container Apps 環境] を右クリックし、[Container Apps 環境の作成] を選択します。

2. Container Apps 環境の作成ページで、次の情報を入力し、[OK] を選択します。

   • [サブスクリプション]: 使用する適切な Azure サブスクリプションを指定します。
   • [リソース グループ]: コンテナー アプリ用のリソース グループを指定します。 以下のオプションの 1 つを選択します。
     • [新規作成]: 新しいリソース グループを作成することを指定します。
     • [既存のものを使用]: Azure アカウントに関連付けられているリソース グループの一覧から選択する必要があることを指定します。
   • [名前]: 新しいコンテナー アプリ環境の名前を指定します。
   • [リージョン]: 該当するリージョン (米国東部など) を指定します。
   • Log Analytics ワークスペース: 使用する Log Analytics ワークスペースを指定するか、既定値をそのまま使用します。

   

3. 作成したコンテナー アプリ環境を右クリックし、Azure エクスプローラーで [コンテナー >アプリの作成] を選択します。 次の情報を入力してください。

   • [サブスクリプション]: 使用する適切な Azure サブスクリプションを指定します。
   • [リソース グループ]: コンテナー アプリ用のリソース グループを指定します。 以下のオプションの 1 つを選択します。
     • [新規作成]: 新しいリソース グループを作成することを指定します。
     • [既存のものを使用]: Azure アカウントに関連付けられているリソース グループの一覧から選択する必要があることを指定します。
   • [名前]: 新しいコンテナー アプリの名前を指定します。
   • [リージョン]: 該当するリージョン (米国東部など) を指定します。
   • [環境]: 使用する Container Apps 環境を指定します。
   • [クイック スタート]: [クイック スタート イメージを使用する] を選択します。

   

4. [OK] を選択します。 アプリの作成に成功すると、ツールキットにステータス メッセージが表示されます。

コンテナー アプリをデプロイする

1. [プロジェクト] タブで、プロジェクトに移動し、Dockerfile を開きます。

   

2. Azure アイコンを選択し、[イメージをコンテナー アプリにデプロイする] を選択します。

   

3. イメージを Azure Container Apps にデプロイするページで、次の情報を入力し、[実行] を選択します。

   • Dockerfile/イメージ: Dockerfile のパスを指定するか、既定値をそのまま使用します。
   • コンテナー レジストリ: 使用するコンテナー レジストリを指定します。
   • リポジトリ名: コンテナー レジストリで使用するリポジトリ名を指定します。
   • タグ名: コンテナー レジストリで使用するタグ名を指定します。
   • コンテナー アプリ: デプロイするコンテナー アプリを指定します。
   • イングレス: HTTP または TCP エンドポイントを必要とするアプリケーションのイングレスを有効にします。 有効にするを選択します。
   • 外部トラフィック: HTTP または TCP エンドポイントを必要とするアプリケーションの外部トラフィックを有効にします。 有効にするを選択します。
   • ターゲット ポート: この値は、コンテナーで使うポート番号に設定します。 この手順でポート 8080 を開きます。

   

4. デプロイが完了すると、Azure Toolkit for IntelliJ に通知が表示されます。 [参照] を選択して、デプロイされたアプリをブラウザーで開いてください。

   

ブラウザーのアドレス バーで、アプリ URL の末尾に /albums パスを追加し、サンプル API 要求からデータを表示します。

リソースをクリーンアップする

Azure Container Apps リソースをクリーンアップして削除する場合は、リソースまたはリソース グループを削除できます。 リソース グループを削除すると、それに関連付けられている他のリソースも削除されます。 リソースをクリーンアップするには、以下の手順を使用します。

1. Azure Container Apps リソースを削除するには、Azure Explorer の左側のサイドバーに移動し、Container Apps 環境項目を見つけます。

2. 削除する Azure Container Apps サービスを右クリックし、[削除] を選択します。

3. リソース グループを削除するには、Azure ポータルにアクセスし、サブスクリプション下のリソースを手動で削除します。

次のステップ

• Azure Container Apps 上の Java の概要