Redis — tek Aggregate, iki hedef, isteğe bağlı kimlik doğrulama
Bu yalın örnek, tek bir Redis bellek içi önbelleğini (Redis kablo protokolü) Developer tarafından yazılmış tek bir Aggregate’ten iki gerçekleştirime derler:
- yerel geliştirme için Docker Compose ve
- resmi üst kaynak
redisimajını doğrudan Kubernetes üzerinde çalıştıran sentezlenmiş helm Recipe (harici chart olmadan).
Sentezlenmiş helm Recipe, 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 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 isteğe bağlı bir parola kimlik bilgisi eklenmiş aynı önbelleği
gösterir; aggregate-helm-synth-auth.yaml ise sentezlenmiş helm yolu için
başvurulabilir bir kimlik bilgisi ekler.
Bu örneğin eşlediği katalogdaki Redis Recipes, yani compose/redis ve helm/redis, AGPL-3.0 lisansını bildirir. valkey-cache örneği, aynı kablo protokolünü konuşan Valkey’i dağıtır; onun helm/valkey Recipe’i BSD-3-Clause bildirir.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer amacı: core/datastore/redis türünde tek bir cache bileşeni, kimlik bilgisi yok — önbellek kimlik doğrulaması olmadan çalışır. |
aggregate-auth.yaml | Bileşenin isteğe bağlı password yuvasına parola kimlik bilgisi eklenmiş aynı önbellek (Compose yolu). |
aggregate-helm-synth-auth.yaml | Sentezlenmiş helm yolu için başvurulabilir bir kimlik bilgisi eklenmiş aynı önbellek — değer, Deployment’ın başvurduğu bir Kubernetes Secret olarak somutlaştırılır. |
manifest-compose.yaml | Redis türünü Compose Recipe’ine (compose/redis), kimlik bilgisini ise dotenv-secret’e eşler. |
manifest-helm-synth.yaml | Redis türünü sentezlenmiş helm Recipe’ine (helm/redis), kimlik bilgisini ise k8s-secret-from-parameter’e 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.yaml | Kimlik 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.
- Önbellek rolünde bir veri deposu. Redis burada bellek içi önbellek olarak kullanılır
ve hiçbir şeyi kalıcı olarak saklamaz; bu nedenle bileşen
stateful-serveryerine düz birserverolarak türlendirilir. Kubernetes üzerinde sentezlenmiş Recipe bir StatefulSet değil Deployment işler ve kalıcı birim istemez; Compose üzerinde hizmet hiçbir veri birimi bildirmez. - Workload sentezi (Kubernetes). Sentezlenmiş helm Recipe, helm sağlayıcısının
harici chart olmadan Kubernetes manifestlerine çevirdiği bir Workload bildirir —
resmi
redisimajını çalıştıran bir Deployment ve bir ClusterIP Service. İşlenen kaynak kümesi tam olarak Workload’un bildirdiği şeydir. Hem bir Compose hem de bir sentezlenmiş helm Reciperedisadını taşıdığından, Manifests bunlara sağlayıcı kapsamlı olarakcompose/redisvehelm/redisbiçiminde başvurur. - Kimlik bilgisi yuvası aracılığıyla isteğe bağlı kimlik doğrulama. Bileşen,
featuresSchemaiçinde isteğe bağlı tek birpasswordyuvası bildirir. Hiçbir kimlik bilgisi eklenmediğinde (temel Aggregate), Recipe önbelleği kimlik doğrulaması devre dışı olarak işler — yuvası olmayan bir Recipe ile bayt bayt aynı biçimde. Bir kimlik bilgisi eklendiğinde her iki hedef de Redis’i--requirepassile başlatır, böylece sunucu parolayı zorunlu kılar: Compose üzerinde (aggregate-auth.yaml) değer sunucuya bu argüman olarak iletilir; sentezlenmiş Kubernetes yolunda (aggregate-helm-synth-auth.yaml) ise Deployment’ın başvurduğu bir Secret olarak somutlaştırılır.
Ö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 redis-cacheArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd redis-cacheDerleme
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), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega 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 `redis-cache` klasörü yoksa, `scaffold` aracını `example` değeri `redis-cache` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `redis-cache` 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 `redis-cache`, `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 `redis-cache/dist/` altındadır.Kimlik bilgisi teslimi notu
Compose yolunda kimlik bilgisi, değer enjekte eden bir gizlidir (aggregate-auth.yaml): değeri, bileşenin ortam hattı üzerinden values.key alanının adlandırdığı değişken olan REDIS_PASSWORD altında teslim edilir ve Recipe bunu sunucuya --requirepass olarak verir. Resmî redis imajı hiçbir parola değişkeni okumaz; bu nedenle değer bir argüman olarak iletilir ve hizmetin komutunda görünür. Değeri Recipe’e onun okuduğu hiçbir değişken altında ulaşmayan bir ek, önbelleği açık bırakmak yerine yuvayı adlandırarak derlemeyi durdurur.
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 Redis,
o ortam değişkenini okuyan --requirepass ile 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. Parolayı ortamdan kendiliğinden okumayan resmi redis
imajında kimlik doğrulamayı gerçekten etkinleştiren budur.
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.