Übersicht der Azure Developer CLI-Vorlagen

Die Azure Developer CLI (azd) verwendet Vorlagen, um App-Ressourcen in der Cloud bereitzustellen und bereitzumachen. 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:

• Verwenden Sie eine vorhandene Vorlage für Ihre App.
• Erstellen Sie eine Vorlage aus Ihrem App-Code
• Schulung – Erstellen und Bereitstellen von azd Vorlagen

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:

Jede azd Vorlage erfordert die folgenden Mindestressourcen:

• Ein ordner infra, 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:

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

Die ursprünglichen App-Ressourcen sind unverändert, aber neue Assets wurden hinzugefügt, auf die azd für Befehle wie azd up angewiesen ist.

• Ein ordner "infra" 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 Verzeichnis src den bereitgestellten Azure-Ressourcen zuzuordnen.
• Ein Ordner .azure wurde erstellt, um Umgebungsvariablen azd zu speichern.
• Ein .github Ordner (optional) wurde hinzugefügt, um CI/CD-Pipelines über GitHub Aktionen zu unterstützen.

Workflows zum Erstellen von Vorlagen

Der Befehl azd init wird verwendet, um eine azd-Vorlage zum Bereitstellen und Deployen der App-Ressourcen auf 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

Code im aktuellen Verzeichnis verwenden

Mit dieser Option wird azd angewiesen, den Code in Ihrem Verzeichnis zu analysieren, um zu ermitteln, welche Technologien verwendet werden, wie zum Beispiel 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üstfunktionen unterstützt werden.

Besuchen Sie das Tutorial Beginnen Sie mit Ihrem App-Code, um eine Vorlage zu erstellen für Einzelheiten zur Implementierung dieses Ansatzes und weitere Informationen darüber, welche Azure-Ressourcen die automatische Erkennung und das Scaffolding unterstützen.

Vorlage auswählen

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 ".

Siehe auch

• Verwenden Sie eine vorhandene Vorlage für Ihre App.
• Erstellen Sie eine Vorlage aus Ihrem App-Code

Anfordern von Hilfe

Informationen zum Melden eines Fehlers, Anfordern von Hilfe oder Vorschlagen einer neuen Funktion für die Azure Developer CLI finden Sie auf der Seite Fehlerbehebung und Support.

Nächste Schritte