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
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente gateway (core/gateway/contour) que nomeia a classe de ingress que ele reconcilia. |
manifest.yaml | Mapeia o tipo de gateway para a Recipe do Helm project-contour (contour). |
release.yaml | Documento 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
Deploymentpara o plano de controle do Contour e umDaemonSetpara o plano de dados do Envoy, conectados entre si pelo chart. - Propriedade da classe de ingress. O valor
ingress_class_namedo desenvolvedor flui para o chart, que cria umaIngressClasscom 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íliaHTTPProxy). A Recipe deixa o gerenciamento de CRDs ativado por padrão; desative-o por meio deinfra.overrides.manage_crdsquando as CRDs estiverem pré-instaladas. - Ponto de entrada do plano de dados. O
Servicedo Envoy é exposto comoLoadBalancerpor padrão; o operador define a porta do serviço HTTP por meio deinfra.porte pode mudar o tipo de serviço por meio deinfra.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:
aggrega scaffold --example contour-gatewayEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd contour-gatewayBuild
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:
aggrega pull --release release.yamlaggrega build --release release.yamlOs 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
Deploymentque executa o plano de controle do Contour, - um
DaemonSetque executa o plano de dados do Envoy, - as
CustomResourceDefinitions do Contour, - uma
IngressClasschamadacontour, - um
ServiceLoadBalancerà 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.