使用 Azure 開發人員 CLI 在主權雲端上

本指南說明如何配置 Azure Developer CLI，以配置資源並在不同雲端部署應用程式。

Azure Developer CLI 支援以下雲端：

  • Azure Public （AzureCloud）預設
  • 由世紀互聯運行的 Azure （AzureChinaCloud）
  • Azure US Government （AzureUSGovernment）

Azure 公共雲是預設，若未指定雲端則使用。

驗證

切換雲端時，執行 azd auth login 以與指定的雲端進行驗證。

以下範例設定一個主權雲，並執行 azd auth login 以與該雲進行認證：

azd config set cloud.name AzureUSGovernment
azd auth login

雲端配置

雲端可以在使用者、專案或環境層級進行配置。 配置優先順序為：

  1. 環境配置會先被選擇
  2. 如果環境中沒有雲端配置，則會使用 專案設定 （azure.yaml）
  3. 若專案設定中未設定雲端，則使用 使用者設定 （azd config set）
  4. 如果使用者設定中沒有設定雲端，azd 會使用公開的 AzureCloud

用使用者設定配置雲端（azd config set）

設定雲端以進行所有 azd 操作，使用 azd config

azd config set cloud.name AzureCloud

azd config set cloud.name AzureChinaCloud

azd config set cloud.name AzureUSGovernment

在專案的 azure.yaml 檔案中設定雲端

用這個 cloud 物件在專案的 azure.yaml 檔案中設定雲端名稱。

name: project-name
cloud:
  name: AzureCloud

name: project-name
cloud:
  name: AzureChinaCloud

name: project-name
cloud:
  name: AzureUSGovernment

在環境的 config.json 檔案中配置雲端

透過更新環境中的環境設定檔 .azure/<environment-name>/config.json來設定特定環境的雲端。 這使得例如，能在不同雲端部署以滿足不同環境。

{
    "cloud": {
        "name": "AzureCloud"
    }
}

{
    "cloud": {
        "name": "AzureChinaCloud"
    }
}

{
    "cloud": {
        "name": "AzureUSGovernment"
    }
}

支援的指令與平台

支援的指令包括

  • auth
  • config
  • 部署
  • 宕機
  • env
  • 佈建
  • 向上
  • 顯示器
  • 節目

azd pipeline 主權雲不支援。

devcenter 這個平台在主權雲中不被支援。

使用 Terraform 進行部署

當你使用 Terraform 部署到主權雲端 azd 時， az CLI 也必須設定為使用所需的雲端。 請參閱 Terraform 的 Azure CLI 文件認證。

將環境變數 ARM_ENVIRONMENT 設為想要的環境。 常見的值包括：

  • public (預設值)
  • usgovernment
  • china

使用 az CLI 選擇合適的雲端：

az cloud set --name AzureCloud

az cloud set --name AzureChinaCloud

az cloud set --name AzureUSGovernment
  • 上次更新時間：