Beginnen Sie mit einer neuen Azure Developer CLI (azd)-Vorlage

Sie können verschiedene Erstellungsmethoden verwenden, um die Standarddateien in einer neuen Azure Developer CLI(azd)-Vorlage zu erstellen:

  • Verwenden Sie die GitHub Copilot Integration in azd init. Der integrierte Workflow analysiert vorhandene Projektdateien oder hilft Ihnen beim Planen eines neuen Projekts, erstellt die Vorlagenressourcen und führt die Überprüfung vor der Bereitstellung aus.
  • Verwenden Sie einen anderen KI-Codierungsassistenten. Fordern Sie den Assistenten auf, dieselben azure.yaml, die Infrastructure-as-Code, die Anwendung sowie die zugehörigen Dateien zu erstellen, ohne sich direkt in azd init zu integrieren.
  • Erstellen Sie die Dateien direkt. Erstellen und bearbeiten Sie die Vorlagenressourcen selbst, wenn Sie die vollständige Steuerung benötigen oder keinen KI-Codierungs-Assistenten verwenden möchten.

Dieser Artikel konzentriert sich in erster Linie auf den integrierten GitHub Copilot-Workflow, weil er eine geführte Benutzerführung bietet, die in azd integriert ist. Unabhängig von der Erstellungsmethode prüfen und validieren Sie jede Datei vor der Bereitstellung.

Important

Die GitHub Copilot-Integration in azd init ist als Vorschau verfügbar. Vorschaufeatures können sich vor der allgemeinen Verfügbarkeit ändern. Weitere Informationen finden Sie in der azd Featureversionsverwaltungs- und Releasestrategie.

Die generierten Ressourcen sind standardmäßige, bearbeitbare azd Vorlagendateien. Nach der Initialisierung können Sie sie direkt oder mit einem beliebigen KI-Codierungsassistenten aktualisieren.

Voraussetzungen für GitHub Copilot

Um den integrierten Copilot-Workflow zu verwenden, benötigen Sie Folgendes:

  • Azure Developer CLI 1.23.11 oder höher.
  • Ein aktives GitHub Copilot-Abonnement.
  • Git, das azd init verwendet, um das Arbeitsverzeichnis zu überprüfen, bevor Dateien geändert werden.
  • Eine interaktive Terminalsitzung.

Wenn Sie noch nicht bei GitHub Copilot angemeldet sind, fordert azd Sie auf, sich anzumelden.

Führen Sie die Ausführung azd version aus, um die installierte Azure Developer CLI-Version zu überprüfen.

Note

Der azd init Workflow startet eine dedizierte GitHub-Copilot-Agent Sitzung im Terminal. Es verwendet keine aktive GitHub Copilot-Chat-Sitzung in Visual Studio Code und setzt sie nicht fort.

