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

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 rabbitmq secara 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

BerkasPeran
aggregate.yamlMaksud Developer: satu komponen broker bertipe core/messaging/rabbitmq, tanpa kredensial — Recipe menyediakan kata sandi pengembangan inline yang deterministik.
aggregate-auth.yamlBroker yang sama dengan kredensial kata sandi inject-value yang terpasang pada slot opsional password milik komponen (digunakan oleh target Compose).
aggregate-helm-synth-auth.yamlBroker yang sama dengan kredensial kata sandi yang dapat direferensikan terpasang, diwujudkan sebagai Secret Kubernetes dan direferensikan oleh StatefulSet (digunakan oleh target Kubernetes).
manifest-compose.yamlMemetakan tipe RabbitMQ ke Recipe Compose (compose/rabbitmq) dan kredensial ke dotenv-secret.
manifest-helm-synth.yamlMemetakan tipe RabbitMQ ke Recipe helm hasil sintesis (helm/rabbitmq) dan kredensial ke k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlRekaman Operator untuk kedua target, kata sandi pengembangan inline.
release-compose-auth.yaml / release-helm-synth-auth.yamlRekaman 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 rabbitmq secara langsung. Compiler menyintesis StatefulSet, ClusterIP Service, dan Headless Service dari ukuran infra milik komponen — tanpa chart eksternal yang perlu diambil atau dilacak. Tag image disematkan melalui infra.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 env secretKeyRef, 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:

Terminal window
aggrega scaffold --example rabbitmq-broker

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

Terminal window
cd rabbitmq-broker

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), inline development password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attached
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 `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.