Freigeben über

Bereitstellen einer Python-Web-App (Flask) mit PostgreSQL in Azure

In diesem Lernprogramm stellen Sie eine datengesteuerte Python-Web-App in Azure App Service mit dem relationalen Datenbankdienst Azure Database for PostgreSQL bereit. Azure App Service unterstützt Python in einer Linux-Serverumgebung. In diesem Artikel wird eine Flask-App verwendet. Alternativen umfassen Django oder das FastAPI-Lernprogramm.

Diagramm zeigt die Architektur eines App-Diensts mit einer PostgreSQL-Datenbank in Azure.

In diesem Tutorial lernen Sie Folgendes:

  • Erstellen einer standardmäßig sicheren Architektur mit App Service, PostgreSQL und Redis Cache
  • Sichern Sie Verbindungsgeheimnisse mit einer verwalteten Identität und Key Vault-Verweisen.
  • Bereitstellen einer Python-Beispiel-App in App Service aus einem GitHub-Repository
  • Greifen Sie auf Verbindungszeichenfolgen und Einstellungen des App Service im Code der Anwendung zu.
  • Vornehmen von Änderungen und erneutes Bereitstellen des Anwendungscodes
  • Generieren eines Datenbankschemas durch Ausführen von Datenbankmigrationsvorgängen
  • Streamen von Diagnoseprotokollen aus Azure
  • Verwalten der App im Azure-Portal
  • Sorgen Sie für dieselbe Architektur und implementieren Sie mithilfe der Azure Developer CLI.
  • Optimieren des Entwicklungsworkflows mit GitHub Codespaces und GitHub Copilot

Voraussetzungen

  • Ein Azure-Konto mit einem aktiven Abonnement. Falls Sie kein Azure-Konto besitzen, können Sie kostenlos eines erstellen.
  • Ein GitHub-Konto. Sie können auch kostenlos eine bekommen.
  • Kenntnisse in der Entwicklung mit Python und Flask
  • (Optional) Ein GitHub Copilot-Konto, um GitHub Copilot zu testen. Es ist eine kostenlose 30-Tage-Testversion verfügbar.

Zum Ende springen

Wenn Sie nur die Beispiel-App in diesem Lernprogramm anzeigen möchten, das in Azure ausgeführt wird, führen Sie die folgenden Befehle in der Azure Cloud Shell aus, und folgen Sie der Eingabeaufforderung:

mkdir msdocs-flask-postgresql-sample-app
cd msdocs-flask-postgresql-sample-app
azd init --template msdocs-flask-postgresql-sample-app
azd up

Beispiel ausführen

Richten Sie als Ausgangspunkt eine datengesteuerte Beispiel-App ein. Aus Gründen Der Einfachheit halber enthält das Beispiel-Repository eine Dev-Container-Konfiguration . Der Entwicklercontainer verfügt über alles, was Sie zum Entwickeln einer Anwendung benötigen. Sie enthält die Datenbank, den Cache und alle Umgebungsvariablen, die von der Beispielanwendung benötigt werden. Der Entwicklercontainer kann in einem GitHub-Codespace ausgeführt werden, sodass Sie das Beispiel auf jedem Computer mit einem Webbrowser ausführen können.

Hinweis

Wenn Sie diesem Lernprogramm mit Ihrer eigenen App folgen, schauen Sie sich die requirements.txt Dateibeschreibung in README.md an, um zu sehen, welche Pakete Sie benötigen.

Schritt 1: In einem neuen Browserfenster:

  1. Melden Sie sich bei Ihrem GitHub-Konto an.
  2. Navigiere zu https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app/fork.
  3. Deaktivieren Sie die Option Nur Mainbranch kopieren. Sie möchten alle Zweige.
  4. Wählen Sie Fork erstellen aus.

Screenshot zeigt, wie Sie einen Fork eines GitHub-Beispiel-Repositorys erstellen.

Schritt 2: Im GitHub-Fork:

  1. Wählen Sie für den Startbranch main>starter-no-infra aus. Diese Verzweigung enthält nur das Beispielprojekt ohne Azure-bezogene Dateien oder Konfigurationen.
  2. Wählen Sie Code aus. Wählen Sie auf der Registerkarte Codespaces die Auswahl Codespace erstellen auf Starter-no-infra aus. Das Einrichten des Codespace dauert einige Minuten. Es wird pip install -r requirements.txt für Ihr Repository ausgeführt.

Screenshot zeigt, wie Sie einen Codespace in GitHub erstellen.

Schritt 3: Im Codespace-Terminal:

  1. Führen Sie eine Datenbankmigration mit flask db upgrade aus.
  2. Führen Sie die App mit flask run aus.
  3. Wenn die Benachrichtigung Your application running on port 5000 is available. angezeigt wird, wählen Sie Im Browser öffnen aus. Die Beispielanwendung sollte in einem neuen Browser-Tab angezeigt werden. Um die Anwendung zu beenden, geben Sie Ctrl+C ein.

Screenshot zeigt, wie die Beispielanwendung im GitHub-Codespace ausgeführt wird.

Tipp

Sie können GitHub Copilot über dieses Repository befragen. Zum Beispiel:

  • @workspace Was macht dieses Projekt?
  • @workspace Wofür dient der Ordner „.devcontainer“?

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Erstellen von App Service und PostgreSQL

