RabbitMQ — bir Aggregate, iki hedef, isteğe bağlı kimlik doğrulama
Bu örnek, tek bir RabbitMQ ileti aracısını (AMQP), geliştiricinin yazdığı tek bir Aggregate’ten iki hedefe derler:
- yerel geliştirme için Docker Compose ve
- resmî upstream
rabbitmqimajını doğrudan çalıştıran sentezlenmiş helm Recipe’i aracılığıyla Kubernetes (kalıcı birime sahip bir StatefulSet, harici chart yok).
Aynı aggregate.yaml her ikisini de yönlendirir. Hedefe göre yalnızca
Manifest’in seçtiği Recipe katmanı değişir. İkinci bir Aggregate, aggregate-helm-synth-auth.yaml,
aynı aracıyı Kubernetes üzerinde, başvurulabilir bir parola kimlik bilgisi
eklenmiş olarak gösterir.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Geliştirici niyeti: core/messaging/rabbitmq türünde tek bir broker bileşeni, kimlik bilgisi yok — Recipe deterministik bir satır içi geliştirme parolası sağlar. |
aggregate-auth.yaml | Bileşenin isteğe bağlı password yuvasına inject-value parola kimlik bilgisi eklenmiş aynı aracı (Compose hedefi tarafından kullanılır). |
aggregate-helm-synth-auth.yaml | Başvurulabilir bir parola kimlik bilgisi eklenmiş, bir Kubernetes Secret olarak oluşturulan ve StatefulSet tarafından başvurulan aynı aracı (Kubernetes hedefi tarafından kullanılır). |
manifest-compose.yaml | RabbitMQ türünü Compose Recipe’ine (compose/rabbitmq), kimlik bilgisini ise dotenv-secret’e eşler. |
manifest-helm-synth.yaml | RabbitMQ türünü sentezlenmiş helm Recipe’ine (helm/rabbitmq), kimlik bilgisini ise k8s-secret-from-parameter’e eşler. |
release-compose.yaml / release-helm-synth.yaml | İki hedef için operatör kayıtları, satır içi geliştirme parolası. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Parolayı kimlik bilgisi yuvası üzerinden sağlayan operatör kayıtları. |
Manifests içindeki Recipe başvuruları sağlayıcı kapsamlıdır (compose/rabbitmq,
helm/rabbitmq), çünkü her sağlayıcı için aynı adda bir Recipe bulunur.
Neyi gösteriyor
- Tek yazım yüzeyi, birçok hedef. Tek bir Aggregate, yığının ne olduğu konusunda doğruluğun kaynağıdır. Her Manifest onun nasıl gerçekleştirileceğini söyler.
- Kalıcı bir aracı. RabbitMQ kuyrukları ve iletileri kalıcı olarak saklar, bu nedenle bileşen
stateful-serverolarak türlendirilir. Kubernetes üzerinde sentezlenmiş Recipe, RabbitMQ veri dizinine bağlanan replika başına kalıcı bir birim ve kararlı ağ kimliği için bir Headless Service içeren bir StatefulSet işler; Compose hizmeti aracıyı yerel geliştirme için dışa açar. - Chart’sız sentez (Kubernetes). Kubernetes hedefi resmî
rabbitmqimajını doğrudan çalıştırır. Derleyici StatefulSet’i, ClusterIP Service’i ve Headless Service’i bileşenininfraboyutlandırmasından sentezler — temin edilecek ya da izlenecek harici chart yoktur. İmaj etiketiinfra.engine_versionile sabitlenir, böylece işlenen çıktıda değişken etiket bulunmaz. - Aracının iki bağlantı noktası. İmajda yönetim etkindir, bu nedenle aracı AMQP bağlantı noktasını (5672) ve yönetim panosunu (15672) kapsayıcıda ve ClusterIP Service üzerinde dışa açar.
- Deterministik kimlik bilgileri. RabbitMQ her zaman kimlik doğrulaması yapar. Hiçbir
kimlik bilgisi eklenmediğinde, her Recipe sabit bir satır içi geliştirme
parolası sağlar; böylece işlenen çıktı çalıştırmalar arasında bayt bayt aynıdır. Bir kimlik bilgisi
eklendiğinde, enjekte edilen değer aracı parolasını belirler: Compose üzerinde
RABBITMQ_DEFAULT_PASShizmet ortam değişkeni olur; Kubernetes üzerinde bir Secret olarak oluşturulur ve bir envsecretKeyRefile başvurulur, böylece düz metin hiçbir zaman işlenen manifeste düşmez.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example rabbitmq-brokerArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd rabbitmq-brokerDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:
# 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-pullİşlenen yapıtlar dist/ altına yerleşir.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Workspace klasöründe henüz `rabbitmq-broker` klasörü yoksa, `scaffold` aracını `example` değeri `rabbitmq-broker` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `rabbitmq-broker` klasörüne yazar. Ardından `build` aracını her Release için birer kez, şu sırayla çağırın — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` ve `release-helm-synth-auth.yaml` — her seferinde `workspace_root` değeri `rabbitmq-broker`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Her derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `rabbitmq-broker/dist/` altındadır.Kimlik bilgisi teslimi notu
Compose üzerinde kimlik bilgisi bir inject-value gizli değeridir: değeri
bileşenin ortam kanalı üzerinden teslim edilir ve RABBITMQ_DEFAULT_PASS hizmet
ortam değişkeni olur. Kubernetes üzerinde kimlik bilgisi başvurulabilirdir:
bir Kubernetes Secret olarak oluşturulur ve StatefulSet ona bir
env secretKeyRef ile başvurur, böylece düz metin parola hiçbir zaman iş yükü
manifestinde görünmez. Kimlik doğrulamalı Aggregates içindeki origin değeri bir geliştirme
yer tutucusudur; gerçek her dağıtım için kimlik bilgisi kaynağınız aracılığıyla gerçek bir değer
sağlayın. Hiçbir kimlik bilgisi eklenmediğinde kullanılan satır içi geliştirme parolası
da yalnızca yerel kullanım içindir.