Azure Developer CLI (azd)-Vorlagenentwicklungsübersicht

Azure Developer CLI (azd)-Vorlagen verpacken die Konfiguration, Infrastruktur und optionalen Anwendungscode, der zum Bereitstellen und Bereitstellen einer Lösung auf Azure erforderlich ist. Sie können eine Vorlage für eine Anwendung, ein nur Infrastrukturprojekt oder einen wiederverwendbaren Ausgangspunkt für zukünftige Projekte verwenden.

Note

Bevor Sie beginnen, lesen Sie Azure Entwickler-CLI-Vorlagen für eine vollständige Beschreibung der Vorlagenstruktur, erforderliche und optionale Ressourcen, Dienst-zu-Ressource-Zuordnungen und wie azd Befehle jede Datei verwenden.

Vorlagenentwicklungsworkflow

Der folgende Workflow gilt unabhängig davon, ob Sie eine Vorlage erstellen oder eine bereits existierende Vorlage initialisieren:

Diagramm des Azd-Vorlagenentwicklungsworkflows, von der Auswahl eines Ausgangspunkts bis hin zum Ausführen von Azd und Verwalten der Vorlage.

  • Wählen Sie einen Ausgangspunkt aus:Beginnen Sie mit einer neuen Vorlage mit der GitHub Copilot Integration, einem anderen KI-Codierungsassistenten oder der direkten Dokumenterstellung. Alternativ können Sie mit einer vorhandenen Vorlage aus Microsoft, Ihrer Organisation oder der Entwicklercommunity beginnen.
  • Erkunden und Bearbeiten der Dateien: Überprüfen Sie, wie azure.yaml, Bicep- oder Terraform-Dateien, App-Code und unterstützende Konfiguration zusammenarbeiten. Siehe Durchsuchen und Bearbeiten von Vorlagendateien.
  • Erweitern und entwickeln Sie sich nach Bedarf: Hinzufügen, Ersetzen, Entfernen oder Neugestalten von App- und Infrastrukturkomponenten Folgen Sie der Erweiterung einer Vorlage für ein End-to-End-Beispiel, das eine Azure Ressource hinzufügt und eine Verbindung mit einer App herstellt.
  • Bereitstellen und Bereitstellen: Führen Sie die Ausführung azd up aus, um die Infrastruktur bereitzustellen und alle App-Dienste bereitzustellen. Weitere Informationen finden Sie unter "Erkunden des azd up Workflows".
  • Verwalten oder Teilen: Bearbeiten Sie die Vorlage weiter, während sich Ihr Projekt weiterentwickelt. Wenn Sie beabsichtigen, es weiterzugeben, testen Sie es zuerst in einem sauberen Verzeichnis und in einer neuen azd-Umgebung.

Note

In diesem Workflow können Sie Vorlagendateien selbst oder mithilfe eines KI-Codierungsassistenten erstellen, bearbeiten oder ersetzen. Das Ergebnis ist derselbe Satz von standardmäßigen, bearbeitbaren azd Ressourcen.

Vorlagenbausteine

Jede azd Vorlage unterstützt eine andere Lösung, aber die meisten Vorlagen kombinieren dieselben Arten von Ressourcen:

  • Project Konfiguration: Die azure.yaml Datei identifiziert die project, bereitstellungsfähigen Dienste, Quellverzeichnisse, Hostingziele und optionale Hooks oder Workflows.
  • Infrastruktur als Code: Bicep- oder Terraform-Dateien definieren die Azure Ressourcen, Rollenzuweisungen, Netzwerk- und App-Einstellungen, die die Lösung benötigt.
  • Anwendungsquelle: Eine Vorlage kann eine oder mehrere bereitstellungsfähige Apps enthalten oder nur Infrastruktur enthalten.
  • Umgebungskonfiguration: Parameter übergeben umgebungsspezifische Werte an Bereitstellungen, und Infrastrukturausgaben werden zu Werten in der aktiven azd Umgebung.

Eine Vorlage für eine App kann die folgende Ordnerstruktur verwenden:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Die genaue Struktur variiert je nach Projekt. App-Quellcode, Infrastrukturmodule und Pipeline-Dateien sind optional, und azure.yaml kennzeichnet die Pfade, die azd verwendet. Diese Ressourcen arbeiten während des gesamten Lebenszyklus der Vorlagenentwicklung zusammen.

Nächste Schritte

Beginnen mit einer neuen Vorlage

Hilfe anfordern

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.

  • Last updated on