In diesem Abschnitt erstellen Sie die Azure-Ressourcen. Dieses Tutorial erstellt eine Reihe von standardmäßig sicheren Ressourcen, darunter App Service und Azure Database for PostgreSQL. Für den Erstellungsprozess geben Sie Folgendes an:

  • Den Namen für die Web-App. Sie wird als Teil des DNS-Namens für Ihre App verwendet.
  • Die Region für die physische Ausführung der App in der Welt Sie ist auch Teil des DNS-Namens für Ihre App.
  • Der Runtimestapel für die App. Die Version von Python, die für Ihre App verwendet werden soll.
  • Der Hostingplan für die App. Das Preisniveau, das die Reihe von Features und Skalierungskapazität für Ihre App enthält.
  • Die Ressourcengruppe für die App. Mit einer Ressourcengruppe können Sie die Azure-Ressourcen für die Anwendung in einem logischen Container gruppieren.

Melden Sie sich beim Azure-Portal an, und führen Sie die folgenden Schritte aus, um Ihre Azure App Service-Ressourcen zu erstellen.

Schritt 1: Im Azure-Portal:

  1. Geben Sie oben im Azure-Portal die Web-App-Datenbank in die Suchleiste ein.
  2. Wählen Sie unter der Überschrift Marketplace das Element mit der Bezeichnung Web App + Datenbank aus. Sie können auch direkt zu "Web App erstellen " navigieren.

Screenshot zeigt, wie Sie das Suchfeld in der oberen Symbolleiste verwenden, um den Assistenten zum Erstellen von Web App + Datenbank zu finden.

Schritt 2: Füllen Sie das Formular auf der Seite Web-App und Datenbank erstellen wie folgt aus.

  1. Ressourcengruppe: Wählen Sie Neu erstellen aus, und verwenden Sie den Namen msdocs-python-postgres-tutorial.
  2. Region: Eine beliebige Azure-Region in Ihrer Nähe.
  3. Name:msdocs-python-postgres-XYZ.
  4. Laufzeitstapel: Python 3.14.
  5. Datenbank:PostgreSQL – Flexibler Server ist standardmäßig als Datenbank-Engine ausgewählt. Der Servername und der Datenbankname sind ebenfalls standardmäßig auf geeignete Werte festgelegt.
  6. Azure Cache for Redis hinzufügen?Nein
  7. Hostingplan: Basic. Wenn Sie bereit sind, können Sie auf einen Produktionstarif hochskalieren.
  8. Klicken Sie auf Überprüfen + erstellen.
  9. Wenn die Überprüfung abgeschlossen ist, wählen Sie Erstellen aus.

Screenshot zeigt, wie Sie eine neue App und Datenbank im Web App + Datenbank-Assistenten konfigurieren.

Schritt 3: Die Bereitstellung dauert einige Minuten. Klicken Sie nach Abschluss der Bereitstellung auf Zu Ressource wechseln. Die Bereitstellung stellt die folgenden Ressourcen bereit:

  • Ressourcengruppe: Der Container für alle erstellten Ressourcen.
  • App Service-Plan: Definiert die Berechnungsressourcen für App Service. Die Bereitstellung erstellt einen Linux-Plan in der Stufe Basic.
  • App Service: Stellt Ihre App dar und wird im App Service Plan ausgeführt.
  • Virtuelles Netzwerk: Integriert in die App Service-App und isoliert den Back-End-Netzwerkdatenverkehr.
  • Netzwerkschnittstellen: Stellt private IP-Adressen dar, eine für jeden privaten Endpunkt.
  • Azure Database for PostgreSQL – Flexibler Server: Nur aus dem virtuellen Netzwerk zugänglich. Eine Datenbank und ein Benutzer werden für Sie auf dem Server erstellt.
  • Private DNS-Zonen: aktiviert die DNS-Auflösung von Schlüsseltresor und Datenbankserver im virtuellen Netzwerk.

Screenshot des abgeschlossenen Bereitstellungsprozesses.

Sichere Verbindungsgeheimnisse

Der Bereitstellungsprozess generiert die Konnektivitätsvariablen für Sie als App-Einstellungen. Die bewährte Sicherheitsmethode besteht darin, Geheimnisse vollständig aus dem App-Service herauszuhalten. Verschieben Sie Ihre Geheimnisse in einen Schlüsseltresor, und ändern Sie die App-Einstellung mithilfe von Dienstconnectors in Key Vault-Verweise.

Schritt 1: Abrufen der vorhandenen Verbindungszeichenfolge:

  1. Wählen Sie im linken Menü der Seite "App Service" Einstellungen>Umgebungsvariablen aus.
  2. Wählen Sie AZURE_POSTGRESQL_CONNECTIONSTRING aus.
  3. Suchen Sie unter Anwendungseinstellungen hinzufügen/bearbeiten im Feld Wert am Ende der Zeichenfolge nach password=.
  4. Kopieren Sie die Kennwortzeichenfolge nach kennwort= zur späteren Verwendung. Diese App-Einstellung ermöglicht die Verbindung zur Postgres-Datenbank, die hinter einem privaten Endpunkt gesichert ist. Der geheime Schlüssel wird direkt in der App Service-App gespeichert, was nicht die bewährte Methode ist. Später ändern Sie diese Konfiguration.

Screenshot zeigt, wie der Wert einer App-Einstellung angezeigt wird.

