Comece já

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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  4. Enable the Cloud Life Sciences API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  7. Enable the Cloud Life Sciences API.

    Enable the 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), ocorrem as seguintes etapas de autenticação:

  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 as CLIs e a Google Cloud CLI

Instale a CLI do Google Cloud para usar as ferramentas e bibliotecas no 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 Google Cloud CLI.

  2. Inicializar a CLI do Google Cloud.

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

    gcloud components update beta

    Se você usa uma VM do Compute Engine com a instalação padrão da CLI gcloud, não é 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 gcloud executando 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 Google Cloud CLI 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 do Google Cloud.

    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 Concluído.

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 do Google Cloud.

    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