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

cert-manager — pengendali siklus hidup sertifikat TLS Kubernetes

Contoh ini mengompilasi sebuah stack kecil yang nyata — pengendali sertifikat cert-manager — dari satu Aggregate yang ditulis oleh Developer ke Kubernetes. Developer mendeklarasikan apa itu cert-manager; satu Recipe Ops memetakan maksud tersebut ke chart Helm resmi cert-manager dari registri jetstack dan merender objek-objek Kubernetes.

cert-manager adalah add-on Kubernetes berlingkup kluster yang mengotomatiskan penerbitan dan pembaruan sertifikat X.509 dari sumber penerbit seperti ACME (Let’s Encrypt), CA privat, atau Vault. Add-on ini memperluas kluster dengan custom resource Certificate, Issuer, dan ClusterIssuer miliknya sendiri. Aplikasi meminta sertifikat dengan mendeklarasikan resource tersebut — bukan dengan menghubungkan upstream — sehingga component ini tidak memiliki edge uses. Dengan alasan yang sama, component ini tidak memiliki bentuk kontainer lokal yang berdiri sendiri, sehingga keluarga ini hanya menyertakan Recipe Helm; tidak ada target Compose. Satu-satunya yang dipublikasikan component ini adalah lokasi tempat server Prometheus menemukan metriknya.

Berkas

BerkasPeran
aggregate.yamlMaksud Developer: satu component cert-manager (core/security/cert-manager) dengan instalasi CRD diaktifkan.
manifest.yamlMemetakan tipe component ke Recipe Helm cert-manager (cert-manager).
release.yamlCatatan operator untuk target Kubernetes: penentuan ukuran controller/webhook/CA-injector.

Apa yang didemonstrasikan

  • Satu permukaan penulisan, diwujudkan oleh Recipe Ops. Aggregate adalah sumber kebenaran tentang apa itu cert-manager. Manifest menyatakan bagaimana mewujudkannya dengan memetakan tipe component ke sebuah Recipe berdasarkan nama; Release menyediakan penentuan ukuran operasional. Maksud Developer dan pemetaan Ops tetap terpisah.
  • Tiga workload terkoordinasi dari satu component. Recipe merender ketiga bagian cert-manager: sebuah Deployment untuk controller yang merekonsiliasi permintaan sertifikat, sebuah Deployment untuk webhook yang memvalidasi dan memberi nilai default pada custom resource, dan sebuah Deployment untuk CA injector yang menghubungkan bundel CA milik webhook ke dalam kluster.
  • Instalasi API sertifikat. Nilai install_crds milik developer mengalir ke dalam chart, yang menginstal CustomResourceDefinition cert-manager (resource Certificate, Issuer, ClusterIssuer, serta Order/Challenge ACME). Setel ke false jika CRD dikelola di luar alur ini.
  • Penghubungan admission. Chart menghasilkan ValidatingWebhookConfiguration dan MutatingWebhookConfiguration yang dilayani webhook, Service webhook, serta set RBAC lengkap — satu ClusterRole/ClusterRoleBinding untuk setiap tanggung jawab controller ditambah Role untuk leader-election — sehingga controller memiliki izin yang dibutuhkannya.
  • Image yang dapat direproduksi. Chart menyertakan tag rilis yang dapat di-resolve; Recipe mem-pin ulang image controller, webhook, CA-injector, dan ACME solver ke tag tersebut sehingga workload yang dirender merujuk ke 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 cert-manager-tls

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

Terminal window
cd cert-manager-tls

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 melalui referensi OCI saat aggrega pull dan mem-pin-nya dalam sebuah lockfile.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya tool Aggrega, dan jangan membuat folder apa pun sendiri. Jika folder workspace belum berisi folder `cert-manager-tls`, panggil tool `scaffold` sekali dengan `example` diatur ke `cert-manager-tls` dan tanpa `dir`: tool itu menulis contoh ke folder baru `cert-manager-tls`. Lalu panggil tool `build` dengan `workspace_root` diatur ke `cert-manager-tls`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana saja yang ditulis build; file-file itu berada di bawah `cert-manager-tls/dist/`.

Apa yang dirender

Build menghasilkan stack cert-manager lengkap — tiga Deployment (controller, webhook, dan CA injector), enam CustomResourceDefinition cert-manager ketika install_crds diaktifkan, sebuah ValidatingWebhookConfiguration dan sebuah MutatingWebhookConfiguration, Service webhook, ServiceAccount controller, serta set RBAC berupa ClusterRole, ClusterRoleBinding, dan Role serta RoleBinding untuk leader-election. Build juga menyertakan sebuah Job pasca-instalasi (pemeriksaan API saat startup yang menunggu hingga API sertifikat siap melayani) dan sebuah Service metrik masing-masing untuk controller dan CA injector — total 50 objek Kubernetes. Image controller, webhook, CA-injector, dan ACME-solver di-pin ke tag rilisnya, sehingga setiap workload merujuk ke tag image yang di-pin.