Erstellen einer Umgebung mithilfe der Azure Developer CLI
Artikel
In diesem Artikel installieren Sie die Azure Developer CLI (AZD), erstellen eine neue Bereitstellungsumgebung, indem Sie Ihre App-Infrastruktur in Azure Deployment Environments 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.
Erstellen und konfigurieren Sie ein Dev Center mit einem Projekt, Umgebungstypen und einem Katalog. Weitere Informationen finden Sie im folgenden Artikel:
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 Sie die Azure Developer CLI-Erweiterung für Visual Studio Code.
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.
In Visual Studio 2022 17.3 Preview 2 oder höher können Sie die Integration mit azd als Previewfunktion aktivieren.
Um das azd-Feature zu aktivieren, wechseln Sie zu Extras>Optionen>Umgebung>Previewfunktion und wählen Sie Integration mit azd, der Azure Developer CLI.
Wenn das Feature aktiviert ist, können Sie die Azure Developer CLI über Ihr gewünschtes Terminal unter Windows, Linux oder macOS verwenden.
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:
Melden Sie sich mit dem folgenden Befehl bei der Azure CLI an:
azd auth login
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.
Zum Öffnen der Developer-Eingabeaufforderung:
Wählen Sie im Menü „Extras“ die Option Terminal aus.
Wählen Sie im Fenster Terminal die Option Developer-Eingabeaufforderung aus.
Melden Sie sich mit dem Developer-Befehlsterminal bei AZD an:
azd auth login
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.
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 in der Liste 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 init identifiziert 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 init sammelt 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 init zeigt eine Liste der Projekte an, auf die Sie Zugriff haben. Wählen Sie das Projekt für Ihre Umgebung aus.
azd init zeigt 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.
Navigieren Sie in der CLI zu dem Ordner, der Ihren Anwendungscode enthält.
Führen Sie den folgenden Befehl aus, um Ihre Anwendung zu initialisieren, und geben Sie die nötigen Informationen an, wenn Sie dazu aufgefordert werden:
azd init
Wählen Sie im AZD-Terminal Code im aktuellen Verzeichnis verwenden aus.
AZD durchsucht das aktuelle Verzeichnis und sammelt je nach App-Typ, den Sie erstellen, weitere Informationen. Folgen Sie den Eingabeaufforderungen, um Ihre AZD-Umgebung zu konfigurieren.
azd init identifiziert 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 init sammelt 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 init zeigt eine Liste der Projekte an, auf die Sie Zugriff haben. Wählen Sie das Projekt für Ihre Umgebung aus.
azd init zeigt 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.
Navigieren Sie in der CLI zu dem Ordner, der Ihren Anwendungscode enthält.
Führen Sie den folgenden Befehl aus, um Ihre Anwendung zu initialisieren, und geben Sie die nötigen Informationen an, wenn Sie dazu aufgefordert werden:
azd init
Wählen Sie im AZD-Terminal Code im aktuellen Verzeichnis verwenden aus.
AZD durchsucht das aktuelle Verzeichnis und sammelt je nach App-Typ, den Sie erstellen, weitere Informationen. Folgen Sie den Eingabeaufforderungen, um Ihre AZD-Umgebung zu konfigurieren.
azd init identifiziert 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 init sammelt 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 init zeigt eine Liste der Projekte an, auf die Sie Zugriff haben. Wählen Sie das Projekt für Ihre Umgebung aus.
azd init zeigt 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.
Stellen Sie Ihre Anwendung mit dem folgenden Befehl in Azure bereit:
azd provision
„azd provision“ bietet eine Liste der Projekte, auf die Sie Zugriff haben. Wählen Sie das Projekt aus, für das Sie Ihre Anwendung bereitstellen möchten.
„azd provision“ stellt eine Liste der Umgebungsdefinitionen im ausgewählten Projekt bereit. Wählen Sie die Umgebungsdefinition aus, die Sie zum Bereitstellen Ihrer Anwendung verwenden möchten.
„azd provision“ stellt eine Liste der Umgebungstypen im ausgewählten Projekt bereit. Wählen Sie den Umgebungstyp aus, den Sie zum Bereitstellen Ihrer Anwendung verwenden möchten.
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.
Stellen Sie Ihre Anwendung mit dem folgenden Befehl in Azure bereit:
azd provision
„azd provision“ bietet eine Liste der Projekte, auf die Sie Zugriff haben. Wählen Sie das Projekt aus, für das Sie Ihre Anwendung bereitstellen möchten.
„azd provision“ stellt eine Liste der Umgebungsdefinitionen im ausgewählten Projekt bereit. Wählen Sie die Umgebungsdefinition aus, die Sie zum Bereitstellen Ihrer Anwendung verwenden möchten.
„azd provision“ stellt eine Liste der Umgebungstypen im ausgewählten Projekt bereit. Wählen Sie den Umgebungstyp aus, den Sie zum Bereitstellen Ihrer Anwendung verwenden möchten.
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.
Verwenden Sie den folgenden Befehl, um die Umgebungen anzuzeigen, auf die Sie Zugriff haben: die lokale AZD-Umgebung und die Remoteumgebung Azure Deployment Environments.
azd env list
azd env list fordert Sie auf, ein Projekt und eine Umgebungsdefinition auszuwählen.
Verwenden Sie den folgenden Befehl, um die Umgebungen anzuzeigen, auf die Sie Zugriff haben: die lokale AZD-Umgebung und die Remoteumgebung Azure Deployment Environments.
azd env list
azd env list fordert Sie auf, 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.
Stellen Sie Ihren Anwendungscode in der Remoteumgebung Azure Deployment Environments bereit, die Sie mithilfe des folgenden Befehls bereitgestellt haben:
azd deploy
Das Bereitstellen des Codes in der Remoteumgebung kann mehrere Minuten dauern.
Sie können den Fortschritt der Bereitstellung im Azure-Portal anzeigen:
Nach Abschluss der Bereitstellung können Sie die Ressourcen anzeigen, die im Azure-Portal bereitgestellt wurden:
Sie können überprüfen, ob Ihr Code bereitgestellt wurde, indem Sie die im AZD-Terminal aufgeführten Endpunkt-URLs auswählen.
Für diese Beispielanwendung sehen Sie etwa Folgendes:
Stellen Sie Ihren Anwendungscode in der Remoteumgebung Azure Deployment Environments bereit, die Sie mithilfe des folgenden Befehls bereitgestellt haben:
azd deploy
Das Bereitstellen des Codes in der Remoteumgebung kann mehrere Minuten dauern.
Sie können den Fortschritt der Bereitstellung im Azure-Portal anzeigen:
Nach Abschluss der Bereitstellung können Sie die Ressourcen anzeigen, die im Azure-Portal bereitgestellt wurden:
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.
Löschen Sie Ihre Azure-Ressourcen mit dem folgenden Befehl:
azd down --environment <environmentName>
Löschen Sie Ihre Azure-Ressourcen mit dem folgenden Befehl: