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

Aggrega Wasm içe aktarıcı soket şeması

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

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

Bir içe aktarıcı plugin soketinin tükettiği (ImportInput) ve ürettiği (ImportOutput) iletim biçimleri. Bir içe aktarıcı, yabancı bir altyapı tanımını Aggrega varlıklarına dönüştürür: adı verilen bir biçim için kaynak baytları okur, her kaynak düğümünü bir katalog varlığına eşler ve ürettiği varlıkları, verdiği eşleme kararlarını, oluşturduğu tanılamaları ve ürettiği iskele dosyalarını döndürür. Bir içe aktarıcı, işlediği biçimleri tanımlayıcısında import: yetenekleri olarak bildirir. İçe aktarıcı anlamı kaynaktan varlıklara eşler; derleyici ise üretilen varlıkları içeriklerine bakmadan aktarır.

Aşağıdaki biçimlerden biri

  • ImportInput
  • ImportOutput

Tanımlar

ImportInput

Bir içe aktarıcı konuğun aldığı yük: baytların nasıl okunacağını seçen kaynak biçimi, birincil kaynak baytları ve bunların okunduğu dosyanın adı, çok dosyalı bir içe aktarma için varsa adlandırılmış kaynaklar, tüketicinin içe aktarıcıya özgü davranış için sağladığı isteğe bağlı opak bir seçenekler belgesi, çalışma alanının kataloğunun barındırdığı Components’in bir görünümü ve içe aktarmanın taslak hazırladığı hedef.

ÖzellikTürZorunluAçıklama
formatstringevetİçe aktarılacak kaynak biçiminin adı; içe aktarıcının duyurduğu import: yeteneklerinden biriyle eşleşir. İçe aktarıcı kaynakları bu biçimde okur.
bytesstringevetİçe aktarılacak birincil kaynak baytları; içe aktarıcı bunları adı verilen biçimde okur: içe aktarmanın kaynağı tek bir dosya olduğunda dosyanın tamamı, bir dizin olduğunda ise boştur; dizinin dosyaları bunun yerine adlandırılmış kaynaklar olarak gelir. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, içe aktarıcının baytları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile hattın baytları taşıdığı biçim arasında dönüşüm yapar.
namestringhayırİçe aktarmanın kaynağının adı, önünde dizin olmadan; böylece bir içe aktarıcı, bildirdiklerinde ve taslağını oluşturduklarında kaynağı adlandırabilir. Kaynak tek bir dosya olduğunda, dosyanın temel adıdır: birincil baytlar adlandırılmış bir kaynak olarak gelmez; bu nedenle taşıdıkları tek ad budur. Kaynak bir dizin olduğunda, dizinin temel adıdır ve dizinin dosyaları yine her biri kendi adıyla adlandırılmış kaynaklar olarak gelir, birincil baytlar ise boş olur. Kaynağın verecek bir adı olmadığında bulunmaz.
sourcesImportSource[]hayırHer biri kendi baytlarını taşıyan, ada göre sıralanmış tek bir listedeki adlandırılmış kaynaklar. İçe aktarmanın kaynağı bir dizin olduğunda, dizinin içe aktarıcının bildirdiği dosya kalıplarının seçtiği her dosyası için bir tane bulunur ve dizin içindeki eğik çizgiyle ayrılmış yoluyla adlandırılır. İçe aktarıcıyı yapılandıran eklemenin with.sources altında bildirdiği dosyalar da burada, her biri temel adıyla taşınır ve ana makine, dizinden okunan bir dosyanın bunlardan biriyle aynı adı taşıdığı bir içe aktarmayı reddeder. Hiçbiri bir şey sağlamadığında bulunmaz.
settingsherhangihayırTüketicinin içe aktarıcıya özgü davranış için sağladığı opak bir içe aktarma seçenekleri belgesi. Ana makine onu yorumlamadan iletir; içe aktarıcı, belgelediği biçim neyse onu okur. Tüketici hiçbir seçenek sağlamadığında bulunmaz.
catalogCatalogProjectionhayırÇalışma alanının kendi kataloğunun — içe aktarıcının kendisinin seçildiği kataloğun — barındırdığı Components’in bir görünümü; böylece içe aktarıcı bir kaynak düğümünü bir katalog varlığına eşlerken bunları aday olarak değerlendirebilir. Ana makine bunu yalnızca o yerel katalogdan oluşturur ve yalnızca adları, sürümleri, etiketleri ve bildirilen yapıyı taşır: asla bir değer, bir varsayılan ya da bir gizli bilgi taşımaz. Sırası sabittir, bu nedenle bir katalog tek bir bayt dizisi verir. Katalog hiçbir Component barındırmadığında bulunmaz.
targetstringhayırİçe aktarmanın taslak hazırladığı sağlayıcı yeteneği, örneğin compose veya helm: içe aktarmaya verilen hedef ya da daha önceki bir içe aktarmayı yenileyen ve kendisi hiçbir hedef belirtmeyen bir içe aktarma için, o önceki içe aktarmanın kaydettiği hedef. Bir içe aktarıcı, yalnızca o hedefin ihtiyaç duyduğu şeyleri taslaklara bildirimler olarak yazar ve yalnızca başka bir hedefin ihtiyaç duyduğu şeyleri dışarıda bırakır. Ana makine, çalışma alanının kataloğundaki bir Recipe’nin ona bağlandığını denetledikten sonra onu verildiği gibi iletir. İçe aktarma hiçbir hedef belirtmediğinde yoktur.

