マネージド ID を使用して Azure SQL Database を Azure Spring Apps にデプロイされたアプリに接続する

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

Note

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

この記事の適用対象: ✔️ Java ✔️ C#

この記事の適用対象: ✔️ Basic または Standard ✔️ Enterprise

この記事では、Azure Spring Apps にデプロイされたアプリのマネージド ID を作成し、それを使用して Azure SQL Database にアクセスする方法について説明します。

Azure SQL Database は、クラウド向けに構築されたインテリジェントでスケーラブルなリレーショナルデータベースサービスです。パフォーマンスと持続性を最適化する、AI を活用した自動機能により、常に最新の状態に保たれます。サーバーレスコンピューティングと Hyperscale ストレージオプションを使用することで、リソースが必要に応じて自動的にスケーリングされるため、ストレージサイズやリソースの管理に煩わされずに、新しいアプリケーションの構築に専念できます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure CLI バージョン 2.45.0 以上。
Spring Data JPA チュートリアルに従って Azure SQL Database をプロビジョニングし、Java アプリをローカルで操作できるようにします。
Azure Spring Apps のシステム割り当てマネージド ID チュートリアルに従って、マネージド ID を有効にして Azure Spring Apps でアプリをプロビジョニングします。

マネージド ID を使用して Azure SQL Database に接続する

手動の手順に従うか、Service Connector を使用して、マネージド ID を使用してアプリケーションを Azure SQL Database に接続できます。

手動で構成
Service Connector

マネージド ID にアクセス許可を付与する

SQL サーバーに接続して、次の SQL クエリを実行します。

CREATE USER [<managed-identity-name>] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [<managed-identity-name>];
ALTER ROLE db_datawriter ADD MEMBER [<managed-identity-name>];
ALTER ROLE db_ddladmin ADD MEMBER [<managed-identity-name>];
GO

<managed-identity-name> プレースホルダーの値はルール <service-instance-name>/apps/<app-name> に従います (例: myspringcloud/apps/sqldemo)。次のコマンドを使用して、Azure CLI でマネージド ID 名のクエリを実行することもできます。

az ad sp show --id <identity-object-ID> --query displayName

マネージド ID を使用するように Java アプリを構成する

次の例に示すように、src/main/resources/application.properties ファイルを開き、spring.datasource.url 行の末尾に Authentication=ActiveDirectoryMSI; を追加します。 $AZ _DATABASE_NAME 変数には、必ず正しい値を使用してください。

spring.datasource.url=jdbc:sqlserver://$AZ_DATABASE_NAME.database.windows.net:1433;database=demo;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;Authentication=ActiveDirectoryMSI;

Note

サービスコネクタは、デプロイレベルで作成されます。そのため、別のデプロイが作成された場合は、接続をもう一度作成する必要があります。

次の例に示すように、コマンドを使用して、システム割り当てマネージド ID を使用して az spring connection create Azure SQL Database に接続するように、Azure Spring Apps にデプロイされたアプリを構成します。

次のコマンドを使用して、Azure CLIの Service Connector パスワードレス拡張機能をインストールします。
```
az extension add --name serviceconnector-passwordless --upgrade
```

次のコマンドを使用してデータベースに接続します。

az spring connection create sql \
    --resource-group $SPRING_APP_RESOURCE_GROUP \
    --service $SPRING_APP_SERVICE_NAME \
    --app $APP_NAME \
    --deployment $DEPLOYMENT_NAME \
    --target-resource-group $SQL_RESOURCE_GROUP \
    --server $SQL_SERVER_NAME \
    --database $DATABASE_NAME \
    --system-identity

作成結果をチェックするには、次のコマンドを使用します。

export CONNECTION_NAME=$(az spring connection list \
   --resource-group $SPRING_APP_RESOURCE_GROUP \
   --service $SPRING_APP_SERVICE_NAME \
   --app $APP_NAME  \
   --query '[0].name' \
   --output tsv)

az spring connection list-configuration \
   --resource-group $SPRING_APP_RESOURCE_GROUP \
   --service $SPRING_APP_SERVICE_NAME \
   --app $APP_NAME  \
   --connection $CONNECTION_NAME

アプリを構築して Azure Spring Apps にデプロイする

アプリをリビルドし、「前提条件」の 2 番目の箇条書きでプロビジョニングした Azure Spring Apps にデプロイします。これで、JPA を使用して Azure Spring Apps の Azure SQL Database にデータを格納および取得するマネージド ID によって認証された Spring Boot アプリケーションが作成されました。

Share via