Como usar a interface do Private Service Connect com o Agent Runtime

O Agent Runtime é compatível com a interface do Private Service Connect (interface do PSC) e o peering de DNS para permitir o tráfego de saída particular e seguro. Isso permite que os agentes acessem com segurança os recursos na VPC ou nas redes locais.

Este documento explica a visão geral e os detalhes de configuração para usar a interface do PSC com o Agent Runtime.

Visão geral

Seu agente é implantado em uma rede segura gerenciada pelo Google sem acesso à sua rede de nuvem privada virtual (VPC). Uma interface do PSC cria uma ponte particular e segura para sua rede, sendo a solução recomendada para interagir com serviços hospedados de forma privada na VPC, no local e em ambientes multicloud.

Quando você configura uma interface do PSC, o Agent Runtime provisiona uma interface em um projeto de locatário do Google em que seu agente é executado. Essa interface se conecta diretamente a um anexo de rede no seu projeto. Todo o tráfego entre o agente e a VPC é transmitido com segurança na rede do Google, sem nunca passar pela Internet pública.

Além de fornecer acesso privado, a interface do PSC é necessária para ativar o acesso à Internet ao usar o VPC Service Controls.

A capacidade do agente de acessar a Internet pública depende da configuração de segurança do projeto, especificamente se você está usando o VPC Service Controls.

  • Sem o VPC Service Controls: quando você configura o agente apenas com uma interface do PSC, o tráfego do agente é roteado para sua VPC. Por padrão, sua VPC não fornece um caminho de saída para a Internet pública para esse tráfego. Para permitir o acesso à internet para seu agente, é preciso configurar explicitamente um caminho de saída na VPC. Por exemplo, é possível configurar uma VM de proxy dedicada na VPC. Para mais informações, consulte o codelab sobre a interface PSC do Agent Runtime.

  • Com o VPC Service Controls: quando o projeto faz parte de um perímetro do VPC Service Controls, o acesso padrão do agente à Internet é bloqueado pelo perímetro para evitar a exfiltração de dados. Para permitir que o agente acesse a Internet pública nesse cenário, é necessário configurar explicitamente um caminho de saída seguro que encaminhe o tráfego pela VPC. A maneira recomendada de fazer isso é configurar um servidor proxy dentro do perímetro da VPC e criar um gateway do Cloud NAT para permitir que a VM de proxy acesse a Internet.

Detalhes de configuração da interface do Private Service Connect

Para ativar a conectividade privada para o agente implantado usando a interface do Private Service Connect, configure uma rede VPC, uma sub-rede e um anexo de rede no projeto do usuário.

Requisitos de intervalo de IP de sub-rede

O Agent Runtime requer uma sub-rede mínima /28 para cada projeto de usuário do Agent Engine.

A sub-rede do anexo de rede é compatível com endereços RFC 1918 e não RFC 1918, com exceção das sub-redes 100.64.0.0/20 e 240.0.0.0/4. O Agent Runtime só pode se conectar a intervalos de endereços IP RFC 1918 que são roteáveis da rede especificada. O Agent Runtime não pode acessar um endereço IP público usado de forma privada ou os seguintes intervalos não RFC 1918:

  • 100.64.0.0/20
  • 192.0.0.0/24
  • 192.0.2.0/24
  • 198.18.0.0/15
  • 198.51.100.0/24
  • 203.0.113.0/24
  • 240.0.0.0/4

Consulte Configurar uma interface do Private Service Connect para mais informações.

Como usar a interface do Private Service Connect com a VPC compartilhada

É possível usar a interface do Private Service Connect com uma arquitetura de VPC compartilhada, que permite criar o Agent Runtime em um projeto de serviço usando uma rede de um projeto host central.

Para que o projeto de serviço use a rede do projeto host, o agente de serviço da plataforma de agente do seu projeto de serviço precisa do papel de Usuário da rede do Compute (roles/compute.networkUser) no projeto host.

Siga estas etapas:

  1. Crie a sub-rede no projeto host.

  2. Crie o anexo de rede no projeto de serviço ou no projeto host. O anexo de rede pode ser criado em qualquer projeto conectado à VPC compartilhada, mas recomendamos colocá-lo no projeto de serviço para simplificar as permissões:

    • Anexo de rede no projeto de serviço (recomendado): conceda o papel de Administrador de rede do Compute (roles/compute.networkAdmin) ao agente de serviço da plataforma de agentes do projeto de serviço. Esse papel é necessário para que o agente de serviço possa atualizar o anexo de rede para aceitar o tráfego do projeto interno do Google. Se você não quiser usar o papel de Administrador de rede do Compute, crie um papel personalizado com as permissões a seguir e conceda esse papel ao agente de serviço da plataforma de agentes do projeto de serviço:

      • compute.networkAttachments.get
      • compute.networkAttachments.update
      • compute.regionOperations.get

    • Anexo de rede no projeto host: siga estas etapas:

      1. Ative a API Agent Platform no projeto host. Consulte Configurar uma interface do Private Service Connect para mais informações.

      2. Se o agente de serviço da plataforma de agentes não existir no projeto host, crie-o usando o seguinte comando:

        gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID
        

        em que PROJECT_ID é o ID do projeto.

      3. Conceda o papel de Administrador de rede do Compute (roles/compute.networkAdmin) ao agente de serviço da plataforma de agentes do projeto host. Consulte Configurar uma interface do Private Service Connect para mais informações. Se você não quiser usar o papel de Administrador de rede do Compute, crie um papel personalizado com as permissões a seguir e conceda esse papel ao agente de serviço da plataforma de agentes do projeto host:

        • compute.networkAttachments.get
        • compute.networkAttachments.update
        • compute.regionOperations.get

Peering de DNS

Enquanto a interface do Private Service Connect fornece o caminho de rede seguro, o peering de DNS fornece o mecanismo de descoberta de serviços. Com a interface do PSC, você precisa saber o endereço IP específico do serviço na rede VPC. Embora seja possível se conectar a serviços usando os endereços IP internos deles, isso não é recomendado para sistemas de produção em que os IPs podem mudar. Com o peering de DNS, o agente implantado pode se conectar a serviços na sua rede VPC usando nomes DNS estáveis e legíveis por humanos, em vez de endereços IP. O peering de DNS permite que os agentes implantados resolvam nomes de DNS usando os registros de uma zona particular do Cloud DNS na sua VPC. Consulte Configurar um peering de DNS particular para mais informações.

Limitações

A interface do Private Service Connect com o Agent Runtime está sujeita às seguintes limitações:

  • Não é possível alterar uma interface do Private Service Connect para um agente do ambiente de execução sem recriar os recursos.

A seguir

Guia

Conheça as cinco maneiras de implantar um agente no Agent Platform Runtime com base nas suas necessidades de desenvolvimento.