Funktionsweise der Azure Developer CLI

  • 6 Minuten

Die Azure Developer CLI (azd) basiert auf entwicklungsfreundlichen Befehlen und grundlegenden Anwendungsvorlagen. azd stellt eine Reihe von Befehlen bereit, mit denen Sie Ihre Anwendung mithilfe standardisierter Projektvorlagen in Azure integrieren und verwalten können. Diese Vorlagen enthalten alle erforderlichen Quellcode- und Konfigurationsressourcen, um Ihre App in Azure bereitzustellen. Sie können azd nutzen, indem Sie eine der vorhandenen und erweiterbaren Beispielvorlagen verwenden oder eine eigene erstellen.

Erkunden der azd-Befehle

Die Azure Developer CLI enthält eine Reihe von praktischen Befehlen, die sich an den gängigen Entwicklungsworkflowphasen orientieren, z. B. der Bereitstellung von Ressourcen. Einige azd-Befehle, z. B. azd up verarbeiten auch mehrere Phasen gleichzeitig, und tragen damit zur weiteren Optimierung dieser Aufgaben bei.

Ein typischer azd-Workflow, bei dem eine vorhandene Vorlage verwendet wird, umfasst beispielsweise die folgenden Schritte:

  1. Ausführen des Befehls azd init mit dem Parameter --template, um eine vorhandene Vorlage zu klonen, und Festlegen eines Umgebungsnamens nach entsprechender Aufforderung.

    azd init --template todo-nodejs-mongo

  2. Ausführen des Befehls azd auth login, um sich beim Azure-Abonnement anzumelden.

    azd auth login

  3. Ausführen des Befehls azd up, um die Vorlagenressource in Azure bereitzustellen.

    azd up

  4. Sobald Ihre Umgebung in Azure eingerichtet ist, können Sie die Anwendungsfeatures oder Azure-Ressourcenvorlagen lokal ändern und dann azd up erneut ausführen, um Ihre Änderungen bereitzustellen.

Zum Durchführen weiterer Aufgaben und zur Erweiterung dieses Workflows sind weitere azd-Befehle verfügbar. azd ist für eine minimale Anzahl von Befehlen mit einer geringen Anzahl von Parametern konzipiert und ist somit besonders benutzerfreundlich. Zu den am häufigsten verwendeten azd Befehlen gehören:

  • azd init: Initialisieren einer neuen Anwendung.
  • azd up: Bereitstellen von Azure-Ressourcen und Bereitstellen eines Projekts mit nur einem Befehl.
  • azd provision: Bereitstellen der Azure-Ressourcen für eine Anwendung.
  • azd deploy: Bereitstellen des Anwendungscodes in Azure.
  • azd pipeline: (Beta) Verwalten und Konfigurieren von Bereitstellungspipelines.
  • azd auth: Authentifizieren bei Azure.
  • azd config: Verwalten von azd-Konfigurationen (z. B. Azure-Standardabonnement, Azure-Region).
  • azd down: Löschen von Azure-Ressourcen für eine Anwendung.

Erkunden von azd-Vorlagen

Die Azure Developer CLI-Befehle sind für die Verwendung mit standardisierten Projektvorlagen vorgesehen. Jede Vorlage ist ein Coderepository, das bestimmte Datei- und Ordnerkonventionen erfüllt. Die Vorlagen enthalten die Ressourcen, die azd benötigt, um Azure-Ressourcen und optional den Anwendungsquellcode bereitzustellen. Einige Vorlagen enthalten möglicherweise keinen Anwendungsquellcode unter der Annahme, dass Sie Eigene hinzufügen. Wenn Sie einen Befehl wie azd up ausführen, verwendet das Tool die Projektvorlagenressourcen, um verschiedene Workflowschritte auszuführen, z. B. um Ressourcen in Azure bereitzustellen.

