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

Aggrega Yetenekten Bağımsız Graf (IR) şeması

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

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

Topoloji Oluşturucu tarafından üretilen, düzleştirilmiş ve tamamen çözümlenmiş tek boyutlu graf.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “IR”evetSabit: "IR"
metadataIRMetadataevetGrafın kimliği: grafın derlendiği Aggregate.
specIRSpecevetGrafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri.

Ek özelliklere izin verilmez.

Tanımlar

Maintainer

ÖzellikTürZorunluAçıklama
namestringevetBakımcının adı.
emailstringhayırBakımcının e-posta adresi.
urlstringhayırBakımcının web adresi.

FieldProvenance

Bir eklentinin values veya infra yükündeki tek bir yaprağın kökeni.

ÖzellikTürZorunluAçıklama
originstringevetYaprağın açıkça mı yazıldığı, yoksa açıklama (annotation) güdümlü genişletme geçişi tarafından mı katkılandığı.
sidestringhayırAçıklamanın bildirildiği yazım yüzeyi; açık yapraklar için bulunmaz.
annotation_keystringhayırBu yaprağı katkılayan açıklamanın adı; açık yapraklar için bulunmaz.
annotation_sourcestringhayırAçıklama bildiriminin kaynak konumu, : biçiminde; açık yapraklar için bulunmaz.
overridden_annotationFieldProvenancehayırBu yaprağı açık bir yaprağa kaptıran açıklama katkısı: açık bir yaprak, açıklamayla katkılanmış bir yaprağın üzerine yazdığında, yerini aldığı bastırılmış köken. Tekildir — her zaman yalnızca bir bastırılmış katkı saklanır.

Ek özelliklere izin verilmez.

AttachmentConnection

Bir eklentinin ait olduğu bağlantı; bileşenin kendi eklenti bloğuna değil, bir bileşenin çizdiği bir bağlantıya yazılmış eklentiler içindir: bağlantının üzerinden kablolandığı soket ve altında yazıldığı takma ad. Bu çift, grafın kenarlarından birini adlandırır — kaynağı eklentiyi taşıyan düğüm olan ve soketi ile takma adı bunlar olan kenarı — böylece bir tüketici eklentiyi o kenara, onun üzerinden de eklentinin sunulduğu hedefe bağlar.

ÖzellikTürZorunluAçıklama
socketstringevetBağlantının üzerinden kablolandığı soket: eklentinin ait olduğu kenarın soketi.
aliasstringevetBağlantının altında yazıldığı takma ad: eklentinin ait olduğu kenarın takma adı.

Ek özelliklere izin verilmez.

IRFeatureEntry

Bir düğüm için çözümlenmiş, feature_values_mapping içinde taşınan tek bir eklenti. Her eklenti ailesi bu biçimi paylaşır — operasyonel bir Feature, kimlik bilgisi Feature’ı, kimlik Feature’ı — böylece hiçbir aile diğerinden daha kayıplı bir izdüşüm almaz. Bir kimlik bilgisi eklentisinin values alanının ne taşıdığı yazarın seçimidir: başvuruyla verilen bir kimlik bilgisi bir gizli bilgi deposuna işaretçi taşır, değerle verilen ise malzemenin kendisini taşır; derleyici hangisi yazıldıysa onu, ikisini de çözümlemeden olduğu gibi taşır.

