Utiliser les bibliothèques clientes Cloud dans Cloud Code

Utiliser les bibliothèques clientes Cloud dans Cloud Code

Cette page vous explique comment démarrer rapidement avec les bibliothèques clientes Cloud et Cloud Code. Vous allez configurer une application Kubernetes à l'aide d'un exemple d'application Hello World, puis la mettre à jour pour qu'elle utilise l'API Cloud Translation afin de traduire la réponse en espagnol.

Avant de commencer

Connectez-vous à votre Google Cloud compte. Si vous ne connaissez pas Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $de crédits sans frais 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine and Cloud Translation APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine and Cloud Translation APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Installez Git pour que Cloud Code puisse effectuer des opérations Git, comme le clonage d'un exemple.
2. Installez le plug-in Cloud Code si ce n'est pas déjà fait.

Créer une application

1. Dans la palette de commandes (Cmd/Ctrl+Shift+P), exécutez Cloud Code: New Application (Cloud Code : Nouvelle application), choisissez Kubernetes Application (Application Kubernetes), puis sélectionnez une application Hello World dans la langue de votre choix. Par exemple, choisissez Node.js: Hello World pour créer une application Hello World Node.js de démarrage.
2. Enregistrez la nouvelle application. Une notification confirme que votre application a été créée et une nouvelle fenêtre s'ouvre avec votre application.

Configurer des identifiants

Remarque : Les clés de compte de service constituent un risque pour la sécurité si elles ne sont pas gérées correctement. Dans la mesure du possible, vous devez choisir une alternative plus sécurisée aux clés de compte de service. Si vous devez vous authentifier avec une clé de compte de service, vous êtes responsable de la sécurité de la clé privée et des autres opérations décrites dans la section Bonnes pratiques pour la gestion des clés de compte de service. Si vous ne parvenez pas à créer une clé de compte de service, il est possible que la création de clé de compte de service soit désactivée pour votre organisation. Pour en savoir plus, consultez la page Gérer les ressources d'organisation sécurisées par défaut.

Si vous avez obtenu la clé de compte de service auprès d'une source externe, vous devez la valider avant de l'utiliser. Pour en savoir plus, consultez la section Exigences de sécurité pour les identifiants provenant de sources externes.

1. Pour ouvrir un terminal, cliquez sur Terminal > New Terminal (Terminal > Nouveau terminal).

2. Créez un compte de service pour authentifier vos requêtes API :

   gcloud iam service-accounts create \
   translation-quickstart \
   --project PROJECT_ID

3. Attribuez le rôle d'utilisateur de l'API Cloud Translation à votre compte de service :

   gcloud projects \
   add-iam-policy-binding \
   PROJECT_ID \
   --member='serviceAccount:translation-quickstart@PROJECT_ID.iam.gserviceaccount.com' \
   --role='roles/cloudtranslate.user'

4. Créez une clé de compte de service :

   gcloud iam service-accounts keys \
   create key.json --iam-account \
   translation-quickstart@PROJECT_ID.iam.gserviceaccount.com

5. Définissez la clé comme identifiant par défaut :

   export \
    GOOGLE_APPLICATION_CREDENTIALS=key.json
   

Appeler l'API Cloud Translation à partir de votre application

Go

1. Installez les bibliothèques clientes Cloud de l'API Cloud Translation :

   1. Pour ouvrir un terminal, cliquez sur Terminal > New Terminal (Terminal > Nouveau terminal).

   2. Exécutez la commande suivante :

      go get cloud.google.com/go/translate/apiv3
      

2. Créez un fichier app.go.

3. Ouvrez app.go et ajoutez le nom du package, les importations et le squelette de l'application :

   package main
   
   import (
     "context"
     "fmt"
   
     translate "cloud.google.com/go/translate/apiv3"
     translatepb "google.golang.org/genproto/googleapis/cloud/translate/v3"
   )
   
   func translateText(w io.Writer, projectID string, sourceLang string, targetLang string, text string) error {
   
   }
   
   func main() {
   
   }
   

