Cette page a été traduite par l'API Cloud Translation.

Déployez une version de base de Google Traduction application sur Python 2 Cloud Run (Docker)

1. Présentation

Cette série d'ateliers de programmation (tutoriels pratiques et d'auto-formation) vise à aider les développeurs à comprendre les différentes options dont ils disposent pour déployer leurs applications. Dans cet atelier de programmation, vous allez apprendre à utiliser l'API Google Cloud Translation avec Python, et à l'exécuter en local ou à la déployer sur une plate-forme de calcul Cloud sans serveur (App Engine, Cloud Functions ou Cloud Run). L'exemple d'application qui se trouve dans le dépôt de ce tutoriel peut être déployé (au moins) hui manières différentes avec seulement des modifications de configuration mineures:

Serveur Flask local (Python 2)
Serveur Flask local (Python 3)
App Engine (Python 2)
App Engine (Python 3)
Cloud Functions (Python 3)
Cloud Run (Python 2 via Docker)
Cloud Run (Python 3 via Docker)
Cloud Run (Python 3 via Cloud Buildpacks)

Cet atelier de programmation porte sur le déploiement de cette application sur les plates-formes en gras ci-dessus.

Vous apprendrez à effectuer les tâches suivantes :

Utiliser les API Google Cloud, en particulier l'API Cloud Translation (avancé/v3)
Exécutez une application Web de base en local ou déployez-la sur une plate-forme de calcul sans serveur dans le cloud.

Prérequis

Un projet Google Cloud avec un compte de facturation Cloud actif
Flask installé pour une exécution en local, ou plate-forme de calcul sans serveur cloud activée pour les déploiements dans le cloud
Des connaissances de base en Python
Connaissance pratique des commandes de base du système d'exploitation

Enquête

Comment allez-vous utiliser ce tutoriel ?

<ph type="x-smartling-placeholder"></ph> Je vais le lire et effectuer les exercices

Lecture seule

Quel est votre niveau d'expérience avec Python ?

Débutant

Intermédiaire

Expert

Quel est votre niveau d'expérience avec les services Google Cloud ?

<ph type="x-smartling-placeholder"></ph> Débutant

Intermédiaire

Expert

2. Préparation

Configuration de l'environnement au rythme de chacun

Connectez-vous à la console Google Cloud, puis créez un projet ou réutilisez un projet existant. (Si vous ne possédez pas encore de compte Gmail ou Google Workspace, vous devez en créer un.)

Le nom du projet est le nom à afficher pour les participants au projet. Il s'agit d'une chaîne de caractères qui n'est pas utilisée par les API Google, et que vous pouvez modifier à tout moment.
L'ID du projet doit être unique sur l'ensemble des projets Google Cloud et doit être immuable (vous ne pouvez pas le modifier une fois que vous l'avez défini). Cloud Console génère automatiquement une chaîne unique dont la composition importe peu, en général. Dans la plupart des ateliers de programmation, vous devrez référencer l'ID du projet (généralement identifié comme PROJECT_ID), donc s'il ne vous convient pas, générez-en un autre au hasard ou définissez le vôtre, puis vérifiez s'il est disponible. Il est ensuite "gelé" une fois le projet créé.
La troisième valeur est le numéro de projet, utilisé par certaines API. Pour en savoir plus sur ces trois valeurs, consultez la documentation.

Vous devez ensuite activer la facturation dans Cloud Console afin d'utiliser les ressources/API Cloud. L'exécution de cet atelier de programmation est très peu coûteuse, voire sans frais. Pour arrêter les ressources afin d'éviter qu'elles ne vous soient facturées après ce tutoriel, suivez les instructions de nettoyage indiquées à la fin de l'atelier. Les nouveaux utilisateurs de Google Cloud peuvent participer au programme d'essai gratuit pour bénéficier d'un crédit de 300 $.

3. Activer l'API Translation

Activer les API Cloud

Dans cette section, vous apprendrez à activer les API Google en général. Pour notre exemple d'application, vous activerez l'API Cloud Translation, Cloud Run et Cloud Artifact Registry.

Introduction

Quelle que soit l'API Google que vous souhaitez utiliser dans votre application, vous devez les activer. L'exemple suivant montre deux façons d'activer l'API Cloud Vision. Après avoir appris à activer une API Cloud, vous pourrez activer d'autres API, car le processus est similaire.

Option 1: Depuis Cloud Shell ou votre interface de ligne de commande

Bien que l'activation des API à partir de la console Cloud soit plus courante, certains développeurs préfèrent tout faire à partir de la ligne de commande. Pour ce faire, vous devez rechercher le "nom de service" d'une API. Son URL ressemble à ceci: SERVICE_NAME.googleapis.com. Vous pouvez les trouver dans le tableau des produits compatibles ou les interroger de manière programmatique avec l'API Google Discovery.

Grâce à ces informations, vous pouvez activer une API à l'aide de Cloud Shell (ou de votre environnement de développement local sur lequel l'outil de ligne de commande gcloud est installé) :

