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

2025-04-12

Den här artikeln 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

Kategori	Requirement
Installation	Azure CLI-tillägget för Azure Deployment Environments.
Förfarande	Slutförande av Skapa och konfigurera ett utvecklingscenter med hjälp av Azure CLI.
Förfarande	Slutförande av Skapa och konfigurera ett projekt med hjälp av Azure CLI.
Behörigheter	Skapa en miljö: Användarrollen Distributionsmiljöer , Rollen DevCenter-projektadministratör eller en inbyggd roll som har rätt behörigheter.

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 Portal.

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).

Anmärkning

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 Läsare för distributionsmiljöer kan visa sina egna miljöer och de miljöer som skapats av andra.

Logga in på Azure CLI:
```
az login
```
Installera eller uppgradera Azure Dev Center-tillägget för CLI:
```
az extension add --name devcenter --upgrade
```
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
```
Konfigurera standardprenumerationen som den prenumeration som innehåller projektet:
```
az account set --subscription <subscriptionName>
```
Konfigurera standardresursgruppen som den resursgrupp som innehåller projektet:
```
az config set defaults.group=<resourceGroupName>
```

Visa en lista över de typer av miljöer som du kan skapa i ett visst projekt:

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

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

Skapa en miljö med hjälp av en miljödefinition (en infrastruktur-som-kod-mall som definieras 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

Anmärkning

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ö.

If you don't have the correct permissions, the environment isn't created. 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ö

To access an environment:

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>

Visa åtkomstslutpunkterna för olika resurser enligt definitionen i ARM-mallens utdata.
Få åtkomst till de specifika resurserna med hjälp av slutpunkterna.

Deploy an environment

az devcenter dev environment deploy --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"

Dela via