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

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. Katalogdan type: ile seçilen iki bileşen, yuva dolduran bir ek olarak zorunlu bir kimlik bilgisi ve veritabanını Adminer’ın databases soketine bağlayan bir uses kenarı.
  • 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/mariadb ve type: 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ık values: bloğuyla karşılaştırın).
  • Dize Borusu. Adminer’ın katalog Component’i, component.aggrega.ai/type=stateful-server etiketli her bileşeni kabul eden bir databases uses-soketi bildirir. Aggregate’in kenarı, veritabanı Recipe’inin provides.host değerini ADMINER_DEFAULT_SERVER iç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 featuresSchema alanı, katalogdaki core/secret-value Feature’ı ile doldurulan bir root_password yuvası 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.0 değerini compose/mariadb:1.0.0 değ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:

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

Derleme

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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Pull, 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:

  • web servisi ADMINER_DEFAULT_SERVER: db taşır — veritabanı Recipe’inin uses kenarı üzerinden teslim edilen provides.host değeri (compose servis adı);
  • aynı kenar depends_on: [db] üretti — yalnızca dizeler değil, topoloji;
  • db servisinin MARIADB_CHARACTER_SET_SERVER ve MARIADB_COLLATION_SERVER değerleri, Aggregate’in hiç anmadığı şema varsayılanlarından gelir;
  • image: mariadb:11.4 ve 8080:8080 port bağlaması Release’in infra: bloklarından gelir — Geliştiricininkinin yanında işlenen Operatör sütunu.

Çalıştırma

Terminal window
cd dist/compose
docker compose up -d

http://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.