ÖzellikTürZorunluAçıklama
typestringevetBu eklentinin talep ettiği Catalog Feature’ının URI’si.
resolved_versionstringevetDerleme sırasında çözümlenen tam anlamsal sürüm.
labelsstring eşlemihayırEklenen Feature’ın katalog etiketleri; katalog varlığının bildirdiği sırayla olduğu gibi taşınır — hiçbir zaman filtrelenmez, normalleştirilmez veya öneki çıkarılmaz; böylece bir tüketici katalog yazarının yazdığını tam olarak okur. Derleyici bunların hiçbirini okumaz. Feature hiç etiket bildirmediğinde ve türü hiçbir katalog varlığına çözümlenmediğinde bulunmaz.
catalog_annotationsstring eşlemihayırEklenen Feature’ın katalog açıklamaları — bu eklentinin adlandırdığı Feature varlığının metadata.annotations alanı — o varlığın bildirdiği sırayla olduğu gibi taşınır; hiçbir zaman filtrelenmez, normalleştirilmez veya öneki çıkarılmaz; böylece bir tüketici, yazarın kendi ad alanındaki anahtarlar dahil, katalog yazarının yazdığını tam olarak okur. Derleyici bunların hiçbirini okumaz. Bu eklentinin var olmasına neden olan açıklamayı adlandıran ve konumunu belirten annotation_key ve annotation_source alanlarından farklıdır: o ikisi eklentinin nasıl ortaya çıktığını bildirir, bu ise adlandırdığı varlığın meta verisini bildirir; features: bloğunda yazılmış bir eklenti bu açıklamaları taşır ama o ikisinden hiçbirini taşımaz. Feature hiç açıklama bildirmediğinde ve türü hiçbir katalog varlığına çözümlenmediğinde bulunmaz.
bindingstringhayırBu eklentinin doldurduğu eklenti yuvasını adlandırır; bildirilmiş hiçbir yuvayı doldurmadığında “free” değerini alır. Bir yuva iki yerden birinde bildirilir ve hangisi olduğuna eklentinin nereye yazıldığı karar verir: düğümün kendi eklenti bloğundaki bir eklenti, ana Component’in featuresSchema alanında bildirdiği bir yuvayı doldurur; bir bağlantıya yazılmış eklenti ise bağlantının soketinin, ana Component üzerindeki o soketin featuresSchema alanında bildirdiği bir yuvayı doldurur. Eşleştirme her ikisinde de ada göredir — Feature, bileşenin bloğunda ya da bağlantıda yuvanın adı altında eklendiğinde eklenti o yuvayı doldurur — bu nedenle değer, bildirilmiş yuva kümesinden tam bir anahtardır ve asla eklentinin anahtarından okunan bir şey değildir. Bir soketin yuva kümesi kapalıdır, çünkü bir bağlantıya soketinin bildirmediği bir ad altında yazılmış eklenti derlemeyi durdurur; bu nedenle bağlantı taşıyan bir eklenti asla free bildirmez. Yalın bir boolean yerine yuva adı taşınır, çünkü hangi yuvanın doldurulduğu yanıtın daha yararlı yarısıdır. Ana Component’in bildirilmiş yuva kümesi çözümlenemediğinde boştur; bu “free” durumundan farklıdır: free, bildirilmiş hiçbir yuvanın bu adı taşımadığına dair olumlu bir bulgudur.
valuesobjecthayırEklentinin operasyonel yapılandırma yükü. Bir kimlik bilgisi için, yazar hangi biçimi bildirdiyse o — bir gizli bilgi deposuna işaretçi ya da malzemenin kendisi.
infraobjecthayırBu eklenti için örnek başına fiziksel boyutlandırma.
injectobjecthayırBağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.
originstring (enum)hayırfeatures: bloğunda yazılmış eklentileri (explicit), açıklama güdümlü genişletme geçişinin ürettiği sentetik eklentilerden (annotation) ayırır; eklentinin value/infra yaprakları ikisinin karışımını taşıdığında ise mixed değerini alır (yaprak başına ayrıntı bu durumda köken eşlemlerinde bulunur). İzin verilen değerler: "explicit", "annotation", "mixed"
annotation_keystringhayırSentetik bir eklentiyi tetikleyen açıklamanın adı. origin explicit olduğunda bulunmaz.
annotation_sourcestringhayırAçıklama bildiriminin kaynak konumu, : biçiminde. origin explicit olduğunda bulunmaz.
values_provenanceFieldProvenance eşlemihayırvalues yükü için yaprak başına köken; noktalı yaprak yoluna göre anahtarlanır.
infra_provenanceFieldProvenance eşlemihayırinfra yükü için yaprak başına köken; noktalı yaprak yoluna göre anahtarlanır.
sensitivebooleanhayırBu eklenti bir yazarın hassas olarak bildirdiği malzemeyi işlediğinde true olur — ya eklenen Feature values, infra veya provides sütununda hassas bir yaprak bildirir ya da eklentinin doldurduğu yuva taşıdığı malzemeyi hassas olarak bildirir: ana Component’in aynı adlı eklenti yuvası ya da bir bağlantıya yazılmış eklenti için bağlantının soketinin bildirdiği o adlı yuva. Birleştirilmiş eklenti üzerinden bu bildirimlerden türetilir; asla bir değerin içeriğinden veya bir addan türetilmez. Bu bildirimlerin hiçbiri yoksa ayarlanmaz.
sensitive_injectstring eşlemlerinin eşlemihayırinject alanının, başvurduğu provides anahtarını eklenti Feature’ının hassas olarak bildirdiği teslim anahtarları; inject’in kendi biçiminde: önce mekanizma, ardından teslim anahtarı, değer olarak da başvurulan provides anahtarı. inject’in bir alt kümesidir. Eklenti hiçbir teslim mekanizması bildirmediğinde veya hassas hiçbir provides anahtarına başvurmadığında bulunmaz.
sensitive_payload_leavesstring[]hayırBu eklentinin values ve infra yükünün taşıdığı, ekli Feature’ın hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak: values. veya infra.. Burada okunan yük, eklentinin sonunda taşıdığı yüktür; bu nedenle Feature şemasının varsayılan olarak bildirdiği bir değerde duran yaprak, bir yazarın yazdığı yaprakla birlikte adlandırılır: doldurulmuş bir varsayılan, yükün taşıdığı bir veridir ve yalnızca yazılmış bloktan okunan bir işaretleme onu adsız bırakırdı. Bu, hassasiyet işaretlemesinin yaprak başına birimidir ve diğer ikisinin yanıtlamadığı bir soruyu yanıtlar: sensitive tüm eklenti için tek bir yanıt verir, sensitive_inject her inject teslim anahtarı için bir yanıt verir ve hiçbiri tek bir yaprağı adlandırmaz. Bir yaprak, Feature şemasının hassas olarak bildirdiği bir yol onu kapsadığında görünür: bildirim o yaprağı ya da onu içeren bir nesneyi adlandırır; dolayısıyla bir bildirimin kapsadığı nesnenin altındaki yaprak o bildirimle adlandırılır. Eşleştirme noktalı yol üzerinde segment segment yürür, yolun kendi metninden hiçbir şey okunmaz ve hiçbir değer incelenmez; böylece db konumundaki bir bildirim db.password yolunu kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Eklenti başına yanıt hiçbir zaman tek tek yapraklara yayılmaz; bu, okunabilir bırakılan bir yaprak hakkında yanlış bir şey ileri sürerdi. Anahtarın bulunmaması, bu eklentinin Feature’ının hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir. Yükün hassas olmadığını ileri sürmez ve adlandıracak böyle bir yaprağı olmayan bir eklentiyi bu ekseni hiç bildirmeyen bir üreticiden ayırmaz; bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir konuk onu tersinden okumuştur. Yapraklar yükün onları tuttuğu sırayla gelir, values sütununun yaprakları infra sütununun yapraklarından önce: values ve infra yüklerinin kendilerinin taşıdığı sırayla aynıdır ve yükü aynı girdinin çalıştırmaları arasında bayt bayt özdeş kılan budur. Eklenti, Feature’ının hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz.
connectionAttachmentConnectionhayırBu eklentinin ait olduğu bağlantı: düğümün bağlantılarından birine yazılan her eklentide bulunur, düğümün kendi eklenti bloğundaki her eklentide bulunmaz. Bir bağlantıya yazılan eklenti, diğer her bakımdan düğümün eklentilerinden biridir: nitelikli adıyla, yani bağlantının takma adı ile yuvanın bir noktayla birleştirilmesiyle anahtarlanır ve bağlamasını ve hassasiyetini bağlantının soketinin bildirdiği yuvadan alır; dolayısıyla ikisini birbirinden ayıran bu alandır ve bağlantıyı anahtardan okunmaya bırakmak yerine veri olarak taşır. Bir tüketici onu soket ve takma ada göre grafiğin kenarlarıyla birleştirir: kaynağı bu eklentiyi taşıyan düğüm olan ve soketi ile takma adı bunlar olan kenar, eklentinin sunulduğu bağlantıdır ve o kenarın hedefi, eklentinin sunulduğu şeydir. Bir Feature eklentisinin çizdiği bağlantının eklentisi hiçbir zaman bunu taşımaz, çünkü böyle bir bağlantı hiç eklenti taşımaz.
realizationstringhayırBu eklentiyi gerçekleştiren FeatureRecipe, : biçiminde: Manifest’in ona bağladığı FeatureRecipe (Manifest’in ad katmanı o adı eşliyorsa eklentinin kendi adıyla, aksi halde Feature türüyle); aynı belgelerin bir derlemesinin onu işlerken kullandığı da budur. Bir bağlantıya yazılan eklenti için ad katmanının okuduğu ad, nitelikli adıdır: bağlantının takma adı ile yuvanın bir noktayla birleştirilmesi. Değer, aggrega inspect’in eklentinin gerçekleştirmesi olarak yazdırdığı çifttir ve bir hedefin işlediği şeye köken damgası vurduğu yerlerde, o FeatureRecipe’nin işlediği belgelerdeki aggrega.ai/recipe-uri değeridir; böylece bir tüketici, biçimler arasında çeviri yapmadan bir eklentiyi işlediği şeyle birleştirir. FeatureRecipe’yi yeteneğe göre değil, ad ve sürüme göre adlandırır. Alan, grafik oluşturulurken Manifest’ten ve katalogdan okunarak Manifest’in hangi FeatureRecipe’yi bağladığını kaydeder: onu üretmek için hiçbir şey getirilmez ve FeatureRecipe yalnızca derleme işlediğinde işlenir. Manifest eklentiyi kataloğun barındırdığı hiçbir FeatureRecipe’ye bağlamadığında bulunmaz.