Schritt 2: Erstellen Sie einen Schlüsseltresor für die sichere Verwaltung von geheimen Schlüsseln:

  1. Geben Sie in der oberen Suchleiste key vault ein, und wählen Sie dann Marketplace>Key Vault aus.
  2. Wählen Sie in der Ressourcengruppemsdocs-python-postgres-tutorial aus.
  3. Geben Sie im Key Vault Name einen Namen ein, der nur aus Buchstaben und Zahlen besteht.
  4. Legen Sie den Wert für Region auf den gleichen Standort wie für die Ressourcengruppe fest.

Screenshot zeigt, wie Sie einen Schlüsseltresor erstellen.

Schritt 3: Sichern Sie den Key Vault mit einem Privaten Endpunkt:

  1. Wählen Sie "Netzwerk" aus.
  2. Deaktivieren SieÖffentlichen Zugriff aktivieren.
  3. Wählen sie Privaten Endpunkt erstellen aus.
  4. Wählen Sie in der Ressourcengruppemsdocs-python-postgres-tutorial aus.
  5. Wählen Sie im Dialogfeld unter Standort denselben Standort wie für Ihre App Service-App aus.
  6. Geben Sie unter Name die Zeichenfolge msdocs-python-postgres-XYZVaultEndpoint ein.
  7. Wählen Sie unter Virtuelles Netzwerkmsdocs-python-postgres-XYZVnet aus.
  8. Wählen Sie in Subnetzmsdocs-python-postgres-XYZSubnet aus.
  9. Klicken Sie auf OK.
  10. Klicken Sie aufÜberprüfen + erstellen und dann auf Erstellen. Warten Sie, bis die Bereitstellung des Schlüsseltresors abgeschlossen ist. Sie sollten sehen, dass Ihre Bereitstellung abgeschlossen ist.

Dieser Screenshot zeigt, wie Sie einen Schlüsseltresor mit einem privaten Endpunkt sichern.

Schritt 4: Konfigurieren Sie den PostgreSQL-Connector:

  1. Geben Sie in der oberen Suchleiste msdocs-python-postgres ein und wählen Sie dann die App-Service-Ressource mit dem Namen msdocs-python-postgres-XYZ aus.
  2. Wählen Sie auf der Seite "App Service" im linken Menü Einstellungen>Service Connector aus. Es gibt bereits einen Connector, den der Bereitstellungsprozess für dich erstellt hat.
  3. Aktivieren Sie das Kontrollkästchen neben dem PostgreSQL-Connector, und wählen Sie dann Bearbeiten aus.
  4. Wählen Sie als Clienttyp die Option Django aus. Obwohl Sie eine Flask-App haben, stellt der Django-Clienttyp im PostgreSQL-Dienstconnector Datenbankvariablen in getrennten Einstellungen zur Verfügung anstatt einer einzigen Verbindungszeichenfolge. Die separaten Variablen sind einfacher im Anwendungscode zu verwenden, der SQLAlchemy verwendet, um eine Verbindung mit der Datenbank herzustellen.
  5. Wählen Sie "Authentifizierung" aus.
  6. Fügen Sie unter Kennwort das Kennwort ein, das Sie zuvor kopiert haben.
  7. Wählen Sie Geheimnis in Key Vault speichern aus.
  8. Wählen Sie unter Key Vault-Verbindung die Option Neu erstellen aus. Über dem Bearbeitungsdialogfeld wird ein Dialogfeld " Verbindung erstellen " geöffnet.

Screenshot zeigt, wie ein Dienstconnector mit einer Key Vault-Verbindung bearbeitet wird.

Schritt 5: Herstellen der Key Vault-Verbindung:

  1. Wählen Sie im Dialogfeld Verbindung erstellen für die Key Vault-Verbindung unter Key Vault den zuvor erstellten Schlüsseltresor aus.
  2. Klicken Sie auf Überprüfen + erstellen.
  3. Wählen Sie nach Abschluss der Überprüfung Erstellen aus.

Screenshot zeigt, wie Sie einen Key Vault-Dienstconnector konfigurieren.

Schritt 6: Abschließen der PostgreSQL-Connector-Einstellungen:

  1. Sie befinden sich wieder im Bearbeitungsdialogfeld für defaultConnector. Warten Sie auf der Registerkarte Authentifizierung, bis der Schlüsseltresorconnector erstellt wurde. Nach dem Erstellen wählt die Dropdown-Liste „Key Vault-Verbindung“ automatisch diese Verbindung aus.
  2. Klicken Sie auf Weiter: Netzwerk.
  3. Wählen Sie Speichern. Warten Sie, bis die Benachrichtigung Update erfolgreich angezeigt wird.

Screenshot der Schlüsseltresor-Verbindung, die im defaultConnector ausgewählt ist.

Schritt 7: Überprüfen der Key Vault-Integration

  1. Wählen Sie im linken Menü erneut Einstellungen>Umgebungsvariablen aus.
  2. Wählen Sie neben AZURE_POSTGRESQL_PASSWORD die Option Wert anzeigen aus. Der Wert sollte @Microsoft.KeyVault(...) sein, was bedeutet, dass es sich um eine Key Vault-Referenz handelt. Das Secret wird nun im Key Vault verwaltet.

Screenshot zeigt, wie der Wert des PostgreSQL-Kennworts in Azure angezeigt wird.

