Contour ağ geçidi — Kubernetes'e özgü bir ingress denetleyicisi
Bu örnek, küçük ama gerçek bir yığını — bir Contour ingress ağ geçidini — Developer’ın yazdığı tek bir Aggregate’ten Kubernetes’e derler. Geliştirici ağ geçidinin ne olduğunu bildirir; tek bir Ops Recipe’i bu niyeti resmî project-contour Helm chart’ına (projenin HTTPS chart deposundan sunulur) eşler ve Kubernetes nesnelerini oluşturur.
Contour, Kubernetes’e özgü bir ingress denetleyicisidir. Denetim düzlemi, kümenin Ingress ve HTTPProxy kaynaklarını izler ve bir Envoy veri düzlemini programlar; bu veri düzlemi istemcinin HTTP ve HTTPS trafiğini sonlandırır ve bu kaynakların adını verdiği arka uç hizmetlerine yük dengelemesiyle dağıtır. Yönlendirme girdisi, bağlanmış bir upstream değil, kümenin kendi Ingress nesneleridir; bu nedenle ağ geçidi hiçbir uses kenarı almaz. Uygulamalar, onun ingress sınıfına karşı Ingress kaynakları bildirerek ona ulaşır. Aynı nedenle bağımsız bir yerel konteyner biçimi yoktur; bu yüzden bu aile yalnızca bir Helm Recipe’i sunar ve Compose hedefi yoktur.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: uzlaştırdığı ingress sınıfının adını veren tek bir gateway bileşeni (core/gateway/contour). |
manifest.yaml | Ağ geçidi türünü project-contour Helm Recipe’ine (contour) eşler. |
release.yaml | Kubernetes hedefi için operatör kaydı: Envoy hizmet bağlantı noktası ile denetim düzlemi/veri düzlemi boyutlandırması. |
Neyi gösteriyor
- Bir Ops Recipe’iyle gerçekleştirilen tek bir yazma yüzeyi. Aggregate, ağ geçidinin ne olduğuna dair doğruluk kaynağıdır. Manifest, ağ geçidi türünü adıyla bir Recipe’e eşleyerek onun nasıl gerçekleştirileceğini söyler; Release ise operasyonel boyutlandırmayı sağlar. Developer niyeti ile Ops eşlemesi ayrı kalır.
- Tek bir bileşenden denetim düzlemi ve veri düzlemi. Recipe, ingress denetleyicisinin iki yarısını da oluşturur: Contour denetim düzlemi için bir
Deploymentve Envoy veri düzlemi için birDaemonSet; ikisi chart tarafından birbirine bağlanır. - Ingress sınıfı sahipliği. Geliştiricinin
ingress_class_namedeğeri chart’a aktarılır ve chart bu adla birIngressClassoluşturur. Uygulamalar, Ingress kaynaklarında bu sınıfa başvurarak ağ geçidine yönlendirme yapar. - CRD yönetimi. Contour kendi
CustomResourceDefinition’larını (HTTPProxyailesini) kurar ve yönetir. Recipe, CRD yönetimini varsayılan olarak açık bırakır; CRD’ler önceden kuruluysa bunuinfra.overrides.manage_crdsüzerinden devre dışı bırakın. - Veri düzlemi giriş noktası. Envoy
Service’i varsayılan olarak birLoadBalancerolarak sunulur; operatör HTTP hizmet bağlantı noktasınıinfra.portüzerinden ayarlar ve hizmet türünüinfra.overrides.service_typeüzerinden değiştirebilir. - Yeniden üretilebilir imajlar. Recipe, Contour ve Envoy imajlarını açık sürüm etiketlerine yeniden sabitler; böylece oluşturulan iş yükleri sabitlenmiş sürümlere başvurur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example contour-gatewayArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd contour-gatewayDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur:
aggrega pull --release release.yamlaggrega build --release release.yamlOluşturulan yapıtlar dist/ altına yerleşir. Derleme, upstream chart’ı aggrega pull sırasında çözümler ve bir kilit dosyasında sabitler.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `contour-gateway` klasörü yoksa `scaffold` aracını `example` değeri `contour-gateway` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `contour-gateway` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `contour-gateway`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `contour-gateway/dist/` altındadır.Neler oluşturulur
Derleme, ingress denetleyicisi yığınının tamamını üretir:
- Contour denetim düzlemini çalıştıran bir
Deployment, - Envoy veri düzlemini çalıştıran bir
DaemonSet, - Contour
CustomResourceDefinition’ları, contouradlı birIngressClass,- Envoy’un önünde HTTP bağlantı noktası 80 ve HTTPS bağlantı noktası 443 üzerinde duran bir
LoadBalancerService,
yanı sıra destekleyici ConfigMap, sertifika üretimi Job’ı, denetim düzleminin Service’i, NetworkPolicy, RBAC ve ServiceAccount. Contour ve Envoy imajları sürüm etiketlerine sabitlenir; böylece her iş yükü sabitlenmiş bir imaj etiketine başvurur.