Ek özelliklere izin verilmez.

IRFeatureEntry.inject

Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırOrtam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır.
filestring eşlemihayırDosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır.
argstring eşlemihayırKomut satırı argümanı ile teslim: anahtarlar tüketicinin bayrak önekleridir, değerler hedefin provides anahtarlarıdır.

IRBoundaryFeature

IR’ye yansıtılan sınır düzeyinde bir Feature eklentisi: Feature tür URI’si ile birlikte, sınır kapsamlı bir FeatureRecipe’nin işlediği ve kaynağını karşısında çözümlediği sınır infra’sı. Sınır düzeyindeki eklentiler values yükü taşımaz.

ÖzellikTürZorunluAçıklama
typestringevetBu sınıra eklenen Catalog Feature’ının URI’si.
infraobjecthayırSınır eklentisi için fiziksel boyutlandırma; sınır kapsamlı bir FeatureRecipe’nin şablonlarını ve kaynağını karşısında değerlendirdiği infra.
sensitive_payload_leavesstring[]hayırBu sınır eklentisinin infra yükünün taşıdığı, ekli Feature’ın hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak. Burada yalnızca infra. koordinatları görünür, çünkü sınır düzeyindeki bir eklenti values yükü taşımaz. Burada okunan yük, eklentinin sonunda taşıdığı yüktür; bu nedenle Feature şemasının varsayılan olarak bildirdiği bir değerde duran yaprak, bir sınırın yazdığı yaprakla birlikte adlandırılır: doldurulmuş bir varsayılan, yükün taşıdığı bir veridir ve yalnızca yazılmış bloktan okunan bir işaretleme onu adsız bırakırdı. Bir yaprak, Feature şemasının hassas olarak bildirdiği bir yol onu kapsadığında görünür: bildirim o yaprağı ya da onu içeren bir nesneyi adlandırır; dolayısıyla bir bildirimin kapsadığı nesnenin altındaki yaprak o bildirimle adlandırılır. Eşleştirme noktalı yol üzerinde segment segment yürür, yolun kendi metninden hiçbir şey okunmaz ve hiçbir değer incelenmez; böylece db konumundaki bir bildirim db.password yolunu kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Anahtarın bulunmaması, bu eklentinin Feature’ının hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; buna ekli Feature’ın bu okuyucunun okuyabileceği hiçbir şemaya çözümlenmediği durum da dahildir. Infra yükünün hassas olmadığını ileri sürmez ve adlandıracak böyle bir yaprağı olmayan bir eklentiyi bu ekseni hiç bildirmeyen bir üreticiden ayırmaz. Bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar yükün onları tuttuğu sırayla gelir; bu, infra yükünün kendisinin taşıdığı sırayla aynıdır ve grafiği aynı girdinin çalıştırmaları arasında bayt bayt özdeş tutan budur. Eklenti, Feature’ının hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz.
realizationstringhayırBu sınır eklentisini gerçekleştiren FeatureRecipe, : biçiminde: Manifest’in ona bağladığı FeatureRecipe (Manifest’in ad katmanı o adı eşliyorsa eklentinin kendi adıyla, aksi halde Feature türüyle); aynı belgelerin bir derlemesinin onu işlerken kullandığı da budur. feature_values_mapping altındaki bir eklenti girdisinin gerçekleştirmesiyle aynı alandır ve aynı biçimde okunur. Manifest eklentiyi kataloğun barındırdığı hiçbir FeatureRecipe’ye bağlamadığında bulunmaz.