gcloud services enable SERVICE_NAME.googleapis.com

Par exemple, la commande suivante active l'API Cloud Vision:

gcloud services enable vision.googleapis.com

Cette commande active App Engine:

gcloud services enable appengine.googleapis.com

Vous pouvez également activer plusieurs API avec une seule requête. Par exemple, cette ligne de commande active Cloud Run, Cloud Artifact Registry et l'API Cloud Translation:

gcloud services enable artifactregistry.googleapis.com run.googleapis.com translate.googleapis.com

Option 2: Dans la console Cloud

Vous pouvez également activer l'API Vision dans le gestionnaire d'API. Dans la console Cloud, accédez à Gestionnaire d'API, puis sélectionnez Bibliothèque.

Si vous voulez activer l'API Cloud Vision, commencez à saisir "vision" dans la barre de recherche. Tous les résultats qui correspondent à votre saisie s'affichent:

Sélectionnez l'API que vous souhaitez activer, puis cliquez sur Activer:

Coût

Si de nombreuses API Google peuvent être utilisées sans frais, l'utilisation des produits Google Cloud et Les API ne sont pas sans frais. Lors de l'activation des API Cloud, vous pouvez être invité à indiquer un compte de facturation actif. Il est cependant important de noter que certains produits Google Cloud proposent un service niveau (quotidien/mensuel), que vous devez dépasser pour que des frais vous soient facturés ; Sinon, votre carte de crédit (ou le mode de paiement spécifié) ne sera pas débitée.

Les utilisateurs doivent consulter les informations tarifaires d'une API avant de l'activer, en particulier en indiquant s'il s'agit d'une version sans frais et, le cas échéant, de quelle version il s'agit. Si vous activez l'API Cloud Vision, vous devez consulter la page d'informations tarifaires. Cloud Vision propose un quota sans frais. Tant que vous respectez les limites agrégées (au cours de chaque mois), aucuns frais ne vous sont facturés.

Les tarifs et les niveaux de sans frais varient selon les API Google. Exemples :

Google Cloud/GCP : chaque produit est facturé différemment et est généralement facturé par cycle de vCPU, consommateur d'espace de stockage, utilisation de mémoire ou facturation à l'utilisation. consultez les informations sur le niveau sans frais ci-dessus.
Google Maps : propose une suite d'API et offre aux utilisateurs un crédit mensuel sans frais de 200 USD dans l'ensemble.
Les API Google Workspace (anciennement G Suite) permettent une utilisation sans frais (dans la limite de certaines limites) couverte par des frais d'abonnement mensuels Workspace. L'utilisation des API Gmail, Google Drive, Agenda, Docs, Sheets et Slides ne fait donc pas l'objet d'une facturation directe.

La procédure de facturation est différente selon les produits Google. Par conséquent, assurez-vous de vous référer à la documentation de votre API pour obtenir ces informations.

Résumé