Folgende Schritte sind zum Schützen Ihrer Verbindungsgeheimnisse erforderlich:

  • Abrufen der Verbindungsgeheimnisse aus den Umgebungsvariablen der App Service-App
  • Erstellen eines Schlüsseltresors.
  • Erstellen einer Key Vault-Verbindung mit der systemseitig zugewiesenen verwalteten Identität
  • Aktualisieren der Dienstconnectors zum Speichern der Geheimnisse in Key Vault

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Bereitstellen von Beispielcode

In diesem Abschnitt konfigurieren Sie die GitHub-Bereitstellung mithilfe von GitHub-Aktionen. Es ist eine von vielen Möglichkeiten, App Service bereitzustellen. Es ist eine hervorragende Möglichkeit, eine kontinuierliche Integration in Ihren Bereitstellungsprozess zu haben. Standardmäßig startet jede git push in Ihrem GitHub-Repository die Build- und Bereitstellungsaktion.

Schritt 1: Wählen Sie im linken Menü Bereitstellung> Bereitstellungscenter aus.

Screenshot zeigt, wie das Bereitstellungscenter in App Service geöffnet wird.

Schritt 2: Auf der Seite Bereitstellungscenter:

  1. Wählen Sie in Quelle die Option GitHub aus. Standardmäßig wird GitHub Actions als Buildanbieter ausgewählt.
  2. Melden Sie sich bei Ihrem GitHub-Konto an und folgen Sie der Aufforderung, Azure zu autorisieren.
  3. Wählen Sie in Organisation Ihr Konto aus.
  4. Wählen Sie im Repository das Repository msdocs-flask-postgresql-sample-app aus.
  5. Wählen Sie unter Branch den Eintrag starter-no-infra aus. Diese Branch ist die gleiche, in der Sie mit Ihrer Beispiel-App gearbeitet haben, ohne Azure-bezogene Dateien oder Konfiguration.
  6. Wählen Sie unter Authentifizierungstyp die Option Benutzerseitig zugewiesene Identität aus.
  7. Wählen Sie im oberen Menü Speichern aus. App Service überträgt eine Workflowdatei in das ausgewählte GitHub-Repository im .github/workflows-Verzeichnis. Standardmäßig erstellt das Bereitstellungscenter eine benutzerseitig zugewiesene Identität für den Workflow zur Authentifizierung mithilfe von Microsoft Entra (OIDC-Authentifizierung). Weitere Authentifizierungsoptionen finden Sie unter Deploy to App Service using GitHub Actions.

Screenshot zeigt, wie CI/CD mithilfe von GitHub Actions konfiguriert wird.

Schritt 3: führen Sie zurück im GitHub-Codespace Ihres Beispielforks git pull origin starter-no-infra aus. Mit diesem Befehl wird die neu zugesicherte Workflowdatei in Ihren Codespace abgerufen.

Screenshot einer Pullaktion in einem GitHub-Codespace.

Schritt 4 (Option 1: mit GitHub Copilot):

  1. Starten Sie eine neue Chat-Sitzung, indem Sie die Chat-Ansicht auswählen und anschließend +.
  2. Fragen, @workspace Wie stellt die App eine Verbindung mit der Datenbank her? Copilot kann Ihnen einige Erläuterungen SQLAlchemygeben, z. B. wie sein Verbindungs-URI in azureproject/development.py und azureproject/production.py konfiguriert ist.
  3. Fragen, @workspace Im Produktionsmodus wird meine App in einer App Service-Web-App ausgeführt, die Azure Service Connector verwendet, um eine Verbindung mit einem flexiblen PostgreSQL-Server mithilfe des Django-Clienttyps herzustellen. Was sind die Namen der Umgebungsvariablen, die ich verwenden muss? Copilot gibt Ihnen möglicherweise einen Codevorschlag ähnlich wie in der Option 2: ohne GitHub Copilot-Schritte und weisen Sie sogar an, die Änderung in der Datei "azureproject/production.py " vorzunehmen.
  4. Öffnen Sie azureproject/production.py im Explorer, und fügen Sie den Codevorschlag ein. GitHub Copilot gibt Ihnen nicht jedes Mal dieselbe Antwort. Antworten sind nicht immer richtig. Möglicherweise müssen Sie weitere Fragen stellen, um ihre Antwort zu optimieren. Tipps finden Sie unter Was kann ich mit GitHub Copilot in meinem Codespace tun?

Screenshot zeigt, wie Sie eine Frage in einer neuen GitHub Copilot-Chatsitzung stellen.

Schritt 4 (Option 2: ohne GitHub Copilot):

  1. Öffnen Sie azureproject/production.py im Explorer.
  2. Suchen Sie den auskommentierten Code (Zeilen 3–8), und heben Sie die Auskommentierung auf. Diese Änderung erstellt eine Verbindungszeichenfolge für SQLAlchemy mithilfe von AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST und AZURE_POSTGRESQL_NAME.

Screenshot zeigt einen geöffneten GitHub-Codespace und azureproject/production.py.

Schritt 5:

  1. Wählen Sie die Quellsteuerungserweiterung aus.
  2. Geben Sie im Textfeld eine Commitnachricht ein, z. B. Configure Azure database connection. Oder wählen Sie aus, und lassen Sie GitHub Copilot eine Commit-Nachricht für Sie generieren.
  3. Wählen Sie Commit aus, und bestätigen Sie dann mit Ja.
  4. Wählen Sie Änderungen synchronisieren 1 aus, und bestätigen Sie dann mit OK.

