external-secrets — operator sinkronisasi secret Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — operator external-secrets —
dari satu Aggregate yang ditulis oleh Developer ke Kubernetes, dengan dukungan Helm chart
resmi external-secrets.
external-secrets menyinkronkan materi rahasia dari sistem manajemen secret eksternal
— HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key
Vault, dan lainnya — ke dalam Secret Kubernetes native, dan menjaganya tetap sinkron saat
sumbernya berubah. Ini adalah controller berlingkup cluster yang memperluas API cluster
dengan custom resource miliknya sendiri, bukan server yang menjadi tujuan rute aplikasi, sehingga
tidak mengambil edge uses, dan satu-satunya yang dipublikasikannya adalah lokasi tempat server Prometheus menemukan
metriknya: aplikasi memperoleh secret-nya dengan mendeklarasikan resource ExternalSecret dan
SecretStore, lalu operator mewujudkan Secret Kubernetes
yang sesuai.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: satu komponen external-secrets (core/security/external-secrets) yang memasang custom resource definition bersama rilisnya. |
manifest.yaml | Memetakan tipe komponen ke Recipe resmi bersumber (external-secrets). |
release.yaml | Catatan operator untuk target Kubernetes: ukuran komputasi operator. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate adalah sumber kebenaran untuk apa operator itu; Manifest menyatakan bagaimana mewujudkannya.
- Nilai dari developer mengalir ke hasil render. Nilai
install_crdsmilik developer ditulis ke nilaiinstallCRDsmilik chart, sehingga custom resource definition external-secrets masuk ke cluster bersama rilisnya. - Controller yang memperluas cluster, tanpa edge topologi. external-secrets menambahkan
custom resource miliknya sendiri ke API cluster; konsumen meminta secret dengan
mendeklarasikan resource tersebut, sehingga komponen tidak memasang edge
usesdan tidak mengekspor apa pun selain lokasi metriknya. - Satu operator yang koheren. Chart merender controller, webhook, dan certificate controller sebagai satu operator; subchart provider bawaan dinonaktifkan, sehingga tidak ada datastore, cache, atau broker asing yang ikut ditarik. Keluaran hasil render identik byte demi byte di setiap eksekusi dengan input yang sama.
- Image yang dapat direproduksi. Recipe menyematkan ketiga container image ke tag rilis yang dapat di-resolve (
ghcr.io/external-secrets/external-secrets:v2.7.0), sehingga workload hasil render merujuk ke versi yang disematkan.
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 external-secrets-operatorKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd external-secrets-operatorBuild
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 alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `external-secrets-operator`, panggil alat `scaffold` sekali dengan `example` diatur ke `external-secrets-operator` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `external-secrets-operator` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `external-secrets-operator`, `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 `external-secrets-operator/dist/`.Apa yang dirender
Build menghasilkan operator external-secrets sebagai sekumpulan objek Kubernetes:
- 24
CustomResourceDefinitionuntuk API external-secrets (ExternalSecret,SecretStore,ClusterSecretStore, serta resource push dan generator terkait), - tiga
Deployment— controller, webhook, dan certificate controller, - RBAC yang mengikat semuanya: beberapa
ClusterRole, beberapaClusterRoleBinding, satuRole, dan satuRoleBinding, - tiga
ServiceAccount, satu per workload, - satu
Serviceuntuk webhook, - dua
ValidatingWebhookConfiguration, - satu
Secretplaceholder yang diisi oleh certificate controller dengan sertifikat serving webhook saat runtime.
Ketiga container image disematkan ke tag rilisnya, sehingga workload merujuk ke image yang disematkan.