Maintenant que vous savez comment activer les API Google en général, accédez au gestionnaire d'API et activez l'API Cloud Translation, Cloud Run et Cloud Artifact Registry (si ce n'est pas déjà fait). Vous activez le premier, car notre application l'utilise. Vous activez ce dernier, car c'est là que nos images de conteneur sont stockées avant d'être déployées pour démarrer votre service Cloud Run. C'est pourquoi vous devez activer cette option. Si vous préférez toutes les activer avec l'outil gcloud, exécutez plutôt la commande suivante depuis votre terminal:

gcloud services enable artifactregistry.googleapis.com run.googleapis.com translate.googleapis.com

Bien que son quota mensuel ne figure pas dans la liste des ressources "Toujours sans frais" la page de résumé du niveau de service, la page des tarifs de l'API Translation indique que tous les utilisateurs bénéficient d'un nombre fixe de caractères traduits chaque mois. Aucuns frais ne devraient vous être facturés par l'API si vous restez en dessous de ce seuil. Si d'autres frais sont liés à Google Cloud, ils sont abordés à la fin de la section "Effectuer un nettoyage". .

4. Obtenir le code de l'application exemple

Clonez le code en local dans le dépôt ou dans Cloud Shell (à l'aide de la commande git clone), ou téléchargez le fichier ZIP à partir du bouton vert Code, comme illustré dans la capture d'écran suivante:

Maintenant que vous avez tout ce qu'il faut, créez une copie complète du dossier pour suivre ce tutoriel, car cela impliquera probablement de supprimer ou de modifier les fichiers. Si vous souhaitez effectuer un autre déploiement, vous pouvez recommencer en copiant l'original afin de ne pas avoir à le cloner ni à le télécharger à nouveau.

5. Visite guidée de l'application exemple

L'application exemple est une application dérivée simple de Google Traduction qui invite les utilisateurs à saisir du texte en anglais pour obtenir la traduction équivalente en espagnol. Ouvrez maintenant le fichier main.py pour voir comment cela fonctionne. En l'absence des commentaires sur l'attribution de licence, la phrase se présente en haut et en bas:

from flask import Flask, render_template, request
import google.auth
from google.cloud import translate

app = Flask(__name__)
_, PROJECT_ID = google.auth.default()
TRANSLATE = translate.TranslationServiceClient()
PARENT = 'projects/{}'.format(PROJECT_ID)
SOURCE, TARGET = ('en', 'English'), ('es', 'Spanish')

# . . . [translate() function definition] . . .

if __name__ == '__main__':
    import os
    app.run(debug=True, threaded=True, host='0.0.0.0',
            port=int(os.environ.get('PORT', 8080)))

Les importations intègrent les fonctionnalités Flask, le module google.auth et la bibliothèque cliente de l'API Cloud Translation.
Les variables globales représentent l'application Flask, l'ID du projet Cloud, le client de l'API Translation et le "chemin d'accès de l'emplacement" parent. pour les appels de l'API Translation, ainsi que les langues source et cible. Dans ce cas, il s'agit de l'anglais (en) et de l'espagnol (es), mais n'hésitez pas à remplacer ces valeurs par d'autres codes de langue compatibles avec l'API Cloud Translation.
Le grand bloc if situé en bas de l'écran est utilisé dans le tutoriel pour exécuter cette application en local. Il utilise le serveur de développement Flask pour diffuser notre application. Cette section est également disponible pour les tutoriels sur le déploiement de Cloud Run au cas où le serveur Web n'est pas intégré au conteneur. Vous êtes invité à activer le regroupement du serveur dans le conteneur. Toutefois, si vous l'oubliez, le code de l'application utilise le serveur de développement Flask. (Il ne s'agit pas d'un problème avec App Engine ou Cloud Functions, car il s'agit de plates-formes basées sur des sources, ce qui signifie que Google Cloud fournit et exécute un serveur Web par défaut.)

Enfin, au milieu de main.py se trouve le cœur de l'application, la fonction translate():

@app.route('/', methods=['GET', 'POST'])
def translate(gcf_request=None):
    """
    main handler - show form and possibly previous translation
    """

    # Flask Request object passed in for Cloud Functions
    # (use gcf_request for GCF but flask.request otherwise)
    local_request = gcf_request if gcf_request else request

    # reset all variables (GET)
    text = translated = None

    # if there is data to process (POST)
    if local_request.method == 'POST':
        text = local_request.form['text']
        data = {
            'contents': [text],
            'parent': PARENT,
            'target_language_code': TARGET[0],
        }
        # handle older call for backwards-compatibility
        try:
            rsp = TRANSLATE.translate_text(request=data)
        except TypeError:
            rsp = TRANSLATE.translate_text(**data)
        translated = rsp.translations[0].translated_text

    # create context & render template
    context = {
        'orig':  {'text': text, 'lc': SOURCE},
        'trans': {'text': translated, 'lc': TARGET},
    }
    return render_template('index.html', **context)

La fonction principale récupère l'entrée utilisateur et appelle l'API Translation pour effectuer le gros du travail. Voyons cela de plus près:

Vérifiez si les requêtes proviennent de Cloud Functions à l'aide de la variable local_request. Cloud Functions envoie son propre objet de requête Flask, tandis que tous les autres (exécutés localement ou déployés sur App Engine ou Cloud Run) obtiennent l'objet de requête directement à partir de Flask.
Réinitialisez les variables de base du formulaire. Cela concerne principalement les requêtes GET, car les requêtes POST contiennent des données qui les remplacent.
S'il s'agit d'une requête POST, récupérez le texte à traduire et créez une structure JSON représentant l'exigence de métadonnées de l'API. Appelez ensuite l'API, en revenant à une version précédente de l'API si l'utilisateur utilise une bibliothèque plus ancienne.
Dans tous les cas, mettez en forme les résultats réels (POST) ou aucune donnée (GET) dans le contexte du modèle et effectuez le rendu.

La partie visuelle de l'application se trouve dans le modèle de fichier index.html. Il affiche tous les résultats précédemment traduits (sinon, il est vide) suivis du formulaire demandant une traduction:

<!doctype html>
<html><head><title>My Google Translate 1990s</title><body>
<h2>My Google Translate (1990s edition)</h2>

{% if trans['text'] %}
    <h4>Previous translation</h4>
    <li><b>Original</b>:   {{ orig['text'] }}  (<i>{{ orig['lc'][0] }}</i>)</li>
    <li><b>Translated</b>: {{ trans['text'] }} (<i>{{ trans['lc'][0] }}</i>)</li>
{% endif %}

<h4>Enter <i>{{ orig['lc'][1] }}</i> text to translate to <i>{{ trans['lc'][1] }}</i>:</h4>
<form method="POST"><input name="text"><input type="submit"></form>
</body></html>

6. Déployer le service

Vous êtes maintenant prêt à déployer votre service de traduction sur Cloud Run en exécutant la commande suivante:

gcloud run deploy translate --source . --allow-unauthenticated --platform managed

Le résultat doit se présenter comme suit et fournir quelques invites pour les étapes suivantes:

$ gcloud run deploy translate --source . --allow-unauthenticated --platform managed
Please specify a region:
 [1] asia-east1
 [2] asia-east2
. . . (other regions) . . .
 [28] us-west4
 [29] cancel
Please enter your numeric choice:  REGION_CHOICE

To make this the default region, run `gcloud config set run/region REGION`.

Deploying from source requires an Artifact Registry repository to
store build artifacts. A repository named [cloud-run-source-deploy] in
 region [REGION] will be created.

Do you want to continue (Y/n)?

This command is equivalent to running "gcloud builds submit --pack image=[IMAGE] ." and "gcloud run deploy translate --image [IMAGE]"

Building . . . and deploying container to Cloud Run service [translate] in project [PROJECT_ID] region [REGION]
✓ Building and deploying... Done.
  ✓ Creating Container Repository...
  ✓ Uploading sources...
  ✓ Building Container... Logs are available at [https://console.cloud.google.com/cloud-build/builds/60e1b
  9bb-b991-4b4e-8d8a-HASH?project=PROJECT_NUMBER].
  ✓ Creating Revision...
  ✓ Routing traffic...
  ✓ Setting IAM Policy...
Done.
Service [translate] revision [translate-00001-xyz] has been deployed and is serving 100 percent of traffic.
Service URL: https://SVC_NAME-HASH-REG_ABBR.a.run.app

Maintenant que votre application est disponible dans le monde entier, vous devriez pouvoir y accéder via l'URL contenant votre ID de projet, comme indiqué dans le résultat du déploiement:

Traduisez quelque chose pour voir ça fonctionner !

7. Conclusion

Félicitations ! Vous avez appris à activer l'API Cloud Translation, à obtenir les identifiants nécessaires et à déployer une application Web simple sur Python 2 Cloud Run. Pour en savoir plus sur ce déploiement, consultez ce tableau du dépôt.

Effectuer un nettoyage

L'API Cloud Translation vous permet d'exécuter sans frais un nombre fixe de caractères traduits par mois. App Engine dispose également d'un quota sans frais. Il en va de même pour Cloud Functions et Cloud Run. Des frais vous seront facturés en cas de dépassement. Si vous prévoyez de passer à l'atelier de programmation suivant, vous n'avez pas besoin d'arrêter votre application.

Toutefois, si vous n'êtes pas encore prêt à passer au tutoriel suivant ou si vous craignez qu'Internet découvre l'application que vous venez de déployer, désactivez votre application App Engine, supprimez votre fonction Cloud ou désactivez votre service Cloud Run pour éviter des frais. Lorsque vous serez prêt à passer au prochain atelier de programmation, vous pourrez le réactiver. En revanche, si vous ne comptez pas utiliser cette application ou d'autres ateliers de programmation, mais que vous souhaitez tout supprimer complètement, vous pouvez arrêter votre projet.

De plus, le déploiement sur une plate-forme de calcul sans serveur Google Cloud entraîne des coûts minimes de compilation et de stockage. Cloud Build et Cloud Storage disposent de leur propre quota sans frais. Pour plus de transparence, Cloud Build crée l'image de votre application, qui est ensuite stockée dans Cloud Container Registry ou dans Artifact Registry, son successeur. Le stockage de cette image utilise une partie de ce quota, tout comme la sortie réseau lors du transfert de cette image vers le service. Cependant, vous pouvez résider dans une région qui n'offre pas ce type de version sans frais. Vous devez donc surveiller l'utilisation de votre espace de stockage afin de réduire les coûts potentiels.

8. Ressources supplémentaires

Dans les sections suivantes, vous trouverez d'autres documents à lire ainsi que des exercices recommandés pour parfaire les connaissances acquises lors de ce tutoriel.

Étude supplémentaire

Maintenant que vous disposez d'une certaine expérience de l'API Translation, vous allez maintenant effectuer quelques exercices supplémentaires pour développer vos compétences. Pour poursuivre votre parcours de formation, modifiez notre application exemple comme suit:

Suivez toutes les autres éditions de cet atelier de programmation pour une exécution en local ou un déploiement sur des plates-formes de calcul sans serveur Google Cloud (consultez le fichier README du dépôt).
Suivez ce tutoriel dans un autre langage de programmation.
Modifiez cette application pour qu'elle prenne en charge d'autres langues sources ou cibles.
Mettre à niveau cette application pour pouvoir traduire du texte dans plusieurs langues modifier le fichier de modèle pour y inclure un menu déroulant des langues cibles prises en charge.

En savoir plus

Google App Engine

Google Cloud Functions

Google Cloud Run

Packs de création Google Cloud, Container Registry, Artifact Registry

Google Cloud Translation et Google ML Kit

Autres produits/pages Google Cloud

Python et Flask

Flask

Licence

Ce tutoriel est soumis à une licence générique Creative Commons Attribution 2.0, tandis que le code source du dépôt est sous licence Apache 2.