Der Screenshot zeigt die Änderungen, die zugesichert und an GitHub übertragen werden.

Schritt 6: Zurück auf der Seite „Bereitstellungscenter“ im Azure-Portal:

  1. Wählen Sie Protokolle und dann Aktualisieren aus, um die neue Bereitstellungsausführung zu sehen.
  2. Wählen Sie in dem Protokollelement für die Bereitstellungsausführung den Eintrag Build/Deploy Logs mit dem neuesten Zeitstempel aus.

Screenshot zeigt, wie Bereitstellungsprotokolle im Bereitstellungscenter geöffnet werden.

Schritt 7: Sie werden zu Ihrem GitHub-Repository weitergeleitet. Die GitHub-Aktion wird ausgeführt. Die Workflowdatei definiert zwei separate Phasen, Erstellen und Bereitstellen. Warten Sie, bis die GitHub-Ausführung den Status Erfolg anzeigt. Dies dauert ca. 5 Minuten.

Screenshot eines ausgeführten GitHub-Vorgangs.

Treten Probleme auf? Sehen Sie sich den Leitfaden zur Problembehandlung an.

Datenbankschema generieren

Bei einer durch ein virtuelles Netzwerk geschützten PostgreSQL-Datenbank können Sie Flask-Datenbankmigrationsvorgänge am einfachsten in einer SSH-Sitzung mit dem Linux-Container in App Service ausführen.

Schritt 1: Zurück auf der Seite "App Service " im linken Menü

  1. Wählen Sie Entwicklungstools>SSH aus.
  2. Klicken Sie auf Starten.

Screenshot zeigt, wie Sie die SSH-Shell für Ihre App über das Azure-Portal öffnen.

Schritt 2: Führen Sie in der SSH-Sitzung flask db upgrade aus. Wenn dies erfolgreich ist, stellt App Service erfolgreich eine Verbindung mit der Datenbank her.

Der Screenshot zeigt die Befehle, die in der SSH-Shell und deren Ausgabe ausgeführt werden sollen.

Tipp

In der SSH-Sitzung können nur Änderungen an Dateien in /home über den Neustart der App hinaus bestehen bleiben. Änderungen außerhalb von /home bleiben nicht erhalten.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Navigieren zur App

Schritt 1: Auf der Seite "App Service ":

  1. Wählen Sie im Menü auf der linken Seite die Option Übersicht aus.
  2. Wählen Sie die URL Ihrer App aus.

Screenshot zeigt, wie Sie einen App-Dienst über das Azure-Portal starten.

Schritt 2: Fügen Sie der Liste ein paar Restaurants zu. Glückwunsch! Sie führen eine Web-App in Azure App Service aus, mit sicherer Konnektivität zu Azure Database for PostgreSQL.

Ein Screenshot der Flask-Web-App mit PostgreSQL, die in Azure ausgeführt wird und Restaurants und Restaurantbewertungen anzeigt.

Übertragung von Diagnoseberichten

Azure App Service erfasst alle Konsolenprotokolle, um Sie bei der Diagnose von Problemen mit Ihrer Anwendung zu unterstützen. Die Beispiel-App enthält print() Anweisungen zur Veranschaulichung dieser Funktion, wie im Folgenden gezeigt.

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

Schritt 1: Auf der Seite "App Service ":

  1. Wählen Sie im linken Menü Überwachung>App Service Protokolle aus.
  2. Wählen Sie unter Anwendungsprotokollierung die Option Dateisystem aus.
  3. Wählen Sie im oberen Menü Speichern aus.

Screenshot zeigt, wie integrierte Protokolle im App Service im Azure-Portal aktiviert werden.

Schritt 2: Wählen Sie im Menü auf der linken Seite die Option Protokollstream aus. Sie sehen die Protokolle für Ihre App, einschließlich Plattformprotokolle und Protokolle innerhalb des Containers.

Screenshot zeigt, wie der Protokolldatenstrom im Azure-Portal angezeigt wird.

Weitere Informationen zur Protokollierung in Python-Apps finden Sie unter Einrichten von Azure Monitor für Ihre Python-Anwendung.

Bereinigen von Ressourcen

Wenn Sie fertig sind, können Sie alle Ressourcen aus Ihrem Azure-Abonnement löschen, indem Sie die Ressourcengruppe löschen.

Schritt 1: In der Suchleiste oben im Azure-Portal:

  1. Geben Sie den Ressourcengruppennamen ein.
  2. Wählen Sie die Ressourcengruppe aus.

Screenshot zeigt, wie Sie im Azure-Portal nach einer Ressourcengruppe suchen und navigieren.

Schritt 2: Wählen Sie auf der Seite „Ressourcengruppe“ die Option Ressourcengruppe löschen aus.

Der Screenshot zeigt den Speicherort der Schaltfläche

Schritt 3:

  1. Um den Löschvorgang zu bestätigen, geben Sie den Namen der Ressourcengruppe ein.
  2. Klicken Sie auf Löschen.
  3. Bestätigen Sie erneut mit Löschen.

Screenshot: Bestätigungsdialogfeld für das Löschen einer Ressourcengruppe im Azure-Portal