Ek özelliklere izin verilmez.

CatalogMetadata

Catalog varlığından açıkça çıkarılan, yaşam döngüsü ve sahiplik verilerini Wasm linter’larına sunan Kurumsal Meta Veri Paketi.

ÖzellikTürZorunluAçıklama
maintainersMaintainer[]hayırKatalog varlığının kendi sahipleri olarak listelediği bakımcılar.
licensestringhayırKatalog varlığının tanımladığı yazılım için bildirdiği SPDX lisans tanımlayıcısı.
repositorystringhayırKatalog varlığının kaynak dosyalarını barındıran yer olarak adlandırdığı Git deposunun URL’si.
homestringhayırKatalog varlığının ana sayfasının, wiki’sinin veya belgelerinin URL’si.
keywordsstring[]hayırKatalog varlığının bildirdiği tanımlayıcı anahtar sözcükler.

Ek özelliklere izin verilmez.

IRNode

ÖzellikTürZorunluAçıklama
descriptionstringhayırBu bileşen örneğinin uygulamadaki rolünü açıklayan, geliştiricinin yazdığı isteğe bağlı belgeler. İşleme ve lint tanılamaları için Aggregate’ten aktarılır.
labelsstring eşlemievetVarlığın ördek tiplemesi (duck typing) ve ontoloji etiketleri.
componentstringevetAlttaki Component’in adı.
resolved_versionstringevetDerleme sırasında çözümlenen Component’in tam Semantic Version değeri.
sync_waveintegerhayırİçeren sınırın syncWave alanından devralınan dağıtım dalgası (varsayılan 0; negatif değere izin verilir). K8s ve Helm’de dağıtımı sıralayan dalgadır: bir argocd.argoproj.io/sync-wave ek açıklamasına dönüşür ve chart’ın zaten Helm hook olarak işaretlediği bir kaynakta o hook’un helm.sh/hook-weight değerine de dönüşür. Compose’da değer hem bir servis etiketi olarak kaydedilir hem de render edildiği dosyanın servislerini aralarındaki depends_on aracılığıyla sıralar. CloudFormation’da bir dağıtım grubunun birleştiği stack’in sağlanmasını sıralar; bir dalgadaki her kaynağın, önceki dalganın kaynaklarına bağımlı olduğu bildirilir: bu, kaynakların oluşturulma sırası ve tersine silinme sırasıdır, asla hazır olma durumu değildir, çünkü bir stack şablonu bir kaynağın hazır olması kavramını ifade etmez. Terraform’da bir sınırın birleştiği kök yapılandırmanın module bloklarını sıralar; bir dalgadaki her modülün, önceki dalganın modüllerine bağımlı olduğu bildirilir: bu, motorun eylemlerini gerçekleştirme sırasıdır, asla hazır olma durumu değildir, çünkü bir yapılandırma bir kaynağın hazır olması kavramını ifade etmez. Değer, düğümün derleme kökeni bilgisiyle de birlikte taşınır.
boundary_pathstringhayırBu düğümün yerleştirildiği Release sınırının yolu: en dıştaki sınırdan içe doğru sınır adları, / ile birleştirilmiş olarak (ör. bir data sınırının içinde bildirilen bir inner sınırına yerleştirilmiş bir bileşen için ‘data/inner’). Bir sınır adı / içeremez, bu nedenle yol belirsizlik olmadan sınırlarına geri ayrılır. Release’in bir sınıra yönlendirdiği içe aktarılmış bir Aggregate’in düğümü o sınırın yolunu taşır. Render plugin’lerinin sınırdan haberdar benzersiz tanımlayıcılar üretmesini sağlar.
subsystem_pathstringhayırBu düğümün bileşeninin bildirildiği Aggregate alt sisteminin yolu: en dıştaki alt sistemden içe doğru alt sistem adları, . ile birleştirilmiş olarak (ör. bir backend alt sisteminin içine yerleştirilmiş bir storage alt sisteminde bildirilen bir bileşen için ‘backend.storage’). Bir alt sistem adı . içeremez, bu nedenle yol belirsizlik olmadan alt sistemlerine geri ayrılır. Üst düzey components bildiren bir Aggregate’in bileşeni, synthesized_subsystem ile işaretlenen sentezlenmiş default değerini taşır. Yol, bileşeni bildiren Aggregate’e görelidir: içe aktarılmış bir Aggregate’in katkıda bulunduğu düğüm, içe aktarıldığı ad olmadan o Aggregate içindeki yolunu taşır (ör. içe aktarılmış Aggregate’in tier alt sistemindeki bir bileşen için ‘tier’), bu nedenle farklı Aggregates’ten gelen düğümler aynı yolu paylaşabilir. Onları, içe aktarma adıyla başlayan düğüm kimliği ve source_file birbirinden ayırır.
synthesized_subsystembooleanhayırBu düğümün alt sistemi derleyici tarafından sentezlendiğinde true: adlandırılmış subsystems yerine üst düzey components bildiren bir Aggregate için oluşturulan default alt sistemi. Türetilmiş köken bilgisidir, asla yazar tarafından yazılmaz: sentezlenmiş default alt sistemini, bir kullanıcının açıkça default olarak adlandırdığı alt sistemden ayırır. synthesized_boundary alanından bağımsızdır (bir düğüm eksenlerden birinde veya her ikisinde sentezlenmiş olabilir). Yazar tarafından yazılmış her alt sistem için yoktur (false).
synthesized_boundarybooleanhayırBu düğümün sınırı derleyici tarafından sentezlendiğinde true: adlandırılmış boundaries yerine üst düzey components bildiren bir Release için oluşturulan default sınırı. Türetilmiş köken bilgisidir, asla yazar tarafından yazılmaz: sentezlenmiş default sınırını, bir kullanıcının açıkça default olarak adlandırdığı sınırdan ayırır ve düğümün yapıtlarını dist/boundaries/default/ yerine düz olarak dist/ dizinine yönlendirir. Yazar tarafından yazılmış her sınır için yoktur (false).
catalog_metadataCatalogMetadatahayırCatalog varlığından açıkça çıkarılan, yaşam döngüsü ve sahiplik verilerini Wasm linter’larına sunan Kurumsal Meta Veri Paketi.
catalog_annotationsstring eşlemihayırDomain 2’de Platform Mimarı tarafından yazılan, değişmez ve içsel bileşen özellikleri.
release_annotationsstring eşlemihayırRelease’teki sınırlardan aşağı doğru aktarılan fiziksel topoloji dizeleri ve operasyonel gerçeklikler.
aggregate_annotationsstring eşlemihayırAggregate’teki alt sistemlerden aşağı doğru aktarılan bilişsel meta veriler, geliştirici niyeti ve FinOps bilgileri.
self_injectobjecthayırAggregate’ten taşınan, Component düzeyindeki self-inject bloğu; düğümün kendisi için bildirdiği bağımsız enjeksiyon yönlendirmesi. Bu şema katmanında opaktır; onu okuyan bir politika plugin’i baytları ayrıştırır.
source_filestringhayırBu düğümün yazıldığı Aggregate dosyasının çalışma alanına göreli yolu. Kök katman düğümleri kök Aggregate’in yolunu taşır; alt aggregate düğümleri içe aktarılmış Aggregate’in dosya yolunu taşır. Yol, çalışma alanı köküne (.aggrega-config.yaml dosyasını içeren dizin) görelidir; bu nedenle grafik, çalışma alanları farklı mutlak yollarda bulunan makinelerde bayt bayt aynıdır. Tanılamaları dosya bazında filtreleyen tüketiciler, karşılaştırmadan önce alanı aynı çalışma alanı köküne göre çözümler. Grafik bir çalışma alanı kökü olmadan oluşturulduğunda bulunmaz.
usesobjecthayırDüğümün uses bloğu, tam olarak yazıldığı gibi: her soket adı, yazarın bildirdiği sırayla, ya hedef örnek adlarından oluşan bir listeye ya da bağlantı girdilerinden oluşan, takma adla anahtarlanmış bir eşleme eşlenir. Bu, yazıldığı haliyle bloktur ve edges içindeki çözümlenmiş bağlantılardan farklı bir olgudur: yazarın doldurduğu bir soket, hiçbir bağlantı üretmediği yerde bile burada görünür; böylece okuyucu, yazarın doldurduğu bir soketi bir hedefe ulaşan soketten ayırt edebilir. Düğüm bir uses bloğu yazmadığında yoktur. Bu şema katmanında opaktır; onu okuyan bir politika plugin’i baytları ayrıştırır.
sensitive_payload_leavesstring[]hayırBu düğümün values ve infra yükünün taşıdığı ve Component’inin hassas olarak bildirdiği yapraklar; her biri, verinin bulunduğu, sütun önekli noktalı yol olarak: values. veya infra.. Düğümün KENDİ verisini, yani values_mapping ve infra_mapping alanlarının bu düğüm için taşıdığını adlandırır ve bir eklenti girdisindeki işaretlemeden farklı bir konudur; o işaretleme, bir eklentinin Feature’ının bildirimine karşı taşıdığı verileri adlandırır. Hiçbiri diğerinden elde edilemez: bir düğümün Component’i ile bir eklentinin Feature’ı farklı şemalar bildirir ve hiçbir şey eklemeyen bir düğüm de values taşır. Burada okunan yük, bu iki eşlemenin taşıdığı yüktür; bu nedenle Component’in şemasının varsayılan olarak bildirdiği bir değerde duran yaprak, bir yazarın yazdığı yaprakla birlikte adlandırılır: doldurulmuş bir varsayılan, grafiğin taşıdığı bir veridir ve yalnızca yazılmış bloklardan okunan bir işaretleme onu adsız bırakırdı. Bir yaprak, Component’in şemasının hassas olarak bildirdiği bir yol onu kapsadığında görünür: bildirim o yaprağı ya da onu içeren bir nesneyi adlandırır; böylece bir bildirimin kapsadığı nesnenin altındaki yaprak o bildirimle adlandırılır. Eşleştirme noktalı yol üzerinde segment segment yapılır; yolun kendi metninden hiçbir şey okunmaz ve hiçbir değer incelenmez; bu nedenle db üzerindeki bir bildirim db.password yaprağını kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Anahtarın yokluğu, bu düğümün Component’inin hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; buna düğümün Component’inin bu okuyucunun okuyabileceği hiçbir şemaya çözümlenmediği durum da dahildir. Düğümün yükünün hassas olmadığını öne sürmez ve adlandırılacak böyle bir yaprağı olmayan bir düğümü, bu ekseni hiç raporlamayan bir üreticiden ayırmaz. Anahtarın yokluğunu bir değeri açık metin olarak görüntüleme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar, yükün onları tuttuğu sırayla gelir; values sütununun yaprakları infra sütunununkilerden önce gelir; bu, o yüklerin kendilerinin taşıdığı sırayla aynıdır ve grafiği aynı girdinin çalıştırmaları arasında bayt bayt aynı tutan da budur. Düğüm, Component’inin hassas olarak bildirdiği hiçbir yaprak taşımadığında yoktur.

