Erkunden der Azure Developer CLI-Initialisierungsworkflows

Die Azure Developer CLI (azd) bietet eine Reihe von Befehlen zum Optimieren der Entwicklung, Bereitstellung und Bereitstellung von Apps in Azure. Mit dem azd init Befehl können Sie neue oder vorhandene Projekte einrichten, indem Sie die Dateien und Konfigurationen generieren, die für die Arbeit mit azderforderlich sind. In diesem Artikel werden die verschiedenen verfügbaren Initialisierungsworkflows erläutert und erklärt, wie Sie die beste Option für Ihr Entwicklungsszenario auswählen können.

Initialisierungsworkflows

Der azd init-Befehl unterstützt mehrere Workflows, um Ihre App darauf vorzubereiten, mit azd zu arbeiten.

• Verwenden Sie Code im aktuellen Verzeichnis: Analysiert eine vorhandene App-Codebasis, um geeignete azd Konfigurationsdateien und Ressourcen zu generieren.
• Wählen Sie eine Vorlage aus: Klonen und Initialisieren einer Vorlage aus einem azdVorlagenkatalog.
• Erstellen Sie ein minimales Projekt: Initialisiert eine Einfache azure.yaml Datei als Ausgangspunkt zum Erstellen einer eigenen azd Vorlage von Grund auf neu.

Wählen Sie den Ansatz aus, der am besten zu Ihrem Projekt passt. Alle diese Flüsse werden in der Übersicht "Vorlagen erstellen" und verwandten Artikeln ausführlicher beschrieben. In den folgenden Abschnitten finden Sie eine konzeptionelle Übersicht über jeden Fluss.

Verwendet Code im aktuellen Verzeichnis

Verwenden Sie diesen Workflow, wenn Sie über eine vorhandene App-Codebasis verfügen und diese für die Bereitstellung in azdAzure vorbereiten möchten.

1. Navigieren Sie zum Stammverzeichnis Ihres Projekts.

2. Führen Sie den Befehl azd init aus:

   azd init
   

3. Wählen Sie „Code im aktuellen Verzeichnis verwenden“ aus. azd Wille:

   • Scannen Sie Ihr Verzeichnis, um die Sprache oder das Framework zu ermitteln, die Ihre App verwendet.
   • Wählen Sie eine geeignete Hostingplattform aus, z. B. Azure-Container-Apps.
   • Sie werden aufgefordert, ermittelte Dienste bei Bedarf hinzuzufügen oder zu entfernen.

   ? How do you want to initialize your app? Use code in the current directory
   
     (✓) Done: Scanning app code in current directory
   
   Detected services:
   
     .NET
     Detected in: src
   
   azd will generate the files necessary to host your app on Azure using Azure Container Apps.
   
   ? Select an option  [Use arrows to move, type to filter]
   > Confirm and continue initializing my app
     Remove a detected service
     Add an undetected service
   

4. Wählen Sie "Bestätigen" aus, und fahren Sie fort, meine App zu initialisieren, um den Workflow abzuschließen. azd erstellt Folgendes in Ihrem App-Verzeichnis:

   • Eine azure.yaml Datei, die Ihre App-Dienste definiert und diesen Hostingressourcen zuordnet.
   • Ein .azure Ordner zum Speichern von Konfigurationseinstellungen wie ihrem Umgebungsnamen.
   • Eine .gitignore Datei, die für Ihre App-Sprache und Hostingplattform konfiguriert ist.

5. Optional führen Sie azd up aus, um die Azure-Container-Apps-Ressourcen zu erstellen und Ihre App bereitzustellen.

Ihre App ist jetzt als azd Vorlage strukturiert, die Sie mit weiteren Azure-Ressourcen und -Diensten weiter entwickeln und erweitern können.

Vorlage auswählen

Mit diesem Workflow können Sie mit einer vordefinierten azd Vorlage beginnen, die in der Regel sowohl Anwendungscode als auch die erforderlichen Azure-Infrastrukturdefinitionen enthält.

1. Führen Sie den Befehl azd init aus:

   azd init
   

   Hinweis

   Sie können azd init mit dem --template Parameter ausführen, um eine Vorlage direkt anhand des Namens zu initialisieren und die Workflow-Auswahl zu überspringen.

2. Wählen Sie "Vorlage auswählen" aus. azd zeigt eine Liste der verfügbaren Vorlagen aus Ihren konfigurierten Vorlagenquellen an.

   ? How do you want to initialize your app? Select a template
   ? Select a project template:  [Use arrows to move, type to filter]
   > Deploy Phoenix to Azure
     (Arize-ai/phoenix-on-azure)
   
     API Center Reference Sample
     (Azure-Samples/APICenter-Reference)
   
     Event Driven Java Application with Azure Service Bus on Azure Spring Apps
     (Azure-Samples/ASA-Samples-Event-Driven-Application)
   
     Static React Web App with Java API and PostgreSQL
     (Azure-Samples/ASA-Samples-Web-Application)
   

3. Geben Sie die Eingabe ein, um die Ergebnisse zu filtern und nach der Hello AZD Vorlage zu suchen. Drücken Sie die EINGABETASTE, um die Vorlage zu klonen und zu initialisieren.

4. Führen Sie azd up optional aus, um die Vorlagenressourcen in Azure bereitzustellen und zu implementieren.

Sie können die initialisierte Vorlage auch als Ausgangspunkt für die Weiterentwicklung verwenden.

Erstellen eines minimalen Projekts

Für fortgeschrittene Benutzer, die mit einem minimalen Setup beginnen und alles manuell anpassen möchten, bietet diese Option nur die grundlegende Konfiguration.

1. Führen Sie den Befehl azd init aus:

   azd init
   

   Hinweis

   Sie können azd init auch mit dem Parameter --minimal ausführen, um die Workflow-Auswahl zu überspringen.

2. Wenn Sie dazu aufgefordert werden, geben Sie einen Namen für Ihre azd Vorlage ein, und drücken Sie die EINGABETASTE.

   ? How do you want to initialize your app? Create a minimal project
   ? What is the name of your project? (empty) hello-azd
   ? What is the name of your project? hello-azd
   
   SUCCESS: Generated azure.yaml project file.
   Run azd add to add new Azure components to your project.
   

   Es wird nur die grundlegende azure.yaml Konfigurationsdatei erstellt. Es werden keine Anwendungscode- oder umfassende Infrastrukturvorlagen hinzugefügt, daher müssen Sie die Infrastrukturdateien basierend auf Ihren Anforderungen manuell erstellen oder anpassen.

3. Verwenden Sie optional die azd addVerfassen-Funktion, um mit dem Hinzufügen von Azure-Ressourcen zu Ihrer App zu beginnen.

Nächste Schritte

Nachdem Sie Ihr Projekt mit azd initinitialisiert haben, haben Sie folgende Möglichkeiten:

• Ändern Sie die generierten Infrastrukturdateien, um Ihre Azure-Ressourcen anzupassen.
• Verwenden Sie azd provision, um die erforderlichen Ressourcen in Azure zu erstellen.
• Verwenden Sie azd deploy, um den Anwendungscode auf die bereitgestellten Ressourcen bereitzustellen.
• Erfahren Sie mehr über den Azure Developer CLI-Up-Workflow, um Bereitstellung und Bereitstellung in einem einzigen Befehl zu kombinieren.

Verwandte Inhalte

• Azure Developer CLI-Befehle
• Azure YAML-Schemareferenz
• Azure Developer CLI-Vorlagen
• Vorlagenkatalog