Freigeben über

Schnellstart: Erstellen und Bereitstellen einer Python Web-App für 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 für Azure. Befolgen Sie die Anweisungen in dieser Schnellstartanleitung:

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

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

Weitere Informationen zu diesen azd-Vorlagen für Python Web App-Entwicklung finden Sie unter:

  • Was sind diese Vorlagen?
  • Wie funktionieren die Vorlagen?
  • Warum möchte ich dies verwenden?
  • Was sind meine anderen Optionen?

Voraussetzungen

Ein Azure-Abonnement – Create one for free

Installieren Sie die folgenden Tools auf Ihrem lokalen Computer:

Vorlage auswählen

Wählen Sie eine Vorlage azd basierend auf dem Python-Webframework, der Azure-Webhosting-Plattform und der Azure-Datenbank-Plattform, auf deren Basis Sie aufbauen möchten.

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

    • Django
    • FastAPI
    • Flask
    Schablone WebFramework Datenbank Hostingplattform GitHub-Repository
    azure-django-postgres-flexible-aca Django PostgreSQL Flexible Server Azure Container Apps repo
    azure-django-postgres-flexible-appservice Django PostgreSQL Flexible Server Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL Adapter) Azure Container Apps repo
    Azure-Django-Cosmos-Postgres-AppService Django Cosmos DB (PostgreSQL Adapter) Azure App Service repo
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL-Erweiterung Azure Container Apps repo

Ausführen der Vorlage

Das Ausführen einer Vorlage ist in allen Sprachen und Frameworks identisch. 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 ihre lokalen Git-Repositorys normalerweise speichern. Erstellen Sie einen neuen Ordner namens azdtest. Wechseln Sie dann mithilfe des Befehls 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 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 den Azure Ressourcengruppen und Ressourcen verwendet. Verwenden Sie für optimale Ergebnisse einen Kurznamen, Kleinbuchstaben und keine Sonderzeichen.

  3. Um azd für Ihr Azure Konto zu authentifizieren, 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:To create the necessary Azure resources, enter the following commands in your terminal and answer any prompts:

    azd up

    Von Bedeutung

    Sobald azd up erfolgreich abgeschlossen ist, ist die Beispielweb-App im öffentlichen Internet verfügbar, und Ihr Azure-Abonnement beginnt mit der Fälligkeit von Gebühren für alle Ressourcen, die erstellt werden. Die Ersteller der 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 zu verwenden, und wählen Sie dann einen Azure Speicherort aus, der verwendet werden soll. Wählen Sie eine Region aus, die ihnen geografisch nahe liegt.

    Das Ausführen von azd up kann mehrere Minuten dauern, da mehrere Azure-Dienste bereitgestellt und implementiert 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

    Wenn Sie mit der Arbeit mit der Beispielweb-App fertig sind, verwenden Sie diese Option , um alle erstellten Dienste zu entfernen.

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

    Screenshot der erfolgreichen Ausgabe der azd-Befehlszeilenschnittstelle mit einer Markierung um die Endpunkt-URL, um die funktionierende Relecloud-Anwendung anzuzeigen, die in Azure bereitgestellt ist.

    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 in Azure ausgeführt wird.

  7. Öffnen Sie eine neue Registerkarte in Ihrem Webbrowser.

    1. Kopieren Sie die zweite URL aus dem vorherigen Schritt, und fügen Sie sie in die Positionsleiste ein.
    2. Im Azure-Portal werden alle Dienste in Ihrer neuen Ressourcengruppe angezeigt, die zum Hosten des Beispielweb-App-Projekts bereitgestellt werden.

Bearbeiten und erneutes Bereitstellen

Nehmen Sie als Nächstes eine kleine Änderung an der Web-App vor, und stellen Sie sie dann erneut bereit.

  1. Öffnen Sie Visual Studio Code, und öffnen Sie den Ordner azdtest.

  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 Reopen in Container aus.

  3. Verwenden Sie die Explorer-Ansicht von Visual Studio Code, um zu src/templates Ordner zu navigieren, und öffnen Sie die Datei index.html. 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 den folgenden Befehl in Ihrem Terminal aus:

    azd deploy

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

  5. Wenn der Befehl abgeschlossen ist, aktualisieren Sie Ihren Webbrowser, um die aktualisierte Seite anzuzeigen. Je nach verwendeter Webhostingplattform 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 Befehl ausführen.

    azd down

    Der Befehl azd down löscht die Azure Ressourcen und den GitHub Actions 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 angezeigt werden, versuchen Sie die folgenden Schritte:

  • Führen Sie den Befehl aus, um alle vom Befehl erstellten Ressourcen zu entfernen. Alternativ können Sie die Im Azure Portal erstellte Ressourcengruppe löschen.
  • Löschen Sie den Azdtest-Ordner auf Ihrem lokalen Computer.
  • Suchen Sie im Azure-Portal nach Key Vaults. Wählen Sie "Gelöschte Tresore verwalten", wählen Sie Ihr Abonnement aus, wählen Sie alle Schlüsseltresor aus, die den Namen azdtest oder den Namen Ihrer Umgebung enthalten, und wählen Sie "Löschen" aus.
  • 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. Versuchen Sie einen kurzen Namen, Kleinbuchstaben, keine Zahlen, keine Großbuchstaben und keine Sonderzeichen.
  • 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.For a more comprehensive list of possible issues and solutions, see the FAQ.

Verwandte Inhalte

  • Last updated on