De nombreuses applications doivent exécuter un traitement en arrière-plan dans d'autres contextes que celui d'une requête Web. Ce tutoriel indique comment créer une application Web qui permet aux utilisateurs de saisir du texte à traduire, puis qui affiche la liste des traductions précédentes. La traduction est effectuée dans un traitement en arrière-plan pour éviter de bloquer la requête de l'utilisateur.
Le schéma suivant illustre le processus de requête de traduction.
Voici, dans l'ordre, comment fonctionne l'application du tutoriel :
- L'application accède à la page Web pour consulter la liste des traductions précédentes stockées dans Firestore.
- Elle demande la traduction d'un texte en saisissant un formulaire HTML.
- La requête de traduction est publiée dans Pub/Sub.
- Une application Cloud Run reçoit le message Pub/Sub.
- L'application Cloud Run utilise Cloud Translation pour traduire le texte.
- L'application Cloud Run stocke le résultat dans Firestore.
Ce tutoriel est destiné à toute personne intéressée par le traitement en arrière-plan avec Google Cloud. Il ne nécessite aucune connaissance particulière de Pub/Sub, Firestore, App Engine ou Cloud Run. Cependant, pour comprendre l'intégralité du code, il peut être utile de se familiariser avec PHP, JavaScript et HTML.
Objectifs
- Comprendre et déployer les services Cloud Run
- Comprendre et déployer une application App Engine
- Tester l'application
Coûts
Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :
Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.
Une fois que vous avez terminé les tâches décrites dans ce document, vous pouvez éviter de continuer à payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Effectuer un nettoyage.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
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, 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, Pub/Sub, and Cloud Translation APIs.
-
Dans la console Google Cloud, ouvrez l'application dans Cloud Shell.
Cloud Shell vous permet d'accéder en ligne de commande à vos ressources cloud, directement depuis votre navigateur. Ouvrez Cloud Shell dans votre navigateur et cliquez sur Proceed (Continuer) pour télécharger l'exemple de code et le modifier dans le répertoire de l'application.
-
Dans Cloud Shell, configurez l'outil
gcloud
pour qu'il utilise votre projet Google Cloud:# Configure gcloud for your project gcloud config set project YOUR_PROJECT_ID
Comprendre le backend Cloud Run
Vous définissez une seule fonction PHP translateString
et configurez votre service Cloud Run pour répondre à un message Pub/Sub en invoquant cette fonction.
La fonction doit importer plusieurs dépendances afin de pouvoir se connecter à Firestore et Translation.
Cloud Run commence par initialiser les clients Firestore et Pub/Sub. Ensuite, il analyse les données du message Pub/Sub pour obtenir le texte à traduire et la langue cible souhaitée.
L'API Translation permet de traduire la chaîne dans la langue souhaitée.
La fonction attribue un nom unique à la requête de traduction pour s'assurer que nous ne stockons pas de traductions en double. Elle procède ensuite à la traduction dans une transaction Firestore afin de s'assurer que les exécutions simultanées n'effectuent pas accidentellement la même traduction deux fois.
Créer et déployer le backend Cloud Run
Créez l'application Cloud Run dans le répertoire
backend
:gcloud builds submit backend/ \ --tag gcr.io/PROJECT_ID/background-function
Déployez l'application Cloud Run à l'aide du tag d'image de l'étape précédente :
gcloud run deploy background-processing-function --platform managed \ --image gcr.io/PROJECT_ID/background-function --region REGION
Où
REGION
est une région Google Cloud.Une fois le déploiement terminé, une URL de l'application déployée s'affiche dans le résultat de la commande. Exemple :
Service [background-processing-function] revision [default-00002-vav] has been deployed and is serving 100 percent of traffic at https://default-c457u4v2ma-uc.a.run.app
Copiez cette URL pour l'étape suivante.
Configurer l'abonnement Pub/Sub
Votre application Cloud Run reçoit des messages de Pub/Sub chaque fois qu'un message est publié sur le sujet translate
.
Une fonction de vérification d'authentification intégrée vérifie que le message Pub/Sub contient un jeton d'autorisation valide provenant d'un compte de service autorisé à appeler votre backend Cloud Run.
Les étapes suivantes vous guideront dans la configuration du sujet Pub/Sub, de l'abonnement et du compte de service pour passer des appels authentifiés à votre backend Cloud Run. Consultez la section Authentifier les communications de service à service pour en savoir plus.
Créez le sujet
translate
pour publier les nouvelles requêtes de traduction :gcloud pubsub topics create translate
Activez votre projet pour créer des jetons d'authentification Pub/Sub :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \ --role=roles/iam.serviceAccountTokenCreator
Où
PROJECT_NUMBER
correspond au numéro de votre projet Google Cloud, que vous pouvez trouver en exécutantgcloud projects describe PROJECT_ID | grep projectNumber
.Créez ou sélectionnez un compte de service pour représenter l'identité de l'abonnement Pub/Sub.
gcloud iam service-accounts create cloud-run-pubsub-invoker \ --display-name "Cloud Run Pub/Sub Invoker"
Remarque : Vous pouvez utiliser
cloud-run-pubsub-invoker
ou le remplacer par un nom unique dans votre projet Google Cloud.Autorisez le compte de service demandeur à appeler votre service
background-processing-function
:gcloud run services add-iam-policy-binding background-processing-function \ --member=serviceAccount:cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com \ --role=roles/run.invoker --platform managed --region REGION
La propagation des modifications d'Identity and Access Management peut prendre plusieurs minutes. Pendant ce temps, des erreurs
HTTP 403
peuvent s'afficher dans les journaux de service.Créez un abonnement Pub/Sub avec le compte de service :
gcloud pubsub subscriptions create run-translate-string --topic translate \ --push-endpoint=CLOUD_RUN_URL \ --push-auth-service-account=cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com
Où
CLOUD_RUN_URL
correspond à l'URL HTTPS que vous avez copiée après avoir créé et déployé votre backend.L'option
--push-account-service-account
active la fonctionnalité push de Pub/Sub pour l'authentification et l'autorisation.Votre domaine de service Cloud Run est automatiquement enregistré pour une utilisation avec les abonnements Pub/Sub.
Comprendre l'application
L'application Web comporte deux composants principaux :
-
Un serveur HTTP PHP pour gérer les requêtes Web. Il comporte les deux points de terminaison suivants :
-
/
: répertorie toutes les traductions existantes et affiche un formulaire que les utilisateurs peuvent envoyer pour demander de nouvelles traductions. -
/request-translation
: les envois de formulaires sont envoyés à ce point de terminaison, qui publie la requête sur Pub/Sub pour être traduite de manière asynchrone.
-
- Modèle HTML rempli à l'aide des traductions existantes par le serveur PHP.
Le serveur HTTP
Dans le répertoire
app
,index.php
commence par configurer l'application Lumen et enregistrer les gestionnaires HTTP :Le gestionnaire d'index (
/
) récupère toutes les traductions existantes dans Firestore et affiche un modèle avec la liste :Le gestionnaire des requêtes de traduction, enregistré sur
/request-translation
, analyse le formulaire HTML, valide la requête, puis publie un message dans Pub/Sub :
Modèle HTML
Le modèle HTML représente la base de la page HTML affichée à l'utilisateur afin qu'il puisse consulter les traductions précédentes et en demander de nouvelles. Ce modèle est rempli par le serveur HTTP à l'aide de la liste des traductions existantes.
-
L'élément
<head>
du modèle HTML inclut des métadonnées, des feuilles de style et le code JavaScript de la page :Cette page intègre des éléments Material Design Lite (MDL) CSS et JavaScript. MDL vous permet d'apporter un aspect Material Design à vos sites Web.
JQuery permet d'attendre la fin de chargement du document et de définir un gestionnaire d'envoi de formulaires. Chaque fois que le formulaire de requête de traduction est envoyé, la page effectue une validation minimale du formulaire pour vérifier que la valeur n'est pas vide, puis envoie une requête asynchrone au point de terminaison
/request-translation
.Enfin, un snackbar MDL apparaît pour indiquer si la requête a abouti ou si une erreur s'est produite.
- Le corps HTML de la page utilise une mise en page MDL et plusieurs composants MDL pour afficher la liste des traductions et un formulaire permettant de demander des traductions supplémentaires:
Exécuter l'application dans Cloud Shell
Avant d'essayer de déployer l'application Web, installez les dépendances et exécutez-la localement.
Commencez par installer les dépendances avec Composer. L'extension gRPC pour PHP est requise. Elle est pré-installée sur Cloud Shell.
composer install -d app
Ensuite, exécutez le serveur Web PHP intégré pour diffuser votre application :
APP_DEBUG=true php -S localhost:8080 -t app
L'option
APP_DEBUG=true
affiche toutes les exceptions qui se produisent.Dans Cloud Shell, cliquez sur Aperçu sur le Web , puis sélectionnez Prévisualiser sur le port 8080. Une nouvelle fenêtre s'affiche avec votre application en cours d'exécution.
Déployer l'application Web
Vous pouvez utiliser l'environnement standard App Engine pour créer et déployer une application qui s'exécute de manière fiable, même lorsqu'elle est soumise à une charge importante et doit gérer de grandes quantités de données.
Dans ce tutoriel, l'interface HTTP est déployée dans l'environnement standard App Engine.
Le fichier app.yaml
configure l'application App Engine :
-
Déployez votre application dans l'environnement standard App Engine à partir du répertoire où se trouve le fichier
app.yaml
:gcloud app deploy
Tester l'application
Après avoir déployé la fonction Cloud et l'application App Engine, essayez de demander une traduction.
-
Pour afficher l'application dans votre navigateur,saisissez l'URL suivante:
https://PROJECT_ID.REGION_ID.r.appspot.com
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre projet Google Cloud.REGION_ID
: code attribué par App Engine à votre application
Une page s'affiche avec une liste de traductions vide et un formulaire de demande de nouvelles traductions.
-
Dans le champ Texte à traduire, saisissez du texte à traduire. Exemple :
Hello, World
. - Dans la liste déroulante, sélectionnez la langue dans laquelle vous souhaitez traduire le texte.
- Cliquez sur Submit (Envoyer).
- Pour actualiser la page, cliquez sur Actualiser refresh. Une nouvelle ligne s'affiche dans la liste de traduction. Si vous ne voyez pas de traduction, attendez encore quelques secondes, puis réessayez. Si vous ne voyez toujours pas de traduction, consultez la section suivante sur le débogage de l'application.
Déboguer l'application
Si vous ne parvenez pas à vous connecter à votre application App Engine ou si vous ne voyez pas de nouvelle traduction, vérifiez les éléments suivants :
- Vérifiez que les commandes de déploiement
gcloud
ont bien abouti et n'ont généré aucune erreur. Si vous rencontrez des erreurs (par exemple,message=Build failed
), corrigez-les et réessayez de créer et déployer l'application Cloud Run, puis de déployer l'application App Engine. Dans Google Cloud Console, accédez à la page Explorateur de journaux.
Accéder à la page "Explorateur de journaux"
- Dans la liste déroulante Ressources sélectionnées récemment, cliquez sur Application GAE, puis sur Tous les ID de module. La liste des requêtes correspondant à votre accès à l'application s'affiche. Si cette liste n'apparaît pas, vérifiez que vous avez bien sélectionné Tous les ID de module dans la liste déroulante. Si des messages d'erreur s'affichent dans la console Google Cloud, vérifiez que le code de votre application correspond au code décrit dans la section "Comprendre l'application Web".
- Dans la liste déroulante Ressources sélectionnées récemment, cliquez sur Révision dans Cloud Run, puis sur Tous les journaux. Une requête POST va être envoyée à l'URL de votre application déployée. Dans le cas contraire, vérifiez que les applications Cloud Run et App Engine utilisent le même sujet Pub/Sub et qu'un abonnement Pub/Sub existe pour la publication vers votre point de terminaison Cloud Run.
Effectuer un nettoyage
Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.
Supprimer le projet Google Cloud
- 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.
Supprimer les ressources du tutoriel
Supprimez l'application App Engine que vous avez créée dans ce tutoriel :
- 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.
- Pour supprimer la version de l'application, cliquez sur Supprimer.
Supprimez le service Cloud Run que vous avez déployé dans ce tutoriel :
gcloud run services delete background-processing-function
Vous pouvez également supprimer des services Cloud Run à partir de Google Cloud Console.
Supprimez les autres ressources Google Cloud créées dans ce tutoriel :
- Supprimez le sujet Pub/Sub
translate
. - Supprimez l'abonnement Pub/Sub
run-translate-string
. - Supprimez l'image de conteneur nommée
gcr.io/PROJECT_ID/background-processing
de Container Registry. - Supprimez le compte de service demandeur
cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com
.
- Supprimez le sujet Pub/Sub