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

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

BerkasPeran
aggregate.yamlMaksud developer: satu komponen secrets (core/security/openbao) dengan UI web bawaan diaktifkan.
manifest.yamlMemetakan tipe komponen ke Recipe bersumber resmi (openbao).
release.yamlCatatan 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_enabled milik 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 PersistentVolumeClaim yang di-mount di /openbao/data, dengan ukuran sesuai storage.size dari 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:

Terminal window
aggrega scaffold --example openbao-secrets

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

Terminal window
cd openbao-secrets

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 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 StatefulSet untuk server OpenBao,
  • sebuah ConfigMap yang 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 ServiceAccount untuk pod server,
  • sebuah ClusterRoleBinding yang memberi server izin token-review yang digunakannya untuk mengautentikasi service account Kubernetes,
  • sebuah Pod helm.sh/hook: test yang 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.