Skip to main content
Alguns clientes corporativos exigem que o Devin se conecte de forma privada a sistemas internos, como GitHub Enterprise Server, GitLab, Bitbucket Data Center, Artifactory, Nexus ou outras infraestruturas de desenvolvimento. O Devin Dedicated SaaS oferece suporte a isso por meio de AWS PrivateLink. Esse modelo mantém todo o tráfego no backbone de rede da AWS e evita exposição à internet pública.

​
Visão geral

PrivateLink fornece conectividade de IP privado da sua VPC do Devin Dedicated SaaS para seus endpoints internos. Para isso, sua equipe disponibiliza um AWS VPC Endpoint Service à frente de cada sistema interno que o Devin precisa acessar. Em seguida, a Cognition cria Interface VPC Endpoints que consomem esse serviço. O PrivateLink é configurado por domínio. Se o Devin precisar acessar vários domínios, você precisará de um Endpoint Service e um Interface Endpoint para cada domínio.

​
Requisitos

Você deve fornecer:
  • Um Network Load Balancer (NLB) na sua conta da AWS que sirva de front-end para cada serviço interno (GitLab, Artifactory, etc.)
  • Um VPC Endpoint Service que use o NLB como destino
  • O nome do serviço para cada Endpoint Service
  • Permissões de entidade principal autorizada que incluam a conta AWS da Cognition
  • Confirmação das portas suportadas para cada serviço
  • Informações de DNS para os domínios que o Devin deve resolver de forma privada
A Cognition fornecerá:
  • O ID da conta AWS para adicionar como entidade principal autorizada
  • As informações da VPC de destino e da sub-rede para os Interface Endpoints
  • A configuração de DNS no lado do Devin assim que a conectividade for estabelecida
Se seus serviços internos estiverem em uma região diferente do tenant Cognition Dedicated SaaS, o PrivateLink ainda pode ser usado. A AWS oferece suporte ao consumo de endpoints entre regiões, desde que o proprietário do serviço o ative.

​
Etapas do cliente

  1. Criar ou reutilizar o Network Load Balancer O NLB deve direcionar para os sistemas internos a que o Devin precisa ter acesso. O NLB deve oferecer suporte a todas as portas necessárias.
  2. Criar um VPC Endpoint Service a partir do NLB Isso torna o serviço disponível para consumo via PrivateLink.
  3. Habilitar suporte entre regiões (cross region) No console da AWS: 
    VPC Console → Endpoint Services → Select service → Actions → Modify supported Regions
    Adicione a região em que seu tenant da Cognition está implantado. Exemplo usando CLI: 
    aws ec2 modify-vpc-endpoint-service-configuration \
    --service-id vpce-svc-0abc123 \
    --add-supported-regions us-east-1  # Região do seu tenant da Cognition
  4. Adicionar a conta AWS da Cognition como principal permitido 
    aws ec2 modify-vpc-endpoint-service-permissions \
    --service-id vpce-svc-0abc123 \
    --add-allowed-principals arn:aws:iam::<COGNITION_ACCOUNT_ID>:root
  5. Fornecer os seguintes detalhes à Cognition
    • Nome do Endpoint Service
      Exemplo: com.amazonaws.vpce.us-west-2.vpce-svc-0abc123
    • Portas que o serviço aceita
    • Domínios que devem ser resolvidos por meio do PrivateLink

​
O que acontece a seguir

Depois que você fornecer os detalhes acima, a Cognition irá:
  1. Criar endpoints de interface da VPC na sua VPC de tenant dedicada usando os nomes de serviço que você forneceu.
  2. Enviar uma solicitação de conexão que você precisará aprovar (manualmente ou por aceitação automática, se configurado).
  3. Configurar DNS para que os domínios que você especificou sejam resolvidos de forma privada no ambiente do Devin.

​
Diagrama de arquitetura

Arquitetura PrivateLink

Conectividade PrivateLink entre regiões, da Cognition para os serviços internos do cliente

​
Considerações principais

TópicoOrientação
Configuração necessáriaUm Endpoint Service por domínio, um Interface Endpoint por domínio
Suporte entre regiõesDeve ser explicitamente habilitado no Endpoint Service
Principais permitidosO cliente deve adicionar o ID da conta AWS da Cognition
DNSOs domínios do cliente serão resolvidos para IPs privados de Interface Endpoint no ambiente da Cognition
PortasOs listeners do NLB devem corresponder às portas que o Devin usa para acessar cada serviço
DisponibilidadeO NLB e os targets subjacentes devem ser configurados em múltiplas Availability Zones
LatênciaPode ocorrer um pequeno aumento de latência entre regiões, já que o tráfego permanece no backbone da AWS

​
Informações a fornecer à Cognition

Quando sua configuração estiver pronta, envie à Cognition:
  • Nomes dos AWS Endpoint Services para cada domínio interno
  • Confirmação de que o suporte entre regiões está habilitado (se aplicável)
  • Confirmação de que a configuração de allowed principal está concluída
  • Portas expostas pelo NLB
  • A lista de domínios que devem ser roteados pelo PrivateLink
A Cognition então provisionará os Interface Endpoints, configurará o DNS e confirmará a conectividade.