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

Aggrega geliştirici niyeti (Aggregate) şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json

Özyinelemeli, parametreli yapay zekâ mimarisi. Hem bir derlemenin kökü hem de yeniden kullanılabilir modül olarak işlev görür.

Aggregate varlıklarının yazımına ilişkin açıklamalı rehberlik için Aggregate yazım başvurusuna bakın; bu sayfa, o başvurunun açıkladığı yapısal şemayı belgeler.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “Aggregate”evetSabit: "Aggregate"
metadataobjectevet
defsstring[]hayırDerleyici için düz bir O(1) sözlüğü korurken Aggregate’i DRY tutmak amacıyla standart YAML çapaları (& ve *) için isteğe bağlı blok. Manifest üzerindeki eşdeğer bloğu yansıtır.
specobjectevetGeliştirici Niyeti yüzeyi: genel parametre sözleşmesi, iç içe aggregate içe aktarımları, dışa aktarılan bileşenlerin genel API’si, alt sistem gruplamaları ve modülü oluşturan bileşen örnekleri.

Ek özelliklere izin verilmez.

aggregate.metadata

ÖzellikTürZorunluAçıklama
namestringevetEn az 1 karakter uzunluğunda.
versionstringevetAggregate modülünün katı Anlamsal Sürümlemesi. Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstringhayır
maintainersobject[]hayırBu varlığın sahibi olan bakımcıların listesi.
licensestringhayırBu varlığın tanımladığı yazılımın lisansı için MIT veya AGPL-3.0 gibi bir SPDX tanımlayıcısı. Bu dosyanın koşullarını değil, o yazılımın koşullarını kaydeder.
repositorystringhayırKaynak dosyaların bulunduğu Git deposunun URL’si.
homestringhayırBu varlığın ana sayfasının, wiki’sinin veya belgelerinin URL’si.
keywordsstring[]hayırKullanıcı arayüzünde keşfedilebilirlik için tanımlayıcı anahtar sözcüklerin listesi.
labelsstring eşlemihayırKatalog keşfi, ilke değerlendirmesi ve Studio/IDE filtrelemesi için modül düzeyinde duck-typing etiketleri. Bu etiketler Aggregate’in yeniden kullanılabilir bir modül olarak kimliğini tanımlar (ör. aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). Alt bileşen düğümlerine aktarılmazlar; bileşen etiketleri yalnızca Alan 2’deki Component katalog varlığından gelir.

Ek özelliklere izin verilmez.

aggregate.metadata.maintainers[]
ÖzellikTürZorunluAçıklama
namestringevet
emailstringhayır
urlstringhayır

Ek özelliklere izin verilmez.

aggregate.spec

Geliştirici Niyeti yüzeyi: genel parametre sözleşmesi, iç içe aggregate içe aktarımları, dışa aktarılan bileşenlerin genel API’si, alt sistem gruplamaları ve modülü oluşturan bileşen örnekleri.

ÖzellikTürZorunluAçıklama
parametersobject eşlemihayırGenel ortam sözleşmesi. Her girdi, kompakt biçim sözcük dağarcığının alt kümesini (type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties) yazan, türü belirlenmiş bir sözleşme nesnesidir. İç içe yapı, türlü biçimin properties: alt alanıyla ifade edilir. Release karşılaması satır içi (parameters: {…}) ya da tek kaynaklı dosya içe aktarımı (parameters: {$import: }) olabilir; parametre sözleşmesi katmanı, parametre enterpolasyonundan önce birleştirilmiş eşlemeyi bu sözleşmeye göre doğrular. Sözcük dağarcığının tamamını dil başvurusunun Aggregate sayfası anlatır.
aggregatesobject eşlemihayırİçe aktarılan modüller olarak işlev gören iç içe aggregate’ler. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$.
exportedComponentsstring eşlemihayırGenel API Arayüzü. Açığa çıkarılan bir genel adı dahili bir bileşen kimliğine eşler. Bu modülü içe aktaran üst Aggregates, bileşenlere bu genel adlarla başvurur.
subsystemssubsystem eşlemihayırBir Aggregate’in bileşenlerinin alt sistemlere adlandırılmış mantıksal gruplamaları. Üst düzey components ile birbirini dışlar; ikisinin birden bildirilmesi reddedilir. Yazarın default olarak adlandırdığı bir alt sistem, sıradan bir bildirilmiş alt sistemdir ve derleyicinin yalnızca components içeren bir Aggregate için sentezlediği default’tan ayrıdır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$.
componentscomponent_instance eşlemihayırBu Aggregate’i oluşturan, doğrudan üst düzeyde yazılan mantıksal atomik bileşenlerin eşlemi. Üst düzey components ile subsystems birbirini dışlar; ikisinin birden bildirilmesi reddedilir. Bileşenler burada (subsystems olmadan) yazıldığında, derleyici yükleme sırasında bunları sentezlenmiş bir default alt sisteme katlar ve IR bu alt sistemi sentezlenmiş olarak işaretler. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$.

