Python-Anwendung in der flexiblen App Engine-Umgebung erstellen

Python-Anwendung in der flexiblen App Engine-Umgebung erstellen

Regions-ID

REGION_ID ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.

Hier finden Sie weitere Informationen zu Regions-IDs.

OK

In dieser Kurzanleitung wird gezeigt, wie Sie eine Anwendung erstellen und bereitstellen, die eine kurze Nachricht anzeigt. Sie können die Beispielanwendung in diesem Schnellstart für jede unterstützte Version von Python verwenden, indem Sie die Laufzeitversion und das Betriebssystem in Ihrer app.yamlDatei angeben.

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build API.

   Enable the API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Build API.

   Enable the API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Zusätzliche Voraussetzungen

1. Initialisieren Sie die App Engine-Anwendung mit Ihrem Projekt und wählen Sie die Region aus:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Wählen Sie bei entsprechender Aufforderung die Region aus, in der sich die App Engine-Anwendung befinden soll.

   Achtung: Sie können die Region einer Anwendung nicht mehr ändern, nachdem Sie sie festgelegt haben.

2. Installieren Sie Folgendes auf Ihrem lokalen Computer:

   • Git herunterladen und installieren

• Mit dem folgenden Befehl installieren Sie die gcloud-Komponente, die die App Engine-Erweiterung für Python enthält:

  gcloud components install app-engine-python
  

3. Bereiten Sie Ihre Umgebung für die Python-Entwicklung vor. Es empfiehlt sich, in Ihrem System die neueste Version von Python, pip und die anderen verwandten Tools installiert zu haben. Eine Anleitung finden Sie im Einrichtungsleitfaden zur Python-Entwicklungsumgebung.

App Engine-Standorte

App Engine ist regional, was bedeutet, dass sich die Infrastruktur, in der Ihre Anwendungen ausgeführt werden, in einer bestimmten Region befindet und Google sie so verwaltet, dass sie redundant in allen Zonen innerhalb dieser Region verfügbar ist.

Die Erfüllung der Latenz-, Verfügbarkeits- oder Langlebigkeitsanforderungen ist der wichtigste Gesichtspunkt bei der Auswahl der Region, in der Ihre Anwendungen ausgeführt werden sollen. Sie können im Allgemeinen die Region auswählen, die den Nutzern Ihrer Anwendung am nächsten ist. Sie sollten jedoch die Standorte berücksichtigen, an denen App Engine verfügbar ist, sowie die Standorte der anderen Google Cloud-Produkte und -Dienste, die Ihre Anwendung nutzt. Eine Nutzung von Diensten über mehrere Standorte kann die Latenz der Anwendung sowie die Preise beeinflussen.

Sie können die Region einer Anwendung nicht mehr ändern, nachdem Sie sie festgelegt haben.

Hinweis: Zwei Standorte, die in App Engine-Befehlen und in der Google Cloud Console europe-west und us-central heißen, werden in der Google-Dokumentation als europe-west1 bzw. us-central1 bezeichnet.

Wenn Sie bereits eine App Engine-Anwendung erstellt haben, können Sie die Region mit einer der folgenden Methoden aufrufen:

• Führen Sie den Befehl gcloud app describe aus:

• Öffnen Sie das App Engine-Dashboard in der Google Cloud Console. Die Region wird oben auf der Seite angezeigt.

OK

In dieser Kurzanleitung wird die neueste Python 3-Anwendung gezeigt, die mit dem Web-Framework Flask geschrieben wurde und in App Engine bereitgestellt werden kann. Auch wenn in diesem Beispiel Flask verwendet wird, können Sie ein beliebiges Web-Framework einsetzen, das die oben beschriebenen Anforderungen erfüllt. Alternative Frameworks sind z. B. Django, Pyramid, Bottle und web.py.

Hello-World-Anwendung herunterladen

Wir haben eine Hello-World-Anwendung für App Engine entwickelt, damit Sie schnell ein Gefühl für die Bereitstellung einer Anwendung in Google Cloud entwickeln können.

1. Klonen Sie das Repository der Hello-World-Beispielanwendung auf dem lokalen Computer:

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples
   

   Sie können das Beispiel auch als ZIP-Datei herunterladen und extrahieren.

