OpenBao — server manajemen rahasia Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — satu server rahasia OpenBao — dari satu Aggregate yang ditulis oleh Developer ke Kubernetes, dengan dukungan
chart Helm resmi OpenBao.
OpenBao menyimpan, membuat, dan mengendalikan akses ke token, kata sandi, sertifikat, dan rahasia lainnya di balik API HTTP yang terautentikasi, serta mengenkripsi statusnya saat diam pada volume data yang tahan lama. Di sini OpenBao berjalan sebagai satu server mandiri yang menyimpan statusnya di backend penyimpanan file bawaan, sehingga dirender sebagai server berjalan yang memiliki status dan didukung oleh volume persisten, bukan sumber daya cloud terkelola. Server diinisialisasi dan di-unseal saat runtime di dalam kluster — token root dan kunci unseal-nya dihasilkan oleh server yang berjalan setelah server dimulai — sehingga tidak ada kredensial yang dideklarasikan dalam Aggregate dan tidak ada rahasia yang dimaterialisasi saat build.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud developer: satu komponen secrets (core/security/openbao) dengan UI web bawaan diaktifkan. |
manifest.yaml | Memetakan tipe komponen ke Recipe bersumber resmi (openbao). |
release.yaml | Catatan operator untuk target Kubernetes: ukuran komputasi server dan ukuran volume data. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate adalah sumber kebenaran tentang apa server rahasia itu; Manifest menyatakan bagaimana mewujudkannya.
- Nilai dari developer mengalir ke hasil render. Nilai
ui_enabledmilik developer ditulis ke konfigurasi server yang di-mount oleh chart, dan mengatur aktif tidaknya UI web bawaan. - Server yang memiliki status pada volume persisten. Recipe bersumber
mengonfigurasi mode mandiri dengan backend penyimpanan file, sehingga server menyimpan
status terenkripsinya pada
PersistentVolumeClaimyang di-mount di/openbao/data, dengan ukuran sesuaistorage.sizedari operator. - Tanpa kredensial saat render. OpenBao menginisialisasi dan meng-unseal dirinya sendiri saat
runtime, sehingga build tidak menyambungkan kredensial apa pun dan tidak menghasilkan
Secret. Keluaran yang dirender identik byte demi byte di setiap eksekusi dengan masukan yang sama. - Image yang dapat direproduksi. Recipe mematok image server ke tag rilis yang dapat di-resolve (
quay.io/openbao/openbao:2.5.5), sehingga workload yang dirender merujuk ke versi yang dipatok.
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 openbao-secretsKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd openbao-secretsBuild
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 Workspace belum berisi folder `openbao-secrets`, panggil alat `scaffold` sekali dengan `example` diatur ke `openbao-secrets` dan tanpa `dir`: alat ini menulis contoh ke folder `openbao-secrets` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `openbao-secrets`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file apa saja yang ditulis build tersebut; file-file itu ada di bawah `openbao-secrets/dist/`.Apa yang dirender
Build menghasilkan stack OpenBao ramping dengan satu workload sebagai tujuh objek Kubernetes:
- sebuah
StatefulSetuntuk server OpenBao, - sebuah
ConfigMapyang membawa konfigurasi server (backend penyimpanan file dan listener API), - dua
Service— service API utama dan service headless internal yang digunakan StatefulSet untuk jaringan pod yang stabil, - sebuah
ServiceAccountuntuk pod server, - sebuah
ClusterRoleBindingyang memberi server izin token-review yang digunakannya untuk mengautentikasi service account Kubernetes, - sebuah
Podhelm.sh/hook: testyang memeriksa kesiapan server.
Tidak ada CustomResourceDefinition — OpenBao adalah server yang berdiri sendiri, bukan controller yang memperluas API kluster. Image server dipatok ke tag rilisnya, sehingga workload merujuk ke tag image yang dipatok.