Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Utiliser les bibliothèques clientes Cloud dans Cloud Code

Cette page vous aide à faire vos premiers pas avec les bibliothèques clientes Cloud et Cloud Code. Vous allez configurer une nouvelle application Kubernetes à l'aide d'un exemple d'application Hello World, puis mettre à jour l'application pour utiliser l'API Cloud Translation afin de traduire la réponse en espagnol.

Avant de commencer

  1. 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.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

  4. Activer les API Google Kubernetes Engine and Cloud Translation.

    Activer les API

  5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  6. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

  7. Activer les API Google Kubernetes Engine and Cloud Translation.

    Activer les API

  8. Installez Git pour que Cloud Code puisse effectuer des opérations Git, comme cloner un exemple.
  9. Si ce n'est pas déjà fait, installez le plug-in Cloud Code.

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 choisissez une application Hello World dans le langage de votre choix. Par exemple, sélectionnez 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 qu'une nouvelle fenêtre s'ouvre.

Configurer les identifiants

  1. Pour ouvrir un terminal, cliquez sur 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 depuis votre application

Accéder

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

    1. Pour ouvrir un terminal, cliquez sur 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 le 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ètre suivantes traduisent 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. Depuis le terminal, exécutez votre application.

    go run app.go
    

Node.js

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

    1. Cliquez sur Cloud Code, puis développez la section Cloud APIs (API Cloud).
    2. Développez Cloud AI, puis cliquez sur API Cloud Translation.
    3. Pour installer la bibliothèque cliente, cliquez sur **NodeJS**, puis sur Icône Exécuter dans le terminalRun in terminal (Exécuter dans le terminal).
  2. Créez un fichier app.js dans votre projet.

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

    const {TranslationServiceClient} = require('@google-cloud/translate');
    
  4. Créez un client 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 la commande Cloud Code: Run on Kubernetes (Exécuter Cloud Code : Exécuter sur Kubernetes).

  8. Une fois l'application déployée, affichez le 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 la section Cloud APIs (API Cloud).
    2. Développez Cloud AI, puis cliquez sur API Cloud Translation.
    3. Pour installer la bibliothèque cliente, cliquez sur Python, puis sur Icône Exécuter dans le terminal Exécuter dans le terminal.
      Remarque: Si vous utilisez un système d'exploitation Linux, y compris un Chromebook, modifiez la commande pour qu'elle utilise pip3 au lieu de pip. Si vous utilisez un Mac, modifiez la commande pour qu'elle utilise pip3 et ajoutez l'option --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. Cette action initialise un client pour qu'il interagisse 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 imprimer le résultat, ajoutez la fonction suivante aux bibliothèques clientes Cloud de l'API Cloud Translation dans la fonction translate_text:

       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 la commande Cloud Code: Run on Kubernetes (Exécuter Cloud Code : Exécuter sur Kubernetes).

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

Nettoyer

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

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

Pour supprimer le cluster :

  1. Dans l'explorateur Kubernetes, mettez en pause le nom de votre cluster, puis cliquez sur Icône Ouvrir dans Google Cloud ConsoleOuvrir dans Google Cloud Console.
  2. Cliquez sur Delete (Supprimer), puis sur Delete.

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

  1. Dans la console Google Cloud, 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 sur Arrêter pour supprimer le projet.

Obtenir de l'aide

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

Étapes suivantes