Erstellen von Azure-Ressourcen und Bereitstellen einer Beispiel-App

In diesem Schritt erstellen Sie die Azure-Ressourcen und stellen eine Beispiel-App für App Service für Linux bereit. Die in diesem Tutorial ausgeführten Schritte erstellen eine Reihe standardmäßig sicherer Ressourcen, die App Service und Azure Database for PostgreSQL umfassen.

Der Entwicklercontainer verfügt bereits über die Azure Developer CLI (AZD).

  1. Führen Sie im Repositorystamm azd init aus.

    azd init --template python-app-service-postgresql-infra

  2. Wenn Sie dazu aufgefordert werden, geben Sie die folgenden Antworten:

    Frage Antwort
    Das aktuelle Verzeichnis ist nicht leer. Möchten Sie ein Projekt hier in <Ihr Verzeichnis> initialisieren? J
    Was möchten Sie mit diesen Dateien tun? Meine vorhandenen Dateien unverändert beibehalten
    Geben Sie einen neuen Umgebungsnamen ein. Geben Sie einen eindeutigen Namen ein. Die AZD-Vorlage verwendet diesen Namen als Teil des DNS-Namens Ihrer Web-App in Azure (<app-name>-<hash>.azurewebsites.net). Alphanumerische Zeichen und Bindestriche sind zulässig.

  3. Melden Sie sich mithilfe des Befehls azd auth login bei Azure an, und folgen Sie der Eingabeaufforderung:

    azd auth login

  4. Erstellen Sie die erforderlichen Azure-Ressourcen mit dem Befehl azd provision. Folgen Sie der Eingabeaufforderung, um das gewünschte Abonnement und den gewünschten Standort für die Azure-Ressourcen auszuwählen.

    azd provision

    Der azd provision Befehl dauert etwa 15 Minuten, bis er abgeschlossen ist. Der Redis-Cache dauert die meiste Zeit. Modifizieren Sie später Ihren Code, damit er mit App Service funktioniert, und stellen Sie die Änderungen mit azd deploy bereit. Während der Ausführung stellt der Befehl Nachrichten zum Bereitstellungs- und Bereitstellungsprozess bereit, einschließlich eines Links zur Bereitstellung in Azure.

    Diese AZD-Vorlage enthält Dateien (azure.yaml und das Verzeichnis infra), die eine standardmäßig sichere Architektur mit den folgenden Azure-Ressourcen generieren:

    • Ressourcengruppe: Der Container für alle erstellten Ressourcen.
    • App Service-Plan: Definiert die Berechnungsressourcen für App Service. Er erstellt einen Linux-Plan auf der Stufe "Einfach ".
    • App Service: Stellt Ihre App dar und wird im App Service Plan ausgeführt.
    • Virtuelles Netzwerk: Integriert in die App Service-App und isoliert den Back-End-Netzwerkdatenverkehr.
    • Private Endpunkte: Zugriffsendpunkte für den Key Vault und den Redis-Cache im virtuellen Netzwerk.
    • Netzwerkschnittstellen: Stellt private IP-Adressen dar, eine für jeden privaten Endpunkt.
    • Azure Database for PostgreSQL flexible Server: Zugriff nur über das virtuelle Netzwerk. Eine Datenbank und ein Benutzer werden für Sie auf dem Server erstellt.
    • Private DNS-Zone: Aktiviert die DNS-Auflösung des PostgeSQL-Servers im virtuellen Netzwerk.
    • Log Analytics-Arbeitsbereich: Fungiert als Zielcontainer für Ihre App, um die Protokolle zu versenden. Dort können Sie auch die Protokolle abfragen.
    • Azure Cache for Redis: Nur von hinter seinem privaten Endpunkt aus zugänglich.
    • Schlüsseltresor: Nur von hinter seinem privaten Endpunkt aus zugänglich. Wird verwendet, um Geheimnisse für die App Service-App zu verwalten.

    Nachdem der Befehl das Erstellen von Ressourcen abgeschlossen und den Anwendungscode zum ersten Mal bereitgestellt hat, funktioniert die bereitgestellte Beispiel-App noch nicht. Sie müssen kleine Änderungen vornehmen, um eine Verbindung mit der Datenbank in Azure herzustellen.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Verwenden Sie die Datenbankverbindungszeichenfolge

