Share via

Erstellen einer Umgebung und Zugreifen darauf mithilfe der Azure-Befehlszeilenschnittstelle

  • Artikel

In diesem Leitfaden wird erläutert, wie Sie mithilfe der Azure CLI eine Umgebung in einem vorhandenen Azure Deployment Environments-Projekt erstellen und darauf zugreifen.

Voraussetzungen

Erstellen einer Umgebung

Beim Erstellen einer Umgebung werden automatisch die erforderlichen Ressourcen und eine Ressourcengruppe für ihre Speicherung erstellt. Der Ressourcengruppenname folgt dem Muster {projectName}-{environmentName}. Sie können die Ressourcengruppe im Azure-Portal anzeigen.

Schließen Sie die folgenden Schritte in der Azure CLI ab, um eine Umgebung zu erstellen und Ressourcen zu konfigurieren. Sie können die Ausgaben anzeigen, wie in der spezifischen Azure Resource Manager-Vorlage (ARM-Vorlage) definiert.

Hinweis

Nur Benutzer, die über die Rolle Deployment Environments User-Rolle, die DevCenter Project Admin-Rolle oder eine integrierte Rolle verfügen, die über entsprechende Berechtigungen verfügt, können eine Umgebung erstellen. Benutzer, die über die Deployment Environments Reader-Rolle verfügen, können ihre eigenen Umgebungen und Von anderen erstellten Umgebungen anzeigen.

  1. Melden Sie sich bei der Azure CLI an:

    az login

  2. Installieren Sie die Azure Dev Center-Erweiterung für die CLI.

    az extension add --name devcenter --upgrade

  3. Listen Sie alle Azure Deployment Environments-Projekte auf, auf die Sie Zugriff haben:

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

  4. Konfigurieren Sie das Standardabonnement als das Abonnement, das das Projekt enthält:

    az account set --subscription <subscriptionName>

  5. Konfigurieren Sie die Standardressourcengruppe als Ressourcengruppe, die das Projekt enthält:

    az config set defaults.group=<resourceGroupName>

  6. Listen Sie die Art der Umgebungen auf, die Sie in einem bestimmten Projekt erstellen können:

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

  7. Auflisten der Umgebungsdefinitionen , die für ein bestimmtes Projekt verfügbar sind:

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

  8. Erstellen Sie eine Umgebung mithilfe einer Umgebungsdefinition (einer Infrastruktur als Codevorlage, die in der Datei "environment.yaml " definiert ist) aus der Liste der verfügbaren Umgebungsdefinitionen:

    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>

    Wenn für die spezifische Umgebungsdefinition Parameter erforderlich sind, verwenden --parameters Und stellen Sie die Parameter als JSON-Zeichenfolge oder JSON-Datei bereit. Beispiel:

    $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

Hinweis

Mit --help können Sie weitere Details zu jedem Befehl, akzeptierten Argumenten und Beispielen anzeigen. Verwenden Sie zum Beispiel az devcenter dev environment create --help, um weitere Details zum Erstellen einer Umgebung anzuzeigen.

Berechtigungsfehler behandeln

Sie müssen die Rolle Deployment Environments-Benutzer, DevCenter-Projektadministrator oder eine integrierte Rolle besitzen, die über die erforderlichen Berechtigungen zum Erstellen einer Umgebung verfügt.

Wenn Sie nicht über die richtigen Berechtigungen verfügen, wird die Umgebung nicht erstellt. Möglicherweise wird eine Fehlermeldung wie im folgenden Beispiel angezeigt:

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

Um das Problem zu beheben, weisen Sie die richtigen Berechtigungen zu: Gewähren Sie dem Entwicklungsteam Projektzugriff.

Zugreifen auf eine Umgebung

So greifen Sie auf eine Umgebung zu:

  1. Listen Sie vorhandene Umgebungen auf, die in einem bestimmten Projekt verfügbar sind:

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

  2. Zeigen Sie die Zugriffsendpunkte auf verschiedene Ressourcen an, wie in den Ausgaben der ARM-Vorlage definiert.

  3. Greifen Sie über die Endpunkte auf die spezifischen Ressourcen zu.

Bereitstellen einer Umgebung

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

Löschen einer Umgebung

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

Zugehöriger Inhalt