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

[アーティクル]
02/01/2024

Note

毎月最初の 50 vCPU 時間と 100 GB 時間のメモリは無料です。詳細については、Apps on Azure ブログの「価格の引き下げ - Azure Spring Apps はより多く、より低コスト」を参照してください。

注意

Azure Spring Apps は、Azure Spring Cloud サービスの新しい名前です。サービスの名前は新しくなりましたが、スクリーンショット、ビデオ、図などの資産の更新に取り組んでいる間、場所によってはしばらく古い名前が表示されます。

この記事では、Microsoft Entra ID によって保護された RESTful API アプリケーションを Azure Spring Apps にデプロイする方法について説明します。サンプルプロジェクトは、バックエンドサービスのみを提供し、Microsoft Entra ID を使用して RESTful API を保護する Simple Todo Web アプリケーションを基盤とする簡略化されたバージョンです。

これらの RESTful API は、ロールベースのアクセス制御 (RBAC) を適用して保護されます。匿名ユーザーはデータにアクセスできないため、異なるユーザーのアクセスを制御することはできません。匿名ユーザーには、次の 3 つのアクセス許可しかありません。

読み取り: このアクセス許可により、ユーザーは ToDo データを読み取ることができます。
書き込み: このアクセス許可により、ユーザーは ToDo データを追加または更新できます。
削除: このアクセス許可により、ユーザーは ToDo データを削除できます。

デプロイが成功したら、Swagger UI を使用して API を表示およびテストできます。

システムのアーキテクチャを次の図に示します。

この記事では、リソースを作成して Azure Spring Apps にデプロイするための次のオプションについて説明します。

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

この記事では、リソースを作成して Azure Spring Apps にデプロイするための次のオプションについて説明します。

Azure portal + Maven プラグインのオプションは、リソースを作成し、アプリケーションを段階的にデプロイするための従来の方法を提供します。このオプションは、Azure クラウドサービスを初めて使用する Spring 開発者に適しています。
Azure CLI のオプションは、強力なコマンドラインツールを使用して、Azure リソースを管理します。このオプションは、Azure クラウドサービスに精通している Spring 開発者に適しています。

Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
次のいずれかのロール:
- "グローバル管理者" または "特権ロール管理者"。任意の API に対してアクセス許可を要求するアプリに同意を付与します。
- クラウドアプリケーション管理者またはアプリケーション管理者。任意の API に対してアクセス許可を要求するアプリに同意を付与します (Microsoft Graph アプリロール (アプリケーションのアクセス許可) は "除きます")。
- アプリケーションで必要なアクセス許可に対して、アプリケーションにアクセス許可を付与するための権限が含まれたカスタムディレクトリロール。
詳細については、「アプリケーションに対してテナント全体の管理者の同意を付与する」を参照してください。
ターゲットサブスクリプションで初めて Azure Spring Apps Enterprise プランインスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。
Git.
Java Development Kit (JDK)、バージョン 17。
Microsoft Entra テナント。作成手順については、「クイックスタート: Microsoft Entra ID で新しいテナントを作成する」を参照してください。

Azure portal + Maven プラグイン
Azure Developer CLI

Azure サブスクリプション Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
次のいずれかのロール:
- "グローバル管理者" または "特権ロール管理者"。任意の API に対してアクセス許可を要求するアプリに同意を付与します。
- クラウドアプリケーション管理者またはアプリケーション管理者。任意の API に対してアクセス許可を要求するアプリに同意を付与します (Microsoft Graph アプリロール (アプリケーションのアクセス許可) は "除きます")。
- アプリケーションで必要なアクセス許可に対して、アプリケーションにアクセス許可を付与するための権限が含まれたカスタムディレクトリロール。
詳細については、「アプリケーションに対してテナント全体の管理者の同意を付与する」を参照してください。
Git.
Java Development Kit (JDK)、バージョン 17。
Microsoft Entra テナント。作成手順については、「クイックスタート: Microsoft Entra ID で新しいテナントを作成する」を参照してください。

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

RESTful API アプリをデプロイするには、最初の手順として、Spring プロジェクトをローカルで実行するように準備します。

次の手順を使用し、アプリをローカル環境にクローンして実行します。

次のコマンドを使用して、GitHub からサンプルプロジェクトを複製します。
```
git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
```
アプリをローカルで実行する場合は、まず「RESTful API を公開する」および、「アプリケーション構成を更新する」セクションの手順を完了してから、次のコマンドを使用して Maven でサンプルアプリケーションを実行してください。
```
cd ASA-Samples-Restful-Application
./mvnw spring-boot:run
```

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

このサンプルアプリを実行するために必要な主なリソースは、Azure Spring Apps インスタンスと Azure Database for PostgreSQL インスタンスです。以下のセクションでは、これらのリソースを作成する方法について説明します。

Azure portal + Maven プラグイン
Azure CLI

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

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

次の手順を使用して、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 の従量課金制の料金プラン。
Terms	選択済み	Marketplace オファリングに関連付けられている契約チェックボックス。このチェックボックスをオンにする必要があります。
サンプルプロジェクトのデプロイ	オフ	組み込みのサンプルアプリケーションを使うオプション。

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

3.3. PostgreSQL インスタンスを準備する

次の手順を使用して、Azure Database for PostgreSQL サーバーを作成します。

Azure portal にアクセスし、[リソースの作成] を選択してください。
[データベース]>[Azure Database for PostgreSQL] の順に選択します。
[フレキシブルサーバー] デプロイオプションを選択します。
[基本] タブに次の情報を入力します。
- [サーバー名]: my-demo-pgsql
- [リージョン]: 米国東部
- [PostgreSQL バージョン]: 14
- [ワークロードの種類]: 開発
- [高可用性を有効にする]: 選択解除
- [認証方法]: PostgreSQL の認証のみ
- [管理者ユーザー名]: myadmin
- [パスワード] と [パスワードの確認]: 任意のパスワードを入力します。
次の情報を使用して、[ネットワーク] タブを構成してください。
- [接続方法]: パブリックアクセス (許可されている IP アドレス)
- [Azure 内の任意の Azure サービスにこのサーバーへのパブリックアクセスを許可する]: オン
[確認と作成] を選んで選択内容を確認し、[作成] を選んでサーバーをプロビジョニングしてください。この操作には数分かかる場合があります。
Azure portal で PostgreSQL サーバーに移動します。 [概要] ページで、[サーバー名]の値を探し、後で使用できるように記録してください。これは、Azure Spring Apps でアプリの環境変数を構成するために必要です。
ナビゲーションメニューから [データベース] を選び、データベースを作成します (例: todo)。