Die AZD-Vorlage, die Sie verwenden, generierte Konnektivitätsvariablen für Sie bereits als App-Einstellungen. Sie gibt sie an das Terminal aus. App-Einstellungen sind eine Möglichkeit, um Verbindungsgeheimnisse aus Ihrem Coderepository herauszuhalten.

  1. Suchen Sie in der AZD-Ausgabe die Einstellungen AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST und AZURE_POSTGRESQL_NAME. Um Geheimnisse zu schützen, werden nur die Einstellungsnamen angezeigt. Sie sehen in der AZD-Ausgabe wie folgt aus:

    App Service app has the following connection settings:
        - AZURE_POSTGRESQL_NAME
        - AZURE_POSTGRESQL_HOST
        - AZURE_POSTGRESQL_USER
        - AZURE_POSTGRESQL_PASSWORD
        - AZURE_REDIS_CONNECTIONSTRING
        - AZURE_KEYVAULT_RESOURCEENDPOINT
        - AZURE_KEYVAULT_SCOPE

  2. Der Einfachheit halber enthält die AZD-Vorlage den direkten Link zur Seite „App-Einstellungen“ der App. Suchen Sie den Link, und öffnen Sie ihn auf einer neuen Browserregisterkarte.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Ändern von Beispielcode und erneute Bereitstellung

  1. Starten Sie im GitHub-Codespace eine neue Chatsitzung, indem Sie die Chatansicht auswählen, und wählen Sie +dann aus.

  2. Fragen, @workspace Wie stellt die App eine Verbindung mit der Datenbank her? Copilot kann Ihnen einige Erläuterungen SQLAlchemygeben, z. B. wie sein Verbindungs-URI in azureproject/development.py und azureproject/production.py konfiguriert ist.

  3. Fragen, @workspace Im Produktionsmodus wird meine App in einer App Service-Web-App ausgeführt, die Azure Service Connector verwendet, um eine Verbindung mit einem flexiblen PostgreSQL-Server mithilfe des Django-Clienttyps herzustellen. Was sind die Namen der Umgebungsvariablen, die ich verwenden muss? Copilot gibt Ihnen möglicherweise einen Codevorschlag ähnlich wie in der Option 2: ohne GitHub Copilot-Schritte und weisen Sie sogar an, die Änderung in der Datei "azureproject/production.py " vorzunehmen.

  4. Öffnen Sie azureproject/production.py im Explorer, und fügen Sie den Codevorschlag ein.

    GitHub Copilot gibt Ihnen nicht jedes Mal dieselbe Antwort. Antworten sind nicht immer richtig. Möglicherweise müssen Sie weitere Fragen stellen, um ihre Antwort zu optimieren. Tipps finden Sie unter Was kann ich mit GitHub Copilot in meinem Codespace machen?.

  5. Führen Sie im Terminal azd deploy aus.

    azd deploy

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Datenbankschema generieren

Bei einer durch ein virtuelles Netzwerk geschützten PostgreSQL-Datenbank können Sie Flask-Datenbankmigrationsvorgänge am einfachsten in einer SSH-Sitzung mit dem Linux-Container in App Service ausführen.

  1. Suchen Sie in der AZD-Ausgabe die URL für die SSH-Sitzung, und navigieren Sie im Browser dorthin. Die Ausgabe sieht wie folgt aus:

    Open SSH session to App Service container at: <URL>

  2. Führen Sie in der SSH-Sitzung flask db upgrade aus. Wenn dies erfolgreich ist, stellt App Service erfolgreich eine Verbindung mit der Datenbank her.

    Der Screenshot zeigt die Befehle, die in der SSH-Shell und deren Ausgabe ausgeführt werden sollen.

    Hinweis

    Nur Änderungen an Dateien in /home können über den Neustart der App hinaus beibehalten werden. Änderungen außerhalb von /home bleiben nicht erhalten.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Navigieren zur App

  1. Suchen Sie in der AZD-Ausgabe die URL für Ihre App, und navigieren Sie im Browser dorthin. Die URL sieht in der AZD-Ausgabe wie folgt aus:

    Deploying services (azd deploy)

  (✓) Done: Deploying service web
  - Endpoint: <URL>

  2. Fügen Sie ein paar Restaurants zu der Liste hinzu.

    Ein Screenshot der Flask-Web-App mit PostgreSQL, die in Azure ausgeführt wird und Restaurants und Restaurantbewertungen anzeigt.

    Glückwunsch! Sie führen eine Web-App in Azure App Service mit sicherer Konnektivität zu Azure Database for PostgreSQL aus.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Übertragung von Diagnoseberichten

Azure App Service kann Konsolenprotokolle erfassen, um Sie bei der Diagnose von Problemen mit Ihrer Anwendung zu unterstützen. Die AZD-Vorlage ermöglicht bereits die Protokollierung beim lokalen Dateisystem und wird die Protokolle an einen Log Analytics-Arbeitsbereich versenden.

Die Beispielanwendung enthält print()-Anweisungen, um diese Funktion wie im folgenden Codeschnipsel gezeigt zu veranschaulichen.

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

Suchen Sie in der AZD-Ausgabe den Link zum Streamen von App Service-Protokollen, und navigieren Sie im Browser dorthin.

Weitere Informationen zur Protokollierung in Python-Apps finden Sie in der Reihe zum Einrichten von Azure Monitor für Ihre Python-Anwendung.

Treten Probleme auf? Sehen Sie sich den Abschnitt zur Problembehandlung an.

Bereinigen von Ressourcen

Führen Sie azd down aus, und folgen Sie den Eingabeaufforderungen, um alle Azure-Ressourcen in der aktuellen Bereitstellungsumgebung zu löschen.

azd down

Problembehandlung

Im Folgenden finden Sie einige Probleme, die beim Ausführen dieses Lernprogramms auftreten können, und schritte, um sie zu beheben.

Ich kann keine Verbindung mit der SSH-Sitzung herstellen

Wenn Sie keine Verbindung mit der SSH-Sitzung herstellen können, konnte die App selbst nicht gestartet werden. Überprüfen Sie die Details in den Diagnoseprotokollen. Wenn beispielsweise ein Fehler angezeigt KeyError: 'AZURE_POSTGRESQL_HOST'wird, bedeutet dies möglicherweise, dass die Umgebungsvariable fehlt. Vielleicht haben Sie die App-Einstellung entfernt.