Ek özelliklere izin verilmez.

Tanımlar

inject_delivery

Bir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features..inject bağlamında iliştirmenin FeatureRecipe’sinin yayımladığı provides değerlerine, component.inject bağlamında ise bileşenin kendi provides değerlerine göre çözümlenir. Bir iliştirmenin features..inject alanında, FeatureRecipe’nin yayımlamadığı bir anahtarı adlandıran bir ‘from’ derlemeyi durdurur; ancak o FeatureRecipe, iliştirmenin işleme bağlamına göre değerlendirdiği bir şablonda (kendi valuesMapping, workload, artifacts, omits alanlarında ya da bir pipeline adımının with veya when alanında — kendi injectMapping alanında değil) iliştirmenin girdilerini .inject konumunda kendisi okuyorsa durum farklıdır; bu durumda anahtar, bileşenin .context.inject alanı üzerinden teslim edilen bir anahtar değil, FeatureRecipe’nin kendisinin tükettiği bir anahtardır. ‘value’ yalnızca component.inject içinde teslim edilir: onu uses[].inject içinde veya bir iliştirmenin features..inject alanında taşıyan bir girdi derlemeyi durdurur, çünkü bu bloklar yalnızca başka bir varlığın yayımladığı anahtarları teslim eder.

Tür: object[]

inject_block

Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri hedefin provides anahtarlarına (uses[].inject), bir iliştirmenin FeatureRecipe’sinin yayımladığı provides anahtarlarına (features..inject) ya da düz dizelere / şablon ifadelerine ve bileşenin kendi provides anahtarlarına (component.inject) eşler. Her teslim mekanizması (env, file, arg veya özel) {in, from?, value?} girdilerinden oluşan bir dizi olarak yazılır — provides başvuruları için açık ‘from’, düz değerler için ‘value’ kullanılır. Özel bir mekanizma all dışında herhangi bir ad alabilir: bir şablon tüm mekanizmaları .context.inject.all konumunda tek bir görünümde birleştirilmiş olarak okur, bu nedenle bu adı taşıyan bir mekanizma bu görünüm tarafından gizlenir ve böyle bir ad vermek derlemeyi durdurur.

