クイックスタート: 初めてのアプリケーションを Azure Spring Apps にデプロイする

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• Git.
• Java Development Kit (JDK)、バージョン 17。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• Git.
• Java Development Kit (JDK)、バージョン 17。
• Azure Developer CLI (AZD)、バージョン 1.2.0 以降。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• ターゲット サブスクリプションで初めて Azure Spring Apps Enterprise プラン インスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• ターゲット サブスクリプションで初めて Azure Spring Apps Enterprise プラン インスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。
• Git.
• Java Development Kit (JDK)、バージョン 17。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• ターゲット サブスクリプションで初めて Azure Spring Apps Enterprise プラン インスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。
• Git.
• Java Development Kit (JDK)、バージョン 17。
• Azure CLI バージョン 2.45.0 以上。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• ターゲット サブスクリプションで初めて Azure Spring Apps Enterprise プラン インスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。
• Java Development Kit (JDK)、バージョン 17。
• IntelliJ IDEA。
• Azure Toolkit for IntelliJ。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
• ターゲット サブスクリプションで初めて Azure Spring Apps Enterprise プラン インスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。
• Java Development Kit (JDK)、バージョン 17。
• Visual Studio Code。

次のセクションの [Azure へのデプロイ] ボタンにより、GitHub の spring-cloud-azure-tools リリース ページから JAR パッケージをダウンロードする Azure portal のエクスペリエンスが起動されます。 ローカル側で必要な準備手順はありません。

次の手順を実行して、プロジェクトを準備します。

1. 次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプル プロジェクトをクローンします。

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. 次のコマンドを使用して、プロジェクト フォルダーに移動します。

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. 次のコマンドを使用して、サンプル プロジェクトをローカルで実行します。

   ./mvnw spring-boot:run
   

次の手順を使用して Azure Developer CLI テンプレートからアプリケーションを初期化します。

1. ターミナルを開き、空のフォルダーを作成して、ディレクトリをそこに変更します。

2. 次のコマンドを実行して、以下のプロジェクトを初期化します:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   次の一覧に、コマンド対話を記載します。

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
   • [Please enter a new environment name] (新しい環境名を入力してください): 環境名を指定します。これは、すべての Azure リソースを保持するために作成されたリソース グループのサフィックスとして使用されます。 この名前は、Azure サブスクリプション内で一意である必要があります。

   コンソールから、次の例のようなメッセージが出力されます。

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   Enter a new environment name: <your-env-name>
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

このセクションでは、[Azure へのデプロイ] ボタンを使用して、Azure portal でデプロイ エクスペリエンスを起動します。 このエクスペリエンスでは、ARM テンプレートを使用して Azure リソースを作成します。

3.1. Azure portal にサインインする

Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure リソースを作成する

次の手順を使用して、アプリが依存するすべての Azure リソースを作成します。

1. 次の [Azure へのデプロイ] ボタンを選択して、Azure portal でデプロイ エクスペリエンスを起動します。

   

