create-service-account

Cria contas de serviço do Google Cloud Platform (GCP) com papéis que permitem que componentes individuais da Apigee híbrida façam chamadas de API autorizadas e façam o download dos arquivos de chave da conta de serviço associados. É possível usar os arquivos de chave da conta de serviço gerados por esse comando no arquivo de modificação da configuração.

A ferramenta create-service-account está localizada no diretório hybrid_root_dir/tools.

Pré-requisitos

A ferramenta create-service-account requer que a CLI do gcloud esteja instalada. Os usuários que invocam o utilitário precisam ter o papel Service Account Admin.

Para começar, verifique se a configuração do projeto gcloud está definida como o projeto que você criou na Etapa 2: criar um projeto do Google Cloud:

gcloud config list project

Se você precisar alterar o ID do projeto atual, use este comando: 

gcloud config set project gcp_project_id

Em que gcp_project_id é o projeto criado na Etapa 2: criar um projeto do Google Cloud.

Sintaxe create-service-account

A ferramenta create-service-account usa a seguinte sintaxe:

create-service-account component_name output_dir [gcp_project_id]

Em que:

  • component_name: especifica o serviço híbrido que usa a conta de serviço. Os valores válidos são:
    • apigee-cassandra
    • apigee-logger
    • apigee-mart
    • apigee-metrics
    • apigee-synchronizer
    • apigee-udca

    Observe que a ferramenta create-service-account não pode criar a conta de serviço apigee-org-admin. Crie essas informações com as APIs do GCP ou da gcloud, conforme descrito em Criar contas de serviço.

  • output_dir: o diretório de saída no qual armazenar a chave da conta de serviço salva.
  • gcp_project_id: (opcional) especifica o ID do projeto do GCP que está vinculado à sua organização habilitada para o ambiente híbrido. Se o ID do projeto do GCP não for fornecido, a ferramenta tentará recuperá-lo a partir da configuração atual da gcloud.

Descrição detalhada

A ferramenta create-service-account:

  • Cria contas de serviço do GCP usadas por componentes híbridos. A conta de serviço criada recebe o papel necessário para que o componente específico opere.
  • Faz o download da chave da conta de serviço no seu sistema. Coloque as chaves da conta de serviço no arquivo de modificação de configuração híbrida, conforme explicado nas instruções de instalação híbridas.

A ferramenta cria contas de serviço para os seguintes componentes:

Componente* Papel Necessário para instalação básica? Descrição
apigee-cassandra Administrador de objetos do Storage Permite backups do Cassandra para o Google Cloud Storage, conforme descrito em Backup e recuperação.
apigee-logger Gravador de registros Permite a coleta de dados de geração de registros, conforme descrito em Geração de registros. Obrigatório apenas para instalações de cluster que não são do GKE.
apigee-mart Nenhum papel Permite a autenticação do serviço MART. Esta conta de serviço não precisa ter um papel associada a ela. Como resultado, ao criar essa conta de serviço, não atribua um papel a ela.
apigee-metrics Gravador de métricas do Monitoring Permite a coleta de dados de métricas, conforme descrito em Coleta de métricas.
apigee-org-admin Administrador da organização do Apigee Permite chamar a API getSyncAuthorization e a API setSyncAuthorization. Não é possível criar essa conta de serviço com a ferramenta create-service-account.
apigee-synchronizer Gerenciador de sincronização da Apigee Permite que o sincronizador faça o download de pacotes de proxy e dados de configuração do ambiente. Ativa também a operação do recurso de rastreamento.
apigee-udca Agente de análise da Apigee Permite a transferência de dados de status de rastreamento, análise e implantação para o plano de gerenciamento.
* Esse nome é usado no nome de arquivo da chave da conta de serviço salva.

Também é possível criar contas de serviço no Console do GCP. Consulte também Como criar e gerenciar contas de serviço.

Exemplo

No exemplo a seguir, criamos uma nova conta de serviço para o serviço apigee-logger e colocamos a chave salva no diretório ./service-accounts.

./my-hybrid-root/tools/create-service-account apigee-logger ./service-accounts