Ich erhalten einen Fehler beim Ausführen von Datenbankmigrationen

Wenn Fehler im Zusammenhang mit dem Herstellen einer Verbindung mit der Datenbank auftreten, überprüfen Sie, ob die App-Einstellungen (AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST und AZURE_POSTGRESQL_NAME) geändert oder gelöscht wurden. Ohne diese Verbindungszeichenfolge kann der Migrationsbefehl (migrate) nicht mit der Datenbank kommunizieren.

Häufig gestellte Fragen

Wie viel kostet diese Einrichtung?

Die Preise für die erstellte Ressourcen sind wie folgt:

  • Der App Service-Plan wird im Tarif Basic erstellt und kann hoch- oder herunterskaliert werden. Informationen dazu finden Sie unter App Service – Preise.
  • PostgreSQL – Flexibler Server wird in der niedrigsten burstfähigen Dienstebene, Standard_B1ms, mit der Mindestspeichergröße erstellt, die hoch- und herunterskaliert werden kann. Weitere Informationen finden Sie unter Azure Database for PostgreSQL – Preise.
  • Das virtuelle Netzwerk hat keine Gebühr, es sei denn, Sie konfigurieren zusätzliche Funktionen, z. B. Peering. Siehe Azure Virtual Network Preise.
  • Die private DNS-Zone verursacht eine kleine Gebühr. Siehe Azure DNS-Preise.

Wie stelle ich mit anderen Tools eine Verbindung mit dem PostgreSQL-Server her, der hinter dem virtuellen Netzwerk geschützt ist?

  • Für den einfachen Zugriff aus einem Befehlszeilentool können Sie psql in der SSH-Sitzung der App ausführen.
  • Um eine Verbindung mit einem Desktoptool herzustellen, muss sich Ihr Computer im virtuellen Netzwerk befinden. Beispielsweise könnte es sich um einen virtuellen Azure-Computer sein, der mit einem der Subnetze oder einem Computer in einem lokalen Netzwerk verbunden ist, der über eine Standort-zu-Standort-VPN-Verbindung mit dem virtuellen Azure-Netzwerk verfügt.
  • Sie können Azure Cloud Shell auch in das virtuelle Netzwerk integrieren.

Wie funktioniert die lokale App-Entwicklung mit GitHub Actions?

Für die automatisch generierte Workflowdatei von App Service als Beispiel startet jeder git push eine neue Build- und Bereitstellungsausführung. Aus einem lokalen Klon des GitHub-Repositorys können Sie die gewünschten Updates vornehmen und zu GitHub pushen. Zum Beispiel:

git add .
git commit -m "<some-message>"
git push origin main

Wie kann ich Fehler während der Bereitstellung von GitHub Actions debuggen?

Wenn ein Schritt in der automatisch generierten GitHub-Workflowdatei fehlschlägt, versuchen Sie, den fehlerhaften Befehl zu ändern, um eine ausführlichere Ausgabe zu generieren. Sie können z. B. eine ausführliche Ausgabe für den python-Befehl abrufen, indem Sie die -d-Option hinzufügen. Committen und pushen Sie Ihre Änderungen, um eine weitere Bereitstellung in App Service auszulösen.

Ich habe keine Berechtigungen zum Erstellen einer benutzerseitig zugewiesenen Identität.

Siehe Einrichten der Bereitstellung von GitHub Actions über das Bereitstellungscenter.

Was kann ich mit GitHub Copilot in meinem Codespace machen?

Möglicherweise haben Sie bemerkt, dass die GitHub Copilot-Chatansicht bereits verfügbar war, als Sie den Codespace erstellt haben. Aus Gründen der Einfachheit fügen wir die GitHub Copilot-Chaterweiterung in die Containerdefinition ein. Siehe .devcontainer/devcontainer.json. Sie benötigen ein GitHub Copilot-Konto. Es ist eine kostenlose 30-Tage-Testversion verfügbar.

Einige Tipps für die Unterhaltung mit GitHub Copilot:

  • In einer einzelnen Chatsitzung bauen die Fragen und Antworten aufeinander auf. Sie können Ihre Fragen anpassen, um die Antwort zu optimieren, die Sie erhalten.
  • Standardmäßig hat GitHub Copilot keinen Zugriff auf Dateien in Ihrem Repository. Um Fragen zu einer Datei zu stellen, öffnen Sie die Datei zuerst im Editor.
  • Damit GitHub Copilot beim Vorbereiten der Antworten Zugriff auf alle Dateien im Repository hat, beginnen Sie Ihre Frage mit @workspace. Weitere Informationen finden Sie unter Use the @workspace agent.
  • In der Chatsitzung kann GitHub Copilot Änderungen vorschlagen und mit @workspace, auch wo die Änderungen vorgenommen werden sollen, aber es ist nicht erlaubt, die Änderungen für Sie vorzunehmen. Sie müssen entscheiden, ob Sie die vorgeschlagenen Änderungen hinzufügen und testen.

Verwandte Inhalte

Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie Sie Ihre App mit einer benutzerdefinierten Domäne und einem Zertifikat schützen.

  Sicher mit benutzerdefinierter Domäne und Zertifikat

Erfahren Sie, wie eine Python-App von App Service ausgeführt wird:

  • Last updated on