İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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 rabbitmq imajı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

DosyaRol
aggregate.yamlGeliş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.yamlBileş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.yamlBaş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.yamlRabbitMQ türünü Compose Recipe’ine (compose/rabbitmq), kimlik bilgisini ise dotenv-secret’e eşler.
manifest-helm-synth.yamlRabbitMQ 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.yamlParolayı 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-server olarak 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î rabbitmq imajını doğrudan çalıştırır. Derleyici StatefulSet’i, ClusterIP Service’i ve Headless Service’i bileşenin infra boyutlandırmasından sentezler — temin edilecek ya da izlenecek harici chart yoktur. İmaj etiketi infra.engine_version ile 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_PASS hizmet ortam değişkeni olur; Kubernetes üzerinde bir Secret olarak oluşturulur ve bir env secretKeyRef ile 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:

Terminal window
aggrega scaffold --example rabbitmq-broker

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd rabbitmq-broker

Derleme

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:

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

İş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.