Freigeben über

Arbeiten mit Azure Developer CLI-Umgebungen

Die Azure Developer CLI (azd) unterstützt Sie beim Erstellen und Verwalten von Umgebungen mit ihren eigenen Konfigurationen, z. B. Dev, Test und Prod. In diesem Artikel wird erläutert, wie Sie Umgebungen erstellen und verwalten und wie Sie sie mit Ihren Bicep-Infrastrukturdateien verwenden.

Erstellen von Umgebungen

Erstellen Sie eine neue Umgebung mit dem azd env new Befehl:

azd env new <environment-name>

So erstellen Sie beispielsweise eine Entwicklungsumgebung:

azd env new dev

Wenn Sie einen Befehl ausführen, z azd up . B. oder azd deploy, fordert Sie auf, azd ein Azure-Abonnement und einen Speicherort für die neue Umgebung auszuwählen. Die Eingabeaufforderungseinstellungen werden in der neuen Umgebung .env oder config.json in Dateien gespeichert.

Sie können das Abonnement und den Standort auch direkt im Befehl angeben:

azd env new prod --subscription "My Production Subscription" --location eastus2

Umgebungen auflisten

Um alle verfügbaren Umgebungen für Ihr Projekt anzuzeigen, verwenden Sie Folgendes:

azd env list

Mit diesem Befehl werden alle von Ihnen erstellten Umgebungen angezeigt, wobei die aktuelle aktive Umgebung hervorgehoben wird:

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Wechseln zwischen Umgebungen

Verwenden Sie den azd env select Befehl, um zu einer anderen Umgebung zu wechseln:

azd env select <environment-name>

So wechseln Sie beispielsweise zu einer Produktionsumgebung:

azd env select prod

Hinweis

Dieser Befehl ändert Ihre aktive Umgebung, die sich auf nachfolgende azd Befehle wie provision oder deploy.

Grundlegendes zur Standardumgebung

Die globale Konfigurationsdatei .azure/config.json verfolgt Ihre aktuell ausgewählte Umgebung. Wenn Sie ausgeführt werden azd init und noch keine Umgebungen vorhanden sind, azd wird ihre erste Umgebung automatisch erstellt und als Standard festgelegt. Wenn Sie bereits über eine oder mehrere Umgebungen verfügen und ausgeführt werden azd env new <name>, azd werden Sie aufgefordert, auszuwählen, ob die neue Umgebung als Standard festgelegt werden soll. Wenn Sie dies ablehnen, wird die neue Umgebung erstellt, ihre aktuelle Auswahl bleibt jedoch unverändert.

Sie können die Standardumgebung für einen einzelnen Befehl vorübergehend außer Kraft setzen, indem Sie das --environment Flag verwenden. Die Verwendung dieses Flags ändert die Standardeinstellung für zukünftige Befehle nicht.

Aktualisieren von Umgebungseinstellungen

Sie können die lokalen Umgebungsvariablen mithilfe des azd env refresh Befehls aktualisieren. Dieser Befehl sucht die neueste Azure-Bereitstellung für Ihre App, ruft die Umgebungsvariablenwerte nach Namen ab und aktualisiert dann Die lokale .env Datei mit diesen neuesten Werten für die ausgewählte Umgebung. Wenn Sie z. B. sowohl eine als prod auch eine dev Version bereitgestellt haben und die dev Umgebung zurzeit ausgewählt ist, ruft sie die neueste Ausgabe aus dieser Bereitstellung ab, um die env-Datei aufzufüllen.

azd env refresh

Hinweis

Der azd env refresh Befehl stellt keine Ressourcen erneut zur Bereitstellung. Sie aktualisiert nur Ihre lokale Umgebungskonfiguration so, dass sie dem aktuellen Zustand in Azure entspricht.

Das Aktualisieren Ihrer Umgebung ist nützlich, wenn:

  • Sie möchten sicherstellen, dass Ihre lokale .env Datei die neuesten Ausgaben ihrer Infrastruktur widerspiegelt (z. B. Verbindungszeichenfolgen, Endpunkte usw.).
  • Sie müssen Umgebungsvariablen synchronisieren, nachdem ein Teamkollege die Umgebung aktualisiert hat.