2. Wechseln Sie zu dem Verzeichnis, das den Beispielcode enthält:

      cd python-docs-samples/appengine/flexible/hello_world
   

Hello World auf lokalem Computer ausführen

So führen Sie die Hello World App auf einem lokalen Computer aus:

Mac OS/Linux

Hinweis: In dieser Anleitung wird die Einrichtung einer virtuellen Umgebung in Python 3 beschrieben. Verwenden Sie bei Python 2-Anwendungen virtualenv, um eine virtuelle Umgebung einzurichten.

1. Erstellen Sie eine isolierte Python-Umgebung:

   python3 -m venv env
   source env/bin/activate

2. Wenn Sie sich nicht in dem Verzeichnis befinden, das den Beispielcode enthält, wechseln Sie zu dem Verzeichnis, das den Beispielcode hello_world enthält: Installieren Sie dann Abhängigkeiten:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

3. Führen Sie die Anwendung aus:

   python main.py

4. Geben Sie im Webbrowser die folgende Adresse ein:

   http://localhost:8080

   Wenn Sie Cloud Shell verwenden, klicken Sie in der Symbolleiste auf Webvorschau  und wählen Sie stattdessen Vorschau auf Port 8080 aus.

Windows

Hinweis: In dieser Anleitung wird die Einrichtung einer virtuellen Umgebung in Python 3 beschrieben. Verwenden Sie bei Python 2-Anwendungen virtualenv, um eine virtuelle Umgebung einzurichten.

Führen Sie Ihre Python-Pakete mit PowerShell aus.

1. Wechseln Sie zu Ihrer Installation von PowerShell.
2. Klicken Sie mit der rechten Maustaste auf die Verknüpfung zu PowerShell und starten Sie diese als Administrator.
3. Erstellen Sie eine isolierte Python-Umgebung.

   python -m venv env
   .\env\Scripts\activate

4. Gehen Sie zu Ihrem Projektverzeichnis und installieren Sie die Abhängigkeiten: Wenn Sie sich nicht in dem Verzeichnis befinden, das den Beispielcode enthält, wechseln Sie zum Verzeichnis mit dem Beispielcode hello_world. Installieren Sie dann Abhängigkeiten:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

5. Führen Sie die Anwendung aus:

   python main.py

6. Geben Sie im Webbrowser die folgende Adresse ein:

   http://localhost:8080

Auf der Seite wird die Nachricht Hello World aus der Beispielanwendung angezeigt. Drücken Sie im Terminalfenster Strg + C, um den Webserver zu beenden.

Hello World in App Engine bereitstellen und ausführen

So stellen Sie die App in der flexiblen App Engine-Umgebung bereit:

1. Führen Sie den folgenden Befehl im Verzeichnis hello_world aus, um die Hello World-Anwendung bereitzustellen:

   gcloud app deploy

   Hier finden Sie Informationen zu optionalen Flags.

   Häufig verwendete gcloud-Befehls-Flags

   • Verwenden Sie das Flag --version, um eine eindeutige ID festzulegen, die die Version Ihrer Anwendung angibt. Andernfalls wird automatisch eine ID generiert. Beispiel: --version [YOUR_VERSION_ID]
   • Verwenden Sie das Flag --project, um eine andere Google Cloud-Projekt-ID als jene anzugeben, die Sie im gcloud-Tool als Standard initialisiert haben. Beispiel: --project [YOUR_PROJECT_ID]

   Beispiel:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   Weitere Informationen zum Bereitstellen der Anwendung über die Befehlszeile finden Sie unter Anwendung bereitstellen und testen. Eine Liste aller Befehls-Flags finden Sie in der Referenz zu gcloud app deploy.

   OK

2. Starten Sie den Browser und rufen Sie die Anwendung unter https://PROJECT_ID.REGION_ID.r.appspot.com auf.

   gcloud app browse

   Dabei ist PROJECT_ID Ihre Google Cloud-Projekt-ID.

Dieses Mal wird die Seite mit der Nachricht "Hello World" von einem Webserver bereitgestellt, der auf einer App Engine-Instanz ausgeführt wird.

Das wars! Sie haben Ihre erste App Engine-Anwendung in der flexiblen App Engine-Umgebung bereitgestellt!

Wenn beim Bereitstellen Ihrer Anwendung Fehler aufgetreten sind, lesen Sie die Tipps zur Fehlerbehebung.

