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

Aggrega Wasm Mutator Socket şeması

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

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

label-transform rolüne bağlanan bir yönetişim eklentisinin tükettiği (MutatorInput) ve ürettiği (MutatorOutput) iletim biçimleri. Rol, topoloji oluşturma sırasında, graf oluşturulduktan sonra ve değerlendirilmeden önce çalışır: eklenti JSON Patch belgeleri döndürür ve ana makine bunları düğüm etiketlerine uygular, başka hiçbir şeye uygulamaz; grafın başka herhangi bir kısmına ulaşan bir yamada derlemeyi durdurur. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir iletim biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.

Aşağıdaki biçimlerden biri

  • MutatorInput
  • MutatorOutput

Tanımlar

MutatorInput

Ana makinenin her çağrıda mutator eklentisine verdiği yük: release düzeyindeki derleme bağlamı ile her düğümün etiketlerini ve örneğinin bildirdiği değerleri taşıyan topoloji grafiğinin bir izdüşümü.

ÖzellikTürZorunluAçıklama
compilation_contextCompilationContextevetMutator’ın derlemeye hangi uyumluluk, FinOps veya yönetişim kurallarının uygulanacağına karar verirken okuduğu Release düzeyindeki meta veriler.
graphMutatorGraphevetTopoloji grafiğinin mutator eklentisine sunulan izdüşümü: her düğümün Component’i, çözümlenmiş sürümü, etiketleri ve örneğinin bildirdiği değerler. Bilinçli olarak tam topoloji sonucundan daha dardır: kenarlar ve feature yükleri sunulmaz, çünkü mutator’ın işi topolojiyi yeniden biçimlendirmek değil, etiketlemektir. Değerler okunmak için oradadır; böylece geliştiricinin bildirdiği bir yapılandırma bir etikete karar verebilir; bir yama yalnızca etiketlere ulaşır, başka hiçbir şeye ulaşmaz; bu nedenle eklenti değerleri değiştiremez.
sourcesMutatorSource[]hayırAna makinenin okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış bir liste hâlindeki tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz.
settingsobjecthayırAna makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

MutatorOutput

Mutator eklentisinin ürettiği yanıt biçimi: ana makinenin topoloji grafiğine uyguladığı opak JSON Patch belgelerinin bir listesi. Yamalar şema katmanında opak kalır; böylece ana makinenin, konuğun zaten uyguladığı JSON Patch ayrıştırıcısını yinelemesi gerekmez.

ÖzellikTürZorunluAçıklama
patchesany[]evetTopoloji grafiğine sırayla uygulanacak opak JSON Patch belgeleri.
errorstringhayırKonuk çalıştığı ancak işlemi tamamlayamadığı zaman ayarlanan hata iletisi; başarıda bulunmaz. Ana makine, mevcut bir hatayı başarısız bir eklenti çağrısı olarak gösterir.

Ek özelliklere izin verilmez.

CompilationContext

Mutator’ın derlemeye hangi uyumluluk, FinOps veya yönetişim kurallarının uygulanacağına karar verirken okuduğu Release düzeyindeki meta veriler.

ÖzellikTürZorunluAçıklama
release_namestringevetRelease’in metadata.name değeri.
environmentstringevetRelease’in altında çalıştığı ortam etiketi (ör. dev, staging, prod).

Ek özelliklere izin verilmez.

MutatorGraph

Topoloji grafiğinin mutator eklentisine sunulan izdüşümü: her düğümün Component’i, çözümlenmiş sürümü, etiketleri ve örneğinin bildirdiği değerler. Bilinçli olarak tam topoloji sonucundan daha dardır: kenarlar ve feature yükleri sunulmaz, çünkü mutator’ın işi topolojiyi yeniden biçimlendirmek değil, etiketlemektir. Değerler okunmak için oradadır; böylece geliştiricinin bildirdiği bir yapılandırma bir etikete karar verebilir; bir yama yalnızca etiketlere ulaşır, başka hiçbir şeye ulaşmaz; bu nedenle eklenti değerleri değiştiremez.

ÖzellikTürZorunluAçıklama
nodesMutatorNode eşlemievetMutlak düğüm kimliğine göre anahtarlanmış düğümler.

Ek özelliklere izin verilmez.

MutatorNode

Mutator eklentisinin kurallarını değerlendirdiği düğüm başına izdüşüm: düğümün hangi Component’i uyguladığı, o Component’in hangi sürümünün çözümlendiği, düğümün hangi etiketleri taşıdığı ve örneğinin hangi değerleri bildirdiği.

ÖzellikTürZorunluAçıklama
componentstringevetDüğümün örneklediği temel Component’in adı.
resolved_versionstringevetÇözümleyicinin bu düğüm için sabitlediği Component’in tam Semantic Version değeri.
labelsstring eşlemievetDüğümün duck-typing ve ontoloji etiketleri.
valuesobjecthayırDüğümün bileşen örneğinin Aggregate içinde bildirdiği değerler; yazarın yazdığı şekliyle anahtarlanmış ve yazarın sırasıyla. Aggregate’teki her şablon parametrelerine göre zaten değerlendirilmiştir; böylece bir parametreye taşınmış bir değer, Release’in sağladığı değer ya da parametrenin varsayılanı olarak gelir. Burada yalnızca örneğin kendi değerleri bulunur: Component’in şemasının bildirdiği bir varsayılan ile bir Recipe’in ya da bir Feature’ın katkıda bulunduğu hiçbir şey burada değildir. Component’in hassas olarak bildirdiği bir değer, tüm graf üzerindeki yönetişim kararının onu aldığı şekilde tam olarak gizlenmiş olarak gelir: yerinde, o kararın taşıdığı aynı tek anahtarlı gizleme işaretçisi nesnesi durur ve bildirilen nedeni adlandırır; hiçbir bildirimin ulaşmadığı kardeş bir değer ise yazıldığı gibi gelir. Bir eklenti hangi etiketleri ekleyeceğine karar vermek için bunları okur; bir yama bunlara ulaşamaz. Örnek hiçbir değer bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

MutatorSource

Eklentiye verilen tek bir tanım dosyası: temel ad yolu ve dosyanın içeriği. İkisi de olduğu gibi taşınır; ana makine içeriği ayrıştırmaz.

ÖzellikTürZorunluAçıklama
pathstringevetKaynak dosyanın temel adı. Ana makine hiçbir zaman mutlak bir ana makine yolu değil, yalnızca temel adı sağlar; böylece iletim taşınabilir ve belirlenimci olur.
contentstringevetKaynak dosyanın opak bir string olarak olduğu gibi taşınan içeriği.

Ek özelliklere izin verilmez.