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

Déployez une version de base de Google Traduction application sur Python 2 App Engine

1. Présentation

Cette série d'ateliers de programmation (tutoriels pratiques à suivre à votre rythme) est destinée à 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 localement ou à la déployer sur une plate-forme de calcul sans serveur Cloud (App Engine, Cloud Functions ou Cloud Run). L'application exemple disponible dans le dépôt de ce tutoriel peut être déployée de (au moins) huit façons différentes avec seulement de légères modifications de configuration:

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 les buildpacks Cloud)

Cet atelier de programmation est consacré au déploiement de cette application sur la ou 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ée/v3)
Exécuter une application Web de base en local ou la déployer sur une plate-forme de calcul sans serveur Cloud

Prérequis

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

Enquête

Comment allez-vous utiliser ce tutoriel ?

Le lire et effectuer les exercices

Le lire uniquement

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 ?

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

Pour notre application exemple, vous allez activer l'API Cloud Translation et le service App Engine à l'aide des instructions similaires fournies ci-dessous.

Activer les API Cloud

Introduction

Quelle que soit l'API Google que vous souhaitez utiliser dans votre application, elle doit être activée. L'exemple suivant montre deux façons d'activer l'API Cloud Vision. Une fois que vous avez appris à activer une API Cloud, vous pouvez activer d'autres API, car la procédure est similaire.

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

Bien qu'il soit plus courant d'activer les API depuis la console Cloud, certains développeurs préfèrent tout faire depuis la ligne de commande. Pour ce faire, vous devez rechercher le "nom de service " d'une API. Il ressemble à une URL: SERVICE_NAME.googleapis.com. Vous les trouverez dans le tableau des produits compatibles ou vous pouvez les interroger de manière programmatique à l'aide de l'API Google Discovery.

Avec ces informations, vous pouvez activer une API à l'aide de Cloud Shell (ou de votre environnement de développement local avec l'outil de ligne de commande gcloud installé) comme suit:

gcloud services enable SERVICE_NAME.googleapis.com

Par exemple, cette commande 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 en 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: Depuis Cloud Console

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

Si vous souhaitez activer l'API Cloud Vision, commencez à saisir "vision" dans la barre de recherche. Tout ce qui correspond à ce que vous avez saisi jusqu'à présent s'affiche:

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

Coût

Bien que de nombreuses API Google puissent être utilisées sans frais, l'utilisation des produits et API Google Cloud n'est pas sans frais. Lorsque vous activez des API Cloud, vous pouvez être invité à renseigner un compte de facturation actif. Il est toutefois important de noter que certains produits Google Cloud disposent d'un niveau"Always Free" (quotidien/mensuel) que vous devez dépasser pour que la facturation démarre. Sinon, votre carte de crédit (ou le mode de facturation spécifié) ne sera pas débitée.

Les utilisateurs doivent consulter les informations tarifaires de toute API avant de l'activer, en particulier pour savoir si elle propose un niveau sans frais et, le cas échéant, de quoi il s'agit. Si vous activez l'API Cloud Vision, consultez la page de ses informations tarifaires. Cloud Vision dispose d'un quota sans frais. Tant que votre utilisation agrégée ne dépasse pas les limites (pour chaque mois), aucuns frais ne vous seront facturés.

