Gateway Contour — un ingress controller nativo di Kubernetes
Questo esempio compila uno stack piccolo e reale — un gateway di ingress Contour — da un unico Aggregate scritto dallo sviluppatore a Kubernetes. Lo sviluppatore dichiara che cosa è il gateway; un’unica Recipe Ops mappa quell’intento sul chart Helm ufficiale project-contour (servito dal repository di chart HTTPS del progetto) e renderizza gli oggetti Kubernetes.
Contour è un ingress controller nativo di Kubernetes. Il suo piano di controllo osserva le risorse Ingress e HTTPProxy del cluster e programma un piano dati Envoy, che termina il traffico HTTP e HTTPS dei client e lo bilancia verso i servizi di backend nominati da quelle risorse. Il suo input di instradamento sono gli oggetti Ingress del cluster stesso — non un upstream cablato — quindi il gateway non prende alcun arco uses. Le applicazioni lo raggiungono dichiarando risorse Ingress rispetto alla sua ingress class. Per lo stesso motivo non ha una forma autonoma in container locale, quindi questa famiglia include solo una Recipe Helm; non c’è alcuna destinazione Compose.
File
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente gateway (core/gateway/contour) che nomina la ingress class che riconcilia. |
manifest.yaml | Mappa il tipo di gateway sulla Recipe Helm project-contour (contour). |
release.yaml | Documento dell’operatore per la destinazione Kubernetes: la porta del servizio Envoy e il dimensionamento del piano di controllo e del piano dati. |
Che cosa dimostra
- Un’unica superficie di authoring, realizzata da una Recipe Ops. L’Aggregate è la fonte di verità per che cosa è il gateway. Il Manifest dice come realizzarlo mappando il tipo di gateway su una Recipe per nome; la Release fornisce il dimensionamento operativo. L’intento dello sviluppatore e la mappatura Ops restano separati.
- Piano di controllo e piano dati da un unico componente. La Recipe renderizza entrambe le metà dell’ingress controller: un
Deploymentper il piano di controllo di Contour e unDaemonSetper il piano dati di Envoy, collegati tra loro dal chart. - Proprietà della ingress class. Il valore
ingress_class_namedello sviluppatore confluisce nel chart, che crea unaIngressClasscon quel nome. Le applicazioni instradano verso il gateway facendo riferimento a quella classe nelle loro risorse Ingress. - Gestione delle CRD. Contour installa e gestisce le proprie
CustomResourceDefinitions (la sua famigliaHTTPProxy). La Recipe lascia attiva per impostazione predefinita la gestione delle CRD; disattivala tramiteinfra.overrides.manage_crdsquando le CRD sono preinstallate. - Punto d’ingresso del piano dati. Il
Servicedi Envoy è esposto comeLoadBalancerper impostazione predefinita; l’operatore imposta la porta del servizio HTTP tramiteinfra.porte può cambiare il tipo di servizio tramiteinfra.overrides.service_type. - Immagini riproducibili. La Recipe fissa di nuovo le immagini di Contour e di Envoy a tag di release espliciti, così che i carichi di lavoro renderizzati facciano riferimento a versioni fissate.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example contour-gatewayPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd contour-gatewayBuild
Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard si risolvono dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo:
aggrega pull --release release.yamlaggrega build --release release.yamlGli artefatti renderizzati finiscono sotto dist/. Il build risolve il chart upstream con aggrega pull e lo fissa in un lockfile.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `contour-gateway`, chiama una volta lo strumento `scaffold` con `example` impostato a `contour-gateway` e senza `dir`: scrive l’esempio in una nuova cartella `contour-gateway`. Poi chiama lo strumento `build` con `workspace_root` impostato a `contour-gateway`, `release` impostato a `release.yaml`, `auto_pull` impostato a true e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `contour-gateway/dist/`.Che cosa viene renderizzato
Il build emette l’intero stack dell’ingress controller:
- un
Deploymentche esegue il piano di controllo di Contour, - un
DaemonSetche esegue il piano dati di Envoy, - le
CustomResourceDefinitions di Contour, - una
IngressClasschiamatacontour, - un
ServiceLoadBalancerdavanti a Envoy sulla porta HTTP 80 e sulla porta HTTPS 443,
insieme alla ConfigMap di supporto, al Job di generazione dei certificati, al Service del piano di controllo, alla NetworkPolicy, a RBAC e al ServiceAccount. Le immagini di Contour e di Envoy sono fissate ai loro tag di release, quindi ogni carico di lavoro fa riferimento a un tag di immagine fissato.