Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente gateway (core/gateway/contour) che nomina la ingress class che riconcilia.
manifest.yamlMappa il tipo di gateway sulla Recipe Helm project-contour (contour).
release.yamlDocumento 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 Deployment per il piano di controllo di Contour e un DaemonSet per il piano dati di Envoy, collegati tra loro dal chart.
  • Proprietà della ingress class. Il valore ingress_class_name dello sviluppatore confluisce nel chart, che crea una IngressClass con 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 famiglia HTTPProxy). La Recipe lascia attiva per impostazione predefinita la gestione delle CRD; disattivala tramite infra.overrides.manage_crds quando le CRD sono preinstallate.
  • Punto d’ingresso del piano dati. Il Service di Envoy è esposto come LoadBalancer per impostazione predefinita; l’operatore imposta la porta del servizio HTTP tramite infra.port e può cambiare il tipo di servizio tramite infra.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:

Terminal window
aggrega scaffold --example contour-gateway

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd contour-gateway

Build

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:

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

Gli 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 Deployment che esegue il piano di controllo di Contour,
  • un DaemonSet che esegue il piano dati di Envoy,
  • le CustomResourceDefinitions di Contour,
  • una IngressClass chiamata contour,
  • un Service LoadBalancer davanti 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.