Erstellen einer Umgebung mithilfe der Azure Developer CLI
In diesem Artikel installieren Sie die Azure Developer CLI (AZD), erstellen eine neue Bereitstellungsumgebung, indem Sie Ihre App-Infrastruktur in Azure Deployment Environments (ADE) bereitstellen und Ihren App-Code in der bereitgestellten Bereitstellungsumgebung bereitstellen.
Azure Developer CLI (AZD) ist ein Open-Source-Tool, das die Zeit beschleunigt, mit der Sie Ihre Anwendung von der lokalen Entwicklungsumgebung auf Azure abrufen können. AZD bietet bewährte, entwicklerfreundliche Befehle, die wichtigen Phasen in Ihrem Workflow entsprechen, gleichgültig, ob Sie im Terminal, in einem Editor, in einer integrierten Entwicklungsumgebung (IDE) oder CI/CD (Continuous Integration und Continuous Delivery) arbeiten.
Informationen zum Einrichten von AZD für die Arbeit mit Azure-Bereitstellungsumgebungen finden Sie unter Verwenden der Azure Developer CLI mit Azure Deployment Environments.
Voraussetzungen
Gehen Sie wie folgt vor:
- Stellen Sie sicher, dass Sie mit Azure Deployment Environments vertraut sind. Lesen Sie Was ist Azure Deployment Environments und Schlüsselkonzepte für Azure Deployment Environments.
- Erstellen und konfigurieren Sie ein Dev Center mit einem Projekt, Umgebungstypen und einem Katalog. Weitere Informationen finden Sie im folgenden Artikel:
- Ein Katalog, der an Ihr Dev Center angefügt ist.
Vorbereiten der Arbeit mit AZD
Wenn Sie zum ersten Mal mit AZD arbeiten, gibt es einige einmalige Einrichtungsaufgaben, die Sie ausführen müssen. Zu diesen Aufgaben gehören die Installation der Azure Developer CLI, die Anmeldung bei Ihrem Azure-Konto und das Aktivieren der AZD-Unterstützung für Azure Deployment Environments.
Installieren der Azure Developer CLI
Wenn Sie azd installieren, werden die azd-Tools nicht global, sondern innerhalb des azd-Bereichs installiert und entfernt, wenn azd deinstalliert wird. Um azd-Tools in Visual Studio Code zu verwenden, installieren Sie die Erweiterung.
Um Azure Developer CLI-Features in Visual Studio Code zu aktivieren, installieren Sie die Azure Developer CLI-Erweiterung, Version v0.8.3. Wählen Sie das Symbol Erweiterungen in der Aktivitätsleiste aus, suchen Sie nach Azure Developer CLI, und wählen Sie dann Installieren aus.
Anmelden mit Azure Developer CLI
Greifen Sie auf Ihre Azure-Ressourcen zu, indem Sie sich anmelden. Wenn Sie eine Anmeldung initiieren, wird ein Browserfenster geöffnet und fordert Sie auf, sich bei Azure anzumelden. Nachdem Sie sich angemeldet haben, zeigt das Terminal eine Meldung an, dass Sie bei Azure angemeldet sind.
Melden Sie sich mit der Befehlspalette bei AZD an:
Die Ausgabe von Befehlen, die von der Befehlspalette ausgegeben werden, wird in einem azd dev-Terminal wie im folgenden Beispiel angezeigt:
Aktivieren der AZD-Unterstützung für ADE
Sie können AZD so konfigurieren, dass es Ressourcen für Ihre Bereitstellungsumgebungen bereitstellt und einsetzt, indem Sie Standardbefehle wie azd up oder azd provision verwenden. Wenn platform.type auf devcenter festgelegt ist, verwenden der gesamte AZD-Remoteumgebungsstatus und die Bereitstellung Dev Center-Komponenten. AZD verwendet eine der Infrastrukturvorlagen, die im Dev Center-Katalog für die Ressourcenbereitstellung definiert sind. In dieser Konfiguration wird der infra-Ordner in Ihren lokalen Vorlagen nicht verwendet.
Erstellen einer Umgebung aus vorhandenem Code
Jetzt können Sie eine Umgebung erstellen, in der Sie arbeiten können. Sie können mit Code in einem lokalen Ordner beginnen oder ein vorhandenes Repository klonen. In diesem Beispiel erstellen Sie eine Umgebung mithilfe von Code in einem lokalen Ordner.
Initialisieren einer neuen Anwendung
Beim Initialisieren einer neuen Anwendung werden die Dateien und Ordner erstellt, die AZD für die Arbeit mit Ihrer Anwendung benötigt.
AZD verwendet eine azure.yaml-Datei, um die Umgebung zu definieren. Die Datei „azure.yaml“ definiert und beschreibt die Apps und Typen von Azure-Ressourcen, die die Anwendung verwendet. Weitere Informationen zu azure.yaml finden Sie unter Schema von azure.yaml in Azure Developer CLI.
Öffnen Sie in Visual Studio Code den Ordner, der Ihren Anwendungscode enthält.
Öffnen Sie die Befehlspalette, geben Sie Azure Developer CLI init ein, und wählen Sie dann Azure Developer CLI (azd): init aus.
Wenn Sie in der Liste der Vorlagen fortfahren möchten, ohne eine Vorlage auszuwählen, drücken Sie zweimal die EINGABETASTE.
Wählen Sie im AZD-Terminal Code im aktuellen Verzeichnis verwenden aus.
azd initidentifiziert die in Ihrem App-Code definierten Dienste und fordert Sie auf, einen Dienst zu bestätigen und fortzusetzen, einen Dienst zu entfernen oder einen Dienst hinzuzufügen. Wählen Sie Bestätigen und die Initialisierung meiner App fortsetzen.
azd initsammelt weiterhin Informationen, um Ihre App zu konfigurieren. Für diese Beispielanwendung werden Sie aufgefordert, den Namen Ihrer MongoDB-Datenbankinstanz und die Ports anzugeben, auf die die Dienste lauschen.
Geben Sie einen Namen für Ihre lokale AZD-Umgebung ein.
azd initzeigt eine Liste der Projekte an, auf die Sie Zugriff haben. Wählen Sie das Projekt für Ihre Umgebung aus.
azd initzeigt eine Liste der Umgebungsdefinitionen im Projekt an. Wählen Sie eine Umgebungsdefinition aus.
AZD erstellt die Projektressourcen, einschließlich einer azure.yaml-Datei, im Stammverzeichnis Ihres Projekts.
Bereitstellen der Infrastruktur für Azure Deployment Environments
Wenn Sie bereit sind, können Sie Ihre lokale Umgebung in einer Azure Deployment Environments-Remoteumgebung in Azure bereitstellen. Dieser Prozess stellt die Infrastruktur und Ressourcen bereit, die in der Umgebungsdefinition in Ihrem Dev Center-Katalog definiert sind.
Klicken Sie im Explorer mit der rechten Maustaste auf azure.yaml, und wählen Sie dann Azure Developer CLI (azd)>Bereitstellen von Azure-Ressourcen (provision) aus.
AZD durchsucht Deployment Environments nach Projekten, auf die Sie Zugriff haben. Wählen Sie im AZD-Terminal folgende Informationen aus, oder geben Sie sie ein:
- Projekt
- Umgebungsdefinition
- Umgebungstyp
- Location
AZD weist ADE an, eine neue Umgebung basierend auf den Informationen zu erstellen, die Sie im vorherigen Schritt angegeben haben.
Sie können die im Azure-Portal oder im Entwicklerportal erstellten Ressourcen anzeigen.
Auflisten vorhandener Umgebungen (optional)
Überprüfen Sie, ob Ihre Umgebung erstellt wurde, indem Sie die vorhandenen Umgebungen auflisten.
Klicken Sie im Explorer mit der rechten Maustaste auf azure.yaml, und wählen Sie dann Azure Developer CLI (azd)>Lokale und Remoteumgebungen anzeigen (env list) aus.
Sie werden aufgefordert, ein Projekt und eine Umgebungsdefinition auszuwählen.
Bereitstellen von Code in Azure Deployment Environments
Wenn Ihre Umgebung bereitgestellt wurde, können Sie Ihren Code in der Umgebung bereitstellen.
Klicken Sie im Explorer mit der rechten Maustaste auf azure.yaml, und wählen Sie dann Azure Developer CLI (azd)>Bereitstellen von Azure-Ressourcen (deploy) aus.
Sie können überprüfen, ob Ihr Code bereitgestellt wurde, indem Sie die im AZD-Terminal aufgeführten Endpunkt-URLs auswählen.
Bereinigen von Ressourcen
Wenn Sie mit Ihrer Umgebung fertig sind, können Sie die Azure-Ressourcen löschen.
Klicken Sie im Explorer mit der rechten Maustaste auf azure.yaml, und wählen Sie dann Azure Developer CLI (azd)>Löschen der Bereitstellung und Ressourcen (down) aus.
Bestätigen Sie, dass Sie die Umgebung löschen möchten, indem Sie bei Aufforderung y eingeben.