Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Usar as bibliotecas de cliente do Cloud no Cloud Code

Veja nesta página como dar os primeiros passos rapidamente com as bibliotecas de cliente do Cloud e o Cloud Code. Você vai 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.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

  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.

    Acessar o seletor de projetos

  6. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

  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 Git, como clonar uma amostra.
  9. Instale o plug-in do Cloud Code, se ainda não tiver feito isso.

Como criar um aplicativo

  1. Na paleta de comandos (Cmd/Ctrl+Shift+P), execute Cloud Code: novo aplicativo, escolha Aplicativo do Kubernetes e um aplicativo Hello World na linguagem que você preferir. 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 o aplicativo foi criado e uma nova janela é 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 o papel de 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
    

Chame a API Cloud Translation do seu aplicativo

Go

  1. Instale as bibliotecas de cliente de nuvem 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, as importações e o esqueleto 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 abaixo, que converte o texto especificado. Selecione File > Save para reformatar o 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 valores de parâmetro a seguir traduzem inglês para 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 de nuvem da API Cloud Translation:

    1. Clique em Cloud Code e abra a seção APIs do Cloud.
    2. Expanda a Cloud AI e clique em API Cloud Translation.
    3. Para instalar a biblioteca de cliente, clique em **NodeJS** e em Ícone &quot;Executar no terminal&quot; Executar no terminal.
  2. Crie um arquivo app.js no projeto.

  3. Abraapp.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 para seu ID do projeto, local e o 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 função async a seguir, que detecta o idioma do texto Hello, world! e traduz o texto 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, em seguida, execute o Cloud Code: executar no Kubernetes.

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

Python

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

    1. Clique em Cloud Code e abra a seção APIs do Cloud.
    2. Expanda a Cloud AI e clique em API Cloud Translation.
    3. Para instalar a biblioteca de cliente, clique em Python e em Ícone &quot;Executar no terminal&quot; Executar no terminal.
      Observação: se você estiver usando um sistema operacional baseado em Linux, incluindo Chromebook, revise o comando para usar pip3 em vez de pip. Se você estiver usando um Mac, revise o comando para usar pip3 e adicionar 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 exibir o resultado na função translate_text, adicione a seguinte chamada às bibliotecas de cliente da nuvem 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 do método app.py, chame translate_text().

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

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

Limpeza

Após 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 de outros recursos usados neste guia de início rápido, exclua o projeto ou o cluster criado se você quiser reutilizá-lo.

Para excluir o cluster, siga estas etapas:

  1. No Kubernetes Explorer, pause o nome do cluster e clique em Ícone &quot;Abrir no Console do Google Cloud&quot; Abrir no Console do Google Cloud.
  2. Clique em Excluir e em Excluir.

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

  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.

Como conseguir suporte

Para enviar feedback, informe problemas no GitHub ou faça uma pergunta no Stack Overflow.

A seguir