Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

BerkasPeran
aggregate.yamlMaksud developer: satu komponen gateway (core/gateway/contour) yang menyebutkan ingress class yang direkonsiliasinya.
manifest.yamlMemetakan tipe gateway ke Recipe Helm project-contour (contour).
release.yamlCatatan 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 Deployment untuk control plane Contour dan sebuah DaemonSet untuk data plane Envoy, yang disambungkan oleh chart.
  • Kepemilikan ingress class. Nilai ingress_class_name dari developer mengalir ke dalam chart, yang membuat IngressClass dengan nama tersebut. Aplikasi melakukan routing ke gateway dengan mereferensikan class tersebut dalam resource Ingress mereka.
  • Pengelolaan CRD. Contour memasang dan mengelola CustomResourceDefinition miliknya sendiri (famili HTTPProxy). Recipe membiarkan pengelolaan CRD aktif secara default; nonaktifkan melalui infra.overrides.manage_crds jika CRD sudah terpasang sebelumnya.
  • Titik masuk data plane. Service Envoy diekspos sebagai LoadBalancer secara default; operator mengatur port layanan HTTP melalui infra.port dan dapat mengubah tipe layanan melalui infra.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:

Terminal window
aggrega scaffold --example contour-gateway

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd contour-gateway

Build

Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:

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

Artefak 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 Deployment yang menjalankan control plane Contour,
  • sebuah DaemonSet yang menjalankan data plane Envoy,
  • CustomResourceDefinition milik Contour,
  • sebuah IngressClass bernama contour,
  • sebuah Service LoadBalancer di 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.