Introdução

Beta

Este produto ou recurso é coberto pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud. Os produtos e recursos pré-GA podem ter compatibilidade limitada, e as mudanças em produtos e recursos anteriores à disponibilidade geral podem não ser compatíveis com outras versões anteriores à disponibilidade geral. Para mais informações, consulte as descrições das fases de lançamento.

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.

   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 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.

   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 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 Mais 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

• Analise as variantes com o BigQuery.
• Armazene e carregue as variantes no Cloud Storage e no BigQuery.
• Veja tutoriais sobre a execução de pipelines com a API Cloud Life Sciences.