快速入門：使用 Azure CLI 在 Azure Spring Apps 中建立服務連線

本快速入門說明如何使用 Azure CLI 和服務 連線 器，將 Azure Spring Apps 連線到其他雲端資源。

服務 連線 or 可讓您快速將計算服務連線到雲端服務，同時管理連線的驗證和網路設定。

必要條件

• Azure 訂用帳戶。 如果您沒有 Azure 訂用帳戶，請在開始之前先建立 Azure 免費帳戶。

• 至少有一個應用程式由 Azure Spring Apps 裝載於 Service 連線 or 支援的區域。 如果您沒有應用程式，請將 第一個應用程式部署至 Azure Spring Apps。

• 在 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.37.0 版或更高版本。 若要升級至最新版本，請執行 az upgrade。 如果您是使用 Azure Cloud Shell，就已安裝最新版本。

• Azure Spring Apps 擴充功能必須安裝在 Azure CLI 或 Cloud Shell 中。 若要安裝它，請執行 az extension add --name spring。

初始設定

1. 如果您是第一次使用 Service 連線 or，請從執行命令 az provider register 來註冊 Service 連線 or 資源提供者開始。

   az provider register -n Microsoft.ServiceLinker
   

   提示

   您可以執行 命令 az provider show -n "Microsoft.ServiceLinker" --query registrationState來檢查資源提供者是否已註冊。 如果輸出為 Registered，則服務 連線 or 已經註冊。

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來檢查您是否已安裝必要的擴充功能。

建立服務連線

使用存取金鑰或受控識別，從 Azure Spring Apps 建立連線。

存取金鑰

1. az spring connection create執行 命令，以使用存取密鑰在 Azure Spring Apps 與 Azure Blob 儲存體 之間建立服務連線。

   az spring connection create storage-blob --secret
   

2. 在 CLI 或 Cloud Shell 的要求中提供下列資訊：

   設定	描述
   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 儲存體。

提示

如果您沒有 Blob 儲存體，您可以執行 az spring connection create storage-blob --new --secret 來布建新的 Blob 儲存體，並使用 連接字串 將它直接連線到 Azure Spring Apps 所裝載的應用程式。

受控識別

重要

若要使用受控識別，您必須擁有在 Microsoft Entra ID 中修改角色指派的許可權。 若沒有此許可權，您的連線建立將會失敗。 要求訂用帳戶擁有者授與您角色指派許可權，或使用存取密鑰來建立連線。

1. 執行 az spring connection create 命令，以使用系統指派的受控識別來建立 Blob 儲存體 的服務連線

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 儲存體。

提示

如果您沒有 Blob 儲存體，您可以執行 az spring connection create storage-blob --new --system-identity 來布建新的 Blob 儲存體，並使用受控識別直接連線到 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

輸出也會顯示連線的布建狀態：失敗或成功。

下一步

如需 Service 連線 or 和 Azure Spring Apps 的詳細資訊，請參閱下列指南。

教學課程：Azure Spring Apps + MySQL

教學課程：Confluent Cloud 上的 Azure Spring Apps + Apache Kafka