Gerenciar APIs do Cloud e bibliotecas de cliente do Cloud no Cloud Code para Cloud Shell

Para acessar os produtos e serviços do Google Cloud de maneira programática, use as APIs do Cloud. Essas APIs expõem uma interface REST REST simples. A maneira recomendada de acessar as APIs do Cloud é usar as bibliotecas de cliente do Cloud.

O Cloud Code facilita a adição de bibliotecas de cliente do Cloud às APIs e à linguagem do Cloud que você está usando no projeto. Na mesma visualização, é possível pesquisar amostras para cada API e incorporar amostras ao aplicativo com facilidade.

Como procurar APIs do Cloud

Para conferir todas as APIs do Google Cloud disponíveis:

  1. Clique em Cloud Code e expanda as APIs do Cloud. nesta seção.

    A visualização das APIs do Cloud agrupa as APIs do Cloud por categoria.

  2. Para ver os detalhes de uma API, clique no nome dela. Detalhes como o nome do serviço, status, instruções de instalação para bibliotecas de cliente, documentação e exemplos de código serão exibidos.

Como ativar APIs do Cloud

Para ativar as APIs do Cloud em um projeto usando a página de detalhes da API, siga estas etapas:

  1. Na página de detalhes da API do Cloud, escolha o projeto para ativar a API.
  2. Clique em Ativar API. Depois que a API for ativada, uma mensagem será exibida para confirmar a alteração.

Como adicionar bibliotecas de cliente em seu projeto

Além de explorar e ativar as APIs do Cloud usando o Cloud Code, também é possível adicionar uma biblioteca de cliente de linguagem específica em seu projeto.

Para instalar uma biblioteca de cliente, siga as instruções na página de detalhes da API da sua linguagem.

Como usar amostras de API

Você pode pesquisar e usar exemplos de código para cada API no navegador de APIs.

  1. Clique em Cloud Code e expanda as APIs do Cloud. nesta seção.

  2. Para abrir a visualização de detalhes, clique no nome de uma API.

  3. Para conferir exemplos de código para a API, clique em Exemplos de código.

  4. Para filtrar a lista de amostras, digite o texto que você quer pesquisar ou escolha uma na lista Linguagem.

  5. Para ver uma amostra, clique no nome dela. Também há opções para copie o exemplo para a área de transferência ou veja o exemplo no GitHub.

Como configurar a autenticação

Depois de ativar as APIs obrigatórias e adicionar o cliente necessário você precisa configurar seu aplicativo para que ele funcione autenticados. A configuração depende do seu tipo de desenvolvimento e da plataforma em que você está executando.

Depois de concluir as etapas de autenticação, seu aplicativo pode ser autenticado e está pronto para ser implantado.

Desenvolvimento local

A instância de VM do Cloud Shell usa a conta de serviço padrão do Compute Engine (que é a conta de serviço usada pelo Google Kubernetes Engine por padrão) como conta de serviço padrão. Isso significa que, ao desenvolver com Cloud Code no Cloud Shell, não é preciso configurar nenhuma configuração adicional ao trabalhar com bibliotecas de cliente. Seu aplicativo é autenticados e prontos para execução local.

Desenvolvimento local com APIs que exigem uma conta de serviço

Algumas APIs, como a API Cloud Translation, exigem uma conta de serviço com as permissões apropriadas para autenticar suas solicitações. Para mais informações, consulte Como criar e gerenciar contas de serviço.

  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 \
    SERVICE_ACCOUNT_ID \
    --project PROJECT_ID

    Substitua os seguintes valores:

    • SERVICE_ACCOUNT_ID: o ID da conta de serviço
    • PROJECT_ID: o ID do projeto;

    Para encontrar esses IDs, no Google Cloud, clique no Menu de navegação no canto superior esquerdo da tela, mantenha o ponteiro do mouse sobre IAM e administrador e clique em Contas de serviço.

    A coluna E-mail mostra o nome SERVICE_ACCOUNT_ID e PROJECT_ID para cada uma das contas de serviço no formato:

    SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com

    Por exemplo: um endereço de e-mail de uma conta de serviço de my-service-account@my-project.iam.gserviceaccount.com tem o seguinte valores:

    • SERVICE_ACCOUNT_ID: my-service-account
    • PROJECT_ID: my-project
  3. Conceda o papel apropriado à sua conta de serviço. O exemplo a seguir concede o papel de usuário da API Cloud Translation. Para determinar o papel a conceder acesso, consulte a documentação da API do Cloud que você está usando.

    gcloud projects \
    add-iam-policy-binding \
    PROJECT_ID \
    --member='serviceAccount:SERVICE_ACCOUNT_ID@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 \
    SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com
  5. Defina a chave como suas credenciais padrão:

    export \
     GOOGLE_APPLICATION_CREDENTIALS=key.json
    
  6. Opcional: para permitir que os usuários representar a conta de serviço, executar gcloud iam service-accounts add-iam-policy-binding comando para conceder a um usuário o papel de usuário da conta de serviço (roles/iam.serviceAccountUser) na conta de serviço:

    gcloud iam service-accounts add-iam-policy-binding \
        SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com \
        --member="user:USER_EMAIL" \
        --role="roles/iam.serviceAccountUser"

    Substitua os seguintes valores:

    • USER_EMAIL: o endereço de e-mail do usuário

Desenvolvimento remoto

GKE;

