共用方式為


使用 Azure CLI 建立及存取環境

本指南說明如何使用 Azure CLI,在現有的 Azure 部署環境專案中建立和存取 環境

必要條件

建立環境

建立環境會自動建立必要的資源和資源群組來儲存它們。 資源群組名稱遵循模式 {projectName}-{environmentName}。 您可以在 Azure 入口網站中檢視資源群組。

在 Azure CLI 中完成下列步驟,以建立環境和設定資源。 您可以檢視特定 Azure Resource Manager 範本 (ARM 範本) 中所定義的輸出。

注意

只有具備部署環境使用者角色、DevCenter 專案管理員角色的使用者,或具備適當權限的內建角色可建立環境。 擁有部署環境讀者角色的使用者,可以檢視自己的環境,以及其他人建立的環境。

  1. 登入 Azure CLI:

    az login
    
  2. 安裝 CLI 的 Azure 開發人員中心延伸模組。

    az extension add --name devcenter --upgrade
    
  3. 列出您有權存取的所有 Azure 部署環境專案:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
    
  4. 將預設訂用帳戶設定為包含專案的訂用帳戶:

    az account set --subscription <subscriptionName>
    
  5. 將預設資源群組設定為包含專案的資源群組:

    az config set defaults.group=<resourceGroupName>
    
  6. 列出您可以在特定專案中建立的環境類型:

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
    
  7. 列出特定專案可用的環境定義

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
    
  8. 使用環境定義建立環境 (environment.yaml 檔案中定義的基礎結構即程式碼範本),從可用的環境定義清單建立環境:

    az devcenter dev environment create --dev-center-name <devcenterName>
        --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
        --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
    

    如果特定的環境定義需要任何參數,請使用 --parameters 並提供參數作為 JSON 字串或 JSON 檔案。 例如:

    $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
    az devcenter dev environment create --dev-center-name <devcenterName>
        --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
        --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
        --parameters $params
    

注意

您可以使用 --help 來檢視任何命令、已接受引數及範例的詳細資料。 例如,使用 az devcenter dev environment create --help 來檢視建立環境的詳細資料。

針對權限錯誤進行疑難排解

您必須具有部署環境使用者角色、DevCenter 專案管理員角色,或具有建立環境所需權限的內建角色

如果您沒有正確的權限,則不會建立環境。 可能會顯示類似下列範例的錯誤訊息:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

若要解決此問題,請指派正確的權限:授與開發小組的存取權

存取環境

若要存取環境:

  1. 列出特定專案中可用的現有環境:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
    
  2. 檢視 ARM 範本輸出中所定義之各種資源的存取端點。

  3. 使用端點存取特定資源。

部署環境

az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

刪除環境

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"