Introdução

Nesta página, você verá as etapas de configuração necessárias para usar a API do Cloud Life Sciences.

Se você concluiu o Início rápido, então já realizou algumas dessas etapas. Consulte esta página para verificar se você está pronto para usar a API do Cloud Life Sciences.

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 a API Cloud Life Sciences.

    Ative a API

  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 a API Cloud Life Sciences.

    Ative a API

Noções básicas sobre as contas de serviço e os papéis padrão

Quando você executa um pipeline pela primeira vez usando a CLI gcloud ou as APIs RPC e REST, as seguintes etapas de autenticação ocorrem:

  1. Uma conta de serviço chamada Agente de serviço do Cloud Life Sciences é criada.
  2. A conta de serviço recebe automaticamente o papel padrão lifesciences.workflowsRunner. O papel permite iniciar e interromper instâncias do Compute Engine no seu projeto.

Se você remover o papel padrão da conta de serviço do projeto relevante, poderá encontrar os seguintes erros:

  • As tentativas de executar pipelines usando a API resultam em erros de permissão. Para corrigir esse problema, consulte Solução de problemas.
  • A API não pode encerrar instâncias em execução quando os pipelines são concluídos, e você continuará sendo cobrado por esses recursos. Para corrigir esse problema, consulte Solução de problemas.

Configurar a CLI do Google Cloud e a CLI do Google Cloud

Instale a CLI do Google Cloud para usar as ferramentas e bibliotecas do Cloud Life Sciences, Compute Engine, Cloud Storage e BigQuery. O SDK inclui as ferramentas de linha de comando gcloud, gsutil e bq.

  1. Faça o download e instale a CLI do Google Cloud.

  2. Inicialize a CLI do Google Cloud.

  3. Depois de inicializar o SDK, instale os componentes do Cloud Life Sciences:

    gcloud components update beta
    

    Se você estiver usando uma VM do Compute Engine com a instalação padrão da CLI gcloud, não será possível instalar os componentes usando o comando anterior. Para ativar a API Cloud Life Sciences em uma VM do Compute Engine, reinstale a CLI do gcloud executando os seguintes comandos:

    sudo apt-get remove google-cloud-sdk
        curl https://sdk.cloud.google.com | bash
        exec -l $SHELL
        gcloud init
    

Fazer o download das credenciais para acessar a API

É necessário fazer o download de um arquivo de chave da conta de serviço para seu projeto se você estiver usando um dos seguintes métodos para acessar a API Cloud Life Sciences:

  • Um exemplo de código do repositório do GitHub do Cloud Life Sciences
  • Uma ferramenta diferente da CLI do Google Cloud que acessa a API Cloud Life Sciences diretamente

Conclua as seguintes etapas para criar um arquivo de chave da conta de serviço:

  1. Acesse a página Credenciais no console.

    Acessar a página "Credenciais"

  2. Clique em Criar credenciais > Conta de serviço.

  3. Na página Detalhes da conta de serviço, digite um nome de conta de serviço e clique em Criar.

  4. Na guia Conceda a essa conta de serviço acesso ao projeto, selecione o papel da conta de serviço. Para acesso mais amplo ao Cloud Life Sciences, selecione Cloud Life Sciences > Executor de fluxos de trabalho do Cloud Life Sciences e clique em Continuar.

  5. (Opcional) Preencha a página Conceda aos usuários acesso a essa conta de serviço.

  6. Clique em Concluir.

Para fazer o download da chave da conta de serviço, conclua as seguintes etapas:

  1. Acesse a página Contas de serviço no console.

    Acessar a página "Contas de Serviço"

  2. Encontre a linha da conta de serviço para a qual você quer criar uma chave. Nessa linha, clique em e em Gerenciar chaves.

  3. Na página Chaves, clique em Adicionar chave e em Criar nova chave.

  4. Selecione JSON como Tipo de chave e clique em Criar.

Clique em Criar para fazer o download de um arquivo de chave da conta de serviço. Armazene esse arquivo com segurança porque ele pode ser usado para autenticação como sua conta de serviço. É possível mover e renomear esse arquivo.

A seguir