Dependendo do escopo do seu projeto, é possível escolher como autenticar os serviços do Google Cloud no GKE:

  • (Somente desenvolvimento)
    1. Crie um cluster do GKE com as seguintes configurações:
      • Verifique se você está usando a conta de serviço que o GKE usa por padrão e a conta de serviço padrão do Compute Engine. Confira também se os Escopos de acesso estão definidos como Permitir acesso total a todas as APIs do Cloud, ambas as configurações acessíveis na seção Pools de nós > Segurança.Como a conta de serviço do Compute Engine é compartilhada por todas as cargas de trabalho implantadas no nó, esse método provisiona um excesso de permissões e só deve ser usado para desenvolvimento.
      • Verifique se a Identidade da carga de trabalho não está ativada no cluster (na seção Cluster > Segurança).
    2. Atribua os papéis necessários à conta de serviço:
  • (Recomendado para produção)
    1. Configure seu cluster e aplicativo do GKE com a Identidade da carga de trabalho para autenticar os serviços do Google Cloud no GKE. Isso associa sua conta de serviço do Kubernetes à sua conta de serviço do Google.
    2. Configure a implantação do Kubernetes para referenciar a conta de serviço do Kubernetes definindo o campo .spec.serviceAccountName no arquivo YAML de implantação do Kubernetes. Se você estiver trabalhando em um aplicativo criado a partir de um modelo do Cloud Code, esse arquivo estará localizado na pasta kubernetes-manifests.
    3. Se o serviço do Google Cloud que você está tentando acessar exigir papéis adicionais, conceda-os à conta de serviço do Google que você está usando para desenvolver seu app:

Cloud Run

  1. Para criar uma nova conta de serviço exclusiva para implantar seu aplicativo Cloud Run, navegue até a página "Contas de serviço" e selecione o projeto em que o secret está armazenado.

    Acessar a página Contas de serviço.

  2. Clique em Criar conta de serviço.
  3. Na caixa de diálogo Criar conta de serviço, forneça um nome descritivo para a conta.
  4. Altere o ID da conta de serviço para um valor exclusivo e reconhecível e, em seguida, clique em Criar.
  5. Se o serviço do Google Cloud que você está tentando acessar exigir papéis adicionais, conceda-os, clique em Continuar e, em seguida, clique em Concluído.
  6. Adicione a conta de serviço à configuração de implantação.
    1. Usando a barra de status do Cloud Code, escolha o comando Cloud Run: implantar.
    2. Na IU de implantação do Cloud Run, em Configurações de revisão, no campo Conta de serviço, especifique sua conta de serviço.
    Seção "Configurações avançadas de revisão" expandida no Cloud Run: o campo "Implantação e conta de serviço" foi preenchido com o nome da conta de serviço no formato service-account-name@project-name.iam.gserviceaccount.com

Cloud Run

Dependendo do escopo do seu projeto, é possível escolher como autenticar os serviços do Google Cloud no GKE:

  • (Somente desenvolvimento)
    1. Crie um cluster do GKE com os seguintes campos:
      • Verifique se você está usando a conta de serviço que o GKE usa por padrão e se a conta de serviço padrão do Compute Engine e se os escopos de acesso estão definidos em Permitir acesso total a todas as APIs do Cloud (as duas configurações acessíveis na seção Pools de nós > Segurança). Como a conta de serviço do Compute Engine é compartilhada por todas as cargas de trabalho implantadas no nó, esse método superprovisiona permissões e só deve ser usado para desenvolvimento.
      • Verifique se a Identidade da carga de trabalho não está ativada no cluster (na seção Cluster > Segurança).
    2. Atribua os papéis necessários à conta de serviço:
  • (Recomendado para produção)
    1. Configure seu cluster e aplicativo do GKE com a Identidade da carga de trabalho para autenticar os serviços do Google Cloud no GKE. Isso associa sua conta de serviço do Kubernetes à sua conta de serviço do Google.
    2. Adicione a conta de serviço à configuração de implantação.
      1. Usando a barra de status do Cloud Code, escolha o comando Cloud Run: implantar.
      2. Na IU de implantação do Cloud Run, em Configurações de revisão, no campo Conta de serviço, especifique sua conta de serviço.
      Seção "Configurações avançadas de revisão" expandida no Cloud Run: o campo "Implantação e conta de serviço" foi preenchido com o nome da conta de serviço do Kubernetes no formato service-account-name@project-name.iam.gserviceaccount.com
    3. Se o serviço do Google Cloud que você está tentando acessar exige conceda-os para a conta de serviço do Google que você está usando para desenvolver seu app:

Desenvolvimento remoto com permissões do Gerenciador de secrets ativadas

Se você estiver desenvolvendo remotamente, usando uma conta de serviço para autenticação, e seu aplicativo usar secrets, conclua mais algumas etapas além das instruções de desenvolvimento remoto. Essas etapas atribuem à sua conta de serviço do Google o papel necessário para acessar um determinado secret do Gerenciador de secrets:

  1. Clique em Cloud Code e expanda a seção Secret Manager.

    O Gerenciador de secrets no Cloud Code é aberto com dois secrets listados

  2. Clique com o botão direito do mouse no secret e selecione Editar permissões no console do Cloud. Isso abre a página de configuração do Gerenciador de secrets para aquele secret no navegador da Web.

    O secret selecionado com o botão direito do mouse no painel do Gerenciador de secrets

  3. No console do Google Cloud, clique em Permissões e em Adicionar.

  4. No campo Novos principais, insira o nome da sua conta de serviço.

  5. No campo Selecionar papel, escolha o papel Acessor de secrets do Gerenciador de secrets.

  6. Clique em Save.

    Sua conta de serviço agora tem permissão para acessar esse secret específico.