Freigeben über

Schnellstart: Erstellen und Bereitstellen einer Python-Web-App in Azure mithilfe einer azd-Vorlage

Diese Schnellstartanleitung führt Sie durch die einfachste und schnellste Methode zum Erstellen und Bereitstellen einer Python-Web- und Datenbanklösung in Azure. Befolgen Sie die Anweisungen in dieser Schnellstartanleitung:

  • Wählen Sie eine azd Vorlage basierend auf dem Python-Webframework, der Azure-Datenbankplattform und der Azure-Webhostingplattform aus, auf der Sie aufbauen möchten.
  • Verwenden Sie CLI-Befehle, um eine Vorlage zum Erstellen einer azd Beispielweb-App und -Datenbank auszuführen und die erforderlichen Azure-Ressourcen zu erstellen und zu konfigurieren, und stellen Sie dann die Beispielweb-App in Azure bereit.
  • Bearbeiten Sie die Web-App auf Ihrem lokalen Computer, und verwenden Sie einen azd Befehl zum erneuten Bereitstellen.
  • Verwenden Sie einen azd Befehl, um Azure-Ressourcen zu bereinigen.

Es sollte weniger als 15 Minuten dauern, bis dieses Lernprogramm abgeschlossen ist. Nach Abschluss können Sie mit dem Ändern des neuen Projekts mit Ihrem benutzerdefinierten Code beginnen.

Weitere Informationen zu diesen azd Vorlagen für die Entwicklung von Python Web App:

Voraussetzungen

Ein Azure-Abonnement – Kostenlos erstellen

Auf Ihrem lokalen Computer muss Folgendes installiert sein:

Vorlage auswählen

Wählen Sie eine azd Vorlage basierend auf dem Python-Webframework, der Azure-Webhostingplattform und der Azure-Datenbankplattform aus, auf der Sie aufbauen möchten.

  1. Wählen Sie in der folgenden Liste der Vorlagen in den folgenden Tabellen einen Vorlagennamen (erste Spalte) aus. Sie werden den Namen der Vorlage während des azd init Schritts im nächsten Abschnitt verwenden.

    Schablone WebFramework Datenbank Hostingplattform GitHub-Repository
    azure-django-postgres-flexible-aca Django PostgreSQL Flexible Server Azure Container Apps – ein Dienst für containerbasierte Anwendungen Aktualisieren
    azure-django-postgres-flexible-appservice Django PostgreSQL Flexible Server Azure App Service Aktualisieren
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL Adapter) Azure Container Apps – ein Dienst für containerbasierte Anwendungen Aktualisieren
    Azure-Django-Cosmos-Postgres-AppService Django Cosmos DB (PostgreSQL Adapter) Azure App Service Aktualisieren
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL-Erweiterung Azure Container Apps – ein Dienst für containerbasierte Anwendungen Aktualisieren

Das GitHub-Repository (letzte Spalte) wird nur zu Referenzzwecken bereitgestellt. Sie sollten das Repository nur direkt klonen, wenn Sie Änderungen an der Vorlage beitragen möchten. Folgen Sie andernfalls den Anweisungen in dieser Quickstart-Anleitung, um die azd CLI zu verwenden und in einem Workflow mit der Vorlage zu interagieren.

Ausführen der Vorlage

Das Ausführen einer azd Vorlage ist in allen Sprachen und Frameworks identisch. Und die gleichen grundlegenden Schritte gelten für alle Vorlagen. Die Schritte sind:

  1. Navigieren Sie auf einem Terminal zu einem Ordner auf Ihrem lokalen Computer, in dem Sie normalerweise Ihre lokalen Git-Repositorys speichern, und erstellen Sie dann einen neuen Ordner namens azdtest. Wechseln Sie dann mit dem cd Befehl in dieses Verzeichnis.

    mkdir azdtest
