Valkey — satu Aggregate, dua target, autentikasi opsional
Contoh ringkas ini mengompilasi satu cache dalam memori Valkey (protokol wire Redis) dari satu Aggregate yang ditulis oleh Developer ke dua realisasi:
- Docker Compose untuk pengembangan lokal, dan
- Recipe helm hasil sintesis yang menjalankan image upstream resmi
valkey/valkeylangsung di Kubernetes (tanpa chart eksternal).
Recipe helm tersintesis adalah jalur Kubernetes: Recipe ini hanya bergantung pada tag image resmi, bukan chart pihak ketiga, dan kumpulan resource yang dirender persis sama dengan yang dideklarasikan workload.
aggregate.yaml yang sama menggerakkan keduanya. Hanya lapisan Recipe yang dipilih oleh Manifest yang berubah per realisasi. Dua Aggregates lainnya menunjukkan cache yang sama dengan kredensial kata sandi opsional terpasang: aggregate-auth.yaml untuk jalur Compose (kredensial inject-value yang digunakan untuk menjalankan server), dan aggregate-helm-synth-auth.yaml untuk jalur helm hasil sintesis (kredensial yang dapat direferensikan dan diwujudkan sebagai Secret Kubernetes).
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu komponen cache bertipe core/datastore/valkey, tanpa kredensial — cache berjalan tanpa autentikasi. |
aggregate-auth.yaml | Cache yang sama dengan kredensial kata sandi yang dilampirkan ke slot opsional password milik komponen (jalur Compose). |
aggregate-helm-synth-auth.yaml | Cache yang sama dengan kredensial referenceable yang dilampirkan untuk jalur helm tersintesis — nilainya diwujudkan sebagai Secret Kubernetes yang dirujuk oleh Deployment. |
manifest-compose.yaml | Memetakan tipe Valkey ke Recipe Compose (compose/valkey) dan kredensial ke dotenv-secret. |
manifest-helm-synth.yaml | Memetakan tipe Valkey ke Recipe helm hasil sintesis (helm/valkey) dan kredensial ke k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Catatan operator untuk kedua realisasi, tanpa autentikasi. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Catatan operator yang mengaktifkan autentikasi. |
Apa yang didemonstrasikan
- Satu permukaan penulisan, banyak target. Satu Aggregate menjadi sumber kebenaran tentang apa stack tersebut. Setiap Manifest menyatakan bagaimana merealisasikannya.
- Datastore berperan cache. Valkey di sini digunakan sebagai cache dalam memori dan
tidak menyimpan apa pun secara permanen, sehingga komponen diberi tipe
serverbiasa, bukanstateful-server. Di Kubernetes, Recipe helm hasil sintesis merender Deployment, bukan StatefulSet, dan tidak meminta volume persisten; di Compose, layanan tidak mendeklarasikan volume data. - Sintesis Workload (Kubernetes). Recipe helm hasil sintesis mendeklarasikan
sebuah Workload — Deployment beserta Service ClusterIP yang menjalankan image resmi
valkey/valkey— yang diterjemahkan oleh provider helm menjadi manifest Kubernetes tanpa chart eksternal. Kumpulan resource yang dirender persis sama dengan yang dideklarasikan Workload. Karena Recipe Compose dan Recipe helm hasil sintesis sama-sama bernamavalkey, Manifests mereferensikannya dengan cakupan provider sebagaicompose/valkeydanhelm/valkey. - Autentikasi opsional melalui slot kredensial. Komponen mendeklarasikan satu slot
passwordopsional dalamfeaturesSchema-nya. Jika tidak ada kredensial yang dipasang (Aggregate dasar), Recipe merender cache dengan autentikasi dinonaktifkan — identik byte demi byte dengan Recipe tanpa slot. Jika kredensial dipasang, kedua target menjalankan Valkey dengan--requirepass, sehingga server mewajibkan kata sandi: di Compose nilainya sampai ke server melalui variabelVALKEY_EXTRA_FLAGSmilik image; di Kubernetes jalur helm hasil sintesis mewujudkannya sebagai Secret yang direferensikan Deployment.
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 valkey-cacheKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd valkey-cacheBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/.
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 `valkey-cache`, panggil alat `scaffold` sekali dengan `example` diatur ke `valkey-cache` dan tanpa `dir`: alat ini menulis contoh ke folder `valkey-cache` yang baru. Lalu panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml`, dan `release-helm-synth-auth.yaml` — setiap kali dengan `workspace_root` diatur ke `valkey-cache`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh setiap build; file tersebut berada di bawah `valkey-cache/dist/`.Catatan pengiriman kredensial
Di jalur Compose, kredensial berupa secret inject-value (aggregate-auth.yaml): nilainya dikirim melalui pipa lingkungan komponen di bawah variabel yang disebut oleh values.key-nya, VALKEY_PASSWORD, dan Recipe menyerahkannya ke server sebagai --requirepass melalui variabel VALKEY_EXTRA_FLAGS milik image, sehingga nilai tersebut muncul di lingkungan service tetapi tidak di baris perintahnya. Skrip startup image mengekspansi variabel itu tanpa tanda kutip, sehingga kata sandi yang mengandung spasi menghentikan server saat start, dan kata sandi yang mengandung *, ?, atau [ dicocokkan dengan nama file di direktori data server, jadi tulislah kata sandi tanpa keduanya. Lampiran kata sandi yang nilainya sampai ke Recipe di bawah variabel yang tidak dibacanya menghentikan build dengan menyebut slot tersebut, alih-alih merender cache yang tidak terlindungi.
Jalur helm hasil sintesis menggunakan kredensial yang dapat direferensikan
(aggregate-helm-synth-auth.yaml): nilainya diwujudkan sebagai Secret Kubernetes,
Deployment mereferensikannya melalui env secretKeyRef, dan Valkey
dijalankan dengan --requirepass yang membaca variabel lingkungan tersebut. Karena itu, kata sandi
teks biasa tidak pernah muncul di manifest Deployment — hanya di
Secret. Inilah yang benar-benar mengaktifkan autentikasi pada image resmi
valkey/valkey, yang tidak membaca kata sandi dari lingkungan dengan
sendirinya.
Nilai origin dalam Aggregates yang terautentikasi adalah placeholder pengembangan;
berikan nilai sebenarnya melalui sumber kredensial Anda untuk deployment nyata apa pun.