Usar as bibliotecas de cliente do Cloud no Cloud Code

Usar as bibliotecas de cliente do Cloud no Cloud Code

Nesta página, mostramos como começar rapidamente a usar as bibliotecas de cliente do Cloud e o Cloud Code. Você configurará um novo aplicativo do Kubernetes usando um aplicativo de amostra Hello World e, em seguida, atualizará o aplicativo para usar a API Cloud Translation para traduzir a resposta para o espanhol.

Antes de começar

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative as APIs Google Kubernetes Engine and Cloud Translation.

   Ative as APIs

5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

7. Ative as APIs Google Kubernetes Engine and Cloud Translation.

   Ative as APIs

8. Instale o Git para que o Cloud Code possa executar operações do Git, como clonar uma amostra.
9. Instale o plug-in do Cloud Code, caso ainda não tenha feito isso.

Como criar um aplicativo

1. Na paleta de comandos (Cmd/Ctrl+Shift+P), execute Cloud Code: New Application, escolha Aplicativo do Kubernetes e, depois, escolha um app Hello World no idioma de sua preferência. Por exemplo, escolha Node.js: Hello World para criar um app inicial Node.js "Hello World".
2. Salve o novo aplicativo. Uma notificação confirma que seu aplicativo foi criado e uma nova janela com ele é aberta.

Configurar credenciais

1. Para abrir um terminal, clique em Terminal > Novo terminal.

2. Crie uma conta de serviço para autenticar suas solicitações de API:

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

3. Conceda à sua conta de serviço a função do usuário da API Cloud Translation:

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

4. Crie uma chave de conta de serviço:

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

5. Defina a chave como suas credenciais padrão:

   export \
    GOOGLE_APPLICATION_CREDENTIALS=key.json
   

Chamar a API Cloud Translation do seu aplicativo

Go

1. Instale as bibliotecas de cliente do Cloud da API Cloud Translation:

   1. Para abrir um terminal, clique em Terminal > Novo terminal.

   2. Execute este comando:

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

2. Crie um arquivo app.go.

3. Abra app.go e adicione o nome do pacote, as importações e a estrutura do app:

   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. Na função translateText(), adicione o código a seguir, que traduz o texto especificado. Selecione File > Save para reformatar seu código:

   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. Na função main(), chame translateText(). Os seguintes valores de parâmetros são traduzidos do inglês para o espanhol:

   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. Execute o aplicativo no terminal.

   go run app.go
   

Node.js

1. Instale as bibliotecas de cliente do Cloud da API Cloud Translation:

   1. Clique em Cloud Code e abra a seção APIs do Cloud.
   2. Expanda Cloud AI e clique em API Cloud Translation.
   3. Para instalar a biblioteca de cliente, clique em NodeJS e, em seguida, play_arrow Executar no terminal.
      

2. Crie um arquivo app.js no projeto.

3. Abra app.js e importe a biblioteca de cliente do Translation no início do arquivo:

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

4. Crie um cliente da API Translation e adicione variáveis ao ID do projeto, local e ao texto que você quer traduzir:

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

5. Adicione a seguinte função async, que detecta o idioma do texto Hello, world! e o traduz para o espanhol:

   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. No final do arquivo app.js, chame translateText():

   translateText();
   

7. Para executar o aplicativo, abra a paleta de comandos (pressione Ctrl/Cmd + Shift + P) e execute Cloud Code: executar no Kubernetes.

8. Depois que o aplicativo for implantado, abra o URL exibido no webview para ver o serviço em execução.

Python

1. Instale as bibliotecas de cliente do Cloud da API Cloud Translation:

   1. Clique em Cloud Code e abra a seção APIs do Cloud.
   2. Expanda Cloud AI e clique em API Cloud Translation.
   3. Para instalar a biblioteca de cliente, clique em Python e depois em play_arrow Executar no terminal.
      Observação: se você estiver usando um sistema operacional baseado em Linux, incluindo o Chromebook, revise o comando para usar pip3 em vez de pip. Se você estiver usando um Mac, revise o comando para usar pip3 e adicione a sinalização --user.

2. Crie um arquivo app.py no projeto.

3. Em app.py, importe a biblioteca de cliente no início do arquivo:

   from google.cloud import translate
   

4. Adicione a função translate_text. Isso inicializa um cliente para interagir com a 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. Para traduzir o texto do inglês para o espanhol e imprimir o resultado, na função translate_text, adicione a seguinte chamada às bibliotecas de cliente do Cloud da 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. No final de app.py, chame translate_text().

   translate_text()
   

7. Para executar o aplicativo, abra a paleta de comandos (pressione Ctrl/Cmd + Shift + P) e execute Cloud Code: executar no Kubernetes.

8. Depois que o aplicativo for implantado, abra o URL exibido no webview para ver o serviço em execução.

Limpar

Depois de interromper o aplicativo, todos os recursos do Kubernetes implantados durante a execução são excluídos automaticamente.

Para evitar cobranças na sua conta por outros recursos usados neste guia de início rápido, exclua o projeto ou o cluster criado se você quiser reutilizar o projeto.

Para excluir o cluster, siga estas etapas:

1. No Kubernetes Explorer, pause no nome do cluster e clique em open_in_new Abrir no console do Google Cloud.
2. Clique em Excluir e em Excluir.

Para excluir o projeto (e os recursos associados, incluindo os clusters):

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. No Console do Google Cloud, acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Receber suporte

Acesse o GitHub (em inglês) para enviar feedback e informar problemas ou faça uma pergunta no Stack Overflow.

A seguir

• Saiba mais sobre a API Cloud Translation.
• Saiba mais sobre as bibliotecas de cliente do Cloud.
• Saiba mais sobre o Cloud Code para VS Code