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 programador, para o Kubernetes. O programador declara o que é o gateway; uma única Recipe de Ops mapeia essa intenção para o chart oficial do Helm 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 controlo 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 distribui pelos serviços de back-end que esses recursos nomeiam. A sua entrada de encaminhamento são os próprios objetos Ingress do cluster — não um upstream ligado —, pelo que o gateway não recebe nenhuma aresta uses. As aplicações alcançam-no declarando recursos Ingress para a sua classe de ingress. Pelo mesmo motivo, não tem uma forma autónoma em contentor local, pelo que esta família inclui apenas uma Recipe do Helm; não há destino do Compose.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: um único componente gateway (core/gateway/contour) que nomeia a classe de ingress que 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 controlo e do plano de dados. |
O que demonstra
- Uma única superfície de autoria, realizada por uma Recipe de Ops. O Aggregate é a fonte de 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 programador e o mapeamento de Ops mantêm-se separados.
- Plano de controlo 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 controlo do Contour e umDaemonSetpara o plano de dados do Envoy, ligados entre si pelo chart. - Propriedade da classe de ingress. O valor
ingress_class_namedo programador flui para o chart, que cria umaIngressClasscom esse nome. As aplicações encaminham para o gateway referenciando essa classe nos seus recursos Ingress. - Gestão de CRDs. O Contour instala e gere as suas próprias
CustomResourceDefinitions (a sua famíliaHTTPProxy). A Recipe deixa a gestão de CRDs ativada por predefinição; desative-se através deinfra.overrides.manage_crdsquando as CRDs estiverem pré-instaladas. - Ponto de entrada do plano de dados. O
Servicedo Envoy é exposto comoLoadBalancerpor predefinição; o operador define a porta do serviço HTTP através deinfra.porte pode mudar o tipo de serviço através deinfra.overrides.service_type. - Imagens reproduzíveis. A Recipe volta a fixar 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
É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example contour-gatewayDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd contour-gatewayCompilação
Este espaço de trabalho não inclui nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefactos renderizados ficam em dist/. A compilação resolve o chart upstream no aggrega pull e fixa-o num lockfile.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por si. Se a pasta da área de trabalho ainda não contiver uma pasta `contour-gateway`, chame uma vez a ferramenta `scaffold` com `example` definido como `contour-gateway` e sem `dir`: esta escreve o exemplo numa 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. Indique-me que ficheiros o build escreveu; encontram-se em `contour-gateway/dist/`.O que é renderizado
A compilação emite a stack completa do controlador de ingress:
- um
Deploymentque executa o plano de controlo 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,
juntamente com a ConfigMap de suporte, o Job de geração de certificados, o Service do plano de controlo, a NetworkPolicy, o RBAC e a ServiceAccount. As imagens do Contour e do Envoy estão fixadas nas suas tags de release, pelo que todas as cargas de trabalho referenciam uma tag de imagem fixada.