Configurar a rede VPC compartilhada

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Nesta página, você encontra os requisitos do projeto host e da rede VPC compartilhada do Cloud Composer.

Com a VPC compartilhada, as organizações estabelecem limites de controle de acesso e orçamento para envolvidos no projeto, além de possibilitar uma comunicação segura e eficiente usando IPs particulares nesses limites. Na configuração da VPC compartilhada, o Cloud Composer pode invocar serviços hospedados em outros projetos do Google Cloud na mesma organização sem expor serviços à Internet pública.

Diretrizes para VPC compartilhada

Projetos de serviço e host do Cloud Composer
Figura 1. Projetos de serviço e host do Cloud Composer

  • A VPC compartilhada exige que você determine um projeto host, que incluirá redes e sub-redes, e um projeto de serviço, que será anexado ao de host. Quando o Cloud Composer faz parte de uma VPC compartilhada, o ambiente dele fica no projeto de serviço.

  • Para configurar a VPC compartilhada, selecione os seguintes intervalos de IP no projeto host:

    • O intervalo de IP principal da sub-rede usada pelos nós do GKE que o Cloud Composer usa como camada do Compute Engine.
    • O intervalo de IP secundário de serviços do GKE.
    • O intervalo de IP secundário de pods do GKE.

  • Os intervalos de IP secundários não podem se sobrepor a nenhum outro intervalo secundário nessa VPC.

  • Verifique se os intervalos secundários são grandes o suficiente para acomodar o tamanho do cluster e o escalonamento do ambiente.

    Consulte Como criar um cluster nativo de VPC para ver diretrizes sobre como configurar intervalos secundários de pods e serviços.

  • O intervalo de endereços principal da sub-rede precisa acomodar o crescimento previsto e considerar os endereços IP inutilizáveis.

  • Se você usar o agente de mascaramento de IP e a configuração de IP particular para seus ambientes, adicione os intervalos de IP de nós e pods à seção nonMasqueradeCIDRs do ConfigMap ip-masq-agent. Para mais informações, consulte Como configurar um agente de mascaramento de IP.

preparação

  1. Encontre os IDs e números de projeto a seguir:

    • Projeto host: contém a rede VPC compartilhada.
    • Projeto de serviço: contém o ambiente do Cloud Composer.

  2. Prepare a organização.

  3. Ative a API GKE nos projetos host e de serviço.

  4. Se você criar um ambiente no projeto de serviço usando o console do Google Cloud, sua conta precisará ter a permissão compute.subnetworks.use no projeto host. Caso contrário, a lista de sub-redes disponíveis não contém sub-redes do projeto host. Se você criar um ambiente usando gcloud, API ou Terraform, sua conta não precisará dessa permissão adicional.

Configurar o projeto de serviço

Se os ambientes do Cloud Composer nunca tiverem sido criados no projeto de serviço, provisione a conta do agente de serviço do Composer no projeto de serviço:

gcloud beta services identity create --service=composer.googleapis.com`

Configurar o projeto host

Configure o projeto host conforme descrito.

(IP privado) Ativar o acesso privado do Google

Se você planeja usar ambientes de IP privado, ative o Acesso privado do Google para a sub-rede no projeto host. Você pode fazer isso na próxima etapa, ao configurar recursos de rede em uma sub-rede nova ou já existente.

Se você planeja usar ambientes de IP público, ainda recomendamos ativar o Acesso privado do Google para a sub-rede no projeto host. Se você optar por não usar o Acesso privado do Google, não bloqueie o tráfego que, de outra forma, a regra de firewall implícita de permissão de saída do IPv4 permitiria. Isso é necessário para alcançar *.googleapis.com endpoints.

Configurar recursos de rede

Escolha uma das opções a seguir para alocar e configurar recursos de rede. Em cada opção, é preciso nomear os intervalos de IP secundários para pods e serviços.

Configurar a VPC compartilhada e anexar o projeto de serviço

  1. Configure a VPC compartilhada caso ainda não tenha feito isso. Se você já configurou a VPC compartilhada, pule para a próxima etapa.

  2. Anexe o projeto de serviço, que você usa para hospedar ambientes do Cloud Composer.

    Ao anexar um projeto, deixe as permissões de rede VPC padrão em vigor.

Conceder permissões à conta do agente de serviço do Composer

No projeto host:

  1. Editar permissões da conta do agente de serviço do Composer, service-SERVICE_PROJECT_NUMBER@cloudcomposer-accounts.iam.gserviceaccount.com)

  2. Para essa conta, adicione outro papel no nível do projeto:

    • Para ambientes de IP particular, adicione o papel Composer Shared VPC Agent.

    • Para ambientes de IP público, adicione o papel Compute Network User.

Conceder permissões à conta do agente de serviço de API do Google

No projeto host:

  1. Editar permissões da conta do agente de serviço da API do Google, SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com.

  2. Adicione outro papel, Usuário da rede do Compute (compute.networkUser) no nível do projeto. Esse é um requisito para grupos de instâncias gerenciadas usados com a VPC compartilhada, porque esse tipo de conta de serviço executa tarefas como a criação de instâncias.

Editar permissões para contas de serviço do GKE

No projeto host, edite as permissões das contas de serviço do GKE, service-SERVICE_PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com.

Para cada conta de serviço, adicione outro papel, compute.networkUser, usando uma das seguintes opções:

  • Conceda esse papel no nível da sub-rede para permitir que uma conta de serviço configure os peerings de VPC exigidos pelo Cloud Composer. Nesse caso, especifique explicitamente a sub-rede a ser usada pelo ambiente, porque o cluster do ambiente pode não ter permissões para encontrar a sub-rede na rede.

  • Conceda esse papel no nível do projeto para todo o projeto host. Nesse caso, a conta de serviço do GKE do projeto de serviço tem permissões para usar qualquer sub-rede no projeto host.

Editar permissões da conta de serviço do GKE do projeto de serviço

No projeto host, edite as permissões da conta de serviço do GKE do projeto de serviço.

Nessa conta, adicione outro papel no nível do projeto: Usuário do agente de serviço de host do Kubernetes Engine (roles/container.hostServiceAgentUser).

Isso permite que a conta de serviço do GKE do projeto de serviço use a conta de serviço do GKE do projeto host para configurar recursos de rede compartilhados.

(IP privado, opcional) Configurar regras de firewall e conectividade com os domínios do Google

Em uma configuração de VPC compartilhada com ambientes de IP privado, como opção, você pode rotear todo o tráfego para as APIs e os serviços do Google por meio de vários endereços IP que pertencem ao domínio private.googleapis.com e configurar as regras de firewall correspondentes. Nessa configuração, seu ambiente acessa as APIs e os serviços do Google por meio de endereços IP que só podem ser roteados do Google Cloud. Se a configuração da VPC compartilhada usar o VPC Service Controls, encaminhe o tráfego por meio de restricted.googleapis.com.

Se a configuração da VPC compartilhada usar ambientes de IP privado:

  1. (Opcional) Configure a conectividade com as APIs e os serviços do Google.
  2. (Opcional) Configure regras de firewall.

Se a configuração da VPC compartilhada usar o VPC Service Controls, use as instruções para ambientes com VPC Service Controls:

  1. Configurar a conectividade com as APIs e os serviços do Google.
  2. Configurar regras de firewall

Conclusão

Você concluiu a configuração da rede VPC compartilhada para os projetos de serviço e host.

Agora é possível criar novos ambientes no projeto de serviço que usam a rede VPC do projeto host.

A seguir