In den folgenden Abschnitten finden Sie Informationen zur Bereinigung sowie Links für mögliche weitere Schritte.

Bereinigen

Zur Vermeidung von Gebühren können Sie Ihr Google Cloud-Projekt löschen und so die Abrechnung für alle in diesem Projekt verwendeten Ressourcen beenden.

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:
• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Nächste Schritte

Informationen zur Plattform

Sie wissen jetzt, wie Sie Anwendungen in App Engine entwickeln und bereitstellen. Nun können Sie sich mit den weiteren Bereichen von Google Cloud vertraut machen. Sie haben bereits die Google Cloud CLI installiert, mit der Sie die Tools zur Interaktion mit Produkten wie z. B. Cloud SQL, Cloud Storage, Firestore nutzen können.

Informationen zur flexiblen App Engine-Umgebung

Im Folgenden finden Sie weitere Themen zu App Engine:

• App Engine – Übersicht
• Routing anfordern
• Anfragen verarbeiten
• Instanzen verwalten

Hello World-Code prüfen

Die Hello-World-Anwendung ist die einfachste realisierbare App Engine-Anwendung, da sie nur einen Dienst enthält, nur eine Version hat und sich der gesamte Code im Stammverzeichnis der Anwendung befindet. Der folgende Abschnitt zeigt die einzelnen Dateien der Anwendung im Detail.

main.py

Die "Hello World"-Anwendung ist eine sehr einfache Flask-Anwendung mit nur einer Datei.

from flask import Flask


app = Flask(__name__)


@app.route("/")
def hello() -> str:
    """Return a friendly HTTP greeting.

    Returns:
        A string with the words 'Hello World!'.
    """
    return "Hello World!"


if __name__ == "__main__":
    # This is used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app.
    app.run(host="127.0.0.1", port=8080, debug=True)

app.yaml

In der app.yaml-Datei wird die folgende Konfiguration für Ihre Anwendung beschrieben:

• Legt env: flex fest. Dies gibt an, dass Ihre Anwendung die flexible App Engine-Umgebung verwendet.

• Gibt die von der App verwendete Laufzeit an. Wenn Sie die Einstellung runtime_version ausschließen, verwendet App Engine die neueste Python-Version als Standardversion für Ihre Anwendung.

• entrypoint weist App Engine an, die Anwendung zu starten. Diese Anwendung verwendet gunicorn, um die Python-App als Alternative zum Entwicklungsserver von Flask bereitzustellen (wird beim lokalen Ausführen verwendet). Die Variable $PORT wird von App Engine beim Starten der Anwendung festgelegt. Weitere Informationen zu entrypoint finden Sie unter Anwendungsstart.

Hinweis: Dies ist die einfachste Methode zur Ausführung von Gunicorn. Die Anwendung wird dadurch jedoch mit einem einzigen blockierenden Worker ausgeführt, d. h., alle HTTP-Anfragen, einschließlich Systemdiagnosen, werden seriell verarbeitet. In der Praxis führt dies dazu, dass die Anwendung bei langsamen Anfragen nicht mehr reagiert. Weitere Informationen zur Konfiguration von Gunicorn für Produktionszwecke finden Sie unter Empfohlene Gunicorn-Konfiguration.

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
  operating_system: ubuntu22

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

• Weitere Informationen zur Python-Laufzeit finden Sie unter Python-Laufzeit

• Weitere Informationen zur Entwicklung der Anwendung und zur Nutzung der Vorteile von Versionen und Diensten erhalten Sie unter Überblick über App Engine

• Weitere Informationen zu den Konfigurationseinstellungen für App Engine finden Sie unter Anwendung mit app.yaml konfigurieren.

requirements.txt

requirements.txt und der Python-Paketmanager pip deklarieren und installieren Anwendungsabhängigkeiten. Für "Hello World" sind Flask (Web-Framework) und Gunicorn (WSGI-Server) erforderlich.

Flask==3.0.3; python_version > '3.6'
Flask==2.3.3; python_version < '3.7'
Werkzeug==3.0.3; python_version > '3.6'
Werkzeug==2.3.7; python_version < '3.7'
gunicorn==22.0.0

requirements.txt gibt die Bibliotheken an, die sowohl lokal als auch beim Bereitstellen in App Engine installiert werden.