cd azdtest

    Verwenden Sie das Terminal von Visual Studio Code nicht für diese Schnellstartanleitung.

  2. Um die lokale Entwicklungsumgebung einzurichten, geben Sie die folgenden Befehle in Ihr Terminal ein, und beantworten Sie alle Eingabeaufforderungen:

    azd init --template <template name>

    Ersetzen Sie <template name> mit einer der Vorlagen aus den Tabellen, die Sie in einem vorherigen Schritt ausgewählt haben, z. B. azure-django-postgres-aca.

    Wenn Sie zur Eingabe eines Umgebungsnamens aufgefordert werden, verwenden Sie azdtest oder einen anderen Namen. Der Umgebungsname wird beim Benennen von Azure-Ressourcengruppen und -ressourcen verwendet. Um optimale Ergebnisse zu erzielen, verwenden Sie einen Kurznamen, Kleinbuchstaben, keine Sonderzeichen.

  3. Um sich bei Ihrem Azure-Konto zu authentifizieren azd , geben Sie die folgenden Befehle in Ihr Terminal ein, und folgen Sie der Eingabeaufforderung:

    azd auth login

    Folgen Sie den Anweisungen, wenn Sie aufgefordert werden, "Konto auswählen" oder sich bei Ihrem Azure-Konto anzumelden. Nachdem Sie sich erfolgreich authentifiziert haben, wird die folgende Meldung auf einer Webseite angezeigt: "Authentifizierung abgeschlossen. Sie können zur Anwendung zurückkehren. Sie können diese Registerkarte gerne abschließend schließen."

    Wenn Sie die Registerkarte schließen, zeigt die Shell die Meldung an:

    Logged in to Azure.

  4. Stellen Sie sicher, dass Docker Desktop im Hintergrund geöffnet und ausgeführt wird, bevor Sie den nächsten Schritt ausführen.

  5. Um die erforderlichen Azure-Ressourcen zu erstellen, geben Sie die folgenden Befehle in Ihr Terminal ein, und beantworten Sie alle Eingabeaufforderungen:

    azd up

    Von Bedeutung

    Nach azd up erfolgreicher Ausführung ist die Beispielweb-App im öffentlichen Internet verfügbar, und Ihr Azure-Abonnement beginnt Gebühren zu sammeln für alle Ressourcen, die erstellt werden. Die Ersteller der azd Vorlagen wählten absichtlich preiswerte Stufen, aber nicht unbedingt kostenlose Stufen, da kostenlose Stufen oft eingeschränkte Verfügbarkeit haben.

    Folgen Sie den Anweisungen, wenn Sie aufgefordert werden, azure-Abonnement für die Zahlung auszuwählen, und wählen Sie dann einen azure-Speicherort aus, der verwendet werden soll. Wählen Sie eine Region aus, die ihnen geografisch nahe liegt.

    Die Ausführung von azd up kann mehrere Minuten dauern, da mehrere Azure-Dienste bereitgestellt und provisioniert werden. Achten Sie bei der Anzeige des Fortschritts auf Fehler. Wenn Fehler angezeigt werden, versuchen Sie Folgendes, um das Problem zu beheben:

    • Löschen Sie den Azd-Schnellstartordner und die Schnellstartanweisungen von Anfang an.
    • Wenn Sie dazu aufgefordert werden, wählen Sie einen einfacheren Namen für Ihre Umgebung aus. Verwenden Sie nur Kleinbuchstaben und Striche. Keine Zahlen, Großbuchstaben oder Sonderzeichen.
    • Wählen Sie einen anderen Speicherort aus.

    Wenn weiterhin Probleme auftreten, lesen Sie den Abschnitt "Problembehandlung " am Ende dieses Dokuments.

    Von Bedeutung

    Nachdem Sie die Arbeit mit der Beispielweb-App abgeschlossen haben, verwenden Sie azd down, um alle Dienste zu entfernen, die von azd up erstellt wurden.

  6. Wenn azd up erfolgreich abgeschlossen wurde, wird die folgende Ausgabe angezeigt:

    Screenshot der erfolgreichen Ausgabe der Befehlszeilenschnittstelle von azd mit einem Hinweis auf die URL des Endpunkts, um die funktionierende, in Azure bereitgestellte Relecloud-Anwendung anzuzeigen.

    Kopieren Sie die erste URL nach dem Wort - Endpoint: , und fügen Sie sie in die Speicherortleiste eines Webbrowsers ein, um das Beispielweb-App-Projekt anzuzeigen, das live in Azure ausgeführt wird.

  7. Öffnen Sie eine neue Registerkarte in Ihrem Webbrowser, kopieren Sie die zweite URL aus dem vorherigen Schritt, und fügen Sie sie in die Speicherortleiste ein. Im Azure-Portal werden alle Dienste in Ihrer neuen Ressourcengruppe angezeigt, die zum Hosten des Beispielweb-App-Projekts bereitgestellt wurden.