Les tarifs et les niveaux 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 processeur virtuel, par espace de stockage consommé, par utilisation de la mémoire ou par utilisation. Consultez les informations sur l'échelon sans frais ci-dessus.
Google Maps : propose une suite d'API et offre aux utilisateurs un crédit mensuel total de 200 USD.
API Google Workspace (anciennement G Suite) : leur utilisation est sans frais (dans certaines limites) et couverte par les frais d'abonnement mensuels Workspace. Par conséquent, il n'y a pas de facturation directe pour l'utilisation des API Gmail, Google Drive, Agenda, Docs, Sheets et Slides.

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 activer les API Google en général, accédez au gestionnaire d'API et activez à la fois l'API Cloud Translation et le service App Engine (si vous ne l'avez pas déjà fait). La première, car notre application l'utilisera, et la seconde, car vous déployez une application App Engine. Si vous préférez le faire à partir de la ligne de commande, exécutez plutôt cette commande:

gcloud services enable appengine.googleapis.com translate.googleapis.com

Bien que son quota mensuel ne soit pas indiqué sur la page récapitulative du niveau "Toujours sans frais ", la page des tarifs de l'API Translation indique que tous les utilisateurs bénéficient d'un nombre fixe de caractères traduits par mois. Vous ne devriez pas être facturé par l'API si vous restez en dessous de ce seuil. Si d'autres frais liés à Google Cloud sont facturés, ils seront indiqués à la fin de la section "Nettoyage".

4. Obtenir le code de l'exemple d'application

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

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

5. Visite de l'application exemple

L'application exemple est un dérivé simple de Google Traduction qui invite les utilisateurs à saisir du texte en anglais et à recevoir la traduction équivalente de ce texte en espagnol. Ouvrez maintenant le fichier main.py pour voir comment il fonctionne. En omettant les lignes commentées sur la licence, le fichier se présente comme suit 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 apportent la fonctionnalité 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 de projet Cloud, le client de l'API Translation, le "chemin d'accès" 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 vous pouvez remplacer ces valeurs par d'autres codes de langue compatibles avec l'API Cloud Translation.
Le grand bloc if en bas 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 présente dans les tutoriels de déploiement Cloud Run au cas où le serveur Web ne serait pas groupé dans le conteneur. Vous êtes invité à activer le regroupement du serveur dans le conteneur. Toutefois, si vous ne le faites pas, le code de l'application utilisera le serveur de développement Flask. (Ce n'est pas un problème avec App Engine ni Cloud Functions, car ce sont des 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 la saisie de l'utilisateur et appelle l'API Translation pour effectuer les tâches lourdes. Décomposons-le:

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 les exigences 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.
Quoi qu'il en soit, mettez en forme les résultats réels (POST) ou aucune donnée (GET) dans le contexte du modèle et affichez-les.

La partie visuelle de l'application se trouve dans le fichier de modèle index.html. Il affiche les résultats déjà traduits (vides dans le cas contraire), suivis du formulaire demandant à traduire un élément:

<!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. Installer des packages/dépendances locaux (dans la bibliothèque)

Comme indiqué précédemment, l'application exemple utilise le microframework Web Flask et la bibliothèque cliente de l'API Google Cloud Translation pour Python. Installez et mettez à jour pip ainsi que cette paire de packages à l'aide de la commande pip (ou pip3) suivante:

pip install -t lib -r requirements.txt

Une fois le commentaire ci-dessus exécuté, le résultat de l'installation s'affiche. Il peut ressembler à ceci:

$ pip install -t lib -r requirements.txt
DEPRECATION: Python 2.7 reached the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 is no longer maintained. pip 21.0 will drop support for Python 2.7 in January 2021. More details about Python 2 support in pip can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support pip 21.0 will remove support for this functionality.
Collecting flask>=1.1.2
  Using cached Flask-1.1.4-py2.py3-none-any.whl (94 kB)
Collecting google-cloud-translate>=2.0.1
  Using cached google_cloud_translate-2.0.2-py2.py3-none-any.whl (91 kB)
Collecting click<8.0,>=5.1
  Using cached click-7.1.2-py2.py3-none-any.whl (82 kB)
Collecting Jinja2<3.0,>=2.10.1
  Using cached Jinja2-2.11.3-py2.py3-none-any.whl (125 kB)
Collecting Werkzeug<2.0,>=0.15
  Using cached Werkzeug-1.0.1-py2.py3-none-any.whl (298 kB)
Collecting itsdangerous<2.0,>=0.24
  Using cached itsdangerous-1.1.0-py2.py3-none-any.whl (16 kB)
Collecting google-api-core[grpc]<2.0.0dev,>=1.15.0
  Downloading google_api_core-1.29.0-py2.py3-none-any.whl (93 kB)
     |████████████████████████████████| 93 kB 2.1 MB/s
Collecting google-cloud-core<2.0dev,>=1.1.0
  Using cached google_cloud_core-1.6.0-py2.py3-none-any.whl (28 kB)
Collecting MarkupSafe>=0.23
  Using cached MarkupSafe-1.1.1-cp27-cp27m-macosx_10_6_intel.whl (17 kB)
Collecting protobuf>=3.12.0
  Downloading protobuf-3.17.2-cp27-cp27m-macosx_10_9_x86_64.whl (958 kB)
     |████████████████████████████████| 958 kB 21.6 MB/s
Collecting futures>=3.2.0; python_version < "3.2"
  Using cached futures-3.3.0-py2-none-any.whl (16 kB)
Collecting six>=1.13.0
  Using cached six-1.16.0-py2.py3-none-any.whl (11 kB)
Collecting packaging>=14.3
  Using cached packaging-20.9-py2.py3-none-any.whl (40 kB)
Collecting googleapis-common-protos<2.0dev,>=1.6.0
  Using cached googleapis_common_protos-1.52.0-py2.py3-none-any.whl (100 kB)
Collecting requests<3.0.0dev,>=2.18.0
  Using cached requests-2.25.1-py2.py3-none-any.whl (61 kB)
Collecting google-auth<2.0dev,>=1.25.0
  Using cached google_auth-1.30.1-py2.py3-none-any.whl (146 kB)
Collecting pytz
  Using cached pytz-2021.1-py2.py3-none-any.whl (510 kB)
Collecting setuptools>=40.3.0
  Using cached setuptools-44.1.1-py2.py3-none-any.whl (583 kB)
Collecting grpcio<2.0dev,>=1.29.0; extra == "grpc"
  Using cached grpcio-1.38.0-cp27-cp27m-macosx_10_10_x86_64.whl (3.8 MB)
Collecting pyparsing>=2.0.2
  Using cached pyparsing-2.4.7-py2.py3-none-any.whl (67 kB)
Collecting chardet<5,>=3.0.2
  Using cached chardet-4.0.0-py2.py3-none-any.whl (178 kB)
Collecting urllib3<1.27,>=1.21.1
  Using cached urllib3-1.26.5-py2.py3-none-any.whl (138 kB)
Collecting idna<3,>=2.5
  Using cached idna-2.10-py2.py3-none-any.whl (58 kB)
Collecting certifi>=2017.4.17
  Downloading certifi-2021.5.30-py2.py3-none-any.whl (145 kB)
     |████████████████████████████████| 145 kB 61.1 MB/s
Collecting pyasn1-modules>=0.2.1
  Using cached pyasn1_modules-0.2.8-py2.py3-none-any.whl (155 kB)
Collecting rsa<4.6; python_version < "3.6"
  Using cached rsa-4.5-py2.py3-none-any.whl (36 kB)
Collecting cachetools<5.0,>=2.0.0
  Using cached cachetools-3.1.1-py2.py3-none-any.whl (11 kB)
Collecting enum34>=1.0.4; python_version < "3.4"
  Using cached enum34-1.1.10-py2-none-any.whl (11 kB)
Collecting pyasn1<0.5.0,>=0.4.6
  Using cached pyasn1-0.4.8-py2.py3-none-any.whl (77 kB)
Installing collected packages: click, MarkupSafe, Jinja2, Werkzeug, itsdangerous, flask, six, protobuf, futures, pyparsing, packaging, googleapis-common-protos, chardet, urllib3, idna, certifi, requests, pyasn1, pyasn1-modules, rsa, cachetools, setuptools, google-auth, pytz, enum34, grpcio, google-api-core, google-cloud-core, google-cloud-translate
ERROR: pip's legacy dependency resolver does not consider dependency conflicts when selecting packages. This behaviour is the source of the following dependency conflicts.
matplotlib 1.3.1 requires nose, which is not installed.
matplotlib 1.3.1 requires tornado, which is not installed.
Successfully installed Jinja2-2.11.3 MarkupSafe-1.1.1 Werkzeug-1.0.1 cachetools-3.1.1 certifi-2021.5.30 chardet-4.0.0 click-7.1.2 enum34-1.1.10 flask-1.1.4 futures-3.3.0 google-api-core-1.29.0 google-auth-1.30.1 google-cloud-core-1.6.0 google-cloud-translate-2.0.2 googleapis-common-protos-1.52.0 grpcio-1.38.0 idna-2.10 itsdangerous-1.1.0 packaging-20.9 protobuf-3.17.2 pyasn1-0.4.8 pyasn1-modules-0.2.8 pyparsing-2.4.7 pytz-2021.1 requests-2.25.1 rsa-4.5 setuptools-44.1.1 six-1.16.0 urllib3-1.26.5

7. Déployer le service

Pour déployer votre service de traduction sur App Engine Python 2, exécutez la commande suivante:

gcloud app deploy

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

$ gcloud app deploy
Services to deploy:

descriptor:      [/private/tmp/nebulous-serverless-python/app.yaml]
source:          [/private/tmp/nebulous-serverless-python]
target project:  [PROJECT_ID]
target service:  [default]
target version:  [20210422t161025]
target url:      [https://PROJECT_ID.appspot.com]


Do you want to continue (Y/n)?

Beginning deployment of service [default]...
╔════════════════════════════════════════════════════════════╗
╠═ Uploading 1290 files to Google Cloud Storage                       ═╣
╚════════════════════════════════════════════════════════════╝
File upload done.
Updating service [default]...done.
Setting traffic split for service [default]...done.
Deployed service [default] to [https://PROJECT_ID.appspot.com]

You can stream logs from the command line by running:
  $ gcloud app logs tail -s default

To view your application in the web browser run:
  $ gcloud app browse

Maintenant que votre application est disponible dans le monde entier, vous devriez pouvoir y accéder à l'URL (contenant votre ID de projet) fournie dans la sortie de votre déploiement:

Traduisez un texte pour voir comment ça marche.

8. Conclusion

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

Effectuer un nettoyage

L'API Cloud Translation vous permet de traduire un nombre fixe de caractères par mois sans frais. App Engine dispose également d'un quota sans frais, tout comme Cloud Functions et Cloud Run. Des frais vous seront facturés si vous dépassez l'un de ces deux seuils. 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 que l'application que vous venez de déployer soit découverte sur Internet, désactivez votre application App Engine, supprimez votre fonction Cloud ou désactivez votre service Cloud Run pour éviter de payer des frais. Lorsque vous serez prêt à passer au prochain atelier de programmation, vous pourrez le réactiver. En revanche, si vous ne souhaitez pas poursuivre cette application ou d'autres ateliers de programmation et 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 de compilation et de stockage mineurs. Cloud Build dispose de son propre quota sans frais, tout comme Cloud Storage. Pour plus de transparence, Cloud Build crée l'image de votre application, qui est ensuite stockée dans Cloud Container Registry ou 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. Toutefois, il est possible que vous ne résidiez pas dans une région où ce niveau d'utilisation sans frais est disponible. Veillez donc à surveiller votre utilisation de l'espace de stockage pour minimiser les coûts potentiels.

9. Ressources supplémentaires

Dans les sections suivantes, vous trouverez des ressources de lecture supplémentaires ainsi que des exercices recommandés pour approfondir les connaissances acquises dans ce tutoriel.

Étude supplémentaire

Maintenant que vous avez acquis une certaine expérience avec l'API Translation, effectuons quelques exercices supplémentaires pour développer vos compétences. Pour poursuivre votre parcours d'apprentissage, modifiez notre application exemple afin de:

Terminez toutes les autres éditions de cet atelier de programmation pour l'exécuter en local ou le déployer sur les plates-formes de calcul sans serveur Google Cloud (voir le README du dépôt).
Suivez ce tutoriel dans un autre langage de programmation.
Modifiez cette application pour qu'elle prenne en charge différentes langues source ou cibles.
Mettez à niveau cette application pour pouvoir traduire du texte dans plusieurs langues. Modifiez le fichier de modèle pour afficher un menu déroulant des langues cibles compatibles.

En savoir plus

Google App Engine

Google Cloud Functions

Google Cloud Run

Google Cloud Buildpacks, Container Registry, Artifact Registry

Google Cloud Translation et Google ML Kit

Autres produits/pages Google Cloud

Python et Flask

Flask

Licence

Ce tutoriel est publié sous une licence Creative Commons Attribution 2.0 Generic, tandis que le code source du dépôt est sous licence Apache 2.