Delen via

Een omgeving maken en openen met behulp van de Azure CLI

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

Vereiste voorwaarden

Categorie Voorwaarde
Installatie de Azure CLI-extensie voor Azure Deployment Environments.
Werkwijze Voltooiing van Een ontwikkelaarscentrum maken en configureren met behulp van de Azure CLI-.
Werkwijze Voltooiing van Een project maken en configureren met behulp van de Azure CLI-.
Machtigingen Een omgeving maken: de rol Gebruiker van implementatieomgevingen, de rol DevCenter Projectbeheerder of een ingebouwde rol met gepaste machtigingen.

Een omgeving maken

Het maken van een omgeving creëert automatisch de vereiste resources en een resourcegroep 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, de rol DevCenter-projectbeheerder 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 of upgrade de Azure Dev Center-extensie voor de CLI:

    az extension add --name devcenter --upgrade

  3. Geef een lijst weer van alle Azure Deployment Environment-projecten waartoe u toegang hebt:

    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. Vermeld de omgevingsdefinities 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 sjabloon voor infrastructuur als code 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 u --parameters en geeft u de parameters op als een JSON-tekenreeks of een JSON-bestand. Voorbeeld:

    $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 gebruiken om meer informatie weer te geven 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 rol Implementatieomgevingen gebruiker, de rol DevCenter-projectbeheerder 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-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"

Verwante inhoud

  • Last updated on