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

Azure portal オプションは、1 回のクリックでリソースを作成してアプリケーションをデプロイできる最も簡単で最速の方法です。このオプションは、Azure クラウドサービスにアプリケーションをj迅速にデプロイしたい Spring 開発者に適しています。
Azure portal と Maven プラグインのオプションは、リソースを作成し、アプリケーションを段階的にデプロイするためのより従来型の方法です。このオプションは、Azure クラウドサービスを初めて使用する Spring 開発者に適しています。
Azure Developer CLI オプションは、単純なコマンドを使用して、自動的にリソースを作成し、アプリケーションをデプロイする、より効率的な方法です。 Azure Developer CLI では、テンプレートを使用して、必要な Azure リソースをプロビジョニングし、アプリケーションコードをデプロイします。このオプションは、Azure クラウドサービスに精通している Spring 開発者に適しています。

Azure portal オプションは、1 回のクリックでリソースを作成してアプリケーションをデプロイできる最も簡単で最速の方法です。このオプションは、Azure クラウドサービスにアプリケーションをj迅速にデプロイしたい Spring 開発者に適しています。
Azure portal と Maven プラグインのオプションは、リソースを作成し、アプリケーションを段階的にデプロイするためのより従来型の方法です。このオプションは、Azure クラウドサービスを初めて使用する Spring 開発者に適しています。
Azure CLI のオプションは、強力なコマンドラインツールを使用して、Azure リソースを管理します。このオプションは、Azure クラウドサービスに精通している Spring 開発者に適しています。
IntelliJ のオプションは、強力な Java IDE を使用して、Azure リソースを簡単に管理します。このオプションは、Azure クラウドサービスおよび IntelliJ IDEA に精通している Spring 開発者に適しています。
Visual Studio Code のオプションは、Azure リソースを簡単に管理できる、軽量でありながら強力なソースコードエディターを使用します。このオプションは、Azure クラウドサービスおよび Visual Studio Code に精通している Spring 開発者に適しています。

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

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

2. Spring プロジェクトを準備する

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

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

次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプルプロジェクトをクローンします。
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
次のコマンドを使用して、プロジェクトフォルダーに移動します。
```
cd gs-spring-boot-for-azure/complete
```
次の Maven コマンドを使用して、プロジェクトをビルドします。
```
./mvnw clean package
```
次のコマンドを使用して、サンプルプロジェクトをローカルで実行します。
```
./mvnw spring-boot:run
```

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

ターミナルを開き、空のフォルダーを作成して、ディレクトリをそこに変更します。
次のコマンドを実行して、以下のプロジェクトを初期化します:
```
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
```

3. クラウド環境を準備する

このセクションでは、Azure Spring Apps サービスインスタンスを作成し、Azure クラウド環境を準備する方法について説明します。

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

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

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

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

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

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

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

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

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

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

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

Azure portal の隅にある [リソースの作成] を選択します。
[Compute]>[Azure Spring Apps] を選択します。

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

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

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

(省略可能) Container Apps 環境を作成します。
- 従量課金ワークロード
- 専用ワークロード
1. [基本] タブに次の情報を入力します。
  - 環境名: myacaenv
  - プラン: 従量課金
  - ゾーン冗長: 無効
2. [作成] を選んで、Container Apps 環境を作成します。
1. [基本] タブに次の情報を入力します。
  - 環境名: myacaenv
  - プラン: (Preview) Consumption and Dedicated workload profiles ((プレビュー) 従量課金と専用ワークロードプロファイル)
  - ゾーン冗長: 無効
2. [ワークロードプロファイル (プレビュー)] タブを選んでから、[ワークロードプロファイルの追加] を選んでワークロードプロファイルを追加します。
3. [ワークロードプロファイルの追加 (プレビュー)] ページで、次の情報を追加します。
  - Workload profile name (ワークロードプロファイル名): my-wlp
  - Workload profile size (ワークロードプロファイルのサイズ): [Dedicated-D4] を選びます
  - Autoscaling instance count range (自動スケーリングのインスタンス数の範囲): 3 と 5 を選びます
