Delen via

Een omgeving maken en openen met behulp van de Azure CLI

  • Artikel

In deze handleiding wordt uitgelegd hoe u een omgeving maakt en opent in een bestaand Azure Deployment Environments-project met behulp van de Azure CLI.

Vereisten

Een omgeving maken

Als u een omgeving maakt, worden automatisch de vereiste resources en een resourcegroep gemaakt om ze op te slaan. De naam van de resourcegroep volgt het patroon {projectName}-{environmentName}. U kunt de resourcegroep weergeven in Azure Portal.

Voer de volgende stappen uit in de Azure CLI om een omgeving te maken en resources te configureren. U kunt de uitvoer bekijken zoals gedefinieerd in de specifieke ARM-sjabloon (Azure Resource Manager).

Notitie

Alleen gebruikers met de gebruikersrol Implementatieomgevingen, het DevCenter-project Beheer of een ingebouwde rol met de juiste machtigingen kunnen een omgeving maken. Gebruikers met de rol Lezer voor implementatieomgevingen kunnen hun eigen omgevingen en omgevingen bekijken die door anderen zijn gemaakt.

  1. Meld u aan bij de Azure CLI:

    az login

  2. Installeer de Azure Ontwikkelaarscentrum-extensie voor de CLI.

    az extension add --name devcenter --upgrade

  3. Geef een lijst weer van alle Azure Deployment Environments-projecten die u toegang hebt tot:

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

  4. Configureer het standaardabonnement als het abonnement dat het project bevat:

    az account set --subscription <subscriptionName>

  5. Configureer de standaardresourcegroep als de resourcegroep die het project bevat:

    az config set defaults.group=<resourceGroupName>

  6. Geef het type omgeving weer dat u in een specifiek project kunt maken:

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

  7. Geef de omgevingsdefinities weer die beschikbaar zijn voor een specifiek project:

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

  8. Maak een omgeving met behulp van een omgevingsdefinitie (een infrastructuur als codesjabloon die is gedefinieerd in het bestand environment.yaml ) uit de lijst met beschikbare omgevingsdefinities:

    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>

    Als voor de specifieke omgevingsdefinitie parameters zijn vereist, gebruikt --parameters u de parameters en geeft u deze op als een JSON-tekenreeks of een JSON-bestand. Bijvoorbeeld:

    $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

Notitie

U kunt --help meer informatie bekijken over opdrachten, geaccepteerde argumenten en voorbeelden. Gebruik bijvoorbeeld az devcenter dev environment create --help om meer informatie weer te geven over het maken van een omgeving.

Een machtigingsfout oplossen

U moet beschikken over de gebruikersrol Implementatieomgevingen, het DevCenter-project Beheer rol of een ingebouwde rol met de vereiste machtigingen voor het maken van een omgeving.

Als u niet over de juiste machtigingen beschikt, wordt de omgeving niet gemaakt. Er kan een foutbericht zoals in het volgende voorbeeld worden weergegeven:

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

Wijs de juiste machtigingen toe om het probleem op te lossen: Geef toegang tot het ontwikkelteam.

Toegang tot een omgeving

Toegang krijgen tot een omgeving:

  1. Maak een lijst met bestaande omgevingen die beschikbaar zijn in een specifiek project:

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

  2. Bekijk de toegangseindpunten voor verschillende resources zoals gedefinieerd in de ARM-sjabloonuitvoer.

  3. Toegang tot de specifieke resources met behulp van de eindpunten.

Een omgeving implementeren

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

Een omgeving verwijderen

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

Gerelateerde inhoud