4. Dans votre fonction translateText(), ajoutez le code suivant, qui traduit le texte spécifié. Sélectionnez File > Save (Fichier > Enregistrer) pour reformater votre code :

   ctx := context.Background()
   client, err := translate.NewTranslationClient(ctx)
   if err != nil {
     return fmt.Errorf("NewTranslationClient: %v", err)
   }
   defer client.Close()
   
   req := &translatepb.TranslateTextRequest{
     Parent:             fmt.Sprintf("projects/%s/locations/global", projectID),
     SourceLanguageCode: sourceLang,
     TargetLanguageCode: targetLang,
     MimeType:           "text/plain", // Mime types: "text/plain", "text/html"
     Contents:           []string{text},
   }
   
   resp, err := client.TranslateText(ctx, req)
   if err != nil {
     return fmt.Errorf("TranslateText: %v", err)
   }
   
   // Display the translation for each input text provided
   for _, translation := range resp.GetTranslations() {
     fmt.Fprintf(w, "Translated text: %v\n", translation.GetTranslatedText())
   }
   
   return nil
   

5. Dans votre fonction main(), appelez translateText(). Les valeurs de paramètres suivantes permettent une traduction de l'anglais vers l'espagnol :

   projectID := "<var>PROJECT_ID</var>"
   sourceLang := "en-US"
   targetLang := "es"
   text := "Text to translate"
   
   err := translateText(os.Stdout, projectID, sourceLang, targetLang, text)
   if err != nil {
     fmt.Print(err)
   }
   

6. À partir du terminal, exécutez votre application.

   go run app.go
   

Java

1. Ouvrez pom.xml et ajoutez l'extrait de code suivant à la section dependencies :

   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>4.11</version>
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-translate</artifactId>
     </dependency>
   </dependencies>
   

2. Ensuite, dans le fichier pom.xml, ajoutez l'extrait de code suivant à la section dependencyManagement :

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>com.google.cloud</groupId>
         <artifactId>libraries-bom</artifactId>
         <version>26.39.0</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>
   

   Assurez-vous d'utiliser la dernière version de Google Cloud Bibliothèques compatibles. Pour obtenir la liste des versions, consultez la section Google Cloud Bibliothèques compatibles.

3. Lorsque vous êtes invité à synchroniser la configuration/le classpath Java, cliquez sur Toujours.

4. Créez un fichier nommé app.java.

5. Dansapp.java, incluez les importations suivantes après la définition du package :

   import com.google.cloud.translate.v3.LocationName;
   import com.google.cloud.translate.v3.TranslateTextRequest;
   import com.google.cloud.translate.v3.TranslateTextResponse;
   import com.google.cloud.translate.v3.Translation;
   import com.google.cloud.translate.v3.TranslationServiceClient;
   import java.io.IOException;
   

6. Ajoutez la méthode translateText() à votre classe App. Cette méthode définit et transmet des variables à une méthode translateText() surchargée. Les valeurs suivantes permettent une traduction de l'anglais vers l'espagnol :

   public static void translateText() throws IOException {
     String projectId = "<walkthrough-project-id/>";
     String targetLanguage = "es";
     String text = "Hello world!";
     translateText(projectId, targetLanguage, text);
   }
   

7. Ajoutez une méthode translateText() surchargée. Cette méthode prend du texte et le traduit dans la langue cible.

   public static void translateText(String projectId, String targetLanguage, String text)
     throws IOException {
   
     try (TranslationServiceClient client = TranslationServiceClient.create()) {
       LocationName parent = LocationName.of(projectId, "global");
   
       TranslateTextRequest request =
         TranslateTextRequest.newBuilder()
         .setParent(parent.toString())
         .setMimeType("text/plain")
         .setTargetLanguageCode(targetLanguage)
         .addContents(text)
         .build();
   
       TranslateTextResponse response = client.translateText(request);
   
       // Display the translation for each input text provided
       for (Translation translation : response.getTranslationsList()) {
         System.out.printf("Translated text: %s\n", translation.getTranslatedText());
       }
     }
   }
   

8. Remplacez l'instruction print dans votre main par un appel à translateText() :

   try {
     translateText();
   }
   catch (IOException e) {
     e.printStackTrace();
   }
   

Node.js

1. Installez les bibliothèques clientes Cloud de l'API Cloud Translation :

   1. Cliquez sur Cloud Code, puis développez l'explorateur Cloud APIs.
   2. Développez Cloud AI , puis cliquez sur Cloud Translation API.
   3. Pour installer la bibliothèque cliente, cliquez sur NodeJS , puis sur play_arrow Run in terminal (Exécuter dans le terminal).
      

2. Créez un fichier app.js dans votre projet.

3. Ouvrez le fichier app.js et importez la bibliothèque cliente Translation au début du fichier :

   const {TranslationServiceClient} = require('@google-cloud/translate');
   

4. Créez un client de l'API Translation et ajoutez des variables pour l'ID de projet, l'emplacement et le texte que vous souhaitez traduire :

   // Instantiates a client
   const translationClient = new TranslationServiceClient();
   
   const projectId = 'PROJECT_ID';
   const location = 'global';
   const text = 'Hello, world!';
   