ÖzellikTürZorunluAçıklama
envinject_deliveryhayırBir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features..inject bağlamında iliştirmenin FeatureRecipe’sinin yayımladığı provides değerlerine, component.inject bağlamında ise bileşenin kendi provides değerlerine göre çözümlenir. Bir iliştirmenin features..inject alanında, FeatureRecipe’nin yayımlamadığı bir anahtarı adlandıran bir ‘from’ derlemeyi durdurur; ancak o FeatureRecipe, iliştirmenin işleme bağlamına göre değerlendirdiği bir şablonda (kendi valuesMapping, workload, artifacts, omits alanlarında ya da bir pipeline adımının with veya when alanında — kendi injectMapping alanında değil) iliştirmenin girdilerini .inject konumunda kendisi okuyorsa durum farklıdır; bu durumda anahtar, bileşenin .context.inject alanı üzerinden teslim edilen bir anahtar değil, FeatureRecipe’nin kendisinin tükettiği bir anahtardır. ‘value’ yalnızca component.inject içinde teslim edilir: onu uses[].inject içinde veya bir iliştirmenin features..inject alanında taşıyan bir girdi derlemeyi durdurur, çünkü bu bloklar yalnızca başka bir varlığın yayımladığı anahtarları teslim eder.
fileinject_deliveryhayırBir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features..inject bağlamında iliştirmenin FeatureRecipe’sinin yayımladığı provides değerlerine, component.inject bağlamında ise bileşenin kendi provides değerlerine göre çözümlenir. Bir iliştirmenin features..inject alanında, FeatureRecipe’nin yayımlamadığı bir anahtarı adlandıran bir ‘from’ derlemeyi durdurur; ancak o FeatureRecipe, iliştirmenin işleme bağlamına göre değerlendirdiği bir şablonda (kendi valuesMapping, workload, artifacts, omits alanlarında ya da bir pipeline adımının with veya when alanında — kendi injectMapping alanında değil) iliştirmenin girdilerini .inject konumunda kendisi okuyorsa durum farklıdır; bu durumda anahtar, bileşenin .context.inject alanı üzerinden teslim edilen bir anahtar değil, FeatureRecipe’nin kendisinin tükettiği bir anahtardır. ‘value’ yalnızca component.inject içinde teslim edilir: onu uses[].inject içinde veya bir iliştirmenin features..inject alanında taşıyan bir girdi derlemeyi durdurur, çünkü bu bloklar yalnızca başka bir varlığın yayımladığı anahtarları teslim eder.
arginject_deliveryhayırBir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features..inject bağlamında iliştirmenin FeatureRecipe’sinin yayımladığı provides değerlerine, component.inject bağlamında ise bileşenin kendi provides değerlerine göre çözümlenir. Bir iliştirmenin features..inject alanında, FeatureRecipe’nin yayımlamadığı bir anahtarı adlandıran bir ‘from’ derlemeyi durdurur; ancak o FeatureRecipe, iliştirmenin işleme bağlamına göre değerlendirdiği bir şablonda (kendi valuesMapping, workload, artifacts, omits alanlarında ya da bir pipeline adımının with veya when alanında — kendi injectMapping alanında değil) iliştirmenin girdilerini .inject konumunda kendisi okuyorsa durum farklıdır; bu durumda anahtar, bileşenin .context.inject alanı üzerinden teslim edilen bir anahtar değil, FeatureRecipe’nin kendisinin tükettiği bir anahtardır. ‘value’ yalnızca component.inject içinde teslim edilir: onu uses[].inject içinde veya bir iliştirmenin features..inject alanında taşıyan bir girdi derlemeyi durdurur, çünkü bu bloklar yalnızca başka bir varlığın yayımladığı anahtarları teslim eder.

component_uses_block

Bir bileşenin bağımlı olduğu bileşenlere kurduğu bağlantılar, sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir takma ad altında adlandırılan bağlantı, geliştiricinin bağlantıya özgü değerlerini ve soketin bildirdiği yuvaları dolduran ekleri taşıyabilir.

Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.

Değerler string[] or map of object türündedir.

Başka hiçbir anahtara izin verilmez.

feature_uses_block

Eklenmiş bir Feature’ın kurduğu bağlantılar; Feature’ın usesSchema içinde bildirdiği bir sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir Feature’ın kurduğu bağlantı kendine ait ek taşımaz: ihtiyaç duyduğu bir kimlik bilgisi, Feature’ın kendi featuresSchema içinde bildirdiği bir yuvayı doldurur ve Feature’ın yanına eklenir.

Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.

Değerler string[] or map of object türündedir.

Başka hiçbir anahtara izin verilmez.

connection_attachment

Bir bağlantının taşıdığı tek bir ek: bağlantının soketinin bildirdiği bir yuvayı dolduran Feature ve geliştiricinin onun için verdiği yapılandırma.

ÖzellikTürZorunluAçıklama
typestringevetBu ekin talep ettiği Feature arayüzünün URI’si (ör. core/referenced-secret:1.0.0).
descriptionstringhayırBu bağlantının eki neden taşıdığını açıklayan isteğe bağlı belgeleme.
valuesobjecthayırFeature için geliştirici tarafından sağlanan, şema bildirimiyle doğrulanan yapılandırma.

Ek özelliklere izin verilmez.

subsystem

ÖzellikTürZorunluAçıklama
descriptionstringhayırBu alt sistemin amacını ve temsil ettiği mantıksal gruplamayı açıklayan isteğe bağlı belgeleme.
annotationsstring, object veya null eşlemihayırBu alt sistem üzerinde geliştirici tarafından yazılan ek açıklamalar. Değerler dize, yapılandırılmış nesne (alt anahtardan değere bir eşlem; devralınan yapılandırılmış bir değerle alt anahtar bazında birleştirilir) veya null’dır; üst alt sistemden devralınan bir anahtar üzerinde açıkça belirtilen null, devralınan bağlamayı bu alt sistemden kaldırır (ek açıklamaya dayalı Feature devre dışı bırakma). Burada bildirilen ek açıklamalar iç içe alt sistemlere ve içerilen bileşenlere devredilir; anahtar bazında daha yakın düzey geçerli olur. Türetilen her IR düğümündeki .context.annotations.aggregate kümesine kadar aşağı doğru aktarılır.
featuresobject eşlemihayırBu alt sistemdeki tüm bileşenlere eklenen kesişen özellikler. Bileşen düzeyindeki özelliklerle aynı şemaya sahiptir (type, values, uses, inject). Graf sonlandırılırken her bileşene düzleştirilir ve yürütme sırasında bileşen düzeyindeki özelliklerden sonra konumlanır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.
subsystemssubsystem eşlemihayırAnahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.
componentscomponent_instance eşlemihayırAnahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.

