İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlDeveloper niyeti: uzlaştırdığı ingress sınıfının adını veren tek bir gateway bileşeni (core/gateway/contour).
manifest.yamlAğ geçidi türünü project-contour Helm Recipe’ine (contour) eşler.
release.yamlKubernetes 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 Deployment ve Envoy veri düzlemi için bir DaemonSet; ikisi chart tarafından birbirine bağlanır.
  • Ingress sınıfı sahipliği. Geliştiricinin ingress_class_name değeri chart’a aktarılır ve chart bu adla bir IngressClass oluş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ı (HTTPProxy ailesini) kurar ve yönetir. Recipe, CRD yönetimini varsayılan olarak açık bırakır; CRD’ler önceden kuruluysa bunu infra.overrides.manage_crds üzerinden devre dışı bırakın.
  • Veri düzlemi giriş noktası. Envoy Service’i varsayılan olarak bir LoadBalancer olarak 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:

Terminal window
aggrega scaffold --example contour-gateway

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd contour-gateway

Derleme

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:

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

Oluş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ı,
  • contour adlı bir IngressClass,
  • Envoy’un önünde HTTP bağlantı noktası 80 ve HTTPS bağlantı noktası 443 üzerinde duran bir LoadBalancer Service,

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.