Ek özelliklere izin verilmez.

CatalogProjection

Bir içe aktarıcının gördüğü biçimiyle çalışma alanının kataloğu: kataloğun barındırdığı her Component için bir girdi; her biri, bir içe aktarıcının bir adayı puanlarken değerlendirdiği meta verileri taşır.

ÖzellikTürZorunluAçıklama
componentsCatalogComponent[]evetKataloğun barındırdığı her Component adı için bir girdi, ada göre sıralanmış. Katalog bir Component’in birden çok sürümünü barındırdığında, girdisi Component’i sürüm belirtmeden adlandıran bir başvurunun çözümlendiği sürümü açıklar.

Ek özelliklere izin verilmez.

CatalogComponent

Çalışma alanının kataloğundaki bir Component: adı ve sürümü, etiketleri, values ve provides alanlarının bildirdiği anahtar adları ve bağımlılıkları için bildirdiği soketler. Başka birini genişleten bir Component, kendi bildirdiklerinin yanı sıra devraldıklarını da taşır.

ÖzellikTürZorunluAçıklama
namestringevetComponent’in metadata.name alanında bildirildiği şekliyle adı — bir Aggregate’in ona başvurduğu ad.
versionstringevetComponent’in metadata.version alanında bildirildiği şekliyle sürümü.
labelsstring eşlemihayırComponent’in etiketleri, string’den string’e bir eşlem olarak. Hiç etiket taşımadığında bulunmaz.
valuesstring[]hayırComponent’in values alanının bildirdiği üst düzey anahtar adları, sıralanmış. Yalnızca adlardan oluşan bir liste: asla bir değer ya da bir varsayılan taşımaz. values alanı hiçbir anahtar bildirmediğinde bulunmaz.
providesstring[]hayırComponent’in provides alanının bildirdiği üst düzey anahtar adları, sıralanmış. Yalnızca adlardan oluşan bir liste: asla bir değer taşımaz. provides alanı hiçbir anahtar bildirmediğinde bulunmaz.
socketsCatalogSocket[]hayırComponent’in bağımlılıkları için bildirdiği soketler, bildirim sırasıyla: başka birini genişleten bir Component için önce devraldığı soketler, genişletilen Component’in bunları bildirdiği sırayla gelir, ardından eklediği soketler gelir. Hiç soket bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

CatalogSocket

Bir katalog Component’inin bağımlılıkları için bildirdiği bir soket: soketin adı ve bu soket üzerinden bağlanan bir bağımlılığın karşılaması gereken etiket seçici.

ÖzellikTürZorunluAçıklama
namestringevetSoketin, Component’in usesSchema alanında bildirildiği şekliyle adı.
selectorstringevetSoketin etiket seçicisi, Component’in yazdığı Kubernetes tarzı dilbilgisinde, olduğu gibi: bu soket üzerinden bağlanan bir bağımlılığın taşıması gereken etiketler.

