Schnellstart für Python 3 in der App Engine-Standardumgebung
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.
Dieser Schnellstart zeigt, wie Sie in App Engine eine Beispielanwendung bereitstellen. Informationen zum Codieren einer Anwendung für App Engine finden Sie unter Anwendung erstellen.
Ist App Engine die richtige Computing-Option für Sie? Weitere Optionen zum Hosten Ihrer Anwendung in Google Cloud
Kosten
Für diesen Leitfaden fallen keine Kosten an. Wenn Sie nur diese Beispielanwendung ausführen, wird Ihr kostenloses Kontingent nicht überschritten.
Hinweis
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Build API aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Build API aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
Zusätzliche Voraussetzungen
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.
Installieren Sie folgende Abhängigkeiten:
Mit dem folgenden Befehl installieren Sie die gcloud-Komponente, die die App Engine-Erweiterung für Python 3 enthält:
gcloud components install app-engine-python
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 normalerweise die Region auswählen, die den Nutzern Ihrer Anwendung am nächsten ist. Sie sollten jedoch die Standorte, an denen App Engine verfügbar ist und die Standorte der anderen Google Cloud-Produkte und -Dienste berücksichtigen, 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.
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 Cloud Console. Die Region wird oben auf der Seite angezeigt.
Hello World-App herunterladen
Wir haben eine einfache Hello-World-Anwendung für Python 3 entwickelt, damit Sie schnell ein Gefühl für die Bereitstellung einer Anwendung in der Google Cloud entwickeln können.
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.
Wechseln Sie zu dem Verzeichnis, das den Beispielcode enthält:
cd python-docs-samples/appengine/standard_python3/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
- Erstellen Sie eine isolierte Python-Umgebung:
python3 -m venv env
source env/bin/activate
- 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
- Führen Sie die Anwendung aus:
python main.py
- Geben Sie im Webbrowser die folgende Adresse ein:
http://localhost:8080
Windows
Führen Sie Ihre Python-Pakete mit PowerShell aus.
- Wechseln Sie zu Ihrer Installation von PowerShell.
- Klicken Sie mit der rechten Maustaste auf die Verknüpfung zu PowerShell und starten Sie diese als Administrator.
- Erstellen Sie eine isolierte Python-Umgebung.
python -m venv env
.\env\Scripts\activate
- 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
- Führen Sie die Anwendung aus:
python main.py
- 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 Anwendung in der App Engine-Standardumgebung bereit:-
Führen Sie den folgenden Befehl im Verzeichnis
standard_python3/hello_world
aus, um die Anwendung "Hello World" 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]
- Mit dem Flag
--project
können Sie eine andere Cloud Console-Projekt-ID als jene angeben, die Sie imgcloud
-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
. - Verwenden Sie das Flag
-
Starten Sie den Browser und rufen Sie die Anwendung unter
https://PROJECT_ID.REGION_ID.r.appspot.com
auf.gcloud app browse
Dabei istPROJECT_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 Python 3-Anwendung in der App Engine-Standardumgebung bereitgestellt.
In den folgenden Abschnitten finden Sie Informationen zur Bereinigung sowie Links für mögliche weitere Schritte.
Bereinigen
Um Gebühren zu vermeiden, können Sie Ihr Cloud-Projekt löschen und so die Abrechnung für alle in diesem Projekt verwendeten Ressourcen beenden.
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.
Weitere Informationen
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 App Engine-Standardumgebung
Im Folgenden finden Sie weitere Themen zu App Engine: