Dela via

Skapa och komma åt en miljö med hjälp av Azure CLI

  • Artikel

Den här guiden beskriver hur du skapar och får åtkomst till en miljö i ett befintligt Azure Deployment Environments-projekt med hjälp av Azure CLI.

Förutsättningar

Skapa en miljö

När du skapar en miljö skapas automatiskt de resurser och en resursgrupp som krävs för att lagra dem. Resursgruppens namn följer mönstret {projectName}-{environmentName}. Du kan visa resursgruppen i Azure-portalen.

Slutför följande steg i Azure CLI för att skapa en miljö och konfigurera resurser. Du kan visa utdata enligt definitionen i den specifika Azure Resource Manager-mallen (ARM-mall).

Kommentar

Endast användare som har användarrollen Distributionsmiljöer, rollen DevCenter-projektadministratör eller en inbyggd roll som har lämpliga behörigheter kan skapa en miljö. Användare som har rollen Distributionsmiljöer läsare kan visa sina egna miljöer och miljöer som skapats av andra.

  1. Logga in på Azure CLI:

    az login

  2. Installera Azure Dev Center-tillägget för CLI.

    az extension add --name devcenter --upgrade

  3. Visa en lista över alla Azure Deployment Environments-projekt som du har åtkomst till:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table

  4. Konfigurera standardprenumerationen som den prenumeration som innehåller projektet:

    az account set --subscription <subscriptionName>

  5. Konfigurera standardresursgruppen som den resursgrupp som innehåller projektet:

    az config set defaults.group=<resourceGroupName>

  6. Ange vilken typ av miljöer du kan skapa i ett visst projekt:

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table

  7. Lista de miljödefinitioner som är tillgängliga för ett visst projekt:

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table

  8. Skapa en miljö med hjälp av en miljödefinition (en infrastruktur som kodmall definierad i filen environment.yaml ) från listan över tillgängliga miljödefinitioner:

    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>

    Om den specifika miljödefinitionen kräver några parametrar använder --parameters du och anger parametrarna som en JSON-sträng eller en JSON-fil. Till exempel:

    $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

Kommentar

Du kan använda --help för att visa mer information om alla kommandon, accepterade argument och exempel. Använd till exempel az devcenter dev environment create --help för att visa mer information om hur du skapar en miljö.

Felsöka ett behörighetsfel

Du måste ha användarrollen Distributionsmiljöer, rollen DevCenter-projektadministratör eller en inbyggd roll som har de behörigheter som krävs för att skapa en miljö.

Om du inte har rätt behörigheter skapas inte miljön. Ett felmeddelande som i följande exempel kan visas:

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

Lös problemet genom att tilldela rätt behörigheter: Ge åtkomst till utvecklingsteamet.

Få åtkomst till en miljö

Så här kommer du åt en miljö:

  1. Visa en lista över befintliga miljöer som är tillgängliga i ett visst projekt:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>

  2. Visa åtkomstslutpunkterna för olika resurser enligt definitionen i ARM-mallens utdata.

  3. Få åtkomst till de specifika resurserna med hjälp av slutpunkterna.

Distribuera en miljö

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

Ta bort en miljö

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

Relaterat innehåll