2. [基本] タブでフォームに入力します。次の表を参考にして、フォームに入力します。

   設定	提案された値	説明
   [サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   リソース グループ	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   リージョン	ユーザーに最も近いリージョン。	このリージョンは、リソース グループの作成に使用されます。

3. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択してアプリを Azure Spring Apps にデプロイします。

4. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。 [Go to resource] (リソースに移動) を選択して、サービスの [概要] ページを開きます。

   

3.1. Azure portal にサインインする

Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure Spring Apps インスタンスを作成する

次の手順を使用して、Azure Spring Apps サービス インスタンスを作成します。

1. Azure portal の隅にある [リソースの作成] を選択します。

2. [Compute]>[Azure Spring Apps] を選択します。

3. [基本情報] フォームに次の情報を入力します。

   次の表を参考にして、フォームに入力します。 推奨プランは Standard consumption & dedicated (preview) です。

   設定	提案された値	説明
   サブスクリプション	お使いのサブスクリプション名	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   Resource group	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   名前	myasa	Azure Spring Apps サービスを識別する一意の名前。 名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。 サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
   プラン	Standard consumption & dedicated (プレビュー)	価格プランによって、インスタンスに関連付けられるリソースとコストが決まります。
   リージョン	ユーザーに最も近いリージョン	ユーザーに最も近い場所。
   Container Apps 環境	myacaenv	環境とは、相互に通信し、仮想ネットワーク、ログ、Dapr 構成を共有できる 1 つ以上のコンテナー アプリを囲む、セキュリティで保護された境界です。

4. (省略可能) Container Apps 環境を作成します。

   • 従量課金ワークロード
   • 専用ワークロード

   1. [基本] タブに次の情報を入力します。

      • 環境名: myacaenv
      • プラン: 従量課金
      • ゾーン冗長: 無効

   2. [作成] を選んで、Container Apps 環境を作成します。

5. Review and Create(確認と作成) を選択して、選択内容を確認します。 [作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。

6. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。

   

7. [リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

次の手順を使用して、必要なリソースを作成します。

1. 次のコマンドを使用して、OAuth 2 で Azure CLI にサインインします。 既にサインインしている場合は、この手順を無視してください。

   azd auth login
   

   コンソールから、次の例のようなメッセージが出力されます。

   Logged in to Azure.
   

2. 次のコマンドを使って、テンプレートのインフラストラクチャを Azure にプロビジョニングします。

   azd provision
   

   次の一覧に、コマンド対話を記載します。

   • [使用する Azure サブスクリプションを選択してください]: 矢印を使用して移動し、入力してフィルター処理し、Enter キーを押します。
   • [使用する Azure の場所を選択してください]: 矢印を使用して移動し、入力してフィルター処理し、Enter キーを押します。

   コンソールから、次の例のようなメッセージが出力されます。

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Note

   これは、完了するまでに時間がかかる場合があります。 Azure リソースがプロビジョニングされると、進行状況インジケーターが表示されます。

前のセクションの [Azure へのデプロイ] ボタンにより、アプリケーションのデプロイを含む Azure portal エクスペリエンスが起動されるため、他に何も必要ありません。

次の手順に従って、Azure Spring Apps 用の Maven プラグインを使用してデプロイします。

1. complete ディレクトリに移動し、次のコマンドを使用して Azure Spring Apps のアプリを構成します。

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   次の一覧に、コマンド対話を記載します。

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
   • Select subscription (サブスクリプションを選択してください): 作成した Azure Spring Apps インスタンスのサブスクリプション リスト番号を選択します。既定では、リストの最初のサブスクリプションに設定されます。 既定の番号を使用する場合は、Enter キーを直接押します。
   • Azure で既存の Azure Spring Apps を使う: 既存の Azure Spring Apps インスタンスを使うには、y キーを押します。
   • Select Azure Spring Apps for deployment (デプロイ用の Azure Spring Apps を選択してください): 作成した Azure Spring Apps インスタンスのリスト番号を選択します。 既定の番号を使用する場合は、Enter キーを直接押します。
   • [Use existing app in Azure Spring Apps <your-instance-name>] (Azure Spring Apps で既存のアプリを使用する): n キーを押して、新しいアプリを作成します。
   • [Input the app name (demo)] (アプリ名 (デモ) を入力する): アプリ名を指定します。 既定のプロジェクト成果物 ID を使用する場合は、直接 Enter キーを押します。
   • [Expose public access for this app (boot-for-azure)] (このアプリ (boot-for-azure) のパブリック アクセスを公開する): y を押します。
   • 上記のすべての構成の保存を確定する: y キーを押します。 n を押した場合、構成は POM ファイルに保存されません。

2. 次のコマンドを使用して、アプリをデプロイします。

   ./mvnw azure-spring-apps:deploy
   

   次の一覧に、コマンド対話を記載します:

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。

   コマンドが実行されると、デプロイが成功したことを示す次のログ メッセージが表示されます。

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
   

次の手順を使用して、アプリをパッケージ化し、Web アプリケーションに必要な Azure リソースをプロビジョニングしてから、Azure Spring Apps にデプロイします。

1. 次のコマンドを実行して、アプリケーションのデプロイ可能なコピーをパッケージ化します:

   azd package
   

   コンソールから、次の例のようなメッセージが出力されます。

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. 次のコマンドを実行して、新しくプロビジョニングされたリソースにアプリケーション コードをデプロイします:

   azd deploy
   

   コンソールから、次の例のようなメッセージが出力されます。

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

次のセクションの [Azure へのデプロイ] ボタンにより、GitHub の spring-cloud-azure-tools リリース ページから JAR パッケージをダウンロードする Azure portal のエクスペリエンスが起動されます。 ローカル側で必要な準備手順はありません。

次の手順を実行して、プロジェクトを準備します。

1. 次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプル プロジェクトをクローンします。

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. 次のコマンドを使用して、プロジェクト フォルダーに移動します。

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. 次のコマンドを使用して、サンプル プロジェクトをローカルで実行します。

   ./mvnw spring-boot:run
   

次の手順を使用して Azure Developer CLI テンプレートからアプリケーションを初期化します。

1. ターミナルを開き、空のフォルダーを作成して、ディレクトリをそこに変更します。

2. 次のコマンドを実行して、以下のプロジェクトを初期化します:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   次の一覧に、コマンド対話を記載します。

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
   • [Please enter a new environment name] (新しい環境名を入力してください): 環境名を指定します。これは、すべての Azure リソースを保持するために作成されたリソース グループのサフィックスとして使用されます。 この名前は、Azure サブスクリプション内で一意である必要があります。

   コンソールから、次の例のようなメッセージが出力されます。

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   Enter a new environment name: <your-env-name>
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

このセクションでは、[Azure へのデプロイ] ボタンを使用して、Azure portal でデプロイ エクスペリエンスを起動します。 このエクスペリエンスでは、ARM テンプレートを使用して Azure リソースを作成します。

3.1. Azure portal にサインインする

Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure リソースを作成する

次の手順を使用して、アプリが依存するすべての Azure リソースを作成します。

1. 次の [Azure へのデプロイ] ボタンを選択して、Azure portal でデプロイ エクスペリエンスを起動します。

   

2. [基本] タブでフォームに入力します。次の表を参考にして、フォームに入力します。

   設定	提案された値	説明
   [サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   リソース グループ	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   リージョン	ユーザーに最も近いリージョン。	このリージョンは、リソース グループの作成に使用されます。

3. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択してアプリを Azure Spring Apps にデプロイします。

4. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。 [Go to resource] (リソースに移動) を選択して、サービスの [概要] ページを開きます。

   

3.1. Azure portal にサインインする

Web ブラウザーを開き、Azure portal に移動します。 資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure Spring Apps インスタンスを作成する

次の手順を使用して、サービス インスタンスを作成します。

1. Azure portal の隅にある [リソースの作成] を選択します。

2. [Compute]>[Azure Spring Apps] を選択します。

3. [基本] フォームに以下の情報を入力します。

   設定	推奨値	説明
   サブスクリプション	お使いのサブスクリプション名	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   Resource group	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   名前	myasa	Azure Spring Apps サービスを識別する一意の名前。 名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。 サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
   プラン	Standard	価格プラン。これによって、インスタンスに関連付けられるリソースとコストが決まります。
   リージョン	ユーザーに最も近いリージョン	ユーザーに最も近い場所。
   ゾーン冗長	未選択	Azure 可用性ゾーンに Azure Spring Apps サービスを作成するかどうかを示します。 この機能は、現在、すべてのリージョンでサポートされているわけではありません。

4. Review and Create(確認と作成) を選択して、選択内容を確認します。 [作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。

5. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。

   

6. [リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

次の手順を使用して、必要なリソースを作成します。

1. 次のコマンドを使用して、OAuth 2 で Azure CLI にサインインします。 既にサインインしている場合は、この手順を無視してください。

   azd auth login
   

   コンソールから、次の例のようなメッセージが出力されます。

   Logged in to Azure.
   

2. 次のコマンドを使用して、Standard プランを使用してテンプレートを設定します。

   azd env set PLAN standard
   

3. 次のコマンドを使用して、アプリケーションのデプロイ可能なコピーをパッケージ化し、テンプレートのインフラストラクチャを Azure にプロビジョニングし、新しくプロビジョニングされたリソースにアプリケーション コードをデプロイします。

   azd provision
   

   次の一覧に、コマンド対話を記載します。

   • [使用する Azure サブスクリプションを選択してください]: 矢印を使用して移動し、入力してフィルター処理し、Enter キーを押します。
   • [使用する Azure の場所を選択してください]: 矢印を使用して移動し、入力してフィルター処理し、Enter キーを押します。

   コンソールに、次の例のようなメッセージが出力されます。

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Note

   これは、完了するまでに時間がかかる場合があります。 Azure リソースがプロビジョニングされると、進行状況インジケーターが表示されます。

前のセクションの [Azure へのデプロイ] ボタンにより、アプリケーションのデプロイを含む Azure portal エクスペリエンスが起動されるため、他に何も必要ありません。

次の手順に従って、Azure Spring Apps 用の Maven プラグインを使用してデプロイします。

1. complete ディレクトリに移動し、次のコマンドを使用して Azure Spring Apps のアプリを構成します。

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   次の一覧に、コマンド対話を記載します。

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
   • Select subscription (サブスクリプションを選択してください): 作成した Azure Spring Apps インスタンスのサブスクリプション リスト番号を選択します。既定では、リストの最初のサブスクリプションに設定されます。 既定の番号を使用する場合は、Enter キーを直接押します。
   • Azure で既存の Azure Spring Apps を使う: 既存の Azure Spring Apps インスタンスを使うには、y キーを押します。
   • Select Azure Spring Apps for deployment (デプロイ用の Azure Spring Apps を選択してください): 作成した Azure Spring Apps インスタンスのリスト番号を選択します。 既定の番号を使用する場合は、Enter キーを直接押します。
   • [Use existing app in Azure Spring Apps <your-instance-name>] (Azure Spring Apps で既存のアプリを使用する): n キーを押して、新しいアプリを作成します。
   • [Input the app name (demo)] (アプリ名 (デモ) を入力する): アプリ名を指定します。 既定のプロジェクト成果物 ID を使用する場合は、直接 Enter キーを押します。
   • [Expose public access for this app (boot-for-azure)] (このアプリ (boot-for-azure) のパブリック アクセスを公開する): y を押します。
   • 上記のすべての構成の保存を確定する: y キーを押します。 n を押した場合、構成は POM ファイルに保存されません。

2. 次のコマンドを使用して、アプリをデプロイします。

   ./mvnw azure-spring-apps:deploy
   

   次の一覧に、コマンド対話を記載します:

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。

   コマンドが実行されると、デプロイが成功したことを示す次のログ メッセージが表示されます。

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
   [INFO]   InstanceName:demo-default-x-xxxxxxxxx-xxxxx  Status:Terminating Reason:null       DiscoverStatus:UNREGISTERED
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

次の手順を使用して、アプリをパッケージ化し、Web アプリケーションに必要な Azure リソースをプロビジョニングしてから、Azure Spring Apps にデプロイします。

1. 次のコマンドを実行して、アプリケーションのデプロイ可能なコピーをパッケージ化します:

   azd package
   

   コンソールから、次の例のようなメッセージが出力されます。

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. 次のコマンドを実行して、新しくプロビジョニングされたリソースにアプリケーション コードをデプロイします:

   azd deploy
   

   コンソールに、次の例のようなメッセージが出力されます。

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

次のセクションの [Azure へのデプロイ] ボタンにより、GitHub の spring-cloud-azure-tools リリース ページから JAR パッケージをダウンロードする Azure portal のエクスペリエンスが起動されます。 ローカル側で必要な準備手順はありません。

次の手順を実行して、プロジェクトを準備します。

1. 次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプル プロジェクトをクローンします。

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. 次のコマンドを使用して、プロジェクト フォルダーに移動します。

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. 次のコマンドを使用して、サンプル プロジェクトをローカルで実行します。

   ./mvnw spring-boot:run
   

次の手順を実行して、プロジェクトを準備します。

1. 次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプル プロジェクトをクローンします。

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. 次のコマンドを使用して、プロジェクト フォルダーに移動します。

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. 次のコマンドを使用して、サンプル プロジェクトをローカルで実行します。

   ./mvnw spring-boot:run
   

プロジェクトを作成するには、次の手順に従います。

1. 次のコマンドを使用して、Azure Spring Apps に対して推奨される依存関係があるサンプル プロジェクトを start.spring.io から生成します。

   curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -
   

2. 次の内容を含むファイル src/main/java/com/example/demo/HelloController.java を追加して、Web アプリケーション用の Web コントローラーを作成します。

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Hello World";
        }
   }
   

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

   ./mvnw clean package
   

4. 次のコマンドを使用して、サンプル プロジェクトをローカルで実行します。

   ./mvnw spring-boot:run
   

Spring プロジェクトを準備するには、「Java on Azure Spring Apps」の「Before you begin」セクションの手順に従います。

このセクションでは、[Azure へのデプロイ] ボタンを使用して、Azure portal でデプロイ エクスペリエンスを起動します。 このエクスペリエンスでは、ARM テンプレートを使用して Azure リソースを作成します。

3.1. Azure portal にサインインする

Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure リソースを作成する

次の手順を使用して、アプリが依存するすべての Azure リソースを作成します。

1. 次の [Azure へのデプロイ] ボタンを選択して、Azure portal でデプロイ エクスペリエンスを起動します。

   

2. [基本] タブでフォームに入力します。次の表を参考にして、フォームに入力します。

   設定	提案された値	説明
   [サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   リソース グループ	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   リージョン	ユーザーに最も近いリージョン。	このリージョンは、リソース グループの作成に使用されます。

3. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択してアプリを Azure Spring Apps にデプロイします。

4. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。 [Go to resource] (リソースに移動) を選択して、サービスの [概要] ページを開きます。

   

3.1. Azure portal にサインインする

Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure Spring Apps インスタンスを作成する

次の手順を使用して、サービス インスタンスを作成します。

1. Azure portal の隅にある [リソースの作成] を選択します。

2. [Compute]>[Azure Spring Apps] を選択します。

3. [基本] フォームに以下の情報を入力します。

   設定	提案された値	説明
   [サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   リソース グループ	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   名前	myasa	Azure Spring Apps サービスを識別する一意の名前。 名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。 サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
   リージョン	ユーザーに最も近いリージョン。	ユーザーに最も近い場所。
   ホスティング オプションとプラン	Enterprise	価格プラン。これによって、インスタンスに関連付けられるリソースとコストが決まります。
   ゾーン冗長	未選択	Azure 可用性ゾーンに Azure Spring Apps サービスを作成するオプション。 この機能は、現在、すべてのリージョンでサポートされているわけではありません。
   ソフトウェア IP プラン	従量課金制	Azure Spring Apps の従量課金制の料金プラン。
   サンプル プロジェクトのデプロイ	未選択	組み込みのサンプル アプリケーションを使うオプション。

4. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。

5. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。

   

6. [リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

3.1. 各リソースの名前を指定する

次のコマンドを使用して、リソースを保持する変数を作成します。 プレースホルダーは必ず、独自の値で置き換えてください。

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. 新しいリソース グループを作成する

次の手順を使用して、新しいリソース グループを作成します。

1. 次のコマンドを使用して、Azure CLI にサインインします。

   az login
   

2. 次のコマンドを使用して、既定の場所を設定します。

   az configure --defaults location=${LOCATION}
   

3. 次のコマンドを使用して、使用可能なすべてのサブスクリプションを一覧表示し、使用するサブスクリプション ID を決定します。

   az account list --output table
   

4. 次のコマンドを使用して、既定のサブスクリプションを設定します。

   az account set --subscription <subscription-ID>
   

5. 次のコマンドを使用して、リソース グループを作成します。

   az group create --resource-group ${RESOURCE_GROUP}
   

6. 次のコマンドを使用して、新しく作成したリソース グループを既定のリソース グループとして設定します。

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. 拡張機能のインストールと名前空間の登録

次のコマンドを使用して、Azure CLI 用の Azure Spring Apps 拡張機能をインストールし、名前空間 Microsoft.SaaS を登録します。

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Azure Spring Apps インスタンスを作成する

次の手順を使用して、サービス インスタンスを作成します。

1. 次のコマンドを使用して、Enterprise プランの法律条項とプライバシー ステートメントに同意します。

   Note

   この手順は、サブスクリプションが Azure Spring Apps の Enterprise プラン インスタンスの作成に使用されたことがない場合にのみ必要です。

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. 次のコマンドを使用して、Azure Spring Apps サービス インスタンスを作成します。

   az spring create \
       --name ${SERVICE_NAME} \
       --sku Enterprise
   

3.5. Azure Spring Apps インスタンスでアプリを作成します。

"アプリ" は、1 つのビジネス アプリを抽象化したものです。 詳しくは、「Azure Spring Apps のアプリとデプロイ」を参照してください。 次の図に示すように、アプリは Azure Spring Apps サービス インスタンスで実行されます。

次のコマンドを使用して、Azure Spring Apps にアプリを作成します。

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

3.1. Azure portal にサインインする

Web ブラウザーを開き、Azure portal に移動し、資格情報を入力してポータルにサインインします。 既定のビューはサービス ダッシュボードです。

3.2. Azure Spring Apps インスタンスを作成する

次の手順を使用して、サービス インスタンスを作成します。

1. Azure portal の隅にある [リソースの作成] を選択します。

2. [Compute]>[Azure Spring Apps] を選択します。

3. [基本] フォームに以下の情報を入力します。

   設定	提案された値	説明
   [サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。 複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
   リソース グループ	myresourcegroup	新しいリソース グループ名、またはサブスクリプションの既存のリソース グループ名。
   名前	myasa	Azure Spring Apps サービスを識別する一意の名前。 名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。 サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
   リージョン	ユーザーに最も近いリージョン。	ユーザーに最も近い場所。
   ホスティング オプションとプラン	Enterprise	価格プラン。これによって、インスタンスに関連付けられるリソースとコストが決まります。
   ゾーン冗長	未選択	Azure 可用性ゾーンに Azure Spring Apps サービスを作成するオプション。 この機能は、現在、すべてのリージョンでサポートされているわけではありません。
   ソフトウェア IP プラン	従量課金制	Azure Spring Apps の従量課金制の料金プラン。
   サンプル プロジェクトのデプロイ	未選択	組み込みのサンプル アプリケーションを使うオプション。

4. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。

5. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。

   

6. [リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

Azure Spring Apps インスタンスを作成するには、「Java on Azure Spring Apps」の「Create an app on Azure Spring Apps」セクションの手順に従います。

前のセクションの [Azure へのデプロイ] ボタンにより、アプリケーションのデプロイを含む Azure portal エクスペリエンスが起動されるため、他に何も必要ありません。

次の手順に従って、Azure Spring Apps 用の Maven プラグインを使用してデプロイします。

1. complete ディレクトリに移動し、次のコマンドを使用して Azure Spring Apps のアプリを構成します。

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   次の一覧に、コマンド対話を記載します。

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
   • Select subscription (サブスクリプションを選択してください): 作成した Azure Spring Apps インスタンスのサブスクリプション リスト番号を選択します。既定では、リストの最初のサブスクリプションに設定されます。 既定の番号を使用する場合は、Enter キーを直接押します。
   • Azure で既存の Azure Spring Apps を使う: 既存の Azure Spring Apps インスタンスを使うには、y キーを押します。
   • Select Azure Spring Apps for deployment (デプロイ用の Azure Spring Apps を選択してください): 作成した Azure Spring Apps インスタンスのリスト番号を選択します。 既定の番号を使用する場合は、Enter キーを直接押します。
   • [Use existing app in Azure Spring Apps <your-instance-name>] (Azure Spring Apps で既存のアプリを使用する): n キーを押して、新しいアプリを作成します。
   • [Input the app name (demo)] (アプリ名 (デモ) を入力する): アプリ名を指定します。 既定のプロジェクト成果物 ID を使用する場合は、直接 Enter キーを押します。
   • [Expose public access for this app (boot-for-azure)] (このアプリ (boot-for-azure) のパブリック アクセスを公開する): y を押します。
   • 上記のすべての構成の保存を確定する: y キーを押します。 n を押した場合、構成は POM ファイルに保存されません。

2. 次のコマンドを使用して、アプリをデプロイします。

   ./mvnw azure-spring-apps:deploy
   

   次の一覧に、コマンド対話を記載します:

   • OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。

   コマンドが実行されると、デプロイが成功したことを示す次のログ メッセージが表示されます。

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

次のコマンドを使用して、アプリの .jar ファイルをデプロイします。

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

アプリケーションのデプロイには数分かかることがあります。

このセクションでは、Azure Spring Apps にアプリケーションをデプロイする手順について説明します。

4.1. プロジェクトをインポートする

次の手順に従って、プロジェクトをインポートします。

1. IntelliJ IDEA を開き、[開く] を選択します。

2. [Open File or Project](ファイルまたはプロジェクトを開く) ダイアログ ボックスで、demo フォルダーを選択します。

   

4.2. アプリをビルドし、デプロイする

次の手順に従って、アプリをビルドしてデプロイします。

1. Azure Toolkit for IntelliJ をまだインストールしていない場合は、「Azure Toolkit for IntelliJ をインストールする」の手順に従います。

   Note

   Azure Toolkit for IntelliJ には、Azure にログインするための 4 つの方法が用意されており、デプロイはログイン後にのみ開始できます。

2. IntelliJ の [Project](プロジェクト) ウィンドウで対象のプロジェクトを右クリックし、[Azure] ->[Deploy to Azure Spring Apps](Azure Spring Apps にデプロイ) を選択します。

   

3. [Name](名前) フィールドのアプリの名前はそのまま使用します。 [Name](名前) は、アプリ名ではなく構成を参照します。 通常、これを変更する必要はありません。

4. [成果物] テキストボックスで、Maven:demo(Java 17) を選択します。

5. [Subscription](サブスクリプション) テキスト ボックスで、自分のサブスクリプションが正しいことを確認します。

6. [Spring Apps] テキスト ボックスで、作成した Azure Spring Apps インスタンスを選択します。

7. [App](アプリ) テキスト ボックスで、プラス記号 (+) を選択して、新しいアプリを作成します。

   

8. [App Basics](アプリの基本情報) にある [アプリ名:] テキストボックスに「demo」と入力して、[その他の設定] を選択します。

9. [Public endpoint](パブリック エンドポイント) の横にある [Enable](有効) ボタンを選択します。 ボタンが [Disable](無効) <有効にする> に変わります。 [OK] をクリックします。

   

10. [Before launch](起動前) で、[Run Maven Goal 'hellospring:package'](Maven の目標 'demo:package' を実行) を選択し、鉛筆アイコンを選択してコマンド ラインを編集します。

    

11. [Command line](コマンド ライン) テキスト ボックスの「package」の後に「-DskipTests」と入力し、[OK] を選択します。

    

12. デプロイを開始するには、[Azure へのデプロイ] ダイアログ ボックスの下部にある [実行] ボタンを選択します。 このプラグインは、demo アプリに対して Maven コマンド package -DskipTests を実行し、package コマンドによって生成された .jar ファイルをデプロイします。

アプリケーションのデプロイには数分かかることがあります。 出力コンソール ログにアプリケーションのパブリック URL が表示されます。

アプリを Azure Spring Apps にデプロイするには、「Java on Azure Spring Apps」の「Build and deploy the app」セクションの手順に従います。

デプロイが完了したら、デプロイの出力からアプリケーション URL を確認します。 次の手順に従って、検証します。

1. [デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

   

2. 各リソース デプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

デプロイが完了したら、出力のアプリケーション URL を使用してアプリケーションにアクセスします。 次の手順を使用して、アプリのログをチェックし、デプロイの問題があれば調査します。

1. [デプロイメント] の [出力]ページから出力アプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

   

2. Azure Spring Apps インスタンスの[概要] ページのナビゲーション ウィンドウで、[ログ] を選択してアプリのログを確認します。

   

デプロイが完了したら、出力のエンドポイントを使用してアプリケーションにアクセスします。 アプリを開くと、応答 Hello World が返されます。

デプロイが完了したら、次の手順を使用して、デプロイの出力からアプリケーション URL を確認できます。

1. [デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

   

2. 各リソース デプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

デプロイが完了したら、次の手順を使用して、アプリのログをチェックし、デプロイの問題があれば調査します。

1. [デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

   

2. Azure Spring Apps インスタンスの概要ページのナビゲーション ウィンドウで、[ログ] を選択してアプリのログを確認します。

   

デプロイが完了したら、出力のエンドポイントを使用してアプリケーションにアクセスします。 アプリを開くと、応答 Hello World が返されます。

デプロイが完了したら、次の手順を使用して、デプロイの出力からアプリケーション URL を確認できます。

1. [デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

   

2. 各リソース デプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

デプロイが完了したら、次の手順に従ってアプリを検証します。

1. アプリケーション URL にアクセスします。 アプリを開くと、応答 Hello World が返されます。

2. コンソール ログを確認します。これは、デプロイの問題があった場合の調査に役立ちます。

デプロイが完了したら、次の手順を使用して、アプリのログをチェックし、デプロイの問題があれば調査します。

1. 出力のアプリケーション URL を使用してアプリケーションにアクセスします。 アプリを開くと、応答 Hello World が返されます。

2. 次のコマンドを使用して、アプリのログをチェックし、デプロイの問題を調査します。

   az spring app logs \
       --service ${SERVICE_NAME} \
       --name ${APP_NAME}
   

次の手順を使用して、アプリケーション ログをストリームします。

1. 出力のアプリケーション URL を使用してアプリケーションにアクセスします。 アプリを開くと、応答 Hello World が返されます。

2. [Azure Explorer] ウィンドウを開き、ノード Azure を展開し、サービス ノード Azure Spring Apps を展開し、作成した Azure Spring Apps インスタンスを展開して、作成したアプリの demo インスタンスを選択します。

3. 右クリックして [Start Streaming Logs](ストリーミング ログの開始) を選択し、[OK] を選択してリアルタイムのアプリケーション ログを表示します。

   

次の手順を使用して、アプリケーション ログをストリームします。

1. 出力のアプリケーション URL を使用してアプリケーションにアクセスします。 アプリを開くと、応答 Hello World が返されます。

2. Azure Spring Apps 上の Java に関する記事のアプリケーション ログのストリーミングに関するセクションの手順に従います。

次の手順に従って、新しく作成したサービス インスタンスを含むリソース グループ全体を削除します。

1. Azure Portal で目的のリソース グループを探します。 ナビゲーション メニューで [リソース グループ] を選択し、該当するリソース グループの名前を選択します。

2. [リソース グループ] ページで [削除] を選択します。 テキスト ボックスに削除を確定するリソース グループの名前を入力し、[削除] を選択します。

次の手順に従って、新しく作成したサービス インスタンスを含むリソース グループ全体を削除します。

1. Azure Portal で目的のリソース グループを探します。 ナビゲーション メニューで [リソース グループ] を選択し、該当するリソース グループの名前を選択します。

2. [リソース グループ] ページで [削除] を選択します。 テキスト ボックスに削除を確定するリソース グループの名前を入力し、[削除] を選択します。

Azure CLI を使用してリソース グループを削除するには、次のコマンドを使用します。

az group delete --name ${RESOURCE_GROUP}

IntelliJ を使用してリソース グループを削除するには、次の手順を使用します。

1. Intellij IDEA に移動し、リソース グループの名前を見つけます。

2. リソース グループを右クリックし、[削除] を選択して、関連するすべての Azure リソースを削除します。

Visual Studio Code を使用してリソース グループを削除するには、次の手順を使用します。

1. Visual Studio Code に移動し、[グループ化] 選択して [リソース グループでグループ化] を有効にし、リソース グループの名前を見つけます。

2. リソース グループを右クリックし、[Delete Resource Group...](リソース グループの削除...) を選択して、関連するすべての Azure リソースを削除します。

次の手順に従って、新しく作成したサービス インスタンスを含むリソース グループ全体を削除します。

1. Azure Portal で目的のリソース グループを探します。 ナビゲーション メニューで [リソース グループ] を選択し、該当するリソース グループの名前を選択します。

2. [リソース グループ] ページで [削除] を選択します。 テキスト ボックスに削除を確定するリソース グループの名前を入力し、[削除] を選択します。

次の手順に従って、新しく作成したサービス インスタンスを含むリソース グループ全体を削除します。

1. Azure Portal で目的のリソース グループを探します。 ナビゲーション メニューで [リソース グループ] を選択し、該当するリソース グループの名前を選択します。

2. [リソース グループ] ページで [削除] を選択します。 テキスト ボックスに削除を確定するリソース グループの名前を入力し、[削除] を選択します。

このサンプル アプリケーションで使用されているすべての Azure リソースを削除するには、次のコマンドを使用します:

azd down

次の一覧に、コマンド対話を記載します:

• 削除するリソースの合計: <your-resources-total>、 続行してもよろしいですか?: y キーを押します。

コンソールから、次の例のようなメッセージが出力されます。

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.