Erstellen mit GitHub Copilot

  1. Öffnen Sie ein Terminal im Verzeichnis, in dem Sie die Vorlage erstellen möchten.

    Note

    Das Verzeichnis kann eine vorhandene Anwendung, ein Infrastrukturprojekt oder die ersten Dateien für eine neue Lösung enthalten. Wenn das Verzeichnis nicht übernommene Änderungen enthält, fordert azd Sie vor dem Fortfahren zur Bestätigung auf. Führen Sie zuerst einen Commit durch, oder heben Sie wichtige Änderungen auf.

  2. Ausführen azd init:

    azd init
    
  3. Wählen Sie "Mit GitHub-Copilot (Vorschau) einrichten" aus.

    Die Initialisierungsaufforderung ähnelt dem folgenden Beispiel:

    ? How do you want to initialize your app?
       Scan current directory
       Select a template
    > Set up with GitHub Copilot (Preview)
    
  4. Überprüfen Sie den angeforderten Toolzugriff, und gewähren Sie Zugriff auf die tools, die für den Workflow erforderlich sind. Copilot verwendet azd und Azure Entwicklungsfunktionen, um das Projekt zu untersuchen, Dateien zu erstellen und das Ergebnis zu überprüfen.

  5. Wählen Sie ein Modell und eine Argumentationsstufe aus, wenn azd Sie dazu auffordert.

    Beim ersten Start werden für die Aufforderungen die folgenden Bezeichnungen verwendet. Das verfügbare Modell und die Auswahl von Gründen hängen von Ihrem GitHub Copilot Konto und dem ausgewählten Modell ab:

    ? Select AI model
    ? Select reasoning effort level
    
  6. Beschreiben Sie, was Sie erstellen möchten. Beziehen Sie relevante Anforderungen ein, z. B.:

    • Gibt an, ob die Vorlage Anwendungscode, nur Infrastruktur oder beides enthält.
    • Die Anwendungssprachen und Frameworks, falls bekannt.
    • Die zu verwendenden Azure Dienste und Hostingplattform.
    • Ob Bicep oder Terraform verwendet werden soll.
    • Sicherheits-, Netzwerk-, Skalierungs- und Regionsanforderungen.

    Beispiel:

    Build an infrastructure-only azd template that provisions an Azure Container Apps
    environment, Azure Container Registry, and Log Analytics workspace with Bicep.
    Use managed identity and least-privilege role assignments. Parameterize the location
    and environment name so the template can be reused.
    
  7. Beantworten Sie alle Architektur- oder Konfigurationsfragen von Copilot. Der Agent bereitet das Projekt auf Azure vor, generiert die Vorlagenressourcen und führt die Überprüfung vor der Bereitstellung aus.

  8. Überprüfen Sie die Gesamtstruktur der Dateien, die von Copilot erstellt oder geändert wurden. Stellen Sie sicher, dass die Vorlage die erwartete Projektkonfiguration, das Infrastrukturverzeichnis, die Anwendungsquelle und unterstützende Ressourcen für Ihre Lösung enthält.

    Eine generierte Nur-Infrastruktur-Vorlage kann z. B. die folgenden Schlüsseldateien enthalten:

    azure.yaml
    infra/
    ├── main.bicep
    ├── main.parameters.json
    └── modules/
       ├── container-apps-environment.bicep
       └── container-registry.bicep
    

    Ausführliche Anleitungen zum Überprüfen der Konfigurations- und Infrastrukturinhalte finden Sie unter Erkunden und Bearbeiten von Vorlagendateien.

Einrichten und Bereitstellen der Vorlage

Nachdem Sie die generierten Dateien genehmigt haben, führen Sie den folgenden Befehl aus:

azd up

Der Befehl erstellt oder wählt eine azd Umgebung aus, stellt die Azure Ressourcen bereit, packt alle Anwendungsdienste und stellt sie bereit. Eine detaillierte Befehlsaufschlüsselung finden Sie unter "Erkunden des azd up Workflows".

Verwenden einer anderen Erstellungsmethode

Andere KI-Codierungsassistenten sind nicht direkt mit dem azd init Workflow verbunden, können aber dieselben Standardvorlagenressourcen erstellen. Sie können auch jedes Asset direkt selbst erstellen.

Erstellen Sie diese Ressourcen selbst, oder bitten Sie einen anderen Codierungsassistenten, Ihre Anforderungen zu analysieren und zu erstellen:

  • Eine azure.yaml Datei, die das Projekt definiert und bereitstellungsfähige Dienste definiert.
  • Bicep- oder Terraform-Dateien, die die erforderlichen Azure Ressourcen bereitstellen.
  • Ressourcenausgaben und Anwendungsumgebungsvariablen.
  • Dockerfiles, Bereitstellungskonfiguration und unterstützende Skripts bei Bedarf.

Um einen minimalen Ausgangspunkt vor der Verwendung eines anderen Agents bereitzustellen, führen Sie Folgendes aus:

azd init --minimal

Wenn Sie einen anderen Programmierassistenten verwenden, weisen Sie ihn an, das azure.yaml-Schema, die Azure-Infrastruktursicherheitsverfahren und die in Azure Developer CLI-Vorlagen beschriebenen Vorlagenkonventionen zu befolgen. Wenn Sie die Dateien direkt erstellen, verwenden Sie die gleichen Verweise wie Ihr Implementierungshandbuch. Überprüfen und validieren Sie alle Dateien, bevor Sie azd up ausführen.

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.