快速入門：使用 Azure CLI，在 Azure 容器應用程式中建立服務連線

發行項
05/22/2024

本快速入門說明如何使用 Azure CLI 和服務連接器，將 Azure 容器應用程式連線到其他雲端資源。服務連接器可讓您快速將計算服務連線到雲端服務，同時管理連線的驗證和網路設定。

重要

Azure 容器應用程式中的服務連接器目前為預覽狀態。請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

必要條件

Azure 訂用帳戶。如果您沒有 Azure 訂閱，請在開始之前，先建立 Azure 免費帳戶。
至少有一個部署至服務連接器所支援區域中 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.37.0 或更新版本。若要升級至最新版本，請執行 az upgrade。如果您是使用 Azure Cloud Shell，就已安裝最新版本。
容器應用程式延伸模組必須安裝在 Azure CLI 或 Cloud Shell 中。若要進行安裝，請執行 az extension add --name containerapp。

初始設定

如果您是第一次使用服務連接器，請從執行命令 az provider register 開始，註冊服務連接器資源提供者。
```
az provider register -n Microsoft.ServiceLinker
```
提示

您可以執行命令 az provider show -n "Microsoft.ServiceLinker" --query registrationState 來檢查資源提供者是否已註冊。如果輸出是 Registered，表示服務連接器已經註冊。
選擇性地執行命令 az containerapp connection list-support-types ，以取得 Azure 容器應用程式支援的目標服務清單。
```
az containerapp connection list-support-types --output table
```

建立服務連線

使用受控識別或存取金鑰建立連線。

受控識別
存取金鑰

重要

若要使用受控識別，您必須擁有修改 Microsoft Entra 角色指派的權限。沒有這個權限，就無法建立連線。您可以要求訂用帳戶擁有者授與您此權限，或改為使用存取金鑰來建立連線。

執行 az containerapp connection create 命令，以使用系統指派的受控識別，從 Azure 容器應用程式建立前往 Blob 儲存體的服務連線。
```
az containerapp connection create storage-blob --system-identity
```

在 Azure CLI 要求時提供下列資訊：

設定	描述
`The resource group that contains the container app`	包含容器應用程式的資源群組名稱。
`Name of the container app`	容器應用程式名稱。
`The container where the connection information will be saved`	容器應用程式的容器名稱。
`The resource group which contains the storage account`	包含儲存體帳戶之資源群組的名稱。
`Name of the storage account`	您要連線之儲存體帳戶的名稱。在本指南中，我們會使用 Blob 儲存體。

注意

如果您沒有 Blob 儲存體，您可以執行 az containerapp connection create storage-blob --new --system-identity 來佈建新的 Blob 儲存體，並使用受控識別直接連線到您的容器應用程式。

執行 az containerapp connection create 命令，以使用存取金鑰建立容器應用程式與 Azure Blob 儲存體之間的服務連線。
```
az containerapp connection create storage-blob --secret
```

在 Azure CLI 要求時提供下列資訊：

設定	描述
`The resource group that contains the container app`	包含容器應用程式的資源群組名稱。
`Name of the container app`	容器應用程式名稱。
`The container where the connection information will be saved`	容器應用程式的容器名稱。
`The resource group which contains the storage account`	包含儲存體帳戶之資源群組的名稱。
`Name of the storage account`	您要連線之儲存體帳戶的名稱。在本指南中，我們會使用 Blob 儲存體。

提示

如果您沒有 Blob 儲存體，您可以執行 az containerapp connection create storage-blob --new --secret 來佈建新的 Blob 儲存體，並使用連接字串直接連線到您的容器應用程式。

檢視連線

使用 Azure CLI 命令 az containerapp connection list 來列出所有容器應用程式的佈建連線。將下列命令中的預留位置 <container-app-resource-group> 和 <container-app-name> 取代為容器應用程式的資源組名和名稱。您也可以移除 [--output table] 選項，以檢視連線的詳細資訊。

az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table

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

下一步

服務連接器內部

共用方式為