Wenn andere Teammitglieder Änderungen an Umgebungskonfigurationen vorgenommen haben oder Wenn Sie Änderungen über das Azure-Portal vorgenommen haben, können Sie Ihre lokalen Umgebungseinstellungen aktualisieren mit:

Ausführen von Befehlen in bestimmten Umgebungen

Sie können viele azd Befehle in einer bestimmten Umgebung ausführen, ohne Ihre aktive Umgebung zu ändern, indem Sie das --environment Folgende verwenden oder -e kennzeichnen:

azd up --environment dev

Mit diesem Befehl wird der up Workflow (Bereitstellen und Bereitstellen) in der dev Umgebung ausgeführt, ohne die aktive Umgebung zu ändern.

Alternativ können Sie zuerst zu Ihrer beabsichtigten Umgebung wechseln:

azd env select test
azd up

Hinweis

Teams sollten die Verwendung von CICD-Pipelines über den azd pipeline config Befehl in Betracht ziehen, anstatt Bereitstellungen mithilfe von Befehlen wie azd up oder azd provision.

Löschen von Umgebungsressourcen

Verwenden Sie den azd down Befehl, um die Azure-Ressourcen für eine bestimmte Umgebung zu löschen:

azd down <environment-name>

Hinweis

Es ist derzeit nicht möglich, Umgebungen direkt mithilfe von Befehlen zu löschen oder umzubenennen azd . Wenn Sie eine Umgebung umbenennen müssen:

  • Dient azd down zum Löschen der Umgebungsressourcen.
  • Führen Sie die Ausführung aus azd env new <new-name> , um die neue Umgebung zu erstellen.
  • Löschen Sie den alten .env Ordner manuell aus .azure.

Verwenden des Umgebungsnamens in Infrastrukturdateien

Sie können die Variable aus der AZURE_ENV_NAME Datei Ihrer Umgebung .env verwenden, um Ihre Infrastrukturbereitstellungen in Bicep anzupassen. Dies ist nützlich, um Ressourcen basierend auf der aktuellen Umgebung zu benennen, zu kategorisieren oder zu konfigurieren.

Hinweis

Besuchen Sie die Arbeitsumgebungsvariablen , um mehr darüber zu erfahren, wie Sie Umgebungsvariablen verwenden, um Ihre Azure Developer CLI-Projekte zu konfigurieren.

  1. azd legt die AZURE_ENV_NAME Umgebungsvariable fest, wenn Sie ein Projekt initialisieren.

    AZURE_ENV_NAME=dev

  2. Verweisen Sie in Ihrer main.parameters.json Datei auf die Umgebungsvariable, sodass azd der Wert ersetzt wird:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "environmentName": {
      "value": "${AZURE_ENV_NAME}"
    }
  }
}

    Wenn Sie die Bereitstellung ausführen azd, wird der Wert von .env der Datei Bicep an die Bicep-Datei main.parameters.jsonübergeben.

  3. Definieren Sie in Ihrer Bicep-Vorlage einen Parameter für den Umgebungsnamen:

    param environmentName string

  4. Sie können den environmentName Parameter verwenden, um Ressourcen zu kategorisieren, wodurch leicht zu erkennen ist, zu welcher Umgebung eine Ressource gehört:

    param environmentName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'mystorage${uniqueString(resourceGroup().id)}'
  location: resourceGroup().location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  tags: {
    Environment: environmentName
    Project: 'myproject'
  }
}

Dieser Ansatz hilft bei der Ressourcenverwaltung, Kostennachverfolgung und Automatisierung, indem jede Ressource der Bereitstellungsumgebung zugeordnet wird.

Nächste Schritte

Verwalten von Umgebungsvariablen in azure Developer CLI

Anpassen Ihrer Azure Developer CLI-Workflows mithilfe von Hooks

  • Last updated on