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

NATS — tek Aggregate, iki hedef, isteğe bağlı kimlik doğrulama

Bu örnek, tek bir NATS mesajlaşma sunucusunu (yayınla-abone ol, istek-yanıt, kuyruklama) Developer tarafından yazılmış tek bir Aggregate’ten iki gerçekleştirime derler:

  • yerel geliştirme için Docker Compose ve
  • resmi upstream nats imajını doğrudan Kubernetes üzerinde çalıştıran sentezlenmiş helm Recipe (harici chart olmadan).

Sentezlenmiş helm Recipe tercih edilen Kubernetes yoludur: üçüncü taraf bir chart yerine yalnızca resmi bir imaj etiketine bağlıdır ve işlenen kaynak kümesi tam olarak iş yükünün bildirdiği şeydir.

Aynı aggregate.yaml her ikisini de yönlendirir. Gerçekleştirime göre yalnızca Manifest’in seçtiği Recipe katmanı değişir. İkinci bir Aggregate olan aggregate-auth.yaml, Compose yolu için inject-value parola kimlik bilgisi eklenmiş aynı sunucuyu gösterir; aggregate-helm-synth-auth.yaml ise sentezlenmiş helm yolu için başvurulabilir bir kimlik bilgisi ekler.

Dosyalar

DosyaRol
aggregate.yamlDeveloper amacı: core/messaging/nats türünde tek bir bus bileşeni, kimlik bilgisi yok — sunucu kimlik doğrulama olmadan çalışır.
aggregate-auth.yamlBileşenin isteğe bağlı password yuvasına inject-value parola kimlik bilgisi eklenmiş aynı sunucu (Compose yolu).
aggregate-helm-synth-auth.yamlSentezlenmiş helm yolu için başvurulabilir bir kimlik bilgisi eklenmiş aynı sunucu — değer, Deployment’ın başvurduğu bir Kubernetes Secret olarak somutlaştırılır.
manifest-compose.yamlNATS türünü Compose Recipe’ine (compose/nats), kimlik bilgisini ise dotenv-secret’a eşler.
manifest-helm-synth.yamlNATS türünü sentezlenmiş helm Recipe’ine (helm/nats), kimlik bilgisini ise k8s-secret-from-parameter’a eşler.
release-compose.yaml / release-helm-synth.yamlİki gerçekleştirim için operatör kayıtları, kimlik doğrulama yok.
release-compose-auth.yaml / release-helm-synth-auth.yamlKimlik doğrulamayı etkinleştiren operatör kayıtları.

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.
  • Durumsuz bir mesajlaşma sunucusu. Bu yalın biçimde NATS, JetStream dosya depolaması devre dışıyken konuları bellekte yönlendirir, bu nedenle bileşen server olarak tiplenir. Kubernetes üzerinde sentezlenmiş Recipe, kalıcı birimi olmayan tek replikalı bir Deployment işler; Compose hizmeti ise sunucuyu yerel geliştirme için dışa açar.
  • Workload sentezi (Kubernetes). Sentezlenmiş helm Recipe, helm sağlayıcısının harici chart olmadan Kubernetes manifestlerine çevirdiği bir Workload — resmi nats imajını çalıştıran bir Deployment ile bir ClusterIP Service — bildirir. İşlenen kaynak kümesi tam olarak Workload’un bildirdiği şeydir. Hem bir Compose hem de sentezlenmiş bir helm Recipe nats adını taşıdığından, Manifests bunlara sağlayıcı kapsamlı olarak compose/nats ve helm/nats biçiminde başvurur.
  • İsteğe bağlı kimlik doğrulama, her iki durumda da deterministik. NATS kimlik doğrulaması varsayılan olarak kapalıdır. Kimlik bilgisi eklenmediğinde hiçbir gerçekleştirim kimlik doğrulamayı etkinleştirmez ve işleme, çalıştırmalar arasında bayt düzeyinde aynıdır. Kimlik bilgisi eklendiğinde, enjekte edilen değer her iki gerçekleştirimde de kullanıcı/parola kimlik doğrulamasını etkinleştirir.

Ö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 nats-messaging

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

Terminal window
cd nats-messaging

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), 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

İş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 klasör oluşturmayın. Çalışma alanı klasöründe henüz `nats-messaging` klasörü yoksa `scaffold` aracını `example` değeri `nats-messaging` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `nats-messaging` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` ve `release-helm-synth-auth.yaml` — her seferinde `workspace_root` değeri `nats-messaging`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `nats-messaging/dist/` altındadır.

Kimlik bilgisi teslimi notu

Compose yolunda kimlik bilgisi bir inject-value gizli bilgisidir (aggregate-auth.yaml): değeri bileşenin ortam hattı üzerinden teslim edilir ve sunucu kullanıcı/parola kimlik doğrulama bayraklarıyla başlatılır.

Sentezlenmiş helm yolu başvurulabilir bir kimlik bilgisi kullanır (aggregate-helm-synth-auth.yaml): değer bir Kubernetes Secret olarak somutlaştırılır, Deployment ona bir env secretKeyRef aracılığıyla başvurur ve sunucu bu ortam değişkenini okuyan --user/--pass bayraklarıyla başlatılır. Bu nedenle düz metin parola Deployment manifestinde hiçbir zaman görünmez — yalnızca Secret’ta görünür.

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.