Yalnızca katalog — sıfır platform yazımıyla MariaDB + Adminer
Bu örnek, küçük ama gerçek bir yığını — önünde bir Adminer web arayüzü bulunan bir MariaDB veritabanını — yalnızca standart kitaplık kataloğu varlıklarına başvurarak dağıtır. Burada hiçbir Component, Feature veya Recipe yazılmaz: üç kısa YAML dosyası her şeyi kataloğun zaten sunduğu varlıklara yönlendirir.
Bu, Aggrega’nın sunduğu en küçük yazım yüzeyidir ve dille doğal ilk temastır. Yazım katmanındaki kardeş örnek aynı yığını kendi katalog katmanını kurarak dağıtır — hazır bir kataloğun size ne kazandırdığını görmek için önce bu örneği, ardından alttaki katmanın nasıl yapıldığını öğrenmek için o örneği okuyun.
Üç dosya
aggregate.yaml— Geliştiricinin niyeti: yığının ne olduğu. Katalogdantype:ile seçilen iki bileşen, yuva dolduran bir ek olarak zorunlu bir kimlik bilgisi ve veritabanını Adminer’ındatabasessoketine bağlayan biruseskenarı.release.yaml— Operatörün ortam başına karşılaması: ne büyüklükte ve nerede.infra:blokları (motor sürümü, depolama boyutu, yayımlanan port) Operatöre aittir; Aggregate bunları asla taşımaz.manifest.yaml— Operatörün yönlendirmesi: bu hedefte her türü hangi Recipe gerçekleştirir. Başvuruların neden sağlayıcıyla nitelendirildiği için aşağıya bakın.
Neyi gösteriyor
- Katalog başvuruları olarak Components.
type: core/datastore/mariadbvetype: core/devtool/adminer, hesaplama bildiriminin tamamıdır. Geliştirici yalnızca Component şemalarının açığa çıkardığı değerleri yazar — atlanan her alan şema varsayılanını alır (işlenmiş çıktının karakter kümesi ve harmanlama ortam değişkenlerini, onları üreten tek satırlıkvalues:bloğuyla karşılaştırın). - Dize Borusu. Adminer’ın katalog Component’i,
component.aggrega.ai/type=stateful-serveretiketli her bileşeni kabul eden birdatabasesuses-soketi bildirir. Aggregate’in kenarı, veritabanı Recipe’ininprovides.hostdeğeriniADMINER_DEFAULT_SERVERiçine enjekte eder. Derleyici dizeyi yorumlamadan yönlendirir — bu hedefte bu bir compose servis adıdır; aynı kenar bir Kubernetes hedefinde bir Service DNS adı taşırdı. - Ek sütunu. Veritabanı Component’inin
featuresSchemaalanı, katalogdakicore/secret-valueFeature’ı ile doldurulan birroot_passwordyuvası gerektirir. Yuva kara kutudur: Manifest’in seçtiği FeatureRecipe teslimatı denetler ve Geliştirici bunu dayatamaz. - Provider ile nitelendirilmiş Recipe yönlendirmesi. Manifest,
core/datastore/mariadb:1.0.0değerinicompose/mariadb:1.0.0değerine eşler — sağlayıcıyla nitelendirilmiş olarak — çünkü standart kitaplık bir mariadb Recipe’ini birden fazla sağlayıcı altında sunar (aralarında compose ve helm). Hedefi belirginleştiren Operatörün eşlemesidir: birden fazla sağlayıcının Recipe’iyle eşleşen çıplak, nitelendirilmemiş bir başvuru, sessizce birini seçmek yerine derlemeyi açıkça durdurur. Yığını yeniden hedeflemek için bu eşlemeleri yeniden yönlendirin; Aggregate değişmez.
Ö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 catalog-onlyArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd catalog-onlyDerleme
Bu dizinden, katalog varlıkları .aggrega-config.yaml dosyasının adlandırdığı varsayılan kayıt defteri olan hub.aggrega.ai’den çözümlenerek:
aggrega pull --release release.yamlaggrega build --release release.yamlPull, başvurulan her varlığı çözümler ve onu release.lock içinde sabitler (kimlik + içerik özeti; eskimiş bir kilit dosyasını yeniden oluşturmak için pull’u yeniden çalıştırın). Standart kütüphane kataloğunun bir çalışma kopyası (nereden edinilir) varsa, varlıkları oradan okumak için iki komutta da onun aggrega-catalog dizinini --catalog ile adlandırın. Derleme bu kilit dosyasını okur — o olmadan derleme durur ve iki ilerleme yolunu, pull’u ya da --auto-pull’u belirtir — ve dist/compose/docker-compose.yaml dosyasını işler. Release bileşenlerini doğrudan yazar (boundaries: bloğu yoktur), bu nedenle derleyici onları sentezlenmiş varsayılan kapsama katar ve dist/ altına düz olarak çıktı verir — tek sınır, yolda sınır adı bölümü yok.
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 `catalog-only` klasörü yoksa `scaffold` aracını `example` değeri `catalog-only` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `catalog-only` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `catalog-only`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olarak ayarlanmış şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `catalog-only/dist/` altındadır.Çıktıyı okuyun
Bağlantıların görünür hâle geldiği yer işlenmiş compose dosyasıdır:
webservisiADMINER_DEFAULT_SERVER: dbtaşır — veritabanı Recipe’inin uses kenarı üzerinden teslim edilenprovides.hostdeğeri (compose servis adı);- aynı kenar
depends_on: [db]üretti — yalnızca dizeler değil, topoloji; dbservisininMARIADB_CHARACTER_SET_SERVERveMARIADB_COLLATION_SERVERdeğerleri, Aggregate’in hiç anmadığı şema varsayılanlarından gelir;image: mariadb:11.4ve8080:8080port bağlaması Release’ininfra:bloklarından gelir — Geliştiricininkinin yanında işlenen Operatör sütunu.
Çalıştırma
cd dist/composedocker compose up -dhttp://localhost:8080 adresini açın: sunucu alanı db ile önceden doldurulmuştur.
Aggregate’in ekindeki geliştirme parolasıyla (dev-root-pw-change-me — yerel geliştirmenin ötesindeki her şeyde değiştirilmesi gereken bir yer tutucu) root olarak, appdb veritabanına oturum açın.
Sırada ne var
Yazım katmanı bu aynı platform katmanını sizin kurmanızı sağlar — bu örneğin hazır olarak tükettiği Components, Recipes ve kimlik bilgisi FeatureRecipes — ve tek bir Aggregate’i dört hedefe derler.