Ek özelliklere izin verilmez.

component_instance

ÖzellikTürZorunluAçıklama
typestringevetİstenen soyut Component, bir başvuru olarak: metadata.name değeri ile isteğe bağlı bir :version (ör. core/api-server:1.0.0); asla bir dosya yolu değil. Üç Katmanlı Varlık Çözümleme Modeli (çalışma alanı katalog dizinleri → önbellek → kayıt defteri) ile çözümlenir: yerel olarak yazılan bir Component, çalışma alanı kökündeki catalog/ altına veya workspace.catalog_dirs altında listelenen bir dizine yerleştirilir; göreli dosya yolu olarak yazılan bir type ise hiçbir kataloğun içermediği bir varlık olarak derlemeyi durdurur.
activeboolean veya stringhayırBu bileşenin derlenmiş topolojide bulunup bulunmadığı. Bir boolean ya da .parameters üzerinde, bir boolean’a çözümlenmesi gereken bir string şablonu. false olarak çözümlendiğinde bileşen topolojiden budanır; bu, bileşenin uses kenarlarına ve eklerine de yayılır. Değerin bir parametreden türetilmesi, bir Release’in o parametreyi karşılayarak bileşenin varlığını açıp kapatmasını sağlar. Belirtilmediğinde varsayılan değer true’dur. Varsayılan: true
descriptionstringhayırBu bileşen örneğinin uygulamadaki rolünü açıklayan isteğe bağlı belgeler. IR grafiğine taşınır.
annotationsstring, object veya null eşlemihayırBu bileşen üzerinde geliştiricinin yazdığı ek açıklamalar (annotations). Değerler dize, yapılandırılmış nesne (alt anahtardan değere bir eşlem; devralınan yapılandırılmış bir değerle alt anahtar bazında birleştirilir) veya null’dır; bir üst alt sistemden devralınan bir anahtar üzerinde açıkça verilen null, devralınan bağlamayı bu bileşenden kaldırır (ek açıklamayla yönlendirilen Feature devre dışı bırakma). Component düzeyindeki ek açıklamalar, devralınan alt sistem düzeyindeki ek açıklamaları anahtar bazında geçersiz kılar; aynı alt sistemdeki kardeş bileşenler kendi ek açıklama eşlemlerini birbirinden bağımsız olarak korur.
valuesobjecthayırComponent’e aktarılan, şeması tarafından doğrulanan opak bilişsel özellikler.
usescomponent_uses_blockhayırBir bileşenin bağımlı olduğu bileşenlere kurduğu bağlantılar, sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir takma ad altında adlandırılan bağlantı, geliştiricinin bağlantıya özgü değerlerini ve soketin bildirdiği yuvaları dolduran ekleri taşıyabilir.
injectinject_blockhayırBileşen düzeyinde self-inject. Bileşenin kendi değerlerini (‘value:’ ile) ya da kendi provides anahtarlarını (‘from:’ ile) doğrudan teslim hattına (.context.inject) enjekte eder. Yalnızca Component katalog varlığı ilgili mekanizmalarla ‘spec.inject’ bildiriyorsa izin verilir. uses[].inject içinde bildirilen bir anahtarla çakışan bir inject anahtarı, inject kaynakları arasında yinelenen bir teslim anahtarı olarak derlemeyi durdurur.
featuresobject eşlemihayırBu bileşene eklenen Features; yazarın her eke verdiği örnek adına göre anahtarlanır. Bu, tek ekleme yüzeyidir: operasyonel bir Feature, bir kimlik bilgisi Feature’ı (feature.aggrega.ai/kind: secret etiketli olan) ve bir kimlik Feature’ı, aynı anahtar sözcük ve aynı biçim altında burada eklenir. Aralarındaki fark, ekin nasıl bildirildiği değil, ne ürettiğidir. Örnek adı, Component’in featuresSchema içinde bildirdiği bir yuvayla eşleşen ek o yuvayı doldurur; diğer her örnek adı serbest bir ektir. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$.

Ek özelliklere izin verilmez.