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

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

Bu yalın örnek, tek bir Valkey 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
  • resmî yukarı akış valkey/valkey imajı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 resmî bir imaj etiketine bağlıdır ve işlenen kaynak kümesi tam olarak iş yükünün bildirdiği şeydir.

Her ikisini de aynı aggregate.yaml yönlendirir. Gerçekleştirime göre yalnızca Manifest tarafından seçilen Recipe katmanı değişir. İki ek Aggregates, aynı önbelleği isteğe bağlı bir parola kimlik bilgisi eklenmiş olarak gösterir: Compose yolu için aggregate-auth.yaml (sunucunun onunla başlatıldığı, değer enjekte eden bir kimlik bilgisi) ve sentezlenmiş helm yolu için aggregate-helm-synth-auth.yaml (Kubernetes Secret olarak somutlaştırılan, başvurulabilir bir kimlik bilgisi).

Dosyalar

DosyaRol
aggregate.yamlDeveloper amacı: core/datastore/valkey türünde tek bir cache bileşeni, kimlik bilgisi yok — önbellek kimlik doğrulama olmadan çalışır.
aggregate-auth.yamlBileşenin isteğe bağlı password yuvasına parola kimlik bilgisi eklenmiş aynı önbellek (Compose yolu).
aggregate-helm-synth-auth.yamlSentezlenmiş 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.yamlValkey türünü Compose Recipe’ine (compose/valkey), kimlik bilgisini ise dotenv-secret’e eşler.
manifest-helm-synth.yamlValkey türünü sentezlenmiş helm Recipe’ine (helm/valkey), 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.
  • Önbellek rolünde bir veri deposu. Valkey burada bellek içi önbellek olarak kullanılır ve hiçbir şeyi kalıcı olarak saklamaz; bu nedenle bileşenin türü stateful-server yerine düz bir server olarak belirlenir. Kubernetes’te sentezlenmiş helm Recipe bir StatefulSet değil, bir Deployment işler ve kalıcı birim talep etmez; Compose’da ise hizmet hiçbir veri birimi bildirmez.
  • Workload sentezi (Kubernetes). Sentezlenmiş helm Recipe, bir Workload bildirir — resmî valkey/valkey imajını çalıştıran bir Deployment ile bir ClusterIP Service — ve helm sağlayıcısı bunu harici chart olmadan Kubernetes manifestlerine dönüştürür. İşlenen kaynak kümesi tam olarak Workload’un bildirdiği şeydir. Hem bir Compose hem de bir sentezlenmiş helm Recipe valkey adını taşıdığından, Manifests bunlara sağlayıcı kapsamlı olarak compose/valkey ve helm/valkey şeklinde başvurur.
  • Kimlik bilgisi yuvası aracılığıyla isteğe bağlı kimlik doğrulama. Bileşen, featuresSchema içinde isteğe bağlı tek bir password yuvası bildirir. Hiçbir kimlik bilgisi eklenmediğinde (temel Aggregate), Recipe önbelleği kimlik doğrulama devre dışı olarak işler — yuvası olmayan bir Recipe ile bayt bayt aynı biçimde. Bir kimlik bilgisi eklendiğinde her iki hedef de Valkey’i --requirepass ile başlatır, böylece sunucu parolayı zorunlu kılar: Compose’da değer sunucuya imajın VALKEY_EXTRA_FLAGS değişkeni aracılığıyla ulaşır; Kubernetes’te ise sentezlenmiş helm yolu onu Deployment’ın başvurduğu bir Secret olarak somutlaştırı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:

Terminal window
aggrega scaffold --example valkey-cache

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

Terminal window
cd valkey-cache

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 hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `valkey-cache` klasörü yoksa `scaffold` aracını `example` değeri `valkey-cache` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `valkey-cache` klasörüne yazar. Ardından `build` aracını her Release için bir 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 `valkey-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 `valkey-cache/dist/` altındadır.

Kimlik bilgisi teslimi notu

Compose yolunda kimlik bilgisi bir inject-value gizlisidir (aggregate-auth.yaml): değeri, bileşenin ortam hattı üzerinden values.key alanının adlandırdığı değişken olan VALKEY_PASSWORD altında teslim edilir ve Recipe bunu sunucuya imajın VALKEY_EXTRA_FLAGS değişkeni aracılığıyla --requirepass olarak verir; böylece değer hizmetin ortamında görünür ama komut satırında görünmez. İmajın başlangıç betiği bu değişkeni tırnaksız genişletir; bu nedenle boşluk içeren bir parola sunucuyu başlangıçta durdurur, *, ? veya [ içeren bir parola ise sunucunun veri dizinindeki dosya adlarıyla eşleştirilir; parolayı bunların hiçbiri olmadan yazın. Değeri Recipe’e onun okuduğu hiçbir değişken altında ulaşmayan bir parola eki, korumasız bir önbellek işlemek 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 Valkey 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 içinde bulunur. Parolayı ortamdan kendiliğinden okumayan resmî valkey/valkey 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.