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

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

BerkasPeran
aggregate.yamlIntent Developer: satu komponen external-secrets (core/security/external-secrets) yang memasang custom resource definition bersama rilisnya.
manifest.yamlMemetakan tipe komponen ke Recipe resmi bersumber (external-secrets).
release.yamlCatatan 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_crds milik developer ditulis ke nilai installCRDs milik 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 uses dan 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:

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

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 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 CustomResourceDefinition untuk 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, beberapa ClusterRoleBinding, satu Role, dan satu RoleBinding,
  • tiga ServiceAccount, satu per workload,
  • satu Service untuk webhook,
  • dua ValidatingWebhookConfiguration,
  • satu Secret placeholder 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.