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

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/valkey langsung 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

BerkasPeran
aggregate.yamlMaksud Developer: satu komponen cache bertipe core/datastore/valkey, 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 Valkey ke Recipe Compose (compose/valkey) dan kredensial ke dotenv-secret.
manifest-helm-synth.yamlMemetakan tipe Valkey ke Recipe helm hasil sintesis (helm/valkey) 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 cache. Valkey di sini digunakan sebagai cache dalam memori dan tidak menyimpan apa pun secara permanen, sehingga komponen diberi tipe server biasa, bukan stateful-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 bernama valkey, Manifests mereferensikannya dengan cakupan provider sebagai compose/valkey dan helm/valkey.
  • Autentikasi opsional melalui slot kredensial. Komponen mendeklarasikan satu slot password opsional dalam featuresSchema-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 variabel VALKEY_EXTRA_FLAGS milik 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:

Terminal window
aggrega scaffold --example valkey-cache

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

Terminal window
cd valkey-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 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.