Gateway Contour — ingress controller native Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — sebuah gateway ingress Contour — dari
satu Aggregate yang ditulis oleh Developer ke Kubernetes. Developer mendeklarasikan apa
gateway tersebut; satu Recipe Ops memetakan maksud itu ke chart Helm resmi
project-contour (disajikan dari repositori chart HTTPS milik proyek tersebut)
dan merender objek-objek Kubernetes.
Contour adalah ingress controller native Kubernetes. Control plane-nya memantau resource
Ingress dan HTTPProxy milik cluster serta memprogram data plane Envoy,
yang mengakhiri lalu lintas HTTP dan HTTPS klien dan menyeimbangkan bebannya ke
layanan pendukung yang disebutkan oleh resource tersebut. Input routing-nya adalah objek Ingress
milik cluster itu sendiri — bukan upstream yang disambungkan — sehingga gateway tidak memiliki edge uses.
Aplikasi menjangkaunya dengan mendeklarasikan resource Ingress terhadap ingress class-nya.
Karena alasan yang sama, gateway ini tidak memiliki bentuk kontainer lokal mandiri, sehingga
famili ini hanya menyediakan Recipe Helm; tidak ada target Compose.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud developer: satu komponen gateway (core/gateway/contour) yang menyebutkan ingress class yang direkonsiliasinya. |
manifest.yaml | Memetakan tipe gateway ke Recipe Helm project-contour (contour). |
release.yaml | Catatan operator untuk target Kubernetes: port layanan Envoy dan ukuran control plane/data plane. |
Apa yang didemonstrasikan
- Satu permukaan penulisan, diwujudkan oleh Recipe Ops. Aggregate adalah sumber kebenaran tentang apa gateway tersebut. Manifest menyatakan bagaimana mewujudkannya dengan memetakan tipe gateway ke Recipe berdasarkan nama; Release menyediakan ukuran operasional. Maksud developer dan pemetaan Ops tetap terpisah.
- Control plane dan data plane dari satu komponen. Recipe merender kedua
bagian ingress controller: sebuah
Deploymentuntuk control plane Contour dan sebuahDaemonSetuntuk data plane Envoy, yang disambungkan oleh chart. - Kepemilikan ingress class. Nilai
ingress_class_namedari developer mengalir ke dalam chart, yang membuatIngressClassdengan nama tersebut. Aplikasi melakukan routing ke gateway dengan mereferensikan class tersebut dalam resource Ingress mereka. - Pengelolaan CRD. Contour memasang dan mengelola
CustomResourceDefinitionmiliknya sendiri (familiHTTPProxy). Recipe membiarkan pengelolaan CRD aktif secara default; nonaktifkan melaluiinfra.overrides.manage_crdsjika CRD sudah terpasang sebelumnya. - Titik masuk data plane.
ServiceEnvoy diekspos sebagaiLoadBalancersecara default; operator mengatur port layanan HTTP melaluiinfra.portdan dapat mengubah tipe layanan melaluiinfra.overrides.service_type. - Image yang dapat direproduksi. Recipe mem-pin ulang image Contour dan Envoy ke tag rilis eksplisit sehingga workload yang dirender mereferensikan versi yang di-pin.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example contour-gatewayKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd contour-gatewayBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:
aggrega pull --release release.yamlaggrega build --release release.yamlArtefak yang dirender ditempatkan di bawah dist/. Build me-resolve chart upstream pada
aggrega pull dan mem-pin-nya dalam lockfile.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `contour-gateway`, panggil alat `scaffold` sekali dengan `example` diatur ke `contour-gateway` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `contour-gateway` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `contour-gateway`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `contour-gateway/dist/`.Apa yang dirender
Build menghasilkan stack ingress controller lengkap:
- sebuah
Deploymentyang menjalankan control plane Contour, - sebuah
DaemonSetyang menjalankan data plane Envoy, CustomResourceDefinitionmilik Contour,- sebuah
IngressClassbernamacontour, - sebuah
ServiceLoadBalancerdi depan Envoy pada port HTTP 80 dan port HTTPS 443,
beserta ConfigMap pendukung, Job pembuatan sertifikat, Service milik control plane, NetworkPolicy, RBAC, dan ServiceAccount. Image Contour dan Envoy di-pin ke tag rilisnya, sehingga setiap workload mereferensikan tag image yang di-pin.