Como usar vários projetos do Google Cloud

Nesta página, mostramos como usar projetos separados do Google Cloud para diferentes aspectos do GKE On-Prem.

O arquivo de configuração do GKE On-Prem tem vários campos para especificar um ID do projeto do Google Cloud.

...
usercluster:
  usagemetering:
    bigqueryprojectid: ""
...
gkeconnect:
  projectid: ""
...
stackdriver:
  projectid: ""
...
cloudauditlogging:
  projectid: ""

A ideia é ter um projeto para se conectar ao GKE On-Prem, outro para geração de registros e monitoramento e assim por diante.

Não é necessário usar IDs de projeto separados. Por exemplo, é possível usar o mesmo projeto para se conexão e geração de registros. Se quiser, use o mesmo projeto para tudo.

Projeto de medição de uso

Se você ativar a medição de uso do GKE para um cluster de usuário, o GKE On-Prem armazenará dados de uso em um conjunto de dados do BigQuery associado a um projeto do Google Cloud de sua escolha.

No arquivo de configuração do GKE On-Prem, defina usercluster.usagemetering.bigqueryprojectid como o ID do projeto do Google Cloud em que serão armazenados os dados de uso.

Como ativar APIs no projeto de medição de uso

Para ativar as APIs necessárias no seu projeto de medição de uso:

Linux e macOS

gcloud services enable --project [PROJECT_ID] \
    bigquery.googleapis.com \
    serviceusage.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto de medição de uso.

Windows

gcloud services enable --project [PROJECT_ID] ^
    bigquery.googleapis.com ^
    serviceusage.googleapis.com ^
    iam.googleapis.com ^
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto de medição de uso.

Como atribuir papéis a contas de serviço no projeto de medição de uso

Sua conta de serviço de medição de uso precisa receber determinados papéis no projeto de medição de uso.

Para detalhes, consulte a conta de serviço de medição de uso.

Projeto connect

Quando você cria um cluster de usuário, o GKE On-Prem usa o Connect para registrar o cluster em um projeto do Google Cloud de sua escolha. Depois que o cluster for registrado, você poderá vê-lo e gerenciá-lo neste projeto no Console do Google Cloud.

O Connect usa uma implantação denominada agente do Connect para estabelecer uma conexão entre o cluster do GKE On-Prem e o projeto do Google Cloud.

No arquivo de configuração local do GKE, defina gkeconnect.projectid como o ID do projeto do Google Cloud em que você quer visualizar e gerenciar o cluster.

Como ativar APIs no projeto connect

Para ativar as APIs necessárias no projeto connect:

Linux e macOS

gcloud services enable --project [PROJECT_ID] \
    cloudresourcemanager.googleapis.com \
    container.googleapis.com \
    gkeconnect.googleapis.com \
    gkehub.googleapis.com \
    serviceusage.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto connect.

Windows

gcloud services enable --project [PROJECT_ID] ^
    cloudresourcemanager.googleapis.com ^
    container.googleapis.com ^
    gkeconnect.googleapis.com ^
    gkehub.googleapis.com ^
    serviceusage.googleapis.com ^
    iam.googleapis.com ^
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto connect.

Como atribuir papéis a contas de serviço no projeto connect

A conta de serviço connect-register e a conta de serviço connect-agent precisam receber determinados papéis no projeto connect.

Para detalhes, consulte Conta de serviço connect-register e Conta de serviço connect-agent.

Projeto logging-monitoring

Em um cluster de usuário, os agentes de geração de registros e métricas coletam dados e os disponibilizam no Cloud Logging e no Cloud Monitoring. Para conferir registros e métricas do cluster, especifique um projeto do Google Cloud associado.

No arquivo de configuração do cluster do usuário, defina stackdriver.projectID como o ID do projeto do Google Cloud que você quer associar à geração de registros e monitoramento. Esse é o projeto em que você verá os registros e as métricas do cluster.

Como ativar APIs no projeto logging-monitoring

Para ativar as APIs necessárias no projeto logging-monitoring:

Linux e macOS

gcloud services enable --project [PROJECT_ID] \
    stackdriver.googleapis.com \
    monitoring.googleapis.com \
    logging.googleapis.com \
    serviceusage.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com

em que [PROJECT_ID] é o ID do projeto logging-monitoring.

Windows

gcloud services enable --project [PROJECT_ID] ^
    stackdriver.googleapis.com ^
    monitoring.googleapis.com ^
    logging.googleapis.com ^
    serviceusage.googleapis.com ^
    iam.googleapis.com ^
    cloudresourcemanager.googleapis.com

em que [PROJECT_ID] é o ID do projeto logging-monitoring.

Como conceder papéis a contas de serviço no projeto logging-monitoring

Sua conta de serviço logging-monitoring precisa receber determinados papéis no projeto logging-monitoring.

Para detalhes, consulte Conta de serviço logging-monitoring.

Projeto de registro de auditoria

Se você ativar os registros de auditoria do Cloud para o GKE On-Prem, as entradas correspondentes do servidor da API Kubernetes do cluster serão enviadas ao Google Cloud. É possível conferir as entradas de registro de auditoria em um projeto do Google Cloud de sua escolha.

No arquivo de configuração do GKE On-Prem, defina cloudauditlogging.projectid como o ID do projeto do Google Cloud em que você quer visualizar os registros de auditoria.

Como ativar APIs no projeto de registro de auditoria

Para ativar as APIs necessárias no projeto de registro de auditoria:

Linux e macOS

gcloud services enable --project [PROJECT_ID] \
    anthosgke.googleapis.com \
    serviceusage.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto de registro de auditoria.

Windows

gcloud services enable --project [PROJECT_ID] ^
    anthosgke.googleapis.com ^
    serviceusage.googleapis.com ^
    iam.googleapis.com ^
    cloudresourcemanager.googleapis.com

[PROJECT_ID] é o ID do projeto de registro de auditoria.

Como conceder papéis a contas de serviço no projeto de registro de auditoria

Sua conta de serviço de registro de auditoria precisa receber determinados papéis do projeto de registro de auditoria.

Para detalhes, consulte Conta de serviço de registro de auditoria.

Projeto pai da sua conta de serviço de acesso a componentes

Para instalar o GKE On-Prem, você precisa ter:

  • criado um projeto do Google Cloud;

  • No projeto do Google Cloud, você criou uma conta de serviço que o GKE On-Prem pode usar para fazer o download de componentes do Container Registry. Essa conta é chamada de conta de serviço de acesso a componentes.

  • ativado a API Anthos. A ativação desta API pode gerar cobranças. Para mais informações, consulte o guia de preços;

O projeto do Google Cloud em que você criou a conta de serviço de acesso a componentes é chamado de pai da conta de serviço de acesso a componentes. Esse projeto pode ser igual a um dos projetos especificados no arquivo de configuração do GKE On-Prem ou pode ser diferente de todos os projetos especificados no arquivo de configuração.

Para ativar as APIs necessárias para o projeto pai da conta de serviço de acesso a componentes:

Linux e macOS

gcloud services enable --project [PROJECT_ID] \
    serviceusage.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com

em que [PROJECT_ID] é o ID do projeto pai da sua conta de serviço de acesso a componentes.

Windows

gcloud services enable --project [PROJECT_ID] ^
    serviceusage.googleapis.com ^
    iam.googleapis.com ^
    cloudresourcemanager.googleapis.com

em que [PROJECT_ID] é o ID do projeto pai da sua conta de serviço de acesso a componentes.

A seguir

Saiba mais sobre contas de serviço e chaves do GKE On-Prem.