Übersicht über die Erstellung von Azure Developer CLI-Vorlagen

Die Azure Developer CLI (azd) verwendet Vorlagen zum Bereitstellen und Bereitstellen von App-Ressourcen in der Cloud. Entwickler können Unterstützung für azd Befehle und Features hinzufügen, indem sie ihre Anwendungen in Vorlagen konvertieren. Dieser Artikel bietet eine kontextbezogene Übersicht über die verschiedenen Optionen zum Erstellen azd von Vorlagen. Nachdem Sie die Konzepte in diesem Artikel verstanden haben, besuchen Sie die folgenden Ressourcen, um detailliertere Implementierungshandbücher zu finden:

Hinweis

In diesem Artikel wird ein allgemeines Verständnis von azd Vorlagen vorausgesetzt. Weitere Informationen zu Vorlagen finden Sie im Vorlagenübersichtsdokument .

Vorlagenerstellungskonzepte

Zum Erstellen einer azd Vorlage müssen Ihrer vorhandenen Codebasis bestimmte Konfigurations- und Infrastrukturressourcen hinzugefügt oder eine neue App aus einer vorhandenen Vorlage gestartet werden, die dieselben Ressourcen enthält. Beide Workflows werden in späteren Abschnitten erläutert. Alle azd Vorlagen verwenden eine ähnliche Dateistruktur basierend auf azd Konventionen. Das folgende Diagramm bietet einen schnellen Überblick über den Prozess zum Erstellen einer azd Vorlage:

Diagramm des Azure Developer CLI-Vorlagenworkflows.

Jede azd Vorlage erfordert die folgenden Mindestressourcen:

  • Ein infra Ordner, der die Infrastruktur als Codedateien (Bicep oder Terraform) enthält.
  • Eine azure.yaml Konfigurationsdatei, die Ihre Anwendungsdienste den bereitgestellten Infrastrukturressourcen zuordnet.

Andere optionale Verzeichnisse sind häufig ebenfalls enthalten, z. B. ein .github Ordner mit Objekten zum Erstellen einer CI/CD-Pipeline. Weitere Informationen zu Vorlagen finden Sie im Vorlagenübersichtsdokument .

Betrachten Sie das folgende Beispiel-App-Repository:

Screenshot der Struktur der Beispiel-App.

Nach dem Konvertieren dieser Beispiel-App in eine azd Vorlage enthält dasselbe App-Repository Folgendes:

Screenshot der abgeschlossenen Struktur der Azd-Vorlage.

Die ursprünglichen App-Ressourcen sind unverändert, aber neue Ressourcen wurden hinzugefügt, die azd von Befehlen wie azd up:

  • Ein infra Ordner wurde hinzugefügt, der Bicep-Dateien enthält, um Azure-Ressourcen zu erstellen.
  • Eine azure.yaml Konfigurationsdatei wurde hinzugefügt, um den App-Code im src Verzeichnis den Bereitgestellten Azure-Ressourcen zuzuordnen.
  • Es wurde ein .azure Ordner erstellt, der Umgebungsvariablen enthält azd .
  • Ein .github Ordner (optional) wurde hinzugefügt, um CI/CD-Pipelines über GitHub-Aktionen zu unterstützen.

Workflows zum Erstellen von Vorlagen

Der azd init Befehl wird verwendet, um eine azd Vorlage für die Bereitstellung und Bereitstellung der App-Ressourcen in Azure zu initialisieren. Mit den Befehlen können Sie zwischen zwei verschiedenen Workflows wählen, um eine Vorlage zu initialisieren, die in den folgenden Abschnitten beschrieben wird: Verwenden Sie Code im aktuellen Verzeichnis und Verwenden einer vorhandenen Vorlage.

Führen Sie den azd init Befehl im Stammverzeichnis des Verzeichnisses aus, das Sie in ein Verzeichnis azd templatekonvertieren möchten:

azd init

Screenshot des Init-Prozesses der Vorlage.

Verwenden von Code im aktuellen Verzeichnis

Mit dieser Option wird angewiesen azd , den Code in Ihrem Verzeichnis zu analysieren, um zu ermitteln, welche Technologien verwendet werden, z. B. die Programmiersprache, das Framework und das Datenbanksystem. azd generiert automatisch Vorlagenressourcen für Sie, z. B. die Dienstdefinitionsdatei azure.yaml und den infra Ordner mit Infrastruktur-as-Code-Dateien. Die generierten Ressourcen sind ein Ausgangspunkt für zusätzliche Änderungen. Verwenden Sie diesen Ansatz, wenn Sie allgemeine Azure-Dienste verwenden möchten, die von azd Gerüstfeatures unterstützt werden.

Besuchen Sie den Start mit Ihrem App-Code, um ein Vorlagenlernprogramm zu erstellen, um Details zur Implementierung dieses Ansatzes zu erhalten und weitere Informationen darüber, welche Azure-Ressourcen die automatische Erkennung und das Gerüst unterstützen.

Auswählen einer Vorlage

Wählen Sie diese Option aus, um eine vorhandene Vorlage zu verwenden, die viele Ihrer Azure-Ressourcen und Architekturziele als Ausgangspunkt definiert. azd fordert Sie auf, eine Startvorlage oder eine andere Vorlage aus dem katalog "awesome-azd " auszuwählen. Wenn Sie eine Vorlage auswählen, werden die Ressourcen dieser Vorlage ihrem vorhandenen Projektverzeichnis hinzugefügt, das als Ausgangspunkt verwendet werden soll. Einige Vorlagen enthalten Beispiel-App-Code, den Sie durch Eigene ersetzen können, während einige (sogenannte "Startvorlagen") nur Infrastruktur sind.

Verwenden Sie den azd init Befehl, um eine vorhandene Vorlage in ein leeres Verzeichnis zu ziehen und sie als Ausgangspunkt für Ihre eigene App zu verwenden. Wenn die Vorlage App-Quellcode enthält, können Sie entweder aus diesem Code erstellen oder das Quellcodeverzeichnis durch Ihr eigenes ersetzen.

Weitere Informationen zur Implementierung dieses Ansatzes finden Sie im Lernprogramm "Start mit vorhandenen Vorlagen ".

Weitere Informationen

Hilfe anfordern

Informationen zum Ablegen eines Fehlers, Anfordern von Hilfe oder Vorschlagen eines neuen Features für die Azure Developer CLI finden Sie auf der Seite "Problembehandlung und Support ".

Nächste Schritte