RabbitMQ — satu Aggregate, dua target, autentikasi opsional
Contoh ini mengompilasi satu broker pesan RabbitMQ (AMQP) dari satu Aggregate yang ditulis oleh Developer ke dua target:
- Docker Compose untuk pengembangan lokal, dan
- Kubernetes, melalui Recipe helm hasil sintesis yang menjalankan image
upstream resmi
rabbitmqsecara langsung (sebuah StatefulSet dengan volume persisten, tanpa chart eksternal).
aggregate.yaml yang sama menggerakkan keduanya. Hanya lapisan Recipe yang dipilih oleh
Manifest yang berubah per target. Aggregate kedua, aggregate-helm-synth-auth.yaml,
menunjukkan broker yang sama di Kubernetes dengan kredensial kata sandi yang dapat direferensikan
terpasang.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu komponen broker bertipe core/messaging/rabbitmq, tanpa kredensial — Recipe menyediakan kata sandi pengembangan inline yang deterministik. |
aggregate-auth.yaml | Broker yang sama dengan kredensial kata sandi inject-value yang terpasang pada slot opsional password milik komponen (digunakan oleh target Compose). |
aggregate-helm-synth-auth.yaml | Broker yang sama dengan kredensial kata sandi yang dapat direferensikan terpasang, diwujudkan sebagai Secret Kubernetes dan direferensikan oleh StatefulSet (digunakan oleh target Kubernetes). |
manifest-compose.yaml | Memetakan tipe RabbitMQ ke Recipe Compose (compose/rabbitmq) dan kredensial ke dotenv-secret. |
manifest-helm-synth.yaml | Memetakan tipe RabbitMQ ke Recipe helm hasil sintesis (helm/rabbitmq) dan kredensial ke k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Rekaman Operator untuk kedua target, kata sandi pengembangan inline. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Rekaman Operator yang menyediakan kata sandi melalui slot kredensial. |
Referensi Recipe dalam Manifests dicakup per provider (compose/rabbitmq,
helm/rabbitmq) karena Recipe dengan nama yang sama ada untuk setiap provider.
Apa yang didemonstrasikan
- Satu permukaan penulisan, banyak target. Satu Aggregate menjadi sumber kebenaran tentang apa stack tersebut. Setiap Manifest menyatakan bagaimana merealisasikannya.
- Broker yang tahan lama. RabbitMQ menyimpan antrean dan pesan secara persisten, sehingga komponen
diberi tipe
stateful-server. Di Kubernetes, Recipe hasil sintesis merender sebuah StatefulSet dengan volume persisten per replika yang dipasang pada direktori data RabbitMQ serta Headless Service untuk identitas jaringan yang stabil; layanan Compose mengekspos broker untuk pengembangan lokal. - Sintesis tanpa chart (Kubernetes). Target Kubernetes menjalankan image resmi
rabbitmqsecara langsung. Compiler menyintesis StatefulSet, ClusterIP Service, dan Headless Service dari ukuraninframilik komponen — tanpa chart eksternal yang perlu diambil atau dilacak. Tag image disematkan melaluiinfra.engine_version, sehingga hasil render tidak memuat tag mengambang. - Kedua port broker. Image ini mengaktifkan manajemen, sehingga broker mengekspos port AMQP (5672) dan dasbor manajemen (15672) pada container dan pada ClusterIP Service.
- Kredensial deterministik. RabbitMQ selalu melakukan autentikasi. Jika tidak ada
kredensial yang terpasang, setiap Recipe menyediakan kata sandi pengembangan inline yang tetap
sehingga hasil render identik byte demi byte di setiap eksekusi. Jika kredensial
terpasang, nilai yang diinjeksikan menetapkan kata sandi broker: di Compose nilai itu menjadi
variabel lingkungan layanan
RABBITMQ_DEFAULT_PASS; di Kubernetes nilai itu diwujudkan sebagai Secret dan direferensikan oleh envsecretKeyRef, sehingga plaintext tidak pernah masuk ke manifest hasil render.
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 rabbitmq-brokerKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd rabbitmq-brokerBuild
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), inline development passwordaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline passwordaggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attachedaggrega 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 `rabbitmq-broker`, panggil alat `scaffold` sekali dengan `example` diatur ke `rabbitmq-broker` dan tanpa `dir`: alat ini menulis contoh ke folder `rabbitmq-broker` 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 `rabbitmq-broker`, `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 `rabbitmq-broker/dist/`.Catatan pengiriman kredensial
Di Compose, kredensial adalah secret inject-value: nilainya dikirimkan melalui
pipa lingkungan komponen dan menjadi variabel lingkungan layanan RABBITMQ_DEFAULT_PASS. Di Kubernetes, kredensial dapat direferensikan: kredensial
diwujudkan sebagai Secret Kubernetes, dan StatefulSet mereferensikannya melalui
env secretKeyRef, sehingga kata sandi plaintext tidak pernah muncul di manifest
workload. Nilai origin dalam Aggregates auth adalah placeholder
pengembangan; sediakan nilai sebenarnya melalui sumber kredensial Anda untuk deployment
sungguhan. Kata sandi pengembangan inline yang digunakan saat tidak ada kredensial yang terpasang
juga hanya untuk penggunaan lokal.