In dieser Schnellstartanleitung erfahren Sie, wie Sie App-Ressourcen in Azure mithilfe einer Azure Developer CLI-Vorlage (azd) bereitstellen und implementieren und dabei nur einige azd Befehle verwenden.
azd-Vorlagen sind Standardcoderepositorys, die Ihren Anwendungsquellcode enthalten, sowie azd Konfigurations- und Infrastrukturdateien, um Azure Ressourcen bereitzustellen. Weitere Informationen zu azd-Vorlagen und dazu, wie sie Ihren Azure Bereitstellungs- und Bereitstellungsprozess beschleunigen können, finden Sie unter What are Azure Developer CLI templates?.
Auswählen und Bereitstellen der Vorlage
Für die vorstehenden Schritte verwenden Sie die folgende Vorlage, um eine App auf Azure bereitzustellen und zu implementieren.
Sie können auch eine Vorlage gemäß Ihren Präferenzen im Vorlagenkatalog Awesome AZD auswählen. Unabhängig davon, welche Vorlage Sie verwenden, erhalten Sie den Vorlagencode in Ihrer Entwicklungsumgebung und können Befehle ausführen, um die App in Azure zu erstellen, erneut bereitzustellen und zu überwachen.
Wählen Sie Ihre bevorzugte Umgebung aus, um den Vorgang fortzusetzen:
Eine lokale Entwicklungsumgebung ist eine großartige Wahl für herkömmliche Entwicklungsworkflows. Sie klonen das Vorlagen-Repository auf Ihr Gerät und führen Befehle für eine lokale Installation von azd aus.
Voraussetzungen
Initialisieren des Projekts
Erstellen Sie im Dateiexplorer oder einem Terminal ein neues leeres Verzeichnis, und wechseln Sie dahin.
Führen Sie den azd init-Befehl aus, und geben Sie die Vorlage an, die Sie als Parameter verwenden möchten:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Geben Sie einen Umgebungsnamen ein, wenn Sie dazu aufgefordert werden, z. B. azdquickstart, wodurch ein Namenspräfix für die Ressourcengruppe festgelegt wird, die erstellt wird, um die Azure Ressourcen aufzunehmen.
Was ist ein Umgebungsname in azd?
Nachdem Sie die Umgebung angegeben haben, klont azd das Vorlagenprojekt auf Ihren Computer und initialisiert das Projekt.
Bereitstellen der App-Ressourcen
Führen Sie den azd auth login-Befehl aus, und azd öffnet einen Browser, um den Anmeldevorgang abzuschließen.
azd auth login
Führen Sie den Befehl azd up aus:
azd up
Sobald Sie bei Azure angemeldet sind, werden Sie zur Eingabe der folgenden Informationen aufgefordert:
| Parameter |
Beschreibung |
Azure Location |
Der Azure Speicherort, an dem Ihre Ressourcen bereitgestellt werden. |
Azure Subscription |
Das Azure-Abonnement, in dem Ihre Ressourcen bereitgestellt werden. |
Wählen Sie die gewünschten Werte aus, und drücken Sie die EINGABETASTE. Der azd up-Befehl behandelt die folgenden Aufgaben für Sie mithilfe der Vorlagenkonfigurations- und Infrastrukturdateien:
- Erstellt und konfiguriert alle erforderlichen Azure Ressourcen (
azd provision), einschließlich:
- Zugriffsrichtlinien und -rollen für Ihr Konto
- Dienst-zu-Dienst-Kommunikation mit verwalteten Identitäten
- Packt den Code (
azd deploy) und stellt ihn bereit
Wenn der azd up-Befehl erfolgreich abgeschlossen ist, zeigt die CLI zwei Links zum Anzeigen von erstellten Ressourcen an:
- ToDo-API-App
- ToDo-Web-App-Frontend
Hinweis
Sie können azd up so oft aufrufen, wie Sie möchten, um sowohl Updates für Ihre Anwendung bereitzustellen als auch zu deployen.
Die Bereitstellung kann fehlschlagen, da eine Ressource in der ausgewählten Region nicht bereitgestellt werden kann. Da dies ein Schnellstart ist, ist es sicher, das .azure-Verzeichnis zu löschen und azd up erneut auszuführen. Wählen Sie bei Aufforderung eine andere Region aus. In einem komplexeren Szenario könnten Sie Dateien im .azure-Verzeichnis selektiv bearbeiten, um die Region zu ändern.
Die Azure Developer CLI bietet eine Visual Studio Code Erweiterung, um das Arbeiten mit azd-Features zu optimieren. Sie können beispielsweise die Befehlspalettenschnittstelle verwenden, um Befehle auszuführen azd . Sie müssen die Azure Developer CLI-Erweiterung für Visual Studio Code installieren, um die vorausstehenden Schritte auszuführen.
Installieren der Azure Developer CLI-Erweiterung
Öffnen Sie Visual Studio Code.
Wählen Sie im Menü "Ansicht" die Option "Erweiterungen" aus.
Geben Sie im Suchfeld Azure Developer CLI ein.
Wählen Sie "Installieren" aus, und warten Sie, bis der Installationsvorgang abgeschlossen ist.
Initialisieren einer neuen App
Öffnen Sie ein leeres Verzeichnis in Visual Studio Code.
Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.
Suchen Sie nach dem Befehl Azure Developer CLI (azd): Initialize app (init), und drücken Sie die EINGABETASTE. Der azd up Befehl weist azd an, die App-Ressourcen vorzubereiten und zu deployen.
Wählen Sie den Workflow "Vorlage auswählen" aus.
Suchen Sie nach der Vorlage React Web App mit Node.js API und MongoDB auf Azurevorlage, und drücken Sie die EINGABETASTE, um sie auszuwählen.
Visual Studio Code klont die Vorlage azd herunter. Die Vorlage enthält Infrastruktur als Codedateien im infra Ordner und eine Beispiel-App im src Ordner. Die Infrastruktur als Codedateien stellen die erforderlichen Ressourcen für Azure bereit, die von der App benötigt werden, wenn sie bereitgestellt wird.
Suchen Sie nach der Vorlage React Web App mit Python API und MongoDB auf Azurevorlage, und drücken Sie die EINGABETASTE, um sie auszuwählen.
Visual Studio Code klont die Vorlage azd. Die Vorlage enthält Infrastruktur als Codedateien im infra Ordner und eine Beispiel-App im src Ordner. Die Infrastruktur als Codedateien stellen die erforderlichen Ressourcen für Azure bereit, die von der App benötigt werden, wenn sie bereitgestellt wird.
Suchen Sie nach der Vorlage React Web App mit C#-API und MongoDB auf Azurevorlage, und drücken Sie die EINGABETASTE, um sie auszuwählen.
Visual Studio Code lädt die Vorlage azd herunter. Die Vorlage enthält Infrastruktur als Codedateien im infra Ordner und eine Beispiel-App im src Ordner. Die Infrastruktur als Codedateien stellen die erforderlichen Ressourcen für Azure bereit, die von der App benötigt werden, wenn sie bereitgestellt wird.
Suchen Sie nach der Vorlage Containerisierte React Web App mit Java API und MongoDB auf AzureVorlage, und drücken Sie die EINGABETASTE, um sie auszuwählen.awesome-azd.
Visual Studio Code klont die Vorlage azd herunter. Die Vorlage enthält Infrastruktur als Codedateien im infra Ordner und eine Beispiel-App im src Ordner. Die Infrastruktur als Codedateien stellen die erforderlichen Ressourcen für Azure bereit, die von der App benötigt werden, wenn sie bereitgestellt wird.
Nachdem die Vorlage geklont wurde, öffnet Visual Studio Code ein Terminal, um Sie zur Eingabe eines Umgebungsnamens aufzufordern. Geben Sie einen kurzen Namen Ihrer Auswahl ein, z. B. azdvscode , und drücken Sie die EINGABETASTE.
Enter a new environment name: [? for help] azdvscode
Der Umgebungsname beeinflusst die Benennung von Ressourcen, die in Azure bereitgestellt werden, und erstellt einen Ordner im Vorlagenverzeichnis .azure, um bestimmte Umgebungseinstellungen zu speichern.
Bereitstellen der App-Ressourcen
Öffnen Sie die Befehlspalette, und suchen Sie nach dem Befehl Azure Developer CLI (azd): Package, Provision and Deploy(up), und drücken Sie die EINGABETASTE. Der azd up Befehl weist azd an, die App-Ressourcen vorzubereiten und zu deployen.
Visual Studio Code öffnet ein Terminalfenster, um den Fortschritt des Bereitstellungs- und Implementierungsprozesses anzuzeigen.
azd verwendet die Abonnement- und Standorteinstellungen, die Sie während des init Prozesses beim Bereitstellen von Ressourcen ausgewählt haben.
Hinweis
Der Bereitstellungs- und Bereitstellungsprozess kann mehrere Minuten dauern.
Wenn der Bereitstellungsprozess abgeschlossen ist, wählen Sie im Ausgabefenster den Link azd aus, um Ihre Website im Browser aufzurufen.
Codespaces sind eine großartige Option für Entwickler, die es vorziehen, in containerisierten Cloudumgebungen zu arbeiten und die Installation von Tools oder Abhängigkeiten lokal zu vermeiden.
Einrichten des Codespace
- Klicken Sie über der Dateiliste auf Diese Vorlage verwenden>In einem Codespace öffnen.
Mit Codespaces werden alle erforderlichen Voraussetzungen für Sie installiert, einschließlich der Visual Studio Code-Erweiterung.
Vorlage ausführen
Nachdem Ihr Codespace erstellt wurde, klicken Sie im Stammverzeichnis mit der rechten Maustaste auf azure.yaml. Wählen Sie in den Optionen up (Ressourcen bereitstellen und Code auf Azure bereitstellen) aus.
Wenn Sie den azd up-Befehl ausführen, werden Sie aufgefordert, die folgenden Informationen anzugeben und sich mit einem Webbrowser und einem Authentifizierungscode anzumelden:
| Parameter |
Beschreibung |
Environment Name |
Präfix für die Ressourcengruppe, die erstellt wird, um alle Azure Ressourcen zu enthalten. Was ist ein Umgebungsname in azd? Sie können immer eine neue Umgebung mit azd env new erstellen. |
Azure Location |
Der Azure Speicherort, an dem Ihre Ressourcen bereitgestellt werden. |
Azure Subscription |
Das Azure-Abonnement, in dem Ihre Ressourcen bereitgestellt werden. |
Dieser Vorgang kann einige Zeit in Anspruch nehmen, da der azd up-Befehl die folgenden Aufgaben behandelt:
- Erstellt und konfiguriert alle erforderlichen Azure Ressourcen (
azd provision).
- Konfiguriert Zugriffsrichtlinien und Rollen für Ihr Konto.
- Implementiert die Dienst-zu-Dienst-Kommunikation mit verwalteten Identitäten.
- Packt den Code (
azd deploy) und stellt ihn bereit.
Nachdem Sie die erforderlichen Parameter bereitgestellt haben und der Befehl azd up abgeschlossen ist, zeigt das CodeSpaces-Terminal zwei Azure Portallinks an, um erstellte Ressourcen anzuzeigen:
- ToDo-API-App
- ToDo-Web-App-Frontend
Was ist passiert?
Nach erfolgreichem Abschluss des azd up Befehls:
- Die Azure-Ressourcen, auf die in der
README.md-Datei der Vorlage verwiesen wird wurden für das Azure Abonnement bereitgestellt, das Sie angegeben haben, nachdem Sie azd up ausgeführt haben. Sie können diese Azure Ressourcen jetzt über das portal Azure anzeigen.
- Die App wurde für Azure erstellt und bereitgestellt. Mit der Ausgabe der Web-App-URL aus dem
azd up-Befehl können Sie zur voll funktionsfähigen App wechseln.
Hinweis
- Sie können
azd up so oft aufrufen, wie Sie möchten, um Ihre Anwendung bereitzustellen und einzusetzen.
- Das Ausführen und Debuggen, das das Starten eines Webbrowsers erfordert, wird derzeit aufgrund bekannter Einschränkungen mit GitHub Codespaces nicht unterstützt. Um eine bessere Erfahrung zu erzielen, empfehlen wir die Verwendung von Codespaces in Desktop.
Ein DevContainer ist ein Docker-Image, das alle erforderlichen Komponenten enthält, die Sie zum Arbeiten mit der azd-Vorlage auf Ihrem lokalen Computer benötigen. Sie sind eine gute Wahl für Entwickler, die containerisierte Umgebungen bevorzugen, die immer noch auf einem lokalen Gerät ausgeführt werden, anstelle eines Clouddiensts wie GitHub Codespaces.
Voraussetzungen
Initialisieren des Projekts
Öffnen Sie ein Terminal, erstellen Sie ein neues leeres Verzeichnis und wechseln Sie in dieses Verzeichnis.
Führen Sie den folgenden Befehl aus, um das Projekt zu initialisieren:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Wenn Sie den azd init-Befehl ausführen, werden Sie aufgefordert, die folgenden Informationen anzugeben:
| Parameter |
Beschreibung |
Environment Name |
Präfix für die Ressourcengruppe, die erstellt wird, um alle Azure Ressourcen zu enthalten. Was ist ein Umgebungsname in azd? Sie können immer eine neue Umgebung mit azd env new erstellen. |
Öffnen Sie den DevContainer
- Öffnen Sie das Projekt in VS Code.
- Drücken Sie F1, und wählen Sie Folgendes aus:
Remote-Containers: Rebuild and Reopen in Container
Führen Sie den Befehl up aus
Führen Sie den folgenden Befehl aus:
azd up
Wenn Sie den azd up-Befehl ausführen, werden Sie aufgefordert, die folgenden Informationen anzugeben:
| Parameter |
Beschreibung |
Azure Location |
Der Azure Speicherort, an dem Ihre Ressourcen bereitgestellt werden. |
Azure Subscription |
Das Azure-Abonnement, in dem Ihre Ressourcen bereitgestellt werden. |
Es kann einige Zeit dauern, bis der azd up-Befehl die folgenden Schritte ausführt:
- Erstellt und konfiguriert alle erforderlichen Azure Ressourcen (
azd provision), einschließlich:
- Zugriffsrichtlinien und -rollen für Ihr Konto
- Dienst-zu-Dienst-Kommunikation mit verwalteten Identitäten
- Packt den Code (
azd deploy) und stellt ihn bereit
Sobald Sie die erforderlichen Parameter bereitgestellt haben und der Befehl azd up abgeschlossen ist, zeigt die CLI zwei Azure Portallinks an, um erstellte Ressourcen anzuzeigen:
- ToDo-API-App
- ToDo-Web-App-Frontend
Hinweis
Sie können azd up so oft ausführen, wie Sie möchten, um Ihre Anwendung in derselben Region und mit denselben Konfigurationswerten bereitzustellen und zu implementieren, die Sie beim ersten Durchlauf angegeben haben.
Bereinigen von Ressourcen
Wenn Sie die in diesem Artikel erstellten Ressourcen nicht mehr benötigen, führen Sie den folgenden Befehl aus, um die App herunterzufahren:
azd down
Wenn Sie eine erneute Bereitstellung in einer anderen Region durchführen möchten, löschen Sie das .azure-Verzeichnis, bevor Sie azd up erneut ausführen. In einem komplexeren Szenario könnten Sie Dateien im .azure-Verzeichnis selektiv bearbeiten, um die Region zu ändern.
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.
Nächste Schritte