NATS — satu Aggregate, dua target, autentikasi opsional
Contoh ini mengompilasi satu server perpesanan NATS (pub-sub, request-reply, antrean) 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
natslangsung di Kubernetes (tanpa chart eksternal).
Recipe helm tersintesis adalah jalur Kubernetes yang diutamakan: jalur 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 untuk setiap realisasi. Aggregate kedua, aggregate-auth.yaml,
menunjukkan server yang sama dengan kredensial kata sandi inject-value yang dipasang untuk
jalur Compose; aggregate-helm-synth-auth.yaml memasang kredensial yang dapat direferensikan
untuk jalur helm hasil sintesis.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu komponen bus bertipe core/messaging/nats, tanpa kredensial — server berjalan tanpa autentikasi. |
aggregate-auth.yaml | Server yang sama dengan kredensial kata sandi inject-value yang dipasang pada slot opsional password milik komponen (jalur Compose). |
aggregate-helm-synth-auth.yaml | Server yang sama dengan kredensial yang dapat dirujuk, dipasang untuk jalur helm tersintesis — nilainya diwujudkan sebagai Secret Kubernetes yang dirujuk oleh Deployment. |
manifest-compose.yaml | Memetakan tipe NATS ke Recipe Compose (compose/nats) dan kredensial ke dotenv-secret. |
manifest-helm-synth.yaml | Memetakan tipe NATS ke Recipe helm hasil sintesis (helm/nats) 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.
- Server perpesanan tanpa status. Dalam bentuk ramping ini, NATS merutekan subjek di
memori dengan penyimpanan file JetStream dinonaktifkan, sehingga komponen diberi tipe
server. Di Kubernetes, Recipe hasil sintesis merender satu Deployment dengan satu replika tanpa volume persisten; layanan Compose mengekspos server untuk pengembangan lokal. - Sintesis workload (Kubernetes). Recipe helm hasil sintesis mendeklarasikan sebuah
Workload — sebuah Deployment ditambah Service ClusterIP yang menjalankan image resmi
nats— 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 bernamanats, Manifests mereferensikannya dengan cakupan provider sebagaicompose/natsdanhelm/nats. - Autentikasi opsional, tetap deterministik. Autentikasi NATS nonaktif secara default. Jika tidak ada kredensial yang dipasang, kedua realisasi tidak mengaktifkan autentikasi dan hasil render identik byte demi byte di setiap eksekusi. Jika kredensial dipasang, nilai yang diinjeksikan mengaktifkan autentikasi user/password pada kedua realisasi.
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 nats-messagingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd nats-messagingBuild
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 `nats-messaging`, panggil alat `scaffold` sekali dengan `example` diatur ke `nats-messaging` dan tanpa `dir`: alat ini menulis contoh ke folder `nats-messaging` 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 `nats-messaging`, `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 `nats-messaging/dist/`.Catatan pengiriman kredensial
Pada jalur Compose, kredensial berupa secret inject-value
(aggregate-auth.yaml): nilainya dikirimkan melalui pipa lingkungan komponen
dan server dijalankan dengan flag autentikasi user/password.
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
server dijalankan dengan flag --user/--pass yang membaca variabel lingkungan
tersebut. Dengan demikian, kata sandi plaintext tidak pernah muncul di manifest
Deployment — hanya di Secret.
Nilai origin dalam Aggregates yang terautentikasi adalah placeholder pengembangan;
berikan nilai sebenarnya melalui sumber kredensial Anda untuk deployment nyata apa pun.