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

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

BerkasPeran
aggregate.yamlMaksud Developer: satu komponen bus bertipe core/messaging/nats, tanpa kredensial — server berjalan tanpa autentikasi.
aggregate-auth.yamlServer yang sama dengan kredensial kata sandi inject-value yang dipasang pada slot opsional password milik komponen (jalur Compose).
aggregate-helm-synth-auth.yamlServer yang sama dengan kredensial yang dapat dirujuk, dipasang untuk jalur helm tersintesis — nilainya diwujudkan sebagai Secret Kubernetes yang dirujuk oleh Deployment.
manifest-compose.yamlMemetakan tipe NATS ke Recipe Compose (compose/nats) dan kredensial ke dotenv-secret.
manifest-helm-synth.yamlMemetakan tipe NATS ke Recipe helm hasil sintesis (helm/nats) 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.
  • 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 bernama nats, Manifests mereferensikannya dengan cakupan provider sebagai compose/nats dan helm/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:

Terminal window
aggrega scaffold --example nats-messaging

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

Terminal window
cd nats-messaging

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