Viele Anwendungen müssen eine Hintergrundverarbeitung außerhalb des Kontexts einer Webanfrage ausführen. In dieser Anleitung wird eine Webanwendung erstellt, mit der Nutzer Text eingeben können, der übersetzt werden soll. Anschließend wird eine Liste früherer Übersetzungen angezeigt. Die Übersetzung erfolgt in einem Hintergrundprozess, um die Anfrage des Nutzers nicht zu blockieren.
Das folgende Diagramm veranschaulicht den Übersetzungsanfrageprozess.
Wie die in dieser Anleitung verwendete Anwendung funktioniert, sehen Sie an der Abfolge der Ereignisse:
- Die Webseite wird aufgerufen, um eine Liste früherer Übersetzungen anzuzeigen, die in Firestore gespeichert sind.
- Die Übersetzung eines Textes wird angefordert. Dazu wird ein HTML-Formular ausgefüllt.
- Die Übersetzungsanfrage wird in Pub/Sub veröffentlicht.
- Eine Cloud Run-Funktion, die dieses Pub/Sub-Thema abonniert hat, wird ausgelöst.
- Die Cloud Run-Funktion verwendet Cloud Translation, um den Text zu übersetzen.
- Die Cloud Run-Funktion speichert das Ergebnis in Firestore.
Diese Anleitung richtet sich an alle, die mehr über die Hintergrundverarbeitung mit Google Cloud erfahren möchten. Es sind keine Vorkenntnisse in Pub/Sub, Firestore, App Engine oder Cloud Run erforderlich. Etwas Erfahrung mit Go, JavaScript und HTML ist allerdings hilfreich, um den gesamten Code zu verstehen.
Lernziele
- Cloud Run-Funktionen verstehen und bereitstellen
- App Engine-Anwendung verstehen und bereitstellen
- Anwendung testen
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Hinweise
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Firestore, Cloud Run functions, Pub/Sub, and Cloud Translation APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Firestore, Cloud Run functions, Pub/Sub, and Cloud Translation APIs.
-
Öffnen Sie die Anwendung in der Google Cloud Console über Cloud Shell.
Cloud Shell bietet Ihnen direkt über den Browser Befehlszeilenzugriff auf Ihre Cloud-Ressourcen. Öffnen Sie Cloud Shell im Browser und klicken Sie auf Fortfahren, um den Beispielcode herunterzuladen und ins Anwendungsverzeichnis zu wechseln.
- Konfigurieren Sie in Cloud Shell das
gcloud
-Tool, um Ihr Google Cloud-Projekt zu verwenden:# Configure gcloud for your project gcloud config set project YOUR_PROJECT_ID
Cloud Run-Funktion
- Die Funktion beginnt mit dem Import mehrerer Abhängigkeiten wie Firestore und Translation. Sie bietet auch einige globale Variablen und Typen.
- Die globalen Firestore- und Translation-Clients werden initialisiert, damit sie zwischen Funktionsaufrufen wiederverwendet werden können. So müssen Sie nicht für jeden Funktionsaufruf neue Clients initialisieren, was die Ausführung verlangsamen würde.
- Die Translation API übersetzt den String in die von Ihnen ausgewählte Sprache.
-
Die Cloud Run-Funktion beginnt mit der Initialisierung der Firestore- und Pub/Sub-Clients. Anschließend parst sie die Pub/Sub-Nachricht, um den zu übersetzenden Text und die gewünschte Zielsprache abzurufen.
Die Anwendung erstellt dann einen eindeutigen Namen für die Übersetzungsanfrage, damit keine doppelten Übersetzungen gespeichert werden. Anschließend wird die Datei in eine Firestore-Transaktion übersetzt, damit bei gleichzeitiger Ausführung nicht versehentlich dieselbe Übersetzung zweimal ausgeführt wird.
Cloud Run-Funktion bereitstellen
Stellen Sie die Cloud Run-Funktion in Cloud Shell im selben Verzeichnis wie die Datei
translate.go
mit einem Pub/Sub-Trigger bereit:gcloud functions deploy Translate --runtime go111 \ --trigger-topic=translate --set-env-vars GOOGLE_CLOUD_PROJECT=YOUR_GOOGLE_CLOUD_PROJECT
Dabei ist
YOUR_GOOGLE_CLOUD_PROJECT
Ihre Google Cloud-Projekt-ID.
Informationen zur Anwendung
Zur Webanwendung gehören zwei Hauptkomponenten:
-
Ein Go-HTTP-Server für Webanfragen Der Server hat die folgenden beiden Endpunkte:
/
: führt alle vorhandenen Übersetzungen auf und zeigt ein Formular an, das Nutzer senden können, um neue Übersetzungen anzufordern./request-translation
: Formulare werden an diesen Endpunkt gesendet, der die Anfrage zur asynchronen Übersetzung in Pub/Sub veröffentlicht.
- Eine HTML-Vorlage, die vom Go-Server mit den vorhandenen Übersetzungen ausgefüllt wird.
HTTP-Server
Im Verzeichnis
index
beginntmain.go
mit dem Einrichten der Anwendung und dem Registrieren von HTTP-Handlern:Der Index-Handler (
/
) ruft alle vorhandenen Übersetzungen aus Firestore ab und füllt eine HTML-Vorlage mit der Liste aus:Neue Übersetzungen werden durch Senden eines HTML-Formulars angefordert. Der Handler für Übersetzungsanfragen, der unter
/request-translation
registriert ist, parst das gesendete Formular, validiert die Anfrage und veröffentlicht eine Nachricht in Pub/Sub:
HTML-Vorlage
Die HTML-Vorlage ist die Grundlage für die HTML-Seite, die dem Nutzer angezeigt wird, damit er frühere Übersetzungen sehen und neue anfordern kann. Die Vorlage wird vom HTTP-Server mit der Liste der vorhandenen Übersetzungen ausgefüllt.
-
Das Element
<head>
der HTML-Vorlage enthält Metadaten, Stylesheets und JavaScript für die Seite:Die Seite bindet CSS von Material Design Lite (MDL) und JavaScript-Assets ein. Mit MDL können Sie Ihren Websites einen Material Design-Look verleihen.
Mithilfe von JQuery wartet die Seite, bis das Dokument fertig geladen ist, und legt dann einen Handler für gesendete Formulare fest. Wenn das Formular zur Übersetzungsanfrage gesendet wird, bestätigt die Seite mithilfe einer minimalen Formularvalidierung, dass der Wert nicht leer ist, und sendet dann eine asynchrone Anfrage an den Endpunkt
/request-translation
.Schließlich wird über eine MDL-Snackbar angegeben, ob die Anfrage erfolgreich war oder ob ein Fehler aufgetreten ist.
- Der HTML-Text der Seite verwendet ein MDL-Layout und mehrere MDL-Komponenten, um eine Liste von Übersetzungen und ein Formular zum Anfordern weiterer Übersetzungen anzuzeigen:
App erstellen
-
Bevor Sie versuchen, die Webanwendung bereitzustellen, erstellen Sie die Anwendung, damit sie kompiliert wird und alle Abhängigkeiten funktionieren.
go build -o start ./index
Der Build war erfolgreich, wenn nichts ausgegeben und eine
start
-Datei erstellt wurde.
Webanwendung bereitstellen
Mit der App Engine-Standardumgebung können Sie eine Anwendung erstellen und bereitstellen, die zuverlässig unter hoher Last und mit großen Datenmengen ausgeführt wird.
In dieser Anleitung wird das HTTP-Front-End in der App Engine-Standardumgebung bereitgestellt.
Die Datei app.yaml
konfiguriert die App Engine-Anwendung:
- Stellen Sie Ihre Anwendung aus demselben Verzeichnis wie die Datei
app.yaml
in der App Engine-Standardumgebung bereit:gcloud app deploy
Anwendung testen
Fordern Sie nach dem Bereitstellen der Cloud Run-Funktion und der App Engine-Anwendung eine Übersetzung an.
-
Geben Sie die folgende URL ein, um die App in Ihrem Browser anzuzeigen:
https://PROJECT_ID.REGION_ID.r.appspot.com
Ersetzen Sie Folgendes:
PROJECT_ID
: Ihre Google Cloud-Projekt-IDREGION_ID
: Code, der Ihrer Anwendung von App Engine zugewiesen wird
Sie sehen eine Seite mit einer leeren Liste von Übersetzungen und einem Formular zum Anfordern neuer Übersetzungen.
- Geben Sie im Feld Text to translate (Zu übersetzender Text) einen Text ein, der übersetzt werden soll, z. B.
Hello, World
. - Wählen Sie in der Drop-down-Liste eine Sprache aus, in die Sie den Text übersetzen möchten.
- Klicken Sie auf Submit (Senden).
- Klicken Sie zum Aktualisieren der Seite auf Aktualisieren refresh. Die Übersetzungsliste enthält jetzt eine neue Zeile. Wenn Sie keine Übersetzung sehen, warten Sie einige Sekunden und versuchen es dann noch einmal. Ist immer noch keine Übersetzung zu sehen, lesen Sie den nächsten Abschnitt zum Debugging der Anwendung.
Fehler in der Anwendung beheben
Wenn Sie keine Verbindung zur App Engine-Anwendung herstellen können oder keine neuen Übersetzungen sehen, gehen Sie so vor:
-
Prüfen Sie, ob die
gcloud
-Bereitstellungsbefehle erfolgreich ausgeführt wurden und keine Fehler ausgegeben haben. Wenn Fehler aufgetreten sind, beheben Sie sie, bevor Sie die Cloud Run-Funktion und die App Engine-Anwendung noch einmal bereitstellen. -
Rufen Sie in der Google Cloud Console die Seite „Loganzeige“ auf.
Zur Seite "Loganzeige"- Klicken Sie in der Drop-down-Liste Kürzlich ausgewählte Ressourcen auf GAE-Anwendung und dann auf Alle Werte für module_id. Sie sehen eine Liste der Anfragen, die Sie beim Besuch Ihrer Anwendung gestellt haben. Wenn keine Anfragenliste angezeigt wird, bestätigen Sie, dass Sie Alle Werte für module_id aus der Drop-down-Liste ausgewählt haben. Wenn Fehlermeldungen in der Google Cloud Console angezeigt werden, prüfen Sie, ob der Code Ihrer Anwendung mit dem Code im Abschnitt „Informationen zur Anwendung“ übereinstimmt.
-
Klicken Sie in der Drop-down-Liste Kürzlich ausgewählte Ressourcen auf Cloud Functions-Funktion und dann auf Alle Funktionsnamen. Daraufhin wird für jede angeforderte Übersetzung eine Funktion angezeigt. Wenn nicht, prüfen Sie, ob die Cloud Run-Funktion und die App Engine-Anwendung dasselbe Pub/Sub-Thema verwenden:
- Prüfen Sie in der Datei
background/index/main.go
, ob dietopicName
-Konstante"translate"
lautet. - Geben Sie beim Bereitstellen der Cloud Run-Funktion unbedingt das Flag
--trigger-topic=translate
an.
- Prüfen Sie in der Datei
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
Google Cloud-Projekt löschen
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
App Engine-Instanz löschen
- In the Google Cloud console, go to the Versions page for App Engine.
- Select the checkbox for the non-default app version that you want to delete.
- Klicken Sie zum Löschen der Anwendungsversion auf Löschen.
Cloud Run-Funktion löschen
-
Löschen Sie die Cloud Run-Funktion, die Sie in dieser Anleitung erstellt haben:
gcloud functions delete Translate
Nächste Schritte
- Weitere Anleitungen zu Cloud Run-Funktionen testen
- Mehr über App Engine erfahren
- Cloud Run testen, um zustandslose Container in einer vollständig verwalteten Umgebung oder im eigenen Google Kubernetes Engine-Cluster auszuführen