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:
Aşağıdaki biçimlerden biri
ImportInputImportOutput
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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
format | string | evet | İçe aktarılacak kaynak biçiminin adı; içe aktarıcının duyurduğu import: |
bytes | string | evet | İç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. |
name | string | hayı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. |
sources | ImportSource[] | hayır | Her 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. |
settings | herhangi | hayır | Tü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. |
catalog | CatalogProjection | hayı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. |
target | string | hayı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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
components | CatalogComponent[] | evet | Kataloğ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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Component’in metadata.name alanında bildirildiği şekliyle adı — bir Aggregate’in ona başvurduğu ad. |
version | string | evet | Component’in metadata.version alanında bildirildiği şekliyle sürümü. |
labels | string eşlemi | hayır | Component’in etiketleri, string’den string’e bir eşlem olarak. Hiç etiket taşımadığında bulunmaz. |
values | string[] | hayır | Component’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. |
provides | string[] | hayır | Component’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. |
sockets | CatalogSocket[] | hayır | Component’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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Soketin, Component’in usesSchema alanında bildirildiği şekliyle adı. |
selector | string | evet | Soketin 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ı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Bu kaynağın içe aktarma içindeki adı; örneğin göreli bir dosya yolu. |
bytes | string | evet | Bu 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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
entities | EmittedEntity[] | 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. |
decisions | ImportDecision[] | 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. |
diagnostics | Diagnostic[] | 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. |
files | ScaffoldFile[] | 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. |
error | string | hayır | Konuk ç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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Yayı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. |
name | string | evet | Yayılan varlığın adı. |
mode | string (enum) | evet | Varlığı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" |
body | string | hayır | Taslağı 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. |
labels | string eşlemi | hayır | Yayılan varlığa eklenecek etiketler, string’den string’e bir eşlem olarak. Çekirdek içe aktarıcılar bunu boş bırakır. |
annotations | string eşlemi | hayır | Yayı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. |
sourceRef | string | hayır | Bu 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. |
decisionRef | string | hayır | Bu 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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
sourceNode | DecisionSourceNode | evet | Bu 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. |
candidates | ImportCandidate[] | 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. |
chosen | DecisionChoice | hayı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. |
rationale | string | hayır | İçe aktarıcının bu seçimi neden yaptığına dair insan tarafından okunabilir bir açıklama. |
swapHint | string | hayır | Okuyucunun 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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | evet | Kaynak düğümün içe aktarılan kaynak içindeki tanımlayıcısı. |
type | string | evet | Kaynak düğümün, kaynağın adlandırdığı şekliyle türü. |
paramsSummary | string | evet | Kaynak 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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
componentName | string | evet | Aday katalog bileşeninin adı. |
score | number | evet | Adayın, sinyal bazında dökümden toplanan genel eşleşme puanı. |
tier | string | evet | Adayın düştüğü eşleşme kademesi; puan üzerinde kaba bir aralık. |
signals | CandidateSignals | evet | Adayı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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
table | number | evet | Eşleme tablosu sinyalinden gelen puan katkısı. |
category | number | evet | Kategori sinyalinden gelen puan katkısı. |
domainLabels | number | evet | Alan etiketleri sinyalinden gelen puan katkısı. |
shape | number | evet | Şekil sinyalinden gelen puan katkısı. |
name | number | evet | Ad 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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
target | string | evet | Seçilen hedef katalog varlığının adı. |
mode | string | evet | Seç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. |
tier | string | evet | Seç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.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | İskele dosyasının, içe aktarma çıktı köküne göre yolu. |
content | string | evet | İskele dosyasının içeriği. |
Ek özelliklere izin verilmez.