Erstellen der Vorlagenstruktur

  • 6 Minuten

Die Azure Developer CLI (azd) unterstützt Sie beim Erstellen neuer Vorlagen für Ihre Apps mithilfe der azd init-Befehls- und Startervorlagen. In dieser Lerneinheit erstellen Sie das grundlegende Gerüst oder die Struktur einer neuen Vorlage, auf der Sie für den Rest des Moduls aufbauen.

  1. Führen Sie in einem leeren Verzeichnis auf Ihrem lokalen Computer den azd init-Befehl aus.

    azd init

  2. Die Befehlsausgabe zeigt eine Liste mit Startervorlagen und vollständigen Beispiel-App-Optionen an. Die Startervorlagen umfassen die grundlegende Ordnerstruktur, die Startinfrastruktur als Codedateien und andere Konfigurationsdateien mit Boilerplate, um mit dem Erstellen von Vorlagen zu beginnen. Die vollständigen Beispielvorlagen enthalten auch Platzhalteranwendungscode und die Dateien, die für die Bereitstellung erforderlich sind. In diesem Modul lernen Sie, Ihre eigene Vorlage zu erstellen, anstatt den vorhandenen App-Code zu ändern. Wählen Sie daher die Option Starter – Bicep aus der Liste aus. Die Azure Developer CLI unterstützt auch die Verwendung von Terraform, wenn Sie diese Option bevorzugen. Die Terraform-Unterstützung befindet sich derzeit im Alpha-Stadium und muss manuell aktiviert werden.

  3. Wenn Sie zur Eingabe eines Umgebungsnamens aufgefordert werden, geben Sie azdlearn oder einen Namen Ihrer Wahl ein. Der Umgebungsname beeinflusst die Benennung der bereitgestellten Ressourcen in Azure.

  4. Im aktuellen Verzeichnis werden mehrere Ordner erstellt:

    The starter template structure.

Hinweis

Sie haben vielleicht bemerkt, dass der Befehl azd init auch eine Projektvorlage namens Minimal bereitstellt, die die einfachste mögliche Vorlagenstruktur enthält. Die von Ihnen ausgewählte Vorlage Starter – Bicep enthält jedoch zusätzlichen Gerüstbaucode, der sehr nützlich, aber dennoch technologieunabhängig ist, so dass sie sich für den Einstieg oft hervorragend eignet.

Die generierten Ordner stellen alle wesentlichen Bausteine einer azd-Vorlage bereit:

  • .azdo: ein Ordner, der die .yml-Starterkonfigurationsdateien für CI/CD mit Azure Pipelines enthält
  • .azure: ein Ordner, der wichtige Einstellungen für die Azure-Umgebung der Vorlage enthält, z. B. den Umgebungsnamen
  • .devcontainer: ein Ordner mit Konfigurationsdateien, die zum Ausführen der Vorlage in einer Entwicklungscontainerumgebung verwendet werden
  • .github: ein Ordner mit einer .yml-Starterkonfigurationsvorlage zum Einrichten einer CI/CD-Pipeline über GitHub-Aktionen
  • infra: ein Ordner mit Bicep-Starterdateien für die IaC-Datei einer Vorlage Wenn Sie die Terraform-Startervorlage ausgewählt haben, enthält dieser Ordner stattdessen Terraform-Dateien.
  • azure.yaml: eine Datei, die beschreibt, wie die Teile Ihrer Anwendung Diensten in Azure zugeordnet werden

Diese Startervorlage enthält das meiste, was Sie zum Erstellen Ihrer eigenen azd-Vorlage benötigen. In den nächsten Einheiten erfahren Sie, wie Sie diese vorhandenen Dateien aktualisieren und neue Ressourcen hinzufügen, um eine vollständige Vorlage zu erstellen.