共用方式為

使用 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"

相關內容