MySQL — tek Aggregate, iki hedef
Bu yalın örnek, Developer tarafından yazılmış Aggregate’lerden tek bir MySQL veritabanını iki hedefe derler:
- helm sağlayıcısının Workload sentezi aracılığıyla Kubernetes (resmi
mysqlimajı üzerinde doğrudan işlenen bir StatefulSet, harici chart yok) ve - yerel geliştirme için Docker Compose.
Her hedefi aynı geliştirici niyeti yönlendirir. Hedefe göre yalnızca Manifest’in seçtiği Recipe katmanı değişir.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate-helm-synth.yaml | Kubernetes temel varyantı için geliştirici niyeti: core/datastore/mysql türünde tek bir db bileşeni, değerleri ve yalnızca zorunlu root_password kimlik bilgisi. |
aggregate-helm-synth-auth.yaml | Kubernetes tam varyantı için geliştirici niyeti: hem root_password hem de user_password kimlik bilgisi yuvaları. |
manifest-helm-synth.yaml | MySQL türünü sentezlenmiş helm Recipe’ine (helm/mysql) ve her kimlik bilgisini kendi FeatureRecipe’ine (env-secret, k8s-secret-from-parameter) eşler. |
release-helm-synth.yaml | Kubernetes temel varyantı için operatör kaydı, operasyonel boyutlandırmayla (engine_version, storage). |
release-helm-synth-auth.yaml | Kubernetes tam varyantı için operatör kaydı. |
aggregate.yaml | Yerel Compose hedefi için geliştirici niyeti: iki kimlik bilgisi yuvası da inject-value kimlik bilgisi olarak teslim edilen aynı db bileşeni. |
manifest-compose.yaml | MySQL türünü Compose Recipe’ine (mysql) ve kimlik bilgisini dotenv-secret’e eşler. |
release-compose.yaml | Yerel Compose hedefi için operatör kaydı; tam konteyner imajını sabitleyen, sağlayıcıya özgü bir infra.overrides girdisi içerir. |
Neyi gösteriyor
- Tek yazım yüzeyi, birçok hedef. 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.
- Kubernetes’te Workload sentezi (tercih edilen).
helm/mysqlRecipe’iform: statefulile yetenekten bağımsız birWorkloadbildirir; helm sağlayıcısı bir StatefulSet, bir ClusterIP Service, bir Headless Service (StatefulSet’in kararlı ağ kimliği) ve veri dizini için bir volumeClaimTemplate sentezler. Konteynerin ortamıMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORDveMYSQL_PASSWORDtaşır. Karakter kümesi ve harmanlama,mysqldsunucu komut satırı argümanları olarak uygulanır (--character-set-server,--collation-server), çünkü resmimysqlimajı bunları ortam değişkenleri olarak değil, sunucu bayrakları olarak alır. - Compose’da Workload sentezi. Compose Recipe’i yetenekten bağımsız bir
Workloadbildirir; compose sağlayıcısı MySQL imajı, ortamı, adlandırılmış bir veri birimi ve bir sağlık denetimi içeren birdocker-compose.yamlhizmeti sentezler. - Operatör için bir kaçış yolu. Compose release’i
infra.overrides.imagedeğerini ayarlar; bu, Component’in kendi şemasının adlandırmadığı provider’a özgü bilgiler için açık sütundur ve oluşturulan servis tam olarak o imaj referansını çalıştırır. Bkz. Provider’a özgü geçersiz kılmalar. - İki yuvalı kimlik bilgisi modeli. Parolalar, bileşenin
features:sütunundaki eklerdir; her birifeature.aggrega.ai/kind: secretetiketli bir Feature’dır ve uygulamavaluesdeğerlerinden ayrı tutulur. Component’infeaturesSchema’sı bir Black-Boxroot_passwordyuvası ve şeffaf biruser_passwordyuvası bildirir.
Kubernetes kimlik bilgisi teslimi
root_password bir Black-Box yuvasıdır (inject: []): teslimi Recipe denetler.
Eklenen inject-value kimlik bilgisi değeri bileşenin inject borusuna koyar ve Recipe
onu .context.inject.env.MYSQL_ROOT_PASSWORD olarak okuyarak düz bir konteyner
ortam değişkeni üretir. Bunun için Kubernetes Secret’ı oluşturulmaz.
user_password şeffaf bir yuvadır (inject: [env, file]). Tam varyant,
bir Kubernetes Secret’ı oluşturan ve kimliğini yayımlayan, referans verilebilir bir
kimlik bilgisi ekler; Recipe yuvaya containers.attachments aracılığıyla başvurur,
sentezleyici bunu bir env secretKeyRef olarak işler. Oluşturulan Secret ve
konteynerin referansı aynı kaynağı adlandırır, çünkü ikisi de
.features.user_password.provides.name değerini okur. user_password’ü
eklenmemiş bırakmak (temel varyant) da geçerlidir: Recipe satır içi bir geliştirme
varsayılanına (MYSQL_PASSWORD: apppass) geri döner ve Secret oluşturulmaz; böylece
asgari bir dağıtım yine de işlenir ve çalışı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 mysql-standaloneArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd mysql-standaloneDerleme
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:
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.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 `mysql-standalone` klasörü yoksa `scaffold` aracını `example` değeri `mysql-standalone` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `mysql-standalone` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml` ve `release-compose.yaml` — her seferinde `workspace_root` değeri `mysql-standalone`, `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 `mysql-standalone/dist/` altındadır.Operatör boyutlandırması
Kubernetes sürümleri, operatör boyutlandırma sütununu ortam başına doldurur:
konteyner imaj etiketi infra.engine_version’dan (mysql:8.4) gelir ve
volumeClaimTemplate’in isteği ile depolama sınıfı infra.storage’dan gelir.
Geliştiricinin Aggregate’i bu alanları hiçbir zaman taşımaz.
Provider’a özgü geçersiz kılmalar
Boyutlandırma sütunları adlandırılmış alanlardır: Component engine_version ve
storage bildirir, dolayısıyla bunlardan birini ayarlayan operatör, Component’in
öngördüğü bir alanı doldurmaktadır. infra.overrides, bir Component’in
öngöremediği şeyler için olan sütundur — herhangi bir iç içe yapıyı kabul eden bir
nesne olarak bildirilir ve her Recipe hangi anahtarları okuduğunu belgeler.
release-compose.yaml bunu kullanır. Compose Recipe’i tek bir anahtar, image, okur
ve bu ayarlandığında konteyner, Recipe’in engine_version’dan oluşturduğu referans
yerine tam olarak bu referansı çalıştırır:
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"İşlenen hizmet geçersiz kılmayı olduğu gibi taşır:
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]Bu, aynı sunucu sürümünün kayıt defteri yansılı ya da özetle sabitlenmiş bir
derlemesine giden yoldur — Component’in sözleşmesine değil, hedef ortama ait bir
dağıtım bilgisi. Anahtar kümesi Component başına değil Recipe başına olduğundan,
hangi anahtarların geçerli olduğuna Recipe’te bakılır: buradaki Compose Recipe’i
image okur ve hiçbirini okumayan bir Recipe bunu belirtir.