Contas de serviço e chaves

Neste documento, explicamos as contas de serviço e as chaves do Google Cloud necessárias para criar clusters na sua implementação de clusters do Anthos no VMware (GKE On-Prem).

As instruções aqui são completas. Para ver uma introdução mais rápida ao uso de uma conta de serviço, consulte Conta de serviço (guia de início rápido).

Antes de começar

Crie projetos do Google Cloud.

Visão geral de contas de serviço

Antes de criar os clusters de administrador e de usuário, é necessário ter estas contas de serviço:

  • Conta de serviço de acesso a componentes
  • Conta de serviço connect-register
  • Conta de serviço connect-agent
  • Conta de serviço logging-monitoring

Dependendo dos recursos que você quer ativar, talvez também seja necessário ter algumas contas de serviço opcionais.

Noções básicas sobre contas de serviço e projetos do Google Cloud

Ao criar uma conta de serviço, você a associa a um projeto do Google Cloud. Esse projeto do Google Cloud é chamado de projeto pai da conta de serviço.

Você identifica o projeto pai de uma conta de serviço observando o endereço de e-mail dela. Por exemplo, veja o endereço de e-mail de uma conta de serviço denominada logger. O projeto pai é alice-123.

logger@alice-123.iam.gserviceaccount.com

Ao conceder um papel de gerenciamento de identidade e acesso (IAM) a uma conta de serviço, você o concede à conta de serviço em um projeto específico do Cloud. Isso segue o padrão geral de conceder um papel a uma identidade em um recurso.

Por exemplo, é possível conceder o papel bigquery.dataEditor à conta de serviço logger@alice-123.iam.gserviceaccount.com no projeto bob-456. Nesse caso, a conta de serviço é a identidade e o projeto do Google Cloud é o recurso.

É importante compreender que é possível conceder um papel a uma conta de serviço em um projeto do Cloud que não seja o projeto pai da conta de serviço.

Permissões para conceder papéis a contas de serviço

Cada uma das contas de serviço precisa receber determinados papéis no projeto relevante do Google Cloud. Por exemplo, sua conta de serviço de registro de conexão precisa receber o papel gkehub.admin no projeto de conexão.

Para conceder papéis em um projeto do Google Cloud, é preciso ter determinadas permissões no projeto. Para detalhes, consulte roles/resourcemanager.projectIamAdmin em Noções básicas sobre papéis.

Se tiver as permissões necessárias, você mesmo poderá conceder os papéis. Caso contrário, outra pessoa na sua organização precisará conceder esses papéis para você.

Como usar gkeadm para criar automaticamente contas de serviço

Nesta página, mostramos como criar contas de serviço manualmente e conceder papéis a elas. Como alternativa a executar essas etapas manualmente, é possível que gkeadm crie algumas contas de serviço e conceda papéis quando você criar uma estação de trabalho de administrador. Para mais informações, consulte Como criar a estação de trabalho de administrador.

Conta de serviço de acesso a componentes

Os clusters do Anthos no VMware usam essa conta de serviço para fazer o download de componentes do cluster, em seu nome, do Container Registry.

Para criar uma conta de serviço de acesso a componentes:

gcloud iam service-accounts create component-access-sa \
    --display-name "Component Access Service Account" \
    --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você quer que seja o projeto pai da sua conta de serviço.

Para criar uma chave JSON para sua conta de serviço de acesso a componentes:

gcloud iam service-accounts keys create component-access-key.json \
   --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço de acesso a componentes.

Como conceder papéis à sua conta de serviço de acesso a componentes

Os arquivos de configuração do cluster de usuário e de administrador têm vários campos que especificam um ID de projeto.

No arquivo de configuração do cluster de administrador:

stackdriver:
  projectID: ""
...
cloudAuditLogging:
  projectid: ""

No arquivo de configuração do cluster do usuário:

stackdriver:
  projectID: ""
...
gkeConnect:
  projectID: ""
...
usageMetering:
  bigQueryProjectID: ""
...
cloudAuditLogging:
  projectid: ""

Os IDs de projeto nos seus arquivos de configuração não precisam ser distintos. Por exemplo, gkeConnect.projectID pode ser igual a cloudAuditLogging.projectID. Na verdade, todos os IDs de projeto nos arquivos de configuração podem ser iguais.

Sua conta de serviço de acesso a componentes precisa receber os seguintes papéis de IAM em cada projeto do Google Cloud especificado nos arquivos de configuração de cluster de usuário e de administrador. Estes papéis são necessários para que os clusters do Anthos no VMware possam fazer verificações de simulação:

  • serviceusage.serviceUsageViewer
  • iam.serviceAccountCreator
  • iam.roleViewer

Para cada projeto do Google Cloud especificado nos arquivos de configuração do cluster, execute os seguintes comandos para conceder os papéis necessários à conta de serviço de acesso ao componente:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/serviceusage.serviceUsageViewer"
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/iam.serviceAccountCreator"
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/iam.roleViewer"

Substitua:

  • PROJECT_ID: ID de um dos projetos do Cloud especificados em arquivos de configuração.

  • SERVICE_ACCOUNT_EMAIL: o endereço de e-mail da conta de serviço de acesso a componentes.