Es gibt zwei Standardansätze zur Verwendung von azd-Vorlagen:

  • Erweitern einer vorhandenen azd-Vorlage: Eine große Bibliothek mit azd-Vorlagen ist bereits vorhanden. Damit sind gängige lokale Anwendungsstapel, -szenarios und -architekturen abgedeckt. Auf der Website mit dem Awesome-AZD-Vorlagenkatalog finden Sie viele weitere Vorlagen. Wenn Sie eine Vorlage finden, die Ihrem lokalen Anwendungsstapel oder der gewünschten Architektur zugeordnet ist, können Sie sie als Ausgangspunkt verwenden. Ersetzen Sie dann das Quellcodeverzeichnis, und ändern Sie die Konfigurations- oder Infrastrukturdateien entsprechend Ihren Anforderungen.

  • Konvertieren einer eigenen App in eine azd-Vorlage: Sie können eine vorhandene App auch in eine azd template konvertieren. Informationen dazu finden Sie im Leitfaden Machen Sie Ihr Projekt kompatibel mit azd. Das Erstellen einer eigenen Vorlage ist anfangs oft mehr Arbeit, ermöglicht aber die meiste Kontrolle und erzeugt eine wiederverwendbare Lösung für zukünftige Entwicklungsarbeit an der App. Folgende Schritte sind im Wesentlichen zum Erstellen einer eigenen Vorlage erforderlich:

    • Initialisieren der Projektvorlage mit azd init

    • Erstellen der Infrastruktur als Codedateien mithilfe von Bicep oder Terraform

    • Aktualisieren der azure.yaml-Datei, um die App-Dienste mit den Azure-Ressourcen zu verknüpfen

    • Bereitstellen mit azd up

      A diagram showing the Azure Developer CLI template creation workflow.

Unabhängig davon, für welchen Ansatz Sie sich entscheiden, ist die resultierende Vorlagenstruktur identisch. Alle azd-Vorlagen enthalten die folgenden Ressourcen:

  • infra-Ordner: Enthält die alle Bicep- bzw. Terraform-Infrastructure-as-Code-Dateien für die azd-Vorlage. Mit Infrastructure-as-Code können Sie Infrastrukturressourcen und Konfigurationen in deklarativen Definitionsdateien definieren, die bei jeder Bereitstellung zuverlässig dieselben Umgebungen generieren. Terraform funktioniert auf verschiedenen Cloudplattformen, während Bicep nur für Azure verwendet werden kann. azd führt diese Dateien aus, um die Azure-Ressourcen zu erstellen, die zum Hosten Ihrer App erforderlich sind. Weitere Informationen zur Infrastructure-as-Code finden Sie im Schulungsmodul Was ist Infrastructure-as-Code?

  • azure.yaml-Datei: Eine Konfigurationsdatei, die einen oder mehrere Dienste in einem Projekt definiert und Azure-Ressourcen für die Bereitstellung zuordnet. So können Sie beispielsweise einen API-Dienst und einen Front-End-Webdienst jeweils mit Attributen definieren, mit denen die beiden Dienste verschiedenen Azure-Ressourcen für die Bereitstellung zugeordnet werden.

  • .azure-Ordner: Enthält wichtige Azure-Konfigurationen und -Umgebungsvariablen, z. B. den Speicherort für die Bereitstellung von Ressourcen oder andere Abonnementinformationen.

  • src folder: Enthält den gesamten bereitstellungsfähigen App-Quellcode. Einige azd-Vorlagen stellen nur Infrastrukturressourcen bereit. Das src-Verzeichnis ist leer, damit Sie eigenen Anwendungscode hinzufügen können.

    A screenshot showing the Azure Developer CLI template structure.

Die meisten azd-Vorlagen enthalten optional auch einen oder mehrere der folgenden Ordner:

  • .devcontainer-Ordner: Ermöglicht die Einrichtung einer Entwicklungscontainerumgebung für eine Anwendung. Hierbei handelt es sich um einen gängigen Ansatz für eine Entwicklungsumgebung, der nicht für azd spezifisch ist.
  • .github-Ordner: Enthält die CI/CD-Workflowdateien für GitHub Actions, den CI/CD-Standardanbieter für azd.
  • .azdo-Ordner: Wenn Sie Azure Pipelines für CI/CD verwenden möchten, definieren Sie die Workflowkonfigurationsdateien in diesem Ordner.