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

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 mysql imajı ü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

DosyaRol
aggregate-helm-synth.yamlKubernetes 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.yamlKubernetes tam varyantı için geliştirici niyeti: hem root_password hem de user_password kimlik bilgisi yuvaları.
manifest-helm-synth.yamlMySQL 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.yamlKubernetes temel varyantı için operatör kaydı, operasyonel boyutlandırmayla (engine_version, storage).
release-helm-synth-auth.yamlKubernetes tam varyantı için operatör kaydı.
aggregate.yamlYerel 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.yamlMySQL türünü Compose Recipe’ine (mysql) ve kimlik bilgisini dotenv-secret’e eşler.
release-compose.yamlYerel 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/mysql Recipe’i form: stateful ile yetenekten bağımsız bir Workload bildirir; 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_PASSWORD ve MYSQL_PASSWORD taşır. Karakter kümesi ve harmanlama, mysqld sunucu komut satırı argümanları olarak uygulanır (--character-set-server, --collation-server), çünkü resmi mysql imajı 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 Workload bildirir; compose sağlayıcısı MySQL imajı, ortamı, adlandırılmış bir veri birimi ve bir sağlık denetimi içeren bir docker-compose.yaml hizmeti sentezler.
  • Operatör için bir kaçış yolu. Compose release’i infra.overrides.image değ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 biri feature.aggrega.ai/kind: secret etiketli bir Feature’dır ve uygulama values değerlerinden ayrı tutulur. Component’in featuresSchema’sı bir Black-Box root_password yuvası ve şeffaf bir user_password yuvası 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:

Terminal window
aggrega scaffold --example mysql-standalone

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

Terminal window
cd mysql-standalone

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
# 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.