3.4. アプリインスタンスを PostgreSQL インスタンスに接続する

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

Azure portal で Azure Spring Apps インスタンスに移動します。
ナビゲーションメニューから [アプリ] を開き、[アプリの作成] を選択してください。
[アプリの作成] ページで、アプリ名を「simple-todo-api」と入力し、デプロイの種類として [Java アーティファクト] を選択します。
[作成] を選択してアプリの作成を完了したら、そのアプリを選択して詳細を表示します。
Azure portal で作成したアプリに移動します。 [概要] ページで、[エンドポイントの割り当て] を選択して、アプリのパブリックエンドポイントを公開します。デプロイ後にアプリにアクセスするための URL を保存します。
ナビゲーションウィンドウで [サービスコネクタ] を選択し、[作成] を選択して、新しいサービス接続を作成します。
[基本] タブに次の情報を入力します。
- [サービスの種類]: DB for PostgreSQL フレキシブルサーバー
- 接続名: 自動的に生成された名前が設定されます。変更も可能です。
- [サブスクリプション]:サブスクリプションを選択します。
- [PostgreSQL flexible server] (PostgreSQL フレキシブルサーバー): my-demo-pgsql
- PostgreSQL データベース: 作成したデータベースを選びます。
- [クライアントの種類]: SpringBoot
次の情報を使って、[次へ: 認証] タブを構成します。
- [Select the authentication type you'd like to use between your compute service and target service.] (コンピューティングサービスとターゲットサービスの間で使用する認証の種類を選択します。): [接続文字列] を選択します。
- [Continue with] (続行): [データベース資格情報] を選択します
- [ユーザー名]: myadmin
- [パスワード]: パスワードを入力します。
[次へ: ネットワーク] を選択します。既定のオプション [ターゲットサービスへのアクセスを有効にするようにファイアウォール規則を構成する] を使います。
[次へ: 確認と作成] を選択して選択内容を確認し、[作成] を選択して接続を作成します。

3.5. RESTful API を公開する

次の手順を使用して、Microsoft Entra ID に RESTful API を公開します。

Azure portal にサインインします。
複数のテナントにアクセスできる場合は、[ディレクトリとサブスクリプション] フィルター () を使用して、アプリケーションを登録するテナントを選択してください。
Microsoft Entra ID を検索して選択します。
[管理] で [アプリの登録]>[新規登録] の順に選択します。
[名前] フィールドにアプリケーションの名前を入力してください (例: Todo)。アプリのユーザーにはこの名前が表示されます。後で変更することもできます。
[サポートされているアカウントの種類] に、[任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ディレクトリ - マルチテナント) と個人用の Microsoft アカウント] を選択してください。
[登録] を選択して、アプリケーションを作成します。
アプリの [概要] ページで、 [アプリケーション (クライアント) ID] の値を探し、後で使用するために記録します。これは、このプロジェクトの YAML 構成ファイルを構成するために必要です。
[管理] で [API の公開] を選択し、ページの先頭にある [アプリケーション ID の URI] を見つけて、[追加] を選択してください。
[アプリケーション ID の URI の編集] ページで、提案されたアプリケーション ID URI (api://{client ID}) をそのまま使用するか、クライアント ID の代わりにわかりやすい名前 (api://simple-todo など ) を使用して、[保存] を選択してください。
[管理] で、[API の公開]>[スコープの追加] を選択し、次の情報を入力してください。
- [スコープ名] に「ToDo.Read」と入力してください。
- [同意できるユーザー] には [管理者のみ] を選択してください。
- [管理者の同意の表示名] には、「ToDo データの読み取り」と入力してください。
- [管理者の同意の説明] として、「認証済みユーザーが ToDo データを読み取ることができます。」と入力してください。
- [状態] は有効のままにしてください。
- スコープの追加を選択します。
前の手順を繰り返して、他の 2 つのスコープ (ToDo.Write と ToDo.Delete) を追加します。

3.6. アプリケーションの構成を更新する

次の手順を使用して、Microsoft Entra 登録済みアプリケーション情報を使用して RESTful API アプリケーションとの関係を確立するように YAML ファイルを更新します。

simple-todo-api アプリの src/main/resources/application.yml ファイルを見つけます。次の例に一致するように、spring.cloud.azure.active-directory セクションの構成を更新します。プレースホルダーを、必ず前に作成した値で置き換えてください。
```
spring:
  cloud:
    azure:
      active-directory:
        profile:
          tenant-id: <tenant>
        credential:
          client-id: <your-application-ID-of-ToDo>
        app-id-uri: <your-application-ID-URI-of-ToDo>
```
Note

v1.0 トークンでは、構成には API のクライアント ID が必要ですが、v2.0 トークンでは、要求でクライアント ID またはアプリケーション ID URI を使用できます。対象ユーザーの検証を適切に完了するために、両方を構成することができます。

tenant-id に使用できる値: common、organizations、consumers、またはテナント ID。これらの値の詳細については、「エラー AADSTS50020 - ID プロバイダーのユーザーアカウントがテナントに存在しない」の「間違ったエンドポイント (個人用アカウントと organization アカウント) を使用しました」セクションを参照してください。シングルテナントアプリの変換については、「Microsoft Entra ID でシングルテナントアプリをマルチテナントに変換する」を参照してください。
次のコマンドを使用して、サンプルプロジェクトをリビルドしてください。
```
./mvnw clean package
```

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

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

export RESOURCE_GROUP=myresourcegroup
export LOCATION=<location>
export POSTGRESQL_SERVER=my-demo-pgsql
export POSTGRESQL_DB=Todo
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=myasa
export APP_NAME=simple-todo-api
export TODO_APP_NAME=Todo
export TODO_APP_URL=api://simple-todo
export TODOWEB_APP_NAME=TodoWeb
export TODOWEB_APP_URL=api://simple-todoweb
export NEW_MEMBER_USERNAME=<new-member-username>
export NEW_MEMBER_PASSWORD=<new-member-password>
export USER_PRINCIPAL_NAME=<user-principal-name>

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 ${AZURE_SPRING_APPS_NAME} --sku enterprise
```

次のコマンドを使って、Azure Spring Apps インスタンスにアプリケーションを作成します。

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

3.5. PostgreSQL インスタンスを準備する

Spring Web アプリは、localhost のデータベースに H2 を、Azure のデータベースに Azure Database for PostgreSQL を使います。

次のコマンドを使用して、PostgreSQL インスタンスを作成します。

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

0.0.0.0 を指定すると、Azure 内にデプロイされたすべてのリソースからサーバーにアクセスするためのパブリックアクセスが有効になります。

3.6. アプリインスタンスを PostgreSQL インスタンスに接続する

アプリケーションインスタンスと PostgreSQL インスタンスが作成されても、アプリケーションインスタンスは PostgreSQL インスタンスに直接アクセスできません。次の手順を使用して、アプリが PostgreSQL インスタンスに接続できるようにします。

次のコマンドを使用して、PostgreSQL インスタンスの完全修飾ドメイン名を取得します。

export PSQL_FQDN=$(az postgres flexible-server show \
    --name ${POSTGRESQL_SERVER} \
    --query fullyQualifiedDomainName \
    --output tsv)

次のコマンドを使用して、環境変数を介して spring.datasource. プロパティをアプリに提供します。

az spring app update \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
          SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
          SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"

3.7. RESTful API を公開する

以下の手順で RESTful API を公開します。

次のコマンドを使って、Microsoft Entra ID アプリケーションを作成します。

az ad app create \
    --display-name ${TODO_APP_NAME} \
    --sign-in-audience AzureADandPersonalMicrosoftAccount \
    --identifier-uris ${TODO_APP_URL}

次のコマンドを使って、アプリケーションのサービスプリンシパルを作成します。
```
az ad sp create --id ${TODO_APP_URL}
```

次のコマンドを使ってアクセス許可 ID を生成します。

permissionid1=$(uuidgen);permissionid2=$(uuidgen);permissionid3=$(uuidgen)

JSON として次のスコープを追加します。

api=$(echo '{
 "oauth2PermissionScopes": [
     {
         "adminConsentDescription": "Allows authenticated users to delete the ToDo data",
         "adminConsentDisplayName": "Delete the ToDo data",
         "id": "'$permissionid1'",
         "isEnabled": true,
         "type": "Admin",
         "userConsentDescription": null,
         "userConsentDisplayName": null,
         "value": "ToDo.Delete"
     },

     {
         "adminConsentDescription": "Allows authenticated users to write the ToDo data",
         "adminConsentDisplayName": "Write the ToDo data",
         "id": "'$permissionid2'",
         "isEnabled": true,
         "type": "Admin",
         "userConsentDescription": null,
         "userConsentDisplayName": null,
         "value": "ToDo.Write"
     },
     {
         "adminConsentDescription": "Allows authenticated users to read the ToDo data",
         "adminConsentDisplayName": "Read the ToDo data",
         "id": "'$permissionid3'",
         "isEnabled": true,
         "type": "Admin",
         "userConsentDescription": null,
         "userConsentDisplayName": null,
         "value": "ToDo.Read"
     }
 ]}')

スコープを追加するには、次のコマンドを使います。
```
az ad app update \
    --id ${TODO_APP_URL} \
    --set api="$api"
```
次のコマンドを使って、次の手順で使うテナント ID を取得します。
```
az account show --query "tenantId" --output tsv
```

次のコマンドを使って、次の手順で使うアプリケーション ID を取得します。

appid=$(az ad app show \
    --id ${TODO_APP_URL} \
    --query appId \
    --output tsv);
echo $appid

3.8. アプリケーションの構成を更新する

simple-todo-api アプリの src/main/resources/application.yml ファイルを見つけます。次の例に一致するように、spring.cloud.azure.active-directory セクションの構成を更新します。プレースホルダーを、必ず前に作成した値で置き換えてください。
```
spring:
  cloud:
    azure:
      active-directory:
        profile:
          tenant-id: <tenant>
        credential:
          client-id: <your-application-ID-of-ToDo>
        app-id-uri: <your-application-ID-URI-of-ToDo>
```
Note

v1.0 トークンでは、構成には API のクライアント ID が必要ですが、v2.0 トークンでは、要求でクライアント ID またはアプリケーション ID URI を使用できます。対象ユーザーの検証を適切に完了するために、両方を構成することができます。

tenant-id に使用できる値: common、organizations、consumers、またはテナント ID。これらの値の詳細については、「エラー AADSTS50020 - ID プロバイダーのユーザーアカウントがテナントに存在しない」の「間違ったエンドポイント (個人用アカウントと organization アカウント) を使用しました」セクションを参照してください。シングルテナントアプリの変換については、「Microsoft Entra ID でシングルテナントアプリをマルチテナントに変換する」を参照してください。
次のコマンドを使用して、サンプルプロジェクトをリビルドしてください。
```
./mvnw clean package
```

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

Azure portal + Maven プラグイン
Azure CLI

アプリを Azure Spring Apps にデプロイできるようになりました。

次の手順に従って、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 キーを直接押します。
- Azure Spring Apps <your-instance-name> で既存のアプリを使う: 作成したアプリを使うには、y キーを押します。
- 上記のすべての構成の保存を確定する: y キーを押します。 n を押した場合、構成は POM ファイルに保存されません。
次のコマンドを使用して、アプリをデプロイします。
```
./mvnw azure-spring-apps:deploy
```
次の一覧に、コマンド対話を記載します:
- OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
コマンドが実行されると、デプロイが成功したことを示す次のログメッセージが表示されます。

[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-api-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-api)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-api.azuremicroservices.io

次のコマンドを使って、ソースコードに基づいてアプリをデプロイします。

az spring app deploy \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --build-env BP_JVM_VERSION=17 \
    --source-path .

5. アプリを検証します

Azure portal + Maven プラグイン
Azure CLI

RESTful API にアクセスして、動作するかどうかを確認できるようになりました。

5.1. アクセストークンの要求

RESTful API は、Microsoft Entra ID によって保護されるリソースサーバーとして機能します。アクセストークンを取得する前に、別のアプリケーションを Microsoft Entra ID に登録し、ToDoWeb という名前のクライアントアプリケーションにアクセス許可を付与する必要があります。

クライアントアプリケーションの登録

次の手順を使用して、アプリケーションを Microsoft Entra ID に登録してください。これは、ToDo アプリのアクセス許可を追加するために使用されます。

Azure portal にサインインします。
複数のテナントにアクセスできる場合は、[ディレクトリとサブスクリプション] フィルター () を使用して、アプリケーションを登録するテナントを選択してください。
Microsoft Entra ID を検索して選択します。
[管理] で [アプリの登録]>[新規登録] の順に選択します。
アプリケーションの名前を [名前] フィールドに入力してください (例: ToDoWeb)。アプリのユーザーにはこの名前が表示されます。後で変更することもできます。
[サポートされているアカウントの種類] で、既定値の [この組織のディレクトリ内のアカウントのみ] を選択してください。
[登録] を選択して、アプリケーションを作成します。
アプリの [概要] ページで、 [アプリケーション (クライアント) ID] の値を探し、後で使用するために記録します。アクセストークンを取得するためにこれが必要です。
[API のアクセス許可] 、 [アクセス許可の追加] 、 [自分の API] の順に選択します。先ほど登録した ToDo アプリケーションを選択し、ToDo.Read、ToDo.Write、ToDo.Delete アクセス許可を選択してください。 アクセス許可の追加 を選択します。
[<テナント名>に管理者の同意を付与する] を選択し、追加したアクセス許可に管理者の同意を付与してください。

RESTful API にアクセスするためのユーザーの追加

Microsoft Entra テナントでメンバーユーザーを作成するには、次の手順に従います。その後、ユーザーは RESTful API を使用して ToDo アプリケーションのデータを管理できます。

[管理] で、[ユーザー]>[新しいユーザー]>[新しいユーザーの作成] を選択してください。
[新しいユーザーの作成] ページで、次の情報を入力してください。
- ユーザープリンシパル名: ユーザーの名前を入力してください。
- 表示名: ユーザーの表示名を入力してください。
- パスワード: [パスワード] ボックスに表示されている自動生成されたパスワードをコピーしてください。
Note

新しいユーザーは、最初のサインイン認証を完了してパスワードを更新する必要があります。そうしないと、アクセストークンを AADSTS50055: The password is expired 取得するとエラーが表示されます。

新しいユーザーがログインすると、[操作が必要です] というダイアログが表示されます。 [後で確認] を選択して検証をスキップできます。
[確認および作成] を選択して、選択内容を確認します。 [作成] を選択してユーザーを作成してください。

Swagger UI 承認の OAuth2 構成を更新する

Swagger UI 承認の OAuth2 構成を更新するには、次の手順に従います。その後、ユーザーがアプリを通じて ToDoWeb アクセストークンを取得することを承認できます。

Azure portal で [Microsoft Entra ID] テナントを開き、登録済みの ToDoWeb アプリに移動してください。
[管理] で [認証] を選択し、[プラットフォームの追加] を選択し、[シングルページアプリケーション] を選択してください。
"リダイレクト URI" フィールド内の OAuth2 リダイレクト URL として <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html 形式を使い、[構成] を選択します。

RESTful API にアクセスして、動作するかどうかを確認できるようになりました。

5.1. アクセストークンの要求

クライアントアプリケーションの登録

次の手順を使って、クライアントアプリケーションを登録します。

次のコマンドを使って、Microsoft Entra ID アプリケーションを作成します。これは ToDo アプリのアクセス許可を追加するために使われます。
```
az ad app create \
    --display-name ${TODOWEB_APP_NAME} \
    --sign-in-audience AzureADMyOrg \
    --identifier-uris ${TODOWEB_APP_URL}
```

次のコマンドを使って、アクセス許可を追加します。

az ad app permission add \
    --id api://simple-todowebtest2 \
    --api $appid \
    --api-permissions $permissionid1=Scope $permissionid2=Scope $permissionid3=Scope

次のコマンドを使って、追加したアクセス許可に対して管理者の同意を与えます。
```
az ad app permission admin-consent --id ${TODOWEB_APP_URL}
```
次のコマンドを使って、「アクセストークンを取得する」手順で使った ToDoWeb アプリのクライアント ID を取得します。
```
az ad app show \
    --id ${TODOWEB_APP_URL} \
    --query appId \
    --output tsv
```

RESTful API にアクセスするためのユーザーの追加

次のコマンドを使って、Microsoft Entra テナントにメンバーユーザーを作成します。これで、ユーザーは RESTful API を使って ToDo アプリケーションのデータを管理できるようになります。

az ad user create \
    --display-name ${NEW_MEMBER_USERNAME} \
    --password ${NEW_MEMBER_PASSWORD} \
    --user-principal-name ${USER_PRINCIPAL_NAME}

Swagger UI 承認の OAuth2 構成を更新する

次の手順で OAuth2 構成を更新します。

次のコマンドを使って、ToDoWeb アプリのオブジェクト ID を取得します。
```
az ad app show --id ${TODOWEB_APP_URL} --query id
```

次のコマンドを使って、simple-todo-api アプリの URL を取得します。

az spring app show \
    --name ${APP_NAME} \
    --service ${AZURE_SPRING_APPS_NAME} \
    --query properties.url

次のコマンドを使って Swagger UI 認可の OAuth2 構成を更新し、<object-id> と <URL> のプレースホルダーを、取得したパラメーター値に置き換えます。その後、ユーザーがアプリを通じて ToDoWeb アクセストークンを取得することを承認できます。
```
az rest \
    --method PATCH \
    --uri "https://graph.microsoft.com/v1.0/applications/<object-id>" \
    --headers 'Content-Type=application/json' \
    --body '{"spa":{"redirectUris":["<URL>/swagger-ui/oauth2-redirect.html"]}}'
```

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

RESTful API アプリをデプロイするには、最初の手順として、Spring プロジェクトをローカルで実行するように準備します。

Azure portal + Maven プラグイン
Azure Developer CLI

次の手順を使用し、アプリをローカル環境にクローンして実行します。

次のコマンドを使用して、GitHub からサンプルプロジェクトを複製します。
```
git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
```
アプリをローカルで実行する場合は、まず「RESTful API を公開する」および、「アプリケーション構成を更新する」セクションの手順を完了してから、次のコマンドを使用して Maven でサンプルアプリケーションを実行してください。
```
cd ASA-Samples-Restful-Application
./mvnw spring-boot:run
```

次の手順を使用して Azure Developer CLI テンプレートの Web アプリケーションを初期化してください。

ターミナルを開き、空のフォルダーを新規作成し、そこにディレクトリを変更します。
次のコマンドを実行して、以下のプロジェクトを初期化します。
```
azd init --template Azure-Samples/ASA-Samples-Restful-Application
```
次の一覧に、コマンド対話を記載します。
- OAuth2 login: OAuth2 プロトコルに基づいて Azure へのサインインを承認する必要があります。
- 新しい環境名を入力してください: 環境名を指定してください。この名前は、すべての Azure リソースを保持するために作成されたリソースグループのサフィックスとして使用されます。この名前は、Azure サブスクリプション内で一意である必要があります。
コンソールから、次の例のようなメッセージが出力されます。
```
Initializing a new project (azd init)

Downloading template code to: <your-local-path>
(✓) Done: Initialized git repository

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 portal + Maven プラグイン
Azure Developer CLI

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

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

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

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

[基本] フォームに入力します。次の表を参考にして、フォームに入力します。推奨されるプランの値は Standard consumption & dedicated (プレビュー) です。

設定	提案された値	説明
[サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
リソースグループ	myresourcegroup	新しいリソースグループ名、またはサブスクリプションの既存のリソースグループ名。
名前	myasa	Azure Spring Apps サービスを識別する一意の名前。名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
プラン	Standard consumption & dedicated (プレビュー)	価格プランによって、インスタンスに関連付けられるリソースとコストが決まります。
リージョン	ユーザーに最も近いリージョン。	ユーザーに最も近い場所。
Container Apps 環境	myenvironment	同じ仮想ネットワークを他のサービスやリソースと共有する Container Apps 環境インスタンスを選択するオプション。

Container Apps 環境を作成するためのガイドとして、次の表を使用してください。

設定	提案された値	説明
環境名	myenvironment	Azure Container Apps 環境サービスを識別する一意の名前。
プラン	消費	価格プランによって、インスタンスに関連付けられるリソースとコストが決まります。
ゾーン冗長	無効	Azure 可用性ゾーンに Container Apps 環境サービスを作成するオプション。

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

重要

従量課金ワークロードプロファイルでは従量課金制の課金モデルがあり、開始コストはありません。プロビジョニングされたリソースに基づいて、専用ワークロードプロファイルに対して課金されます。詳細については、「Azure Container Apps のワークロードプロファイル」と「Azure Spring Apps の価格」のページを参照してください。

3.3. PostgreSQL インスタンスを準備する

次の手順を使用して、Azure Database for PostgreSQL サーバーを作成します。

Azure portal にアクセスし、[リソースの作成] を選択してください。
[データベース]>[Azure Database for PostgreSQL] の順に選択します。
[フレキシブルサーバー] デプロイオプションを選択します。
[基本] タブに次の情報を入力します。
- [サーバー名]: my-demo-pgsql
- [リージョン]: 米国東部
- [PostgreSQL バージョン]: 14
- [ワークロードの種類]: 開発
- [高可用性を有効にする]: 選択解除
- [認証方法]: PostgreSQL の認証のみ
- [管理者ユーザー名]: myadmin
- [パスワード] と [パスワードの確認]: 任意のパスワードを入力します。
次の情報を使用して、[ネットワーク] タブを構成してください。
- [接続方法]: パブリックアクセス (許可されている IP アドレス)
- [Azure 内の任意の Azure サービスにこのサーバーへのパブリックアクセスを許可する]: オン
[確認と作成] を選んで選択内容を確認し、[作成] を選んでサーバーをプロビジョニングしてください。この操作には数分かかる場合があります。
Azure portal で PostgreSQL サーバーに移動します。 [概要] ページで、[サーバー名]の値を探し、後で使用できるように記録してください。これは、Azure Spring Apps でアプリの環境変数を構成するために必要です。
ナビゲーションメニューから [データベース] を選び、データベースを作成します (例: todo)。

3.4. アプリインスタンスを PostgreSQL インスタンスに接続する

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

Azure portal で Azure Spring Apps インスタンスに移動します。
ナビゲーションメニューから [アプリ] を開き、[アプリの作成] を選択してください。
[アプリの作成] ページで、アプリ名 simple-todo-api を入力し、デプロイの種類として [Java アーティファクト] を選択してください。
[作成] を選択してアプリの作成を完了し、そのアプリを選択して詳細を表示してください。
Azure portal で作成したアプリに移動します。 [概要] ページで、[エンドポイントの割り当て] を選択して、アプリのパブリックエンドポイントを公開します。デプロイ後にアプリにアクセスするための URL を保存します。
作成したアプリに移動して [設定] を展開し、ナビゲーションメニューで [構成] を選択し、[環境変数] を選択して、環境変数を設定します。

PostgreSQL 接続に次の環境変数を追加し、[保存] を選択してアプリ構成の更新を完了してください。プレースホルダーは、以前に作成した独自の値に置き換えてください。

環境変数	値
`SPRING_DATASOURCE_URL`	`jdbc:postgresql://<your-PostgreSQL-server-name>:5432/<your-PostgreSQL-database-name>`
`SPRING_DATASOURCE_USERNAME`	`<your-PostgreSQL-admin-user>`
`SPRING_DATASOURCE_PASSWORD`	`<your-PostgreSQL-admin-password>`

3.5. RESTful API を公開する

次の手順を使用して、Microsoft Entra ID に RESTful API を公開します。

Azure portal にサインインします。
複数のテナントにアクセスできる場合は、[ディレクトリとサブスクリプション] フィルター () を使用して、アプリケーションを登録するテナントを選択してください。
Microsoft Entra ID を検索して選択します。
[管理] で [アプリの登録]>[新規登録] の順に選択します。
[名前] フィールドにアプリケーションの名前を入力してください (例: Todo)。アプリのユーザーにはこの名前が表示されます。後で変更することもできます。
[サポートされているアカウントの種類] に、[任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ディレクトリ - マルチテナント) と個人用の Microsoft アカウント] を選択してください。
[登録] を選択して、アプリケーションを作成します。
アプリの [概要] ページで、 [アプリケーション (クライアント) ID] の値を探し、後で使用するために記録します。これは、このプロジェクトの YAML 構成ファイルを構成するために必要です。
[管理] で [API の公開] を選択し、ページの先頭にある [アプリケーション ID の URI] を見つけて、[追加] を選択してください。
[アプリケーション ID の URI の編集] ページで、提案されたアプリケーション ID URI (api://{client ID}) をそのまま使用するか、クライアント ID の代わりにわかりやすい名前 (api://simple-todo など ) を使用して、[保存] を選択してください。
[管理] で、[API の公開]>[スコープの追加] を選択し、次の情報を入力してください。
- [スコープ名] に「ToDo.Read」と入力してください。
- [同意できるユーザー] には [管理者のみ] を選択してください。
- [管理者の同意の表示名] には、「ToDo データの読み取り」と入力してください。
- [管理者の同意の説明] として、「認証済みユーザーが ToDo データを読み取ることができます。」と入力してください。
- [状態] は有効のままにしてください。
- スコープの追加を選択します。
前の手順を繰り返して、他の 2 つのスコープ (ToDo.Write と ToDo.Delete) を追加します。

3.6. アプリケーションの構成を更新する

simple-todo-api アプリの src/main/resources/application.yml ファイルを見つけます。次の例に一致するように、spring.cloud.azure.active-directory セクションの構成を更新します。プレースホルダーを、必ず前に作成した値で置き換えてください。
```
spring:
  cloud:
    azure:
      active-directory:
        profile:
          tenant-id: <tenant>
        credential:
          client-id: <your-application-ID-of-ToDo>
        app-id-uri: <your-application-ID-URI-of-ToDo>
```
Note

v1.0 トークンでは、構成には API のクライアント ID が必要ですが、v2.0 トークンでは、要求でクライアント ID またはアプリケーション ID URI を使用できます。対象ユーザーの検証を適切に完了するために、両方を構成することができます。

tenant-id に使用できる値: common、organizations、consumers、またはテナント ID。これらの値の詳細については、「エラー AADSTS50020 - ID プロバイダーのユーザーアカウントがテナントに存在しない」の「間違ったエンドポイント (個人用アカウントと organization アカウント) を使用しました」セクションを参照してください。シングルテナントアプリの変換については、「Microsoft Entra ID でシングルテナントアプリをマルチテナントに変換する」を参照してください。
次のコマンドを使用して、サンプルプロジェクトをリビルドしてください。
```
./mvnw clean package
```

3.1. Azure リソースを準備する

必要な Azure リソースをプロビジョニングするには、次の手順に従います。

次のコマンドを実行して、OAuth2 を使って Azure にログインしてください。既にログインしている場合は、この手順は無視してください。
```
azd auth login
```
次のコマンドを実行して、Azure Spring Apps の機能を有効にしてください。
```
azd config set alpha.springapp on
```
次のコマンドを実行して、アプリケーションのデプロイ可能なコピーをパッケージ化し、テンプレートのインフラストラクチャを 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>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/overview
```
Note

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

3.2. RESTful API を公開する

次の手順を使用して、Microsoft Entra ID に RESTful API を公開します。

Azure portal にサインインします。
複数のテナントにアクセスできる場合は、[ディレクトリとサブスクリプション] フィルター () を使用して、アプリケーションを登録するテナントを選択してください。
Microsoft Entra ID を検索して選択します。
[管理] で [アプリの登録]>[新規登録] の順に選択します。
[名前] フィールドにアプリケーションの名前を入力してください (例: Todo)。アプリのユーザーにはこの名前が表示されます。後で変更することもできます。
[サポートされているアカウントの種類] に、[任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ディレクトリ - マルチテナント) と個人用の Microsoft アカウント] を選択してください。
[登録] を選択して、アプリケーションを作成します。
アプリの [概要] ページで、 [アプリケーション (クライアント) ID] の値を探し、後で使用するために記録します。これは、このプロジェクトの YAML 構成ファイルを構成するために必要です。
[管理] で [API の公開] を選択し、ページの先頭にある [アプリケーション ID の URI] を見つけて、[追加] を選択してください。
[アプリケーション ID の URI の編集] ページで、提案されたアプリケーション ID URI (api://{client ID}) をそのまま使用するか、クライアント ID の代わりにわかりやすい名前 (api://simple-todo など ) を使用して、[保存] を選択してください。
[管理] で、[API の公開]>[スコープの追加] を選択し、次の情報を入力してください。
- [スコープ名] に「ToDo.Read」と入力してください。
- [同意できるユーザー] には [管理者のみ] を選択してください。
- [管理者の同意の表示名] には、「ToDo データの読み取り」と入力してください。
- [管理者の同意の説明] として、「認証済みユーザーが ToDo データを読み取ることができます。」と入力してください。
- [状態] は有効のままにしてください。
- スコープの追加を選択します。
前の手順を繰り返して、他の 2 つのスコープ (ToDo.Write と ToDo.Delete) を追加します。

3.3. アプリケーションの構成を更新する

simple-todo-api アプリの src/main/resources/application.yml ファイルを見つけます。次の例に一致するように、spring.cloud.azure.active-directory セクションの構成を更新します。プレースホルダーを、必ず前に作成した値で置き換えてください。
```
spring:
  cloud:
    azure:
      active-directory:
        profile:
          tenant-id: <tenant>
        credential:
          client-id: <your-application-ID-of-ToDo>
        app-id-uri: <your-application-ID-URI-of-ToDo>
```
Note

v1.0 トークンでは、構成には API のクライアント ID が必要ですが、v2.0 トークンでは、要求でクライアント ID またはアプリケーション ID URI を使用できます。対象ユーザーの検証を適切に完了するために、両方を構成することができます。

tenant-id に使用できる値: common、organizations、consumers、またはテナント ID。これらの値の詳細については、「エラー AADSTS50020 - ID プロバイダーのユーザーアカウントがテナントに存在しない」の「間違ったエンドポイント (個人用アカウントと organization アカウント) を使用しました」セクションを参照してください。シングルテナントアプリの変換については、「Microsoft Entra ID でシングルテナントアプリをマルチテナントに変換する」を参照してください。
次のコマンドを使用して、サンプルプロジェクトをリビルドしてください。
```
./mvnw clean package
```

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

アプリを Azure Spring Apps にデプロイできるようになりました。

Azure portal + Maven プラグイン
Azure Developer CLI

次の手順に従って、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 キーを直接押します。
- Azure Spring Apps <your-instance-name> で既存のアプリを使う: 作成したアプリを使うには、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
```

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

azd deploy

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

Deploying services (azd deploy)

WARNING: Feature 'springapp' is in alpha stage.
To learn more about alpha features and their support, visit https://aka.ms/azd-feature-stages.

...

Deploying service simple-todo-api (Fetching endpoints for spring app service)
- Endpoint: https://simple-todo-api.xxxxxxxx-xxxxxxxx.xxxxxx.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

出力の Endpoint は、ToDo API アプリケーションにアクセスするためのベースエンドポイントです。

Note

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

5. アプリを検証します

RESTful API にアクセスして、動作するかどうかを確認できるようになりました。

5.1. アクセストークンの要求

クライアントアプリケーションの登録

Azure portal にサインインします。
複数のテナントにアクセスできる場合は、[ディレクトリとサブスクリプション] フィルター () を使用して、アプリケーションを登録するテナントを選択してください。
Microsoft Entra ID を検索して選択します。
[管理] で [アプリの登録]>[新規登録] の順に選択します。
アプリケーションの名前を [名前] フィールドに入力してください (例: ToDoWeb)。アプリのユーザーにはこの名前が表示されます。後で変更することもできます。
[サポートされているアカウントの種類] で、既定値の [この組織のディレクトリ内のアカウントのみ] を選択してください。
[登録] を選択して、アプリケーションを作成します。
アプリの [概要] ページで、 [アプリケーション (クライアント) ID] の値を探し、後で使用するために記録します。アクセストークンを取得するためにこれが必要です。
[API のアクセス許可] 、 [アクセス許可の追加] 、 [自分の API] の順に選択します。先ほど登録した ToDo アプリケーションを選択し、ToDo.Read、ToDo.Write、ToDo.Delete アクセス許可を選択してください。 アクセス許可の追加 を選択します。
[<テナント名>に管理者の同意を付与する] を選択し、追加したアクセス許可に管理者の同意を付与してください。

RESTful API にアクセスするためのユーザーの追加

[管理] で、[ユーザー]>[新しいユーザー]>[新しいユーザーの作成] を選択してください。
[新しいユーザーの作成] ページで、次の情報を入力してください。
- ユーザープリンシパル名: ユーザーの名前を入力してください。
- 表示名: ユーザーの表示名を入力してください。
- パスワード: [パスワード] ボックスに表示されている自動生成されたパスワードをコピーしてください。
Note

新しいユーザーは、最初のサインイン認証を完了してパスワードを更新する必要があります。そうしないと、アクセストークンを AADSTS50055: The password is expired 取得するとエラーが表示されます。

新しいユーザーがログインすると、[操作が必要です] というダイアログが表示されます。 [後で確認] を選択して検証をスキップできます。
[確認および作成] を選択して、選択内容を確認します。 [作成] を選択してユーザーを作成してください。

Swagger UI 承認の OAuth2 構成を更新する

Azure portal で [Microsoft Entra ID] テナントを開き、登録済みの ToDoWeb アプリに移動してください。
[管理] で [認証] を選択し、[プラットフォームの追加] を選択し、[シングルページアプリケーション] を選択してください。
"リダイレクト URI" フィールド内の OAuth2 リダイレクト URL として <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html 形式を使い、[構成] を選択します。

アクセストークンを取得する

OAuth 2.0 認証コードフローメソッドを使用して Microsoft Entra ID でアクセストークンを取得し、ToDo アプリの RESTful API にアクセスするには、次の手順を使用してください。

アプリによって公開されている URL を開き、[承認] を選択して OAuth2 認証を準備します。
[使用可能な承認] ウィンドウで、[client_id] フィールドに ToDoWeb アプリのクライアント ID を入力し、[スコープ] フィールドのすべてのスコープを選択し、[client_secret] フィールドは無視して、[承認] を選択して Microsoft Entra サインインページにリダイレクトします。

前のユーザーによるサインインが完了すると、[使用可能な承認] ウィンドウに戻ります。

5.2. RESTful API にアクセスする

Swagger UI で ToDo アプリの RESTful API にアクセスするには、次の手順に従います。

API POST /api/simple-todo/lists を選択し、[試してみる] を選択してください。次の要求本文を入力し、[実行] を選択して ToDo リストを作成してください。
```
{
  "name": "My List"
}
```
実行が完了すると、次の応答本文が表示されます。
```
{
  "id": "<ID-of-the-ToDo-list>",
  "name": "My List",
  "description": null
}
```
API POST /api/simple-todo/lists/{listId}/items を選択し、[試してみる] を選択してください。listId の場合は、前に作成した ToDo リスト ID を入力し、次の要求本文を入力して、[実行] を選択して ToDo アイテムを作成してください。
```
{
  "name": "My first ToDo item", 
  "listId": "<ID-of-the-ToDo-list>",
  "state": "todo"
}
```
このアクションにより、次の ToDo 項目が返されます。
```
{
  "id": "<ID-of-the-ToDo-item>",
  "listId": "<ID-of-the-ToDo-list>",
  "name": "My first ToDo item",
  "description": null,
  "state": "todo",
  "dueDate": "2023-07-11T13:59:24.9033069+08:00",
  "completedDate": null
}
```
API GET /api/simple-todo/lists を選択し、[実行] を選択して ToDo リストにクエリを実行してください。このアクションにより、次の ToDo リストが返されます。
```
[
  {
    "id": "<ID-of-the-ToDo-list>",
    "name": "My List",
    "description": null
  }
]
```
API GET /api/simple-todo/lists/{listId}/items を選択し、[試してみる] を選択してください。listId の場合は、前に作成した ToDo リスト ID を入力し、[実行] を選択して ToDo 項目のクエリを実行してください。このアクションにより、次の ToDo 項目が返されます。
```
[
  {
    "id": "<ID-of-the-ToDo-item>",
    "listId": "<ID-of-the-ToDo-list>",
    "name": "My first ToDo item",
    "description": null,
    "state": "todo",
    "dueDate": "2023-07-11T13:59:24.903307+08:00",
    "completedDate": null
  }
]
```

API PUT /api/simple-todo/lists/{listId}/items/{itemId} を選択し、[試してみる] を選択してください。listId には、ToDo リスト ID を入力してください。 itemId の場合は、ToDo 項目 ID を入力し、次の要求本文を入力し、[実行] を選択して ToDo 項目を更新してください。

{
  "id": "<ID-of-the-ToDo-item>",
  "listId": "<ID-of-the-ToDo-list>",
  "name": "My first ToDo item",
  "description": "Updated description.",
  "dueDate": "2023-07-11T13:59:24.903307+08:00",
  "state": "inprogress"
}

このアクションにより、次の更新された ToDo 項目が返されます。

{
  "id": "<ID-of-the-ToDo-item>",
  "listId": "<ID-of-the-ToDo-list>",
  "name": "My first ToDo item",
  "description": "Updated description.",
  "state": "inprogress",
  "dueDate": "2023-07-11T05:59:24.903307Z",
  "completedDate": null
}

API DELETE /api/simple-todo/lists/{listId}/items/{itemId} を選択し、[試してみる] を選択してください。listId には、ToDo リスト ID を入力してください。 itemId の場合は、ToDo 項目 ID を入力し、[実行] を選択して ToDo 項目を削除してください。サーバー応答コード 204 が表示されます。

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

Azure リソースグループを削除した場合、そのリソースグループに含まれたすべてのリソースが対象となります。

Azure portal + Maven プラグイン
Azure CLI

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

Azure Portal で目的のリソースグループを探します。
ナビゲーションメニューで、 [リソースグループ] を選択します。次に、リソースグループ名を選択します - 例えば myresourcegroup など。
リソースグループページで [削除] を選択します。リソースグループ名 (例: myresourcegroup など) をテキストボックスに入力して、削除を確認してください。次に、 [削除] を選択します。

次のコマンドを使用して、新しく作成したサーバーを含むリソースグループ全体を削除します。

az group delete --name ${RESOURCE_GROUP}

Azure portal + Maven プラグイン
Azure Developer CLI

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

Azure Portal で目的のリソースグループを探します。
ナビゲーションメニューで、 [リソースグループ] を選択します。次に、リソースグループ名を選択します - 例えば myresourcegroup など。
リソースグループページで [削除] を選択します。リソースグループ名 (例: myresourcegroup など) をテキストボックスに入力して、削除を確認してください。次に、 [削除] を選択します。

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

azd down

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

Total resources to delete: [your-resources-total], are you sure you want to continue? (削除するリソースの合計: [ご自分のリソースの合計] 削除しますか?): y キーを押してください。

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

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

7. 次のステップ

クイックスタート: イベントドリブンアプリケーションを Azure Spring Apps にデプロイする

クイックスタート: マイクロサービスアプリケーションを Azure Spring Apps にデプロイする

Azure Spring Apps の構造化アプリケーションログ

既存のカスタムドメインを Azure Spring Apps にマップする

GitHub Actions で Azure Spring Apps の CI/CD を使用する

Azure Spring Apps へのアプリケーションデプロイを自動化する

詳細については、次の記事を参照してください。

Share via

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

1.前提条件

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

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

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

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

3.3. PostgreSQL インスタンスを準備する

3.4. アプリ インスタンスを PostgreSQL インスタンスに接続する

3.5. RESTful API を公開する

3.6. アプリケーションの構成を更新する

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

5. アプリ を検証します

5.1. アクセス トークンの要求

クライアント アプリケーションの登録

RESTful API にアクセスするためのユーザーの追加

Swagger UI 承認の OAuth2 構成を更新する

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

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

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

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

3.3. PostgreSQL インスタンスを準備する

3.4. アプリ インスタンスを PostgreSQL インスタンスに接続する

3.5. RESTful API を公開する

3.6. アプリケーションの構成を更新する

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

5. アプリ を検証します

5.1. アクセス トークンの要求

クライアント アプリケーションの登録

RESTful API にアクセスするためのユーザーの追加

Swagger UI 承認の OAuth2 構成を更新する

アクセス トークンを取得する

5.2. RESTful API にアクセスする

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

7. 次のステップ

その他のリソース

3.4. アプリインスタンスを PostgreSQL インスタンスに接続する

5. アプリを検証します

5.1. アクセストークンの要求

クライアントアプリケーションの登録

3.4. アプリインスタンスを PostgreSQL インスタンスに接続する

5. アプリを検証します

5.1. アクセストークンの要求

クライアントアプリケーションの登録

アクセストークンを取得する