Ek özelliklere izin verilmez.

IREdge

ÖzellikTürZorunluAçıklama
sourcestringevetBağlantının başladığı, tüketen düğümün ID’si.
targetstringevetBağlantının ulaştığı düğümün ID’si.
socketstringhayırBu kenarın ait olduğu usesSchema kategorisi (ör. ‘databases’, ‘tools’).
aliasstringhayırBu bağlantı için geliştiricinin tanımladığı takma ad (ör. ‘primary_db’).
socket_declarationstring (enum)evetSoketin nereden geldiği: soketin sahibi olan katalog varlığı (tüketen Component ya da Feature tarafından yazılmış bir kenar için kaynak Feature) soketi usesSchema içinde listelediğinde declared, Aggregate yazarı kataloğun bildirmediği bir soketi adlandırdığında ad-hoc. Bu, kenarın yazarlığından bağımsız üçüncü bir eksendir: kenarı kimin çizdiğini değil, soketin nereden geldiğini söyler; bu nedenle bildirilmiş bir sokete giden Release tarafından yazılmış bir kenar ile ad-hoc bir sokete giden Aggregate tarafından yazılmış bir kenar iki eksende birbirinden bağımsız olarak farklılaşır. Bildirilmiş bir soket, kenarın hangi hedeflere ulaşabileceğini kısıtlayan seçici dahil olmak üzere usesSchema girdisini taşır; ad-hoc bir soketin katalog girdisi ve dolayısıyla seçicisi yoktur, bu yüzden kenarın ne taşıyabileceği yalnızca hedefin bildirdiği provides ile sınırlanır. Her zaman bulunur; böylece bir tüketici hiçbir zaman eksik bir değeri declared olarak okumak zorunda kalmaz ve bir politika her kenarın declared olmasını şart koşabilir. Aynı biçimdeki soruyu farklı bir konu için yanıtlayan bir eklentinin bağlama işaretçisinden farklıdır. İzin verilen değerler: "declared", "ad-hoc"
origin_featurestringhayırBu kenar bir Feature tarafından (feature.aggrega.ai/kind: secret etiketli kimlik bilgisi Features dahil) özerk olarak bildirildiyse, Feature tür URI’sini tanımlar. Wasm eklentilerinin kendi topolojilerini ayırmasını sağlar.
origin_feature_instancestringhayırBu kenarı bildiren Feature’ın eklenti başına örnek adı. Sınır kapsamlı bir FeatureRecipe’in çözümlenmiş provides değerlerini örneğe göre bulur ve aynı sınırdaki aynı Feature türünün iki eklentisini birbirinden ayırır.
origin_releasebooleanhayırBu kenar, bildirilmiş ancak bağlanmamış bir soketi mevcut bir bileşene bağlayan bir Release tarafından oluşturulduğunda true. Yapılandırmayı değil, kenar YAZARLIĞINI işaretler: bir Release’in yalnızca infra sağladığı, geliştirici tarafından bildirilmiş bir kenar Aggregate kaynaklı kalır (origin_release ayarlanmamış; Release infra’sı kenarın infra eşleminde görünür). origin_feature ayarlı => Feature kaynaklı; origin_release true => Release kaynaklı; hiçbiri => Aggregate kaynaklı.
valuesobjecthayırBu kenar için çözümlenmiş, bağlantı başına geliştirici değerleri (Aggregate kenarından); çözümleme sırasında kaynak soketin (kenarın kaynağı olan, tüketen bileşendeki soket) bildirdiği valueSchema’ya göre doğrulanır ve tüketen düğümün render bağlamına .context.uses..values konumunda yansıtılır. Yazarın atladığı anahtarlar soketin bildirdiği varsayılanlarla doldurulur; yazılmış bir değer önceliklidir.
infraobjecthayırBu kenar için bir Release kenar girdisinin sağladığı, çözümlenmiş bağlantı başına infra; çözümleme sırasında kaynak soketin (kenarın kaynağı olan, tüketen bileşendeki soket) bildirdiği infraSchema’ya göre doğrulanır ve .context.uses..infra konumunda yansıtılır. Yazarın atladığı anahtarlar soketin bildirdiği varsayılanlarla doldurulur; yazılmış bir değer önceliklidir.
injectobjecthayırBağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.
sensitive_payload_leavesstring[]hayırBu kenarın values ve infra yüklerinin taşıdığı ve bu yüklerin yazıldığı soketin hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak: values. veya infra.. Okunan bildirim, TÜKETEN bileşen — kenarın kaynağı — üzerinde, bu kenarın bağlandığı soketin altındaki bağlantı başına sözleşmedir: valueSchema’sı values yükünü, infraSchema’sı infra yükünü yönetir; bu, her iki yükün de doğrulandığı sözleşmenin aynısıdır. Hedefin bildirimlerinin hiçbir rolü yoktur: hedefin yayımladığı şey, tüketicinin bağlantı için yazdığı yapılandırmadan farklı bir veridir. Bu, bir düğümdeki işaretlemeyle aynı alandır ve aynı şekilde okunur, ancak konusu ondan farklıdır: bir düğümün işaretlemesi düğümün kendi verisini Component’inin şemasına göre adlandırır, bu ise bağlantının yapılandırmasını soketin sözleşmesine göre adlandırır; dolayısıyla hiçbiri diğerinden elde edilemez. Burada okunan yükler bu kenarın taşıdığı yüklerdir; bu nedenle soketin sözleşmesinin varsayılan olarak bildirdiği bir değerde duran yaprak, bir yazarın yazdığı yaprakla birlikte adlandırılır. Bir yaprak, sözleşmenin hassas olarak bildirdiği bir yol onu kapsadığında görünür: bildirim o yaprağı ya da onu içeren bir nesneyi adlandırır. Eşleştirme noktalı yol üzerinde segment segment yürür, yolun kendi metninden hiçbir şey okunmaz ve hiçbir değer incelenmez; böylece db konumundaki bir bildirim db.password yolunu kapsar ve db_password adlı kardeş yaprağa ulaşmaz. Hassas olarak bildirilmiş değerleri graftan gizleyen bir yüzey, bu yaprakları bu kenarın values ve infra yüklerinde ve tüketen düğümün aynı bağlantıya ait uses girdisinde gizler; bu girdi değerleri yazarın yazdığı biçimde taşır. Anahtarın bulunmaması, bu kenarın, soketinin sözleşmesinin hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; soketin burada okunabilecek bir sözleşme bildirmediği durum da buna dahildir. Yapılandırmanın hassas olmadığını ileri sürmez ve bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar yüklerin onları tuttuğu sırayla gelir, values sütununun yaprakları infra sütununun yapraklarından önce; grafı aynı girdinin çalıştırmaları arasında bayt bayt özdeş tutan budur. Kenar, soketinin sözleşmesinin hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz.