Ek özelliklere izin verilmez.

ImportSource

Çok dosyalı ya da dizin içe aktarmasındaki bir adlandırılmış kaynak: kaynağın yerini belirten bir ad ve kendi baytları.

ÖzellikTürZorunluAçıklama
namestringevetBu kaynağın içe aktarma içindeki adı; örneğin göreli bir dosya yolu.
bytesstringevetBu kaynağın baytları. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, içe aktarıcının baytları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile hattın baytları taşıdığı biçim arasında dönüşüm yapar.

Ek özelliklere izin verilmez.

ImportOutput

Bir içe aktarıcı konuğun döndürdüğü yük: içe aktarmanın ürettiği varlıklar, bunların ardındaki eşleme kararları, içe aktarmanın ortaya çıkardığı tanılamalar ve ürettiği iskele dosyaları. Her alan isteğe bağlıdır; bu nedenle hiçbir şeyi çözümlemeyen bir içe aktarma yalnızca tanılamalar döndürebilir.

ÖzellikTürZorunluAçıklama
entitiesEmittedEntity[]hayırİçe aktarmanın ürettiği varlıklar; her biri ya mevcut bir katalog varlığına bir başvuru ya da taslak olarak hazırlanmış bir varlık gövdesidir. İçe aktarma hiçbir varlık yaymadığında bulunmaz.
decisionsImportDecision[]hayırİçe aktarmanın verdiği eşleme kararları; çözümlediği her kaynak düğümü için bir tane olup değerlendirdiği adayları ve yaptığı seçimi kaydeder. İçe aktarma hiçbir karar kaydetmediğinde bulunmaz.
diagnosticsDiagnostic[]hayırİçe aktarmanın ortaya çıkardığı tanılamalar — örneğin çözümlenmemiş bir kaynak düğümü ya da belirsiz bir eşleme. İçe aktarma hiç tanılama üretmediğinde bulunmaz.
filesScaffoldFile[]hayırİçe aktarmanın varlıkların yanında ürettiği iskele dosyaları; örneğin bir başlangıç aggregate’i ya da bir readme. İçe aktarma hiç dosya üretmediğinde bulunmaz.
errorstringhayırKonuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır.

Ek özelliklere izin verilmez.

EmittedEntity

İçe aktarmanın ürettiği bir varlık: türü, adı ve nasıl yayıldığı — mevcut bir katalog varlığına bir başvuru ya da yeni taslağı hazırlanmış bir varlık gövdesi.

ÖzellikTürZorunluAçıklama
kindstringevetYayılan varlığın türü. Çekirdek içe aktarıcılar Component, Aggregate ve Release yayar; bir okuyucu başka herhangi bir türü hoş görür.
namestringevetYayılan varlığın adı.
modestring (enum)evetVarlığın nasıl yayıldığı: reference, mevcut bir katalog varlığını adıyla işaret eder; draft ise yeni taslağı hazırlanmış bir varlık gövdesi taşır. İzin verilen değerler: "reference", "draft"
bodystringhayırTaslağı hazırlanmış bir varlığın ham YAML gövdesi. Bir varlığın taslağını hazırlamak yerine mevcut bir varlığı adlandıran saf bir başvuru için boştur.
labelsstring eşlemihayırYayılan varlığa eklenecek etiketler, string’den string’e bir eşlem olarak. Çekirdek içe aktarıcılar bunu boş bırakır.
annotationsstring eşlemihayırYayılan varlığa eklenecek ek açıklamalar, string’den string’e bir eşlem olarak. Çekirdek içe aktarıcılar bunu boş bırakır.
sourceRefstringhayırBu varlığın yayıldığı kaynak düğümüne bir başvuru; böylece bir okuyucu varlığı içe aktarılan kaynaktaki kökenine kadar izleyebilir.
decisionRefstringhayırBu varlığı üreten eşleme kararına bir başvuru; varlığı değerlendirilen adaylara ve yapılan seçime bağlar.

Ek özelliklere izin verilmez.

ImportDecision

Tek bir eşleme kararı: içe aktarıcının çözümlediği kaynak düğüm, tarttığı aday katalog varlıkları, seçtiği aday ve seçimin ardındaki gerekçe.

