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
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu component cert-manager (core/security/cert-manager) dengan instalasi CRD diaktifkan. |
manifest.yaml | Memetakan tipe component ke Recipe Helm cert-manager (cert-manager). |
release.yaml | Catatan 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
Deploymentuntuk controller yang merekonsiliasi permintaan sertifikat, sebuahDeploymentuntuk webhook yang memvalidasi dan memberi nilai default pada custom resource, dan sebuahDeploymentuntuk CA injector yang menghubungkan bundel CA milik webhook ke dalam kluster. - Instalasi API sertifikat. Nilai
install_crdsmilik developer mengalir ke dalam chart, yang menginstalCustomResourceDefinitioncert-manager (resourceCertificate,Issuer,ClusterIssuer, sertaOrder/ChallengeACME). Setel ke false jika CRD dikelola di luar alur ini. - Penghubungan admission. Chart menghasilkan
ValidatingWebhookConfigurationdanMutatingWebhookConfigurationyang dilayani webhook,Servicewebhook, serta set RBAC lengkap — satuClusterRole/ClusterRoleBindinguntuk setiap tanggung jawab controller ditambahRoleuntuk 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:
aggrega scaffold --example cert-manager-tlsKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd cert-manager-tlsBuild
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 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.