次の方法で共有

クイック スタート: Azure CLI を使用して Azure Spring Apps でサービス接続を作成する

  • [アーティクル]

このクイック スタートでは、Azure CLI と Service Connector を使用して Azure Spring Apps を他のクラウド リソースに接続する方法について説明します。

Service Connector を使用すると、接続の認証とネットワーク設定を管理しながら、コンピューティング サービスをクラウド サービスにすばやく接続できます。

前提条件

  • 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 を実行します。

  • バージョン 2.37.0 以降の Azure CLI。 最新バージョンにアップグレードするには、az upgrade を実行します。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

  • Azure Spring Apps 拡張機能が、Azure CLI または Cloud Shell にインストールされている必要があります。 インストールするには、az extension add --name spring を実行します。

初期セットアップ

  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. 必要に応じて、コマンド az spring connection list-support-types を実行して、Azure Spring Apps でサポートされているターゲット サービスの一覧を取得します。

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

    ヒント

    コマンド az spring がシステムに認識されない場合は、az extension add --name spring を実行して、必要な拡張機能がインストールされていることを確認します。

サービス接続を作成する

マネージド ID またはアクセス キーを使用して Azure Spring Apps から接続を作成します。

重要

マネージド ID を使用するには、Microsoft Entra ID でロールの割り当てを変更するアクセス許可が必要です。 サブスクリプション所有者に、ロールの割り当てのアクセス許可を依頼するか、アクセス キーを使用して接続を作成します。

  1. az spring connection create コマンドを実行して、Azure Spring Apps にデプロイされたアプリケーションを、システム割り当てマネージド ID を使用して Blob Storage リソースに接続します。

  2. CLI または Cloud Shell の要求に応じて、以下の情報を指定します。

    az spring connection create storage-blob --system-identity
    設定 説明
    The resource group which contains the spring-cloud Azure Spring Apps によってホストされているアプリを含むリソース グループの名前。
    Name of the spring-cloud service Azure Spring Apps リソースの名前。
    Name of the spring-cloud app ターゲット サービスに接続する Azure Spring Apps によってホストされているアプリケーションの名前。
    The resource group which contains the storage account ストレージ アカウントを持つリソース グループの名前。
    Name of the storage account 接続先のストレージ アカウントの名前。 このガイドでは、Blob Storage を使用しています。

ヒント

Blob Storage がない場合は、az spring connection create storage-blob --new --system-identity を実行して新しい Blob Storage をプロビジョニングし、マネージド ID を使用して Azure Spring Apps によってホストされているアプリケーションに直接接続できます。

接続の表示

コマンド az spring connection list を実行して、Azure Spring Apps のプロビジョニングされたすべての接続を一覧表示します。

以下のコマンドのプレースホルダー<azure-spring-apps-resource-group>、<azure-spring-apps-name>、<app-name> を Azure Spring Apps リソース グループの名前、Azure Spring Apps リソースの名前、アプリケーションの名前に置き換えます。 また、--output table オプションを削除して、接続に関する詳細情報を表示することもできます。

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

出力には、接続のプロビジョニングの状態 (失敗または成功) も表示されます。

次のステップ

サービス コネクタと Azure Spring Apps の詳細については、以下のガイドを参照してください。

チュートリアル: Azure Spring Apps + MySQL

チュートリアル: Azure Spring Apps + Confluent Cloud での Apache Kafka