Conta de serviço connect-register

Os clusters do Anthos no VMware usam essa conta de serviço para registrar seus clusters de usuários com o Google Cloud.

Para criar uma conta de serviço de conexão entre registros:

gcloud iam service-accounts create connect-register-sa \
    --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você quer ser o pai da conta de serviço do connect-register.

Para criar uma chave JSON para sua conta de serviço do connect-register:

gcloud iam service-accounts keys create connect-register-key.json \
   --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço do connect-register.

Sua conta de serviço de registro de conexão precisa receber o papel gkehub.admin no projeto de conexão. Este é o projeto do Google Cloud em que você quer visualizar e gerenciar os clusters.

Para conceder o papel gkehub.admin à sua conta de serviço connect-register:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/gkehub.admin"

Substitua PROJECT_ID pelo ID do projeto de conexão.

Conta de serviço connect-agent

Os clusters do Anthos no VMware usam essa conta de serviço para manter uma conexão entre os clusters do Anthos no VMware e no Google Cloud.

Para criar uma conta de serviço do agente de conexão:

gcloud iam service-accounts create connect-agent-sa \
    --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Cloud que você quer ser o pai da conta de serviço do connect-register.

Para criar uma chave JSON para sua conta de serviço do agente de conexão:

gcloud iam service-accounts keys create connect-agent-key.json \
    --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço do agente de conexão.

A conta de serviço do agente de conexão precisa receber o papel gkehub.connect no projeto de conexão. Este é o projeto do Google Cloud em que você quer visualizar e gerenciar os clusters.

Para conceder o papel gkehub.connect à sua conta de serviço connect-agent:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/gkehub.connect"

Substitua PROJECT_ID pelo ID do projeto de conexão.

Conta de serviço logging-monitoring

Os clusters do Anthos no VMware usam essa conta de serviço para exportar registros e métricas de clusters para o Cloud Logging e o Cloud Monitoring.

Para criar uma conta de serviço de monitoramento de registros:

gcloud iam service-accounts create logging-monitoring-sa \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você quer ser o pai da conta de serviço de monitoramento de registros.

Para criar uma chave JSON para sua conta de serviço de monitoramento de registros:

gcloud iam service-accounts keys create logging-monitoring-key.json \
    --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço de monitoramento de registros.

Sua conta de serviço de monitoramento de geração de registros precisa receber os seguintes papéis no seu projeto de geração de registros. Este é o projeto do Google Cloud em que você quer ver os registros dos clusters.

  • stackdriver.resourceMetadata.writer
  • logging.logWriter
  • monitoring.metricWriter
  • monitoring.dashboardEditor

Para conceder os papéis necessários à conta de serviço de monitoramento de registros:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/stackdriver.resourceMetadata.writer"
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/logging.logWriter"
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/monitoring.metricWriter"
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/monitoring.dashboardEditor"

Substitua PROJECT_ID pelo ID do projeto de geração de registros.

Contas de serviço opcionais

Conta de serviço de medição de uso

Os clusters do Anthos no VMware usam essa conta de serviço para armazenar dados de uso em um conjunto de dados do BigQuery.

Para criar uma conta de serviço de medição de uso:

gcloud iam service-accounts create usage-metering-sa \
    --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você quer que seja o pai da sua conta de serviço de medição de uso.

Para criar uma chave JSON para sua conta de serviço de medição de uso:

gcloud iam service-accounts keys create usage-metering-key.json \
   --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço de medição de uso.

Sua conta de serviço de medição de uso precisa receber o papel bigquery.dataEditor no projeto de medição de uso. Esse é o projeto do Google Cloud em que você quer visualizar os dados de uso do cluster do usuário.

Para conceder o papel bigquery.dataEditor à conta de serviço de medição de uso:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:SERVICE_ACCOUNT_EMAIL" \
    --role "roles/bigquery.dataEditor"

Substitua PROJECT_ID pelo ID do projeto de medição de uso.

Conta de serviço do Audit Logging

Os clusters do Anthos no VMware usam essa conta de serviço para enviar registros de auditoria do Kubernetes do seu cluster para os registros de auditoria do Cloud.

Para criar uma conta de serviço de geração de registros de auditoria:

gcloud iam service-accounts create audit-logging-sa \
    --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você quer que seja o pai da sua conta de serviço de registro de auditoria.

Para criar uma chave JSON para sua conta de serviço de geração de registros de auditoria:

gcloud iam service-accounts keys create audit-logging-key.json \
   --iam-account SERVICE_ACCOUNT_EMAIL

Substitua SERVICE_ACCOUNT_EMAIL pelo endereço de e-mail da conta de serviço de geração de registros de auditoria.

Você não precisa conceder papéis à conta de serviço de registro de auditoria.

Conta de serviço de autorização binária

Os clusters do Anthos no VMware usam essa conta de serviço para chamar a API Binary Authorization.

Para informações sobre como criar uma conta de serviço de autorização binária, consulte Autorização binária no GKE On-Prem.

A seguir

Criar uma estação de trabalho de administrador.