Brama Contour — natywny dla Kubernetes kontroler ingress
Ten przykład kompiluje mały, rzeczywisty stos — bramę ingress Contour — z
jednej encji Aggregate napisanej przez dewelopera do Kubernetes. Deweloper deklaruje, czym
jest brama; jedna encja Recipe zespołu Ops odwzorowuje tę intencję na oficjalny
chart Helm project-contour (udostępniany z repozytorium chartów projektu przez HTTPS)
i renderuje obiekty Kubernetes.
Contour to natywny dla Kubernetes kontroler ingress. Jego płaszczyzna sterowania obserwuje
zasoby Ingress i HTTPProxy klastra i programuje płaszczyznę danych Envoy,
która kończy ruch HTTP i HTTPS klientów i rozkłada go na
usługi docelowe wskazane przez te zasoby. Jego wejściem routingu są własne obiekty Ingress
klastra — a nie podłączony upstream — dlatego brama nie ma krawędzi uses.
Aplikacje docierają do niej, deklarując zasoby Ingress dla jej klasy ingress.
Z tego samego powodu nie ma ona samodzielnej formy lokalnego kontenera, więc ta
rodzina dostarcza wyłącznie encję Recipe dla Helm; nie ma celu Compose.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja dewelopera: pojedynczy komponent gateway (core/gateway/contour), który określa klasę ingress, którą uzgadnia. |
manifest.yaml | Odwzorowuje typ bramy na encję Recipe dla Helm project-contour (contour). |
release.yaml | Rekord operatora dla celu Kubernetes: port usługi Envoy oraz wymiarowanie płaszczyzny sterowania i płaszczyzny danych. |
Co demonstruje
- Jedna powierzchnia tworzenia, realizowana przez encję Recipe zespołu Ops. Encja Aggregate jest źródłem prawdy o tym, czym jest brama. Encja Manifest mówi, jak ją zrealizować, odwzorowując typ bramy na encję Recipe po nazwie; encja Release dostarcza wymiarowanie operacyjne. Intencja dewelopera i odwzorowanie Ops pozostają rozdzielone.
- Płaszczyzna sterowania i płaszczyzna danych z jednego komponentu. Encja Recipe renderuje obie
połowy kontrolera ingress:
Deploymentdla płaszczyzny sterowania Contour iDaemonSetdla płaszczyzny danych Envoy, połączone ze sobą przez chart. - Własność klasy ingress. Wartość
ingress_class_namedewelopera trafia do chartu, który tworzyIngressClasso tej nazwie. Aplikacje kierują ruch do bramy, odwołując się do tej klasy w swoich zasobach Ingress. - Zarządzanie CRD. Contour instaluje własne zasoby
CustomResourceDefinition(rodzinęHTTPProxy) i nimi zarządza. Encja Recipe domyślnie pozostawia zarządzanie CRD włączone; można je wyłączyć przezinfra.overrides.manage_crds, gdy CRD są zainstalowane wcześniej. - Punkt wejścia płaszczyzny danych.
ServiceEnvoy jest domyślnie wystawiany jakoLoadBalancer; operator ustawia port usługi HTTP przezinfra.porti może zmienić typ usługi przezinfra.overrides.service_type. - Odtwarzalne obrazy. Encja Recipe ponownie przypina obrazy Contour i Envoy do jawnych tagów wydań, dzięki czemu renderowane obciążenia odwołują się do przypiętych wersji.
Generowanie przykładu
Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example contour-gatewayNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd contour-gatewayKompilacja
Ta przestrzeń robocza nie zawiera pliku .aggrega-config.yaml, więc encje biblioteki standardowej są rozwiązywane z rejestru hub, hub.aggrega.ai, i flaga katalogu nie jest potrzebna:
aggrega pull --release release.yamlaggrega build --release release.yamlWyrenderowane artefakty trafiają do dist/. Kompilacja rozwiązuje chart upstream przy
aggrega pull i przypina go w pliku blokady.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `contour-gateway`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `contour-gateway` i bez `dir`: zapisuje ono przykład w nowym folderze `contour-gateway`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `contour-gateway`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, które pliki zapisała kompilacja; znajdują się w `contour-gateway/dist/`.Co jest renderowane
Kompilacja emituje pełny stos kontrolera ingress:
Deploymenturuchamiający płaszczyznę sterowania Contour,DaemonSeturuchamiający płaszczyznę danych Envoy,- zasoby
CustomResourceDefinitionContour, IngressClasso nazwiecontour,LoadBalancerServiceudostępniający Envoy na porcie HTTP 80 i porcie HTTPS 443,
wraz z pomocniczymi zasobami: ConfigMap, Job generującym certyfikaty, Service płaszczyzny sterowania, NetworkPolicy, RBAC i ServiceAccount. Obrazy Contour i Envoy są przypięte do swoich tagów wydań, więc każde obciążenie odwołuje się do przypiętego tagu obrazu.