Ek özelliklere izin verilmez.

IREdge.inject

Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırOrtam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır.
filestring eşlemihayırDosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır.
argstring eşlemihayırKomut satırı argümanı ile teslim: anahtarlar tüketicinin bayrak önekleridir, değerler hedefin provides anahtarlarıdır.

IRMetadata

Grafın kimliği: grafın derlendiği Aggregate.

ÖzellikTürZorunluAçıklama
aggregate_namestringevetAggregate’in metadata.name değeri.

Ek özelliklere izin verilmez.

IRProvenance

Tanılama ve denetim için izlenebilirlik meta verileri.

ÖzellikTürZorunluAçıklama
schema_versionstringevetGrafiğin uyduğu IR şemasının sürümü: aggrega.ai/v1beta1, grafiğin apiVersion alanının taşıdığı değerle aynı.
compiler_versionstringevetZorunlu uyumluluk damgası. Bu grafiği oluşturan aggrega ikili dosyasını sürümüyle tanımlar.
aggregate_versionstringevetDerleme sırasında kullanılan kök Aggregate amacının tam semantik sürümü.
manifest_versionstringevetDerleme sırasında kullanılan Manifest kilit dosyasının tam semantik sürümü.
release_versionstringevetDerleme sırasında kullanılan Release yönlendirme dosyasının tam semantik sürümü.