5. Ajoutez la fonction async suivante, qui détecte la langue de votre texte Hello, world! et le traduit en espagnol :

   async function translateText() {
       // Construct request
       const request = {
           parent: `projects/PROJECT_ID/locations/LOCATION`,
           contents: [text],
           mimeType: 'text/plain', // mime types: text/plain, text/html
           sourceLanguageCode: 'en',
           targetLanguageCode: 'es',
       };
   
       // Run request
       const [response] = await translationClient.translateText(request);
   
       for (const translation of response.translations) {
           console.log(`Translation: ${translation.translatedText}`);
       }
   }
   

6. À la fin de votre fichier app.js, appelez translateText() :

   translateText();
   

7. Pour exécuter votre application, ouvrez la palette de commandes (appuyez sur Ctrl/Cmd + Shift + P), puis exécutez Cloud Code: Run on Kubernetes (Cloud Code : Exécuter sur Kubernetes).

8. Une fois le déploiement terminé, affichez votre service en cours d'exécution en ouvrant l'URL affichée dans la vue Web.

Python

1. Installez les bibliothèques clientes Cloud de l'API Cloud Translation :

   1. Cliquez sur Cloud Code, puis développez l'explorateur Cloud APIs.
   2. Développez Cloud AI , puis cliquez sur Cloud Translation API.
   3. Pour installer la bibliothèque cliente, cliquez sur Python , puis sur play_arrow Run in terminal (Exécuter dans le terminal).
      Remarque : Si vous utilisez un système d'exploitation basé sur Linux, y compris un Chromebook, modifiez la commande pour utiliser pip3 au lieu de pip. Si vous utilisez un Mac, modifiez la commande pour utiliser pip3 et ajoutez l'indicateur --user

2. Créez un fichier app.py dans votre projet.

3. Dans app.py, importez la bibliothèque cliente au début du fichier :

   from google.cloud import translate
   

4. Ajoutez la fonction translate_text. Cela crée un client pour interagir avec l'API Cloud Translation.

   def translate_text(text="Hello, world!", project_id="PROJECT_ID"):
   
   client = translate.TranslationServiceClient()
   location = "global"
   parent = "projects/PROJECT_ID/locations/LOCATION"
   

5. Pour traduire du texte de l'anglais vers l'espagnol et afficher le résultat, dans votre fonction translate_text, ajoutez l'appel suivant aux bibliothèques clientes Cloud de l'API Cloud Translation :

      response = client.translate_text(
       request={
           "parent": parent,
           "contents": [text],
           "mime_type": "text/plain",
           "source_language_code": "en-US",
           "target_language_code": "es",
       }
   )
   
   for translation in response.translations:
       print("Translated text: {}".format(translation.translated_text))
   

6. À la fin de app.py, appelez translate_text().

   translate_text()

7. Pour exécuter votre application, ouvrez la palette de commandes (appuyez sur Ctrl/Cmd + Shift + P), puis exécutez Cloud Code: Run on Kubernetes (Cloud Code : Exécuter sur Kubernetes).

8. Une fois le déploiement terminé, affichez votre service en cours d'exécution en ouvrant l'URL affichée dans la vue Web.

Effectuer un nettoyage

Une fois votre application arrêtée, toutes les ressources Kubernetes déployées pendant l'exécution sont automatiquement supprimées.

Pour éviter que les autres ressources utilisées dans ce démarrage rapide soient facturées sur votre compte, veillez à supprimer le projet ou le cluster que vous avez créé si vous souhaitez réutiliser le projet.

Pour supprimer le cluster :

1. Dans l' explorateur Kubernetes, pointez sur le nom de votre cluster, puis cliquez sur open_in_new Open in Google Cloud console (Ouvrir dans la console).
2. Cliquez sur Delete (Supprimer) et de nouveau sur Delete.

Pour supprimer votre projet (et les ressources associées, y compris les clusters) :

Attention : La suppression d'un projet a les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. Dans la Google Cloud console, accédez à la page Gérer les ressources.

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez Arrêter pour supprimer le projet.

Obtenir de l'aide

Pour envoyer vos commentaires, signalez tout problème sur GitHub, ou posez une question sur Stack Overflow.

Étape suivante

• En savoir plus sur l'API Cloud Translation
• En savoir plus sur les bibliothèques clientes Cloud
• En savoir plus sur Cloud Code pour VS Code