クイック スタート: Azure CLI を使用して App Service にサービス接続を作成する

このクイックスタートでは、Azure CLI を使用して Azure App Service でサービス接続を作成する手順について説明します。

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

前提条件

  • Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  • CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

    • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

    • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

    • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

  • このクイックスタートには、Azure CLI のバージョン 2.30.0 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。
  • このクイックスタートは、少なくとも 1 つの App Service が Azure 上で既に実行されていることを前提としています。 App Service がない場合は、作成します

初期セットアップ

  1. Service Connector を初めて使用する場合は、まずコマンド az provider register を実行して Service Connector リソース プロバイダーを登録します。

    az provider register -n Microsoft.ServiceLinker
    

    ヒント

    コマンド az provider show -n "Microsoft.ServiceLinker" --query registrationState を実行して、リソース プロバイダーが既に登録されているかどうかをチェックできます。 出力が Registered の場合、Service Connector は既に登録されています。

  2. 必要に応じて、Azure CLI の az webapp connection list-support-types コマンドを使用して、App Service でサポートされているターゲット サービスの一覧を取得します。

    az webapp connection list-support-types --output table
    

サービス接続を作成する

重要

マネージド ID の使用には Microsoft Entra ロールの割り当てへのアクセス許可が必要です。 このアクセス許可がない場合、接続の作成は失敗します。 このアクセス許可を自分に付与することをサブスクリプション所有者に依頼するか、アクセス キーを使って接続を作成できます。

Azure CLI の az webapp connection コマンドを使って次の情報を指定し、システム割り当てマネージド ID で Blob Storage へのサービス接続を作成します。

  • App Service が含まれているリソース グループの名前
  • App Service の名前
  • ストレージ アカウントが含まれるリソース グループの名前
  • ストレージ アカウントの名前
az webapp connection create storage-blob

Note

Blob Storage がない場合は、az webapp connection create storage-blob --new --system-identity を実行して、新しい Blob Storage リソースをプロビジョニングし、App Service インスタンスに直接接続できます。

接続の表示

Azure CLI の az webapp connection コマンドを実行して次の情報を指定し、App Service への接続の一覧を表示します。

  • App Service が含まれているリソース グループの名前
  • App Service の名前
az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

次のステップ

以下のチュートリアルに従い、サービス コネクタを使って独自のアプリケーションの構築を始めます。