Redis — satu Aggregate, dua target, autentikasi opsional
Contoh ringkas ini mengompilasi satu cache dalam memori Redis (protokol wire Redis) dari satu Aggregate yang ditulis oleh Developer menjadi dua realisasi:
- Docker Compose untuk pengembangan lokal, dan
- Recipe helm yang disintesis yang menjalankan image upstream resmi
redislangsung di Kubernetes (tanpa chart eksternal).
Recipe helm yang disintesis adalah jalur Kubernetes: Recipe ini hanya bergantung pada tag image resmi, bukan pada chart pihak ketiga, dan kumpulan resource yang dirender persis sama dengan yang dideklarasikan oleh workload.
aggregate.yaml yang sama menggerakkan keduanya. Hanya lapisan Recipe yang dipilih oleh
Manifest yang berubah untuk setiap realisasi. Aggregate kedua, aggregate-auth.yaml,
menunjukkan cache yang sama dengan kredensial kata sandi opsional yang dilampirkan untuk
jalur Compose; aggregate-helm-synth-auth.yaml melampirkan
kredensial yang dapat direferensikan untuk jalur helm yang disintesis.
Recipes Redis dari katalog yang dipetakan contoh ini, compose/redis dan helm/redis, mendeklarasikan lisensi AGPL-3.0. Contoh valkey-cache men-deploy Valkey, yang menggunakan protokol wire yang sama; Recipe helm/valkey-nya mendeklarasikan BSD-3-Clause.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu komponen cache bertipe core/datastore/redis, 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 Redis ke Recipe Compose (compose/redis) dan kredensial ke dotenv-secret. |
manifest-helm-synth.yaml | Memetakan tipe Redis ke Recipe helm yang disintesis (helm/redis) 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 sebagai cache. Redis di sini digunakan sebagai cache dalam memori dan
tidak menyimpan apa pun secara permanen, sehingga komponen ini bertipe
serverbiasa, bukanstateful-server. Di Kubernetes, Recipe yang disintesis merender sebuah Deployment, bukan StatefulSet, dan tidak meminta persistent volume; di Compose, service tidak mendeklarasikan volume data. - Sintesis Workload (Kubernetes). Recipe helm yang disintesis mendeklarasikan sebuah
Workload — sebuah Deployment ditambah Service ClusterIP yang menjalankan image resmi
redis— yang diterjemahkan oleh provider helm menjadi manifest Kubernetes tanpa chart eksternal. Kumpulan resource yang dirender persis sama dengan yang dideklarasikan oleh Workload. Karena Recipe Compose dan Recipe helm yang disintesis sama-sama bernamaredis, Manifests mereferensikannya dengan cakupan provider sebagaicompose/redisdanhelm/redis. - Autentikasi opsional melalui slot kredensial. Komponen mendeklarasikan satu slot opsional
passworddalamfeaturesSchemamiliknya. Jika tidak ada kredensial yang dilampirkan (Aggregate dasar), Recipe merender cache dengan autentikasi dinonaktifkan — identik byte demi byte dengan Recipe tanpa slot. Jika kredensial dilampirkan, kedua target menjalankan Redis dengan--requirepass, sehingga server mewajibkan kata sandi: di Compose (aggregate-auth.yaml) nilainya diteruskan ke server sebagai argumen tersebut; di jalur Kubernetes yang disintesis (aggregate-helm-synth-auth.yaml) nilai tersebut diwujudkan sebagai Secret yang direferensikan oleh 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 redis-cacheKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd redis-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 Workspace belum berisi folder `redis-cache`, panggil alat `scaffold` sekali dengan `example` diatur ke `redis-cache` dan tanpa `dir`: alat ini menulis contoh ke folder `redis-cache` yang baru. Kemudian 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 `redis-cache`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file apa saja yang ditulis setiap build; file-file itu ada di bawah `redis-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, REDIS_PASSWORD, dan Recipe menyerahkannya ke server sebagai --requirepass. Image redis resmi tidak membaca variabel kata sandi apa pun, sehingga nilainya diteruskan sebagai argumen dan terlihat di perintah service. Lampiran yang nilainya sampai ke Recipe di bawah variabel yang tidak dibacanya menghentikan build dengan menyebut slot tersebut, alih-alih membiarkan cache terbuka.
Jalur helm yang disintesis menggunakan kredensial yang dapat direferensikan
(aggregate-helm-synth-auth.yaml): nilainya diwujudkan sebagai Secret
Kubernetes, Deployment mereferensikannya melalui env secretKeyRef, dan Redis
dijalankan dengan --requirepass yang membaca variabel lingkungan tersebut. Dengan demikian,
kata sandi plaintext tidak pernah muncul di manifest Deployment — hanya di
Secret. Inilah yang benar-benar mengaktifkan autentikasi pada image resmi redis,
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.