Freigeben über


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 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:

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.

Verwenden Sie die folgenden Anweisungen zum Installieren der Azure Developer CLI.

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.

Screenshot: Visual Studio Code mit dem Befehl „Anmelden“ in der Befehlspalette.

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:

Screenshot von Visual Studio Code, der den Bereich Erweiterungen zeigt, in dem „Azure Developer CLI“ und „Installieren“ hervorgehoben sind.

Die Ausgabe von Befehlen, die von der Befehlspalette ausgegeben werden, wird in einem azd dev-Terminal wie im folgenden Beispiel angezeigt:

Screenshot des azd-Entwicklerterminals, das die Meldung „Zum Schließen eine beliebige Taste drücken“ anzeigt.

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.

Screenshot von Visual Studio Code, der den Befehl „Support aktivieren“ in der Befehlspalette zeigt.

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.

  1. Öffnen Sie in Visual Studio Code den Ordner, der Ihren Anwendungscode enthält.

  2. Ö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.

    Screenshot der Befehlspalette von Visual Studio Code, in der „Azure Developer CLI (azd): init“ hervorgehoben ist.

  3. Wenn Sie in der Liste der Vorlagen fortfahren möchten, ohne eine Vorlage auszuwählen, drücken Sie zweimal die EINGABETASTE.

  4. Wählen Sie im AZD-Terminal Code im aktuellen Verzeichnis verwenden aus.

    Screenshot des AZD-Terminals in Visual Studio Code, der die Eingabeaufforderung „Code im aktuellen Verzeichnis verwenden“ anzeigt.

  5. 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.

    Screenshot der AZD-Init-Aufforderung zum Bestätigen und Fortfahren, zum Entfernen oder Hinzufügen eines Diensts.

  6. 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.

    Screenshot der „azd init“-Eingabeaufforderung für einen Datenbanknamen.

  7. Geben Sie einen Namen für Ihre lokale AZD-Umgebung ein.

    Screenshot der „azd init“-Eingabeaufforderung zur Eingabe eines neuen Umgebungsnamens.

  8. azd init zeigt eine Liste der Projekte an, auf die Sie Zugriff haben. Wählen Sie das Projekt für Ihre Umgebung aus.

    Screenshot der „azd init“-Eingabeaufforderung zur Auswahl eines Projekts.

  9. azd init zeigt eine Liste der Umgebungsdefinitionen im Projekt an. Wählen Sie eine Umgebungsdefinition aus.

    Screenshot der „azd init“-Eingabeaufforderung zur Auswahl von Umgebungsdefinitionen.

    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.

  1. 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.

    Screenshot von Visual Studio Code, auf dem die Datei „azure.yaml“ hervorgehoben ist, und dem azd-Kontextmenü, auf dem die Azure Developer CLI und die Bereitstellungsumgebung hervorgehoben sind.

  2. 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:

    1. Projekt
    2. Umgebungsdefinition
    3. Umgebungstyp
    4. Location
  3. AZD weist ADE an, eine neue Umgebung basierend auf den Informationen zu erstellen, die Sie im vorherigen Schritt angegeben haben.

  4. 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.

  1. 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.

    Screenshot von Visual Studio Code, auf dem die Datei „azure.yaml“ hervorgehoben ist, und dem azd-Kontextmenü, auf dem die Azure Developer CLI und „Lokale und Remoteumgebungen anzeigen“ hervorgehoben sind.

    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.

  1. 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.

    Screenshot von Visual Studio Code, auf dem die Datei „azure.yaml“ hervorgehoben ist, und dem azd-Kontextmenü, auf dem die Azure Developer CLI und „In Azure bereitstellen“ hervorgehoben sind.

  2. 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.

Screenshot von Visual Studio Code, auf dem die Datei „azure.yaml“ hervorgehoben ist, und dem azd-Kontextmenü, auf dem die Azure Developer CLI und „Bereitstellung und Ressourcen (nachgelagert) löschen“ hervorgehoben sind.

Bestätigen Sie, dass Sie die Umgebung löschen möchten, indem Sie bei Aufforderung y eingeben.