Bearbeiten und erneutes Bereitstellen

Der nächste Schritt besteht darin, eine kleine Änderung an der Web-App vorzunehmen und dann erneut bereitzustellen.

  1. Öffnen Sie Visual Studio Code, und öffnen Sie den zuvor erstellten Azdtest-Ordner .

  2. Diese Vorlage ist für die optionale Verwendung von Dev-Containern konfiguriert. Wenn die Dev Container-Benachrichtigung in Visual Studio Code angezeigt wird, wählen Sie die Schaltfläche "In Container erneut öffnen" aus.

  3. Verwenden Sie die Explorer-Ansicht von Visual Studio Code, um zum Ordner "src/templates " zu navigieren, und öffnen Sie die index.html Datei. Suchen Sie folgende Codezeile:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    Ändern sie den Text innerhalb von H1:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    Speichern Sie Ihre Änderungen.

  4. Um die App mit Ihrer Änderung erneut bereitzustellen, führen Sie in Ihrem Terminal den folgenden Befehl aus:

    azd deploy

    Da Sie Dev-Container verwenden und remote mit der Shell des Containers verbunden sind, verwenden Sie nicht den Terminalbereich von Visual Studio Code, um Befehle auszuführen azd .

  5. Sobald der Befehl abgeschlossen ist, aktualisieren Sie Ihren Webbrowser, um das Update zu sehen. Je nachdem, welche Webhostingplattform verwendet wird, kann es mehrere Minuten dauern, bis Ihre Änderungen sichtbar sind.

    Jetzt können Sie Dateien in der Vorlage bearbeiten und löschen. Weitere Informationen finden Sie unter Was kann ich in der Vorlage bearbeiten oder löschen?

Bereinigen von Ressourcen

  1. Bereinigen Sie die von der Vorlage erstellten Ressourcen, indem Sie den azd down Befehl ausführen.

    azd down

    Der azd down Befehl löscht die Azure-Ressourcen und den GitHub-Aktionen-Workflow. Wenn Sie dazu aufgefordert werden, stimmen Sie dem Löschen aller Ressourcen zu, die der Ressourcengruppe zugeordnet sind.

    Sie können den Azdtest-Ordner auch löschen oder als Grundlage für Ihre eigene Anwendung verwenden, indem Sie die Dateien des Projekts ändern.

Problembehandlung

Wenn Fehler während azd up angezeigt werden, versuchen Sie die folgenden Schritte:

  • Führen Sie azd down aus, um alle Ressourcen zu entfernen, die erstellt wurden. Alternativ können Sie die Ressourcengruppe löschen, die im Azure-Portal erstellt wurde.
  • Löschen Sie den Azdtest-Ordner auf Ihrem lokalen Computer.
  • Suchen Sie im Azure-Portal nach Key Vaults. Wählen Sie Gelöschte Vaults verwalten, wählen Sie Ihr Abonnement, markieren Sie alle Schlüsselspeicher, die den Namen azdtest oder wie auch immer Sie Ihre Umgebung benannt haben, enthalten, und wählen Sie Löschen.
  • Wiederholen Sie die Schritte in dieser Schnellstartanleitung. Wählen Sie in diesem Fall, wenn Sie dazu aufgefordert werden, einen einfacheren Namen für Ihre Umgebung aus. Probieren Sie einen kurzen Namen, Kleinbuchstaben, keine Zahlen, keine Großbuchstaben, keine Sonderzeichen aus.
  • Wenn Sie die Schnellstartschritte wiederholen, wählen Sie einen anderen Speicherort aus.

Eine umfassendere Liste möglicher Probleme und Lösungen finden Sie in den häufig gestellten Fragen .

Verwandte Inhalte

  • Last updated on