4. [追加] を選択します。これを選ぶと、[ワークロードプロファイルの追加 (プレビュー)] ページに戻ります。 my-wlp を選んでから、[作成] を選んで Container Apps 環境を作成します。
Review and Create(確認と作成) を選択して、選択内容を確認します。 [作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。
ツールバーの [通知] アイコン (ベル) を選択して、デプロイプロセスを監視します。デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。
[リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

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

次のコマンドを使用して、OAuth 2 で Azure CLI にサインインします。既にサインインしている場合は、この手順を無視してください。
```
azd auth login
```
コンソールから、次の例のようなメッセージが出力されます。
```
Logged in to Azure.
```
次のコマンドを使って、テンプレートのインフラストラクチャを 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 リソースがプロビジョニングされると、進行状況インジケーターが表示されます。

4. アプリを Azure Spring Apps にデプロイする

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

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

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 ファイルに保存されません。

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

./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 にデプロイします。

次のコマンドを実行して、アプリケーションのデプロイ可能なコピーをパッケージ化します:
```
azd package
```
コンソールから、次の例のようなメッセージが出力されます。
```
SUCCESS: Your application was packaged for Azure in xx seconds.
```

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

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

Note

azd up を使って、前の 3 つのコマンド azd provision (Azure リソースをプロビジョニングする)、azd package (アプリケーションのデプロイ可能なコピーをパッケージ化する)、azd deploy (アプリケーションコードをデプロイする) を組み合わせることもできます。詳細については、「spring-guides/gs-spring-boot-for-azure」を参照してください。

2. Spring プロジェクトを準備する

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

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

次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプルプロジェクトをクローンします。
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
次のコマンドを使用して、プロジェクトフォルダーに移動します。
```
cd gs-spring-boot-for-azure/complete
```
次の Maven コマンドを使用して、プロジェクトをビルドします。
```
./mvnw clean package
```
次のコマンドを使用して、サンプルプロジェクトをローカルで実行します。
```
./mvnw spring-boot:run
```

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

ターミナルを開き、空のフォルダーを作成して、ディレクトリをそこに変更します。
次のコマンドを実行して、以下のプロジェクトを初期化します:
```
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
```

3. クラウド環境を準備する

このセクションでは、Azure Spring Apps サービスインスタンスを作成し、Azure クラウド環境を準備する方法について説明します。

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

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

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

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

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

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

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

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

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

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

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

Azure portal の隅にある [リソースの作成] を選択します。
[Compute]>[Azure Spring Apps] を選択します。

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

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

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

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

次のコマンドを使用して、OAuth 2 で Azure CLI にサインインします。既にサインインしている場合は、この手順を無視してください。
```
azd auth login
```
コンソールから、次の例のようなメッセージが出力されます。
```
Logged in to Azure.
```
次のコマンドを使用して、Standard プランを使用してテンプレートを設定します。
```
azd env set PLAN standard
```
次のコマンドを使用して、アプリケーションのデプロイ可能なコピーをパッケージ化し、テンプレートのインフラストラクチャを 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 リソースがプロビジョニングされると、進行状況インジケーターが表示されます。

4. アプリを Azure Spring Apps にデプロイする

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

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

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 ファイルに保存されません。

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

./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 にデプロイします。

次のコマンドを実行して、アプリケーションのデプロイ可能なコピーをパッケージ化します:
```
azd package
```
コンソールから、次の例のようなメッセージが出力されます。
```
SUCCESS: Your application was packaged for Azure in xx seconds.
```

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

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

Note

azd up を使用して、前の 3 つのコマンドazd package (アプリケーションのデプロイ可能なコピーをパッケージ化する)、azd provision (Azure リソースをプロビジョニングする)、および azd deploy (アプリケーションコードをデプロイする) を組み合わせることもできます。詳細については、「spring-guides/gs-spring-boot-for-azure」を参照してください。

2. Spring プロジェクトを準備する

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

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

次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプルプロジェクトをクローンします。
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
次のコマンドを使用して、プロジェクトフォルダーに移動します。
```
cd gs-spring-boot-for-azure/complete
```
次の Maven コマンドを使用して、プロジェクトをビルドします。
```
./mvnw clean package
```
次のコマンドを使用して、サンプルプロジェクトをローカルで実行します。
```
./mvnw spring-boot:run
```

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

次のコマンドを使用して、GitHub から Azure 用の Spring Boot サンプルプロジェクトをクローンします。
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
次のコマンドを使用して、プロジェクトフォルダーに移動します。
```
cd gs-spring-boot-for-azure/complete
```
次の Maven コマンドを使用して、プロジェクトをビルドします。
```
./mvnw clean package
```
次のコマンドを使用して、サンプルプロジェクトをローカルで実行します。
```
./mvnw spring-boot:run
```

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

次のコマンドを使用して、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 -

次の内容を含むファイル 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";
     }
}