Ek özelliklere izin verilir.

IRSpec

Grafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri.

ÖzellikTürZorunluAçıklama
nodesIRNode eşlemievetGrafikteki tüm düğümlerin mutlak kimliklerine göre anahtarlanmış sözlüğü. Tamamen topolojiktir. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta ya da kısa çizgi. Desen: ^[a-zA-Z0-9_.-]+$.
edgesIREdge[]evetDüğümler arasındaki açık mantıksal ağ yolları ve bağımlılıklar.
values_mappingobjectevetDüğüm kimliğine göre eşlenmiş, opak olarak aktarılan bilişsel yükler için tek doğruluk kaynağı.
infra_mappingobjectevetRelease’ten enjekte edilen, düğüm kimliğine göre eşlenmiş fiziksel boyutlandırma yükü.
feature_values_mappingIRFeatureEntry eşlemi eşlemievetDüğüm kimliklerinin bağlı Feature yapılandırmalarına normalleştirilmiş eşlemi. Tek bir grup, ne ürettiğinden bağımsız olarak bir düğümdeki her eklentiyi (operasyonel Features, kimlik bilgisi Features, kimlik Features) taşır ve yazarın her eklentiye verdiği örnek adına göre anahtarlanır. Düğümün bağlantılarından birine yazılmış bir eklenti, nitelikli adıyla, yani bağlantının takma adı ile yuvanın noktayla birleştirilmesiyle anahtarlanır ve bağlantısını kendi connection alanında adlandırır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta ya da kısa çizgi. Desen: ^[a-zA-Z0-9_.-]+$.
boundary_featuresIRBoundaryFeature eşlemi eşlemihayırHer sınırın Feature eklentileri; önce sınır yoluna, sonra örnek adına göre anahtarlanır. Yalnızca grafikte sınır düzeyinde Feature eklentileri olduğunda bulunur. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta, eğik çizgi ya da kısa çizgi. Desen: ^[a-zA-Z0-9_./-]+$.
provenanceIRProvenanceevetTanılama ve denetim için izlenebilirlik meta verileri.

Ek özelliklere izin verilmez.

IRGraph

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “IR”evetSabit: "IR"
metadataIRMetadataevetGrafın kimliği: grafın derlendiği Aggregate.
specIRSpecevetGrafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri.

Ek özelliklere izin verilmez.