Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Gateway Contour — um controlador de ingress nativo do Kubernetes

Este exemplo compila uma stack pequena e real — um gateway de ingress Contour — a partir de um único Aggregate escrito pelo desenvolvedor, para o Kubernetes. O desenvolvedor declara o que o gateway é; uma única Recipe de Ops mapeia essa intenção para o chart do Helm oficial project-contour (servido a partir do repositório de charts HTTPS do projeto) e renderiza os objetos do Kubernetes.

O Contour é um controlador de ingress nativo do Kubernetes. O seu plano de controle observa os recursos Ingress e HTTPProxy do cluster e programa um plano de dados Envoy, que termina o tráfego HTTP e HTTPS dos clientes e o balanceia para os serviços de back-end que esses recursos nomeiam. A sua entrada de roteamento são os próprios objetos Ingress do cluster — não um upstream ligado —, então o gateway não recebe nenhuma aresta uses. As aplicações o alcançam declarando recursos Ingress para a sua classe de ingress. Pelo mesmo motivo ele não tem uma forma autônoma em contêiner local, então esta família traz apenas uma Recipe do Helm; não há destino do Compose.

Arquivos

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: um único componente gateway (core/gateway/contour) que nomeia a classe de ingress que ele reconcilia.
manifest.yamlMapeia o tipo de gateway para a Recipe do Helm project-contour (contour).
release.yamlDocumento do operador para o destino Kubernetes: a porta do serviço do Envoy e o dimensionamento do plano de controle e do plano de dados.

O que ele demonstra

  • Uma única superfície de autoria, realizada por uma Recipe de Ops. O Aggregate é a fonte da verdade sobre o que o gateway é. O Manifest diz como realizá-lo, mapeando o tipo de gateway para uma Recipe pelo nome; a Release fornece o dimensionamento operacional. A intenção do desenvolvedor e o mapeamento de Ops ficam separados.
  • Plano de controle e plano de dados a partir de um único componente. A Recipe renderiza as duas metades do controlador de ingress: um Deployment para o plano de controle do Contour e um DaemonSet para o plano de dados do Envoy, conectados entre si pelo chart.
  • Propriedade da classe de ingress. O valor ingress_class_name do desenvolvedor flui para o chart, que cria uma IngressClass com esse nome. As aplicações roteiam para o gateway referenciando essa classe nos seus recursos Ingress.
  • Gerenciamento de CRDs. O Contour instala e gerencia as suas próprias CustomResourceDefinitions (a sua família HTTPProxy). A Recipe deixa o gerenciamento de CRDs ativado por padrão; desative-o por meio de infra.overrides.manage_crds quando as CRDs estiverem pré-instaladas.
  • Ponto de entrada do plano de dados. O Service do Envoy é exposto como LoadBalancer por padrão; o operador define a porta do serviço HTTP por meio de infra.port e pode mudar o tipo de serviço por meio de infra.overrides.service_type.
  • Imagens reproduzíveis. A Recipe fixa novamente as imagens do Contour e do Envoy em tags de release explícitas, para que as cargas de trabalho renderizadas referenciem versões fixadas.

Gerar o exemplo

Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.

Escreva o exemplo em uma nova pasta com o nome dele:

Terminal window
aggrega scaffold --example contour-gateway

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd contour-gateway

Build

Este espaço de trabalho não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Os artefatos renderizados ficam em dist/. O build resolve o chart upstream no aggrega pull e o fixa em um lockfile.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.

Use somente as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço de trabalho ainda não contém uma pasta `contour-gateway`, chame uma vez a ferramenta `scaffold` com `example` definido como `contour-gateway` e sem `dir`: ela grava o exemplo em uma nova pasta `contour-gateway`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `contour-gateway`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `contour-gateway/dist/`.

O que é renderizado

O build emite a stack completa do controlador de ingress:

  • um Deployment que executa o plano de controle do Contour,
  • um DaemonSet que executa o plano de dados do Envoy,
  • as CustomResourceDefinitions do Contour,
  • uma IngressClass chamada contour,
  • um Service LoadBalancer à frente do Envoy na porta HTTP 80 e na porta HTTPS 443,

junto com a ConfigMap de suporte, o Job de geração de certificados, o Service do plano de controle, a NetworkPolicy, o RBAC e a ServiceAccount. As imagens do Contour e do Envoy são fixadas nas suas tags de release, então toda carga de trabalho referencia uma tag de imagem fixada.