次の Maven コマンドを使用して、プロジェクトをビルドします。
```
./mvnw clean package
```
次のコマンドを使用して、サンプルプロジェクトをローカルで実行します。
```
./mvnw spring-boot:run
```

3. クラウド環境を準備する

このセクションでは、Azure Spring Apps サービスインスタンスを作成し、Azure クラウド環境を準備する方法について説明します。

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

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

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

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

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

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

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

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

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

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

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

Azure portal の隅にある [リソースの作成] を選択します。
[Compute]>[Azure Spring Apps] を選択します。

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

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

Review and Create(確認と作成) を選択して、選択内容を確認します。次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。
ツールバーの [通知] アイコン (ベル) を選択して、デプロイプロセスを監視します。デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。
[リソースに移動] を選択して、[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. 新しいリソースグループを作成する

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

次のコマンドを使用して、Azure CLI にサインインします。
```
az login
```
次のコマンドを使用して、既定の場所を設定します。
```
az configure --defaults location=${LOCATION}
```
次のコマンドを使用して、使用可能なすべてのサブスクリプションを一覧表示し、使用するサブスクリプション ID を決定します。
```
az account list --output table
```
次のコマンドを使用して、既定のサブスクリプションを設定します。
```
az account set --subscription <subscription-ID>
```
次のコマンドを使用して、リソースグループを作成します。
```
az group create --resource-group ${RESOURCE_GROUP}
```
次のコマンドを使用して、新しく作成したリソースグループを既定のリソースグループとして設定します。
```
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 インスタンスを作成する

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

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

Note

この手順は、サブスクリプションが Azure Spring Apps の Enterprise プランインスタンスの作成に使用されたことがない場合にのみ必要です。
```
az term accept \
    --publisher vmware-inc \
    --product azure-spring-cloud-vmware-tanzu-2 \
    --plan asa-ent-hr-mtr
```
次のコマンドを使用して、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 サービスインスタンスの間の関係を示す図。

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

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

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

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

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

Azure portal の隅にある [リソースの作成] を選択します。
[Compute]>[Azure Spring Apps] を選択します。

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

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

Review and Create(確認と作成) を選択して、選択内容を確認します。次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。
ツールバーの [通知] アイコン (ベル) を選択して、デプロイプロセスを監視します。デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。
[リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

4. アプリを Azure Spring Apps にデプロイする

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

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

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 ファイルに保存されません。

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

./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. プロジェクトをインポートする

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

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

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

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

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

Note

Azure Toolkit for IntelliJ には、Azure にログインするための 4 つの方法が用意されており、デプロイはログイン後にのみ開始できます。
IntelliJ の [Project](プロジェクト) ウィンドウで対象のプロジェクトを右クリックし、[Azure] ->[Deploy to Azure Spring Apps](Azure Spring Apps にデプロイ) を選択します。
[Name](名前) フィールドのアプリの名前はそのまま使用します。 [Name](名前) は、アプリ名ではなく構成を参照します。通常、これを変更する必要はありません。
[成果物] テキストボックスで、Maven:demo(Java 17) を選択します。
[Subscription](サブスクリプション) テキストボックスで、自分のサブスクリプションが正しいことを確認します。
[Spring Apps] テキストボックスで、作成した Azure Spring Apps インスタンスを選択します。
[App](アプリ) テキストボックスで、プラス記号 (+) を選択して、新しいアプリを作成します。
[App Basics](アプリの基本情報) にある [アプリ名:] テキストボックスに「demo」と入力して、[その他の設定] を選択します。
[Public endpoint](パブリックエンドポイント) の横にある [Enable](有効) ボタンを選択します。ボタンが [Disable](無効) <有効にする> に変わります。 [OK] をクリックします。
[Before launch](起動前) で、[Run Maven Goal 'hellospring:package'](Maven の目標 'demo:package' を実行) を選択し、鉛筆アイコンを選択してコマンドラインを編集します。
[Command line](コマンドライン) テキストボックスの「package」の後に「-DskipTests」と入力し、[OK] を選択します。
デプロイを開始するには、[Azure へのデプロイ] ダイアログボックスの下部にある [実行] ボタンを選択します。このプラグインは、demo アプリに対して Maven コマンド package -DskipTests を実行し、package コマンドによって生成された .jar ファイルをデプロイします。

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

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

[デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。アプリを開くと、応答 Hello World が返されます。
各リソースデプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

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

[デプロイメント] の [出力]ページから出力アプリケーション URL にアクセスします。アプリを開くと、応答 Hello World が返されます。
Azure Spring Apps インスタンスの[概要] ページのナビゲーションウィンドウで、[ログ] を選択してアプリのログを確認します。

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

[デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。アプリを開くと、応答 Hello World が返されます。
各リソースデプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

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

[デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。アプリを開くと、応答 Hello World が返されます。
Azure Spring Apps インスタンスの概要ページのナビゲーションウィンドウで、[ログ] を選択してアプリのログを確認します。

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

[デプロイメント] の [出力]ページからアプリケーション URL にアクセスします。アプリを開くと、応答 Hello World が返されます。
各リソースデプロイの詳細を確認します。これは、デプロイの問題があった場合の調査に役立ちます。

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

出力のアプリケーション URL を使用してアプリケーションにアクセスします。アプリを開くと、応答 Hello World が返されます。
次のコマンドを使用して、アプリのログをチェックし、デプロイの問題を調査します。
```
az spring app logs \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME}
```

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

出力のアプリケーション URL を使用してアプリケーションにアクセスします。アプリを開くと、応答 Hello World が返されます。
[Azure Explorer] ウィンドウを開き、ノード Azure を展開し、サービスノード Azure Spring Apps を展開し、作成した Azure Spring Apps インスタンスを展開して、作成したアプリの demo インスタンスを選択します。
右クリックして [Start Streaming Logs](ストリーミングログの開始) を選択し、[OK] を選択してリアルタイムのアプリケーションログを表示します。

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

出力のアプリケーション URL を使用してアプリケーションにアクセスします。アプリを開くと、応答 Hello World が返されます。
Azure Spring Apps 上の Java に関する記事のアプリケーションログのストリーミングに関するセクションの手順に従います。

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

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

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

az group delete --name ${RESOURCE_GROUP}

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

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

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

azd down

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

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

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

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

サンプルアプリの概要

フィットネスストアサンプルアプリの概要

次の方法で共有

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

1.前提条件

2. Spring プロジェクトを準備する

3. クラウド環境を準備する

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

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

4. アプリを Azure Spring Apps にデプロイする

2. Spring プロジェクトを準備する

3. クラウド環境を準備する

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

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

4. アプリを Azure Spring Apps にデプロイする

2. Spring プロジェクトを準備する

3. クラウド環境を準備する

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

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

4. アプリを Azure Spring Apps にデプロイする

5. アプリ を検証します

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

7. 次のステップ

フィードバック

その他のリソース

5. アプリを検証します