ÖzellikTürZorunluAçıklama
sourceNodeDecisionSourceNodeevetBu kararın çözümlediği kaynak düğüm: içe aktarıcının kaynaktan okuyup bir katalog varlığına eşlediği düğüm.
candidatesImportCandidate[]hayırİçe aktarıcının bu kaynak düğüm için tarttığı aday katalog varlıkları; her biri puanıyla ve o puanın ardındaki sinyal bazında dökümle birlikte. İçe aktarıcı hiçbir adayı tartmadığında bulunmaz.
chosenDecisionChoicehayırİçe aktarıcının bu kaynak düğüm için seçtiği aday ve onu nasıl yaydığı. İçe aktarıcı hiçbir seçim yapmadığında bulunmaz.
rationalestringhayırİçe aktarıcının bu seçimi neden yaptığına dair insan tarafından okunabilir bir açıklama.
swapHintstringhayırOkuyucunun kararı gözden geçirebilmesi için seçilen eşlemenin bir alternatifle nasıl değiştirileceğini açıklayan bir ipucu.

Ek özelliklere izin verilmez.

DecisionSourceNode

Bir eşleme kararının çözümlediği kaynak düğüm: bir tanımlayıcı, kaynağın ona verdiği tür ve parametrelerinin insan tarafından okunabilir bir özeti.

ÖzellikTürZorunluAçıklama
idstringevetKaynak düğümün içe aktarılan kaynak içindeki tanımlayıcısı.
typestringevetKaynak düğümün, kaynağın adlandırdığı şekliyle türü.
paramsSummarystringevetKaynak düğümün parametrelerinin, kararla birlikte gösterilmek üzere insan tarafından okunabilir bir özeti.

Ek özelliklere izin verilmez.

ImportCandidate

İçe aktarıcının bir kaynak düğüm için tarttığı tek bir aday katalog varlığı: aday bileşen, genel puanı, puanın düştüğü eşleşme kademesi ve puanın ardındaki sinyal bazında döküm.

ÖzellikTürZorunluAçıklama
componentNamestringevetAday katalog bileşeninin adı.
scorenumberevetAdayın, sinyal bazında dökümden toplanan genel eşleşme puanı.
tierstringevetAdayın düştüğü eşleşme kademesi; puan üzerinde kaba bir aralık.
signalsCandidateSignalsevetAdayın puanının ardındaki sinyal bazında döküm.

Ek özelliklere izin verilmez.

CandidateSignals

Bir adayın puanının ardındaki sinyal bazında döküm: eşleşen her sinyal için bir katkı. Sabit alanlı bir nesnedir; böylece sinyal kümesi kararlıdır ve iletim biçimi deterministiktir.

ÖzellikTürZorunluAçıklama
tablenumberevetEşleme tablosu sinyalinden gelen puan katkısı.
categorynumberevetKategori sinyalinden gelen puan katkısı.
domainLabelsnumberevetAlan etiketleri sinyalinden gelen puan katkısı.
shapenumberevetŞekil sinyalinden gelen puan katkısı.
namenumberevetAd sinyalinden gelen puan katkısı.

Ek özelliklere izin verilmez.

DecisionChoice

Bir eşleme kararının seçtiği aday: hedef katalog varlığı, nasıl yayıldığı ve seçimin eşleşme kademesi.

ÖzellikTürZorunluAçıklama
targetstringevetSeçilen hedef katalog varlığının adı.
modestringevetSeçilen hedefin, yayılan bir varlığın kipini yansıtacak şekilde nasıl yayıldığı: mevcut bir varlığa başvuru ya da yeni taslağı hazırlanmış bir gövde.
tierstringevetSeçilen hedefin eşleşme kademesi.

Ek özelliklere izin verilmez.

ScaffoldFile

İçe aktarmanın ürettiği tek bir iskele dosyası: içe aktarma çıktı köküne göre bir yol ve dosyanın içeriği.

ÖzellikTürZorunluAçıklama
pathstringevetİskele dosyasının, içe aktarma çıktı köküne göre yolu.
contentstringevetİskele dosyasının içeriği.

Ek özelliklere izin verilmez.