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. Das Einbinden von REGION_ID.r
in App Engine-URLs ist für vorhandene Anwendungen optional und wird bald für alle neuen Anwendungen erforderlich sein.
Für einen reibungslosen Übergang wird App Engine nach und nach für die Verwendung von Regions-IDs aktualisiert. Wenn Ihr Google Cloud-Projekt noch nicht aktualisiert wurde, wird für Ihre Anwendung keine Regions-ID angezeigt. Da die ID für vorhandene Anwendungen optional ist, müssen Sie keine URLs aktualisieren oder andere Änderungen vornehmen, wenn die Regions-ID für Ihre vorhandenen Anwendungen verfügbar wird.
Pub/Sub bietet zuverlässiges und asynchrones m:n-Messaging zwischen Anwendungen. Publisher-Anwendungen können Nachrichten an ein bestimmtes Thema senden. Andere Anwendungen haben die Möglichkeit, dieses Thema zu abonnieren, um Nachrichten dazu zu erhalten.
In diesem Dokument wird beschrieben, wie Sie mit der Cloud-Clientbibliothek Pub/Sub-Nachrichten in einer Python-Anwendung senden und empfangen.
Vorbereitung
- Folgen Sie der Anleitung unter "Hello, World!" für Python in App Engine, um Ihre Umgebung und Ihr Projekt einzurichten und um mehr über die Strukturierung von Python-Anwendungen in App Engine zu erfahren.
- Notieren Sie sich Ihre Projekt-ID und bewahren Sie sie auf. Sie benötigen die ID zur Ausführung der in diesem Dokument beschriebenen Beispielanwendung.
Beispielanwendung klonen
Kopieren Sie die Beispielanwendungen auf Ihren lokalen Computer und rufen Sie das Verzeichnis pubsub
auf:
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/pubsub
Thema und Abo erstellen
Erstellen Sie ein Thema und ein Abo, einschließlich des Endpunkts, an den der Pub/Sub-Server Anfragen senden soll:
gcloud pubsub topics create YOUR_TOPIC_NAME gcloud pubsub subscriptions create YOUR_SUBSCRIPTION_NAME \ --topic YOUR_TOPIC_NAME \ --push-endpoint \ https://YOUR_PROJECT_ID.REGION_ID.r.appspot.com/pubsub/push?token=YOUR_TOKEN \ --ack-deadline 10
Ersetzen Sie YOUR_TOKEN
durch ein geheimes, zufälliges Token. Der Push-Endpunkt verwendet dieses zum Verifizieren von Anfragen.
Umgebungsvariablen festlegen
Legen Sie in der Datei app.yaml
die Umgebungsvariablen für die Projekt-ID, das Thema und das Bestätigungstoken fest:
Codeüberprüfung
Die Beispielanwendung verwendet die Cloud-Clientbibliotheken.
Die Beispielanwendung verwendet die in der Datei app.yaml
festgelegten Werte zum Konfigurieren von Umgebungsvariablen. Anhand dieser Werte bestätigt der Push-Anfragen-Handler, dass die Anfrage von Pub/Sub kommt und aus einer vertrauenswürdigen Quelle stammt:
app.config['PUBSUB_VERIFICATION_TOKEN'] = \
os.environ['PUBSUB_VERIFICATION_TOKEN']
app.config['PUBSUB_TOPIC'] = os.environ['PUBSUB_TOPIC']
Die Beispielanwendung verwaltet eine globale Liste zum Speichern der von dieser Instanz empfangenen Nachrichten:
MESSAGES = []
Die Methode pubsub_push()
empfängt Push-Nachrichtenund fügt sie der globalen Liste MESSAGES
hinzu:
Die Methode index()
interagiert mit der App Engine-Webanwendung, um neue Nachrichten zu veröffentlichen und empfangene Nachrichten anzuzeigen:
Beispiel lokal ausführen
Bei einer lokalen Ausführung können Sie sich über das Cloud SDK für die Nutzung von Google Cloud APIs authentifizieren. Wenn Sie Ihre Umgebung wie unter Vorbereitung beschrieben eingerichtet haben, ist die Authentifizierung bereits über den Befehl gcloud init
erfolgt.
Installieren Sie Abhängigkeiten, vorzugsweise in einer virtuellen Umgebung.
Mac OS/Linux
- Erstellen Sie eine isolierte Python-Umgebung in einem Verzeichnis außerhalb Ihres Projekts und aktivieren Sie diese:
python3 -m venv env
source env/bin/activate
- Wechseln Sie zu Ihrem Projektverzeichnis und installieren Sie die Abhängigkeiten:
cd YOUR_PROJECT
pip install -r requirements.txt
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 von PowerShell und starten Sie diese als Administrator.
- Erstellen Sie eine isolierte Python-Umgebung in einem Verzeichnis außerhalb Ihres Projekts und aktivieren Sie diese:
python -m venv env
env\Scripts\activate
- Wechseln Sie zu Ihrem Projektverzeichnis und installieren Sie die Abhängigkeiten:
cd YOUR_PROJECT
pip install -r requirements.txt
Legen Sie vor dem Starten Ihrer Anwendung Umgebungsvariablen fest:
export GOOGLE_CLOUD_PROJECT=[your-project-id]
export PUBSUB_VERIFICATION_TOKEN=[your-verification-token]
export PUBSUB_TOPIC=[your-topic]
python main.py
Push-Benachrichtigungen simulieren
Die Anwendung kann Nachrichten lokal senden, aber keine Push-Nachrichten lokal empfangen. Sie können jedoch eine Push-Nachricht simulieren, wenn Sie eine HTTP-Anfrage an den lokalen Push-Benachrichtigungsendpunkt senden. Das Beispiel enthält die Datei sample_message.json
.
Sie verwenden curl
oder einen httpie
-Client, um eine HTTP-Anfrage vom Typ POST
zu senden:
curl -i --data @sample_message.json "localhost:8080/push-handlers/receive_messages?token=[your-token]"
Oder
http POST ":8080/push-handlers/receive_messages?token=[your-token]" < sample_message.json
Antwort
HTTP/1.0 200 OK
Content-Length: 2
Content-Type: text/html; charset=utf-8
Date: Mon, 10 Aug 2015 17:52:03 GMT
Server: Werkzeug/0.10.4 Python/2.7.10
OK
Nachdem die Anfrage abgeschlossen ist, können Sie localhost:8080
aktualisieren und die Nachricht in der Liste der empfangenen Nachrichten sehen.
In App Engine ausführen
Führen Sie zum Bereitstellen der Demo-Anwendung in App Engine mit dem gcloud
-Befehlszeilentool den folgenden Befehl in dem Verzeichnis aus, in dem sich die Datei app.yaml
befindet:
gcloud app deploy
Sie können jetzt unter https://PROJECT_ID.REGION_ID.r.appspot.com
auf die Anwendung zugreifen.
Sie können das Formular zum Senden von Nachrichten verwenden, dabei ist jedoch nicht sicher, welche Instanz Ihrer Anwendung die Benachrichtigung erhält. Außerdem haben Sie die Möglichkeit, mehrere Nachrichten zu senden und die Seite zu aktualisieren, damit die empfangene Nachricht angezeigt wird.