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

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 redis langsung 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

BerkasPeran
aggregate.yamlMaksud Developer: satu komponen cache bertipe core/datastore/redis, tanpa kredensial — cache berjalan tanpa autentikasi.
aggregate-auth.yamlCache yang sama dengan kredensial kata sandi yang dilampirkan ke slot opsional password milik komponen (jalur Compose).
aggregate-helm-synth-auth.yamlCache yang sama dengan kredensial referenceable yang dilampirkan untuk jalur helm tersintesis — nilainya diwujudkan sebagai Secret Kubernetes yang dirujuk oleh Deployment.
manifest-compose.yamlMemetakan tipe Redis ke Recipe Compose (compose/redis) dan kredensial ke dotenv-secret.
manifest-helm-synth.yamlMemetakan tipe Redis ke Recipe helm yang disintesis (helm/redis) dan kredensial ke k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlCatatan operator untuk kedua realisasi, tanpa autentikasi.
release-compose-auth.yaml / release-helm-synth-auth.yamlCatatan 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 server biasa, bukan stateful-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 bernama redis, Manifests mereferensikannya dengan cakupan provider sebagai compose/redis dan helm/redis.
  • Autentikasi opsional melalui slot kredensial. Komponen mendeklarasikan satu slot opsional password dalam featuresSchema miliknya. 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:

Terminal window
aggrega scaffold --example redis-cache

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

Terminal window
cd redis-cache

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; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:

Terminal window
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

Artefak 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.