Freigeben über

Erstellen und Zugreifen auf eine Umgebung mithilfe der Azure CLI

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

Voraussetzungen

Kategorie Anforderung
Installation Die Azure CLI-Erweiterung für Azure-Bereitstellungsumgebungen.
Procedure Abschluss des Erstellens und Konfigurieren eines Dev Centers mithilfe der Azure CLI.
Procedure Abschluss des Erstellens und Konfigurieren eines Projekts mithilfe der Azure CLI.
Erlaubnisse So erstellen Sie eine Umgebung: Die Benutzerrolle "Bereitstellungsumgebungen ", die Rolle "DevCenter-Projektadministrator " oder eine integrierte Rolle, die über entsprechende Berechtigungen verfügt.

Erstellen einer Umgebung

Durch das Erstellen einer Umgebung werden automatisch die erforderlichen Ressourcen und eine Ressourcengruppe erstellt, um sie zu speichern. Der Ressourcengruppenname folgt dem Muster {projectName}-{environmentName}. Sie können die Ressourcengruppe im Azure-Portal anzeigen.

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

Hinweis

Nur Benutzer, die über die Rolle "Bereitstellungsumgebungen" verfügen, die Rolle "DevCenter-Projektadministrator " oder eine integrierte Rolle, die über entsprechende Berechtigungen verfügt, können eine Umgebung erstellen. Benutzer mit der Rolle "Deployment Environments Reader " können ihre eigenen Umgebungen und Umgebungen anzeigen, die von anderen Benutzern erstellt wurden.

  1. Melden Sie sich bei der Azure CLI an:

    az login

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

    az extension add --name devcenter --upgrade

  3. Auflisten aller Azure Deployment Environments-Projekte, auf die Sie Zugriff haben:

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

  4. Konfigurieren Sie das Standardabonnement als 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. Auflisten des Typs der Umgebungen, 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-as-Code-Vorlage, 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

Sie können --help verwenden, um mehr Details zu jedem Befehl, zulässigen Argumenten und Beispielen anzuzeigen. Verwenden Sie az devcenter dev environment create --help z. B. zum Anzeigen weiterer Details zum Erstellen einer Umgebung.

Behandeln eines Berechtigungsfehlers

Sie müssen über die Rolle "Deployment Environments User ", die Rolle "DevCenter-Projektadministrator " oder eine integrierte Rolle verfügen, 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. Eine Fehlermeldung wie das folgende Beispiel kann angezeigt werden:

(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 Zugriff auf das Entwicklungsteam.

Zugreifen auf eine Umgebung

So greifen Sie auf eine Umgebung zu:

  1. Auflisten vorhandener Umgebungen, 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 ARM-Vorlagenausgaben definiert.

  3. Greifen Sie mithilfe der Endpunkte auf die spezifischen Ressourcen zu.

Bereitstellen einer Umgebung

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

Eine Umgebung löschen

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

Verwandte Inhalte

  • Last updated on