Aggrega çalışma alanı yapılandırma şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/aggrega-config-v1beta1.schema.json
aggrega CLI tarafından kullanılan, çalışma alanına özgü yapılandırma dosyası. .aggrega-config.yaml konumunda bulunur. workspace bloğu kök işaretçisidir: varlığı çalışma alanı kökünü işaretler ve yalnızca katalog dizinlerini içerir. Diğer her anahtar bir ayardır ve en üst düzeyde, şu sınıflar hâlinde yer alır: içeriğin nereden getirildiği, nasıl sabitlendiği ve önbelleğe alındığı (registry seçimi, çevrimdışı çalışma, otomatik çekme ve sabitleme davranışı, artifact ve derlenmiş modül önbelleklerinin konumları ve boyut sınırları), içeriğe nasıl güvenildiği (imzalama ve imza doğrulama davranışı), yazımın ne kadar sıkı değerlendirildiği (kural başına lint ayarları, kullanımdan kaldırma sıkılığı ve yazım sürümü ipucu), hangi Wasm eklentilerinin tüm çalışma alanına bağlandığı (yönetişim, linter, içe aktarıcı ve hedef başına Provider-işleme bağlamaları) ve CLI’ın nasıl çalıştığı (eşzamanlılık, sunum ve daemon ayrıştırma önbelleği çıkarma sınırları). Aşağıdaki özellikler eksiksiz ve yetkili listedir; bu özet anahtarları değil sınıfları adlandırır, bu nedenle bir anahtar eklemek onu yanlışlayamaz. Düz bir en üst düzey yapıdır; apiVersion/kind zarfı yoktur ve katalog içeriğinden ayrıdır. Şema evrimi disiplini: yeni bir en üst düzey anahtar eklemek SemVer-MINOR artışıdır (eklemeli); bir anahtarı kaldırmak ya da yerini değiştirmek veya bir kısıtlamayı sıkılaştırmak SemVer-MAJOR kırılmadır.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspace | object | hayır | Çalışma alanı kök işaretçisi. Yalnızca varlığı, dizini çalışma alanının kökü olarak işaretler; yalnızca kökü tanımlayan katalog dizinlerini taşır: çalışma alanının kendi dizinlerini ve bir Release’e kendine ait olarak verilen dizinleri. Kökü tanımlamayan her ayar burada değil, üst düzeyde yer alır. Vendored katalog dizini olmayan bir kökü işaretlemek için workspace: {} yazın. |
default_registry | string | hayır | Bir varlık açıkça bir kayıt defteri adlandırmadığında varlıkların yayımlandığı ve bağımlılıkların çözümlendiği varsayılan OCI kayıt defteri: aggrega push oraya yayımlar ve aggrega pull oradan getirir. Varsayılanı hub.aggrega.ai değeridir. registries altındaki bir girdinin name değerini yazın; bu durumda değer o girdinin host değerini temsil eder; ya da ana makinenin kendisini; ya da ana makineyi, ardından / ve bir depo yolunu yazın, örneğin ghcr.io/acme veya harbor.example.com/platform. Önce ad eşleştirilir: bir girdinin name değeri olan bir değer, bir ana makine gibi yazılmış olsa bile o girdinin ana makinesidir; böylece yayımlama, çekme, imza doğrulama ve kayıt defterine özgü her güven ayarı o tek ana makineyi kullanır; iki girdinin adı olan bir değer belirsiz olduğu için reddedilir ve ardından yol gelen bir ad reddedilir, çünkü bir ad bir girdinin ana makinesini temsil eder, altındaki bir konumu değil. Diğer her değer, güven politikasının tutulduğu yazımla yazılmış bir ana makine olmalıdır: nokta içeren küçük harfli bir ana makine adı (registry.example.com), localhost, ardından bir bağlantı noktası gelen tek bir ad (registry:5000), bir IPv4 adresi veya köşeli parantez içinde bir IPv6 adresi ([::1]); her biri isteğe bağlı bir :port ile ve şema, kimlik bilgisi, boşluk veya büyük harf olmadan; isteğe bağlı olarak ardından bir depo yolu gelir: / ile birleştirilmiş, küçük harf ve rakamlardan oluşan bir veya daha fazla bölüm; bir bölüm içinde ., _, __ veya tirelerle ayrılabilir; etiket, özet veya sonda / olmadan. Yol, öğelerin yayımlandığı ve getirildiği yerdir: varsayılan kayıt defteri üzerinden yayımlanan her varlık <host>/<path>/ altında yayımlanır ve onun üzerinden çözümlenen her varlık oradan getirilir; böylece birinin yayımladığını diğeri bulur. Yol, bir kayıt defterine nasıl güvenildiğinin hiçbir zaman parçası değildir: politikası uygulanan registries girdisi, oturum açma, imzalama gereksinimi ve güvenilen kimliklerin tümü yalnızca ana makineyle bulunur. HTTPS üzerinden erişilen bir ana makinede 443 numaralı bağlantı noktası o ana makinenin varsayılan bağlantı noktasıdır ve yazılması reddedilir; ret, bağlantı noktası olmadan yazılacak yazımı adlandırır; localhost ve diğer geri döngü adreslerine düz HTTP üzerinden erişilir, bu nedenle orada 443 sıradan bir bağlantı noktasıdır ve korunur. Boş bir değer hiçbir varsayılan kayıt defteri adlandırmaz. Değer bu şema tarafından değil, yapılandırma yüklendiğinde değerlendirilir, çünkü bir adın başvurduğu girdi başka bir yapılandırma dosyasında bildirilmiş olabilir: değer, tüm yapılandırma dosyalarından ve AGGREGA_DEFAULT_REGISTRY ortam değişkeninden sonra okunur ve hangisi ayarlamış olursa olsun aynı sözcüklerle, o dosyayı veya değişkeni adlandırarak reddedilir. Tek bir çağrı için bir yayının hedefini adlandıran --registry bayrağı da girdilerin adlarıyla aynı şekilde eşleştirilir; taşıdığı diğer her değer bir başvuru olabilir ve o başvurunun adlandırdığı ana makine aynı yazıma tabidir ve yayın, depo yolu olmadan oraya ulaşır. Ana makine yalnızca yazımına göre değerlendirilir: adın çözümlenip çözümlenmediği veya orada bir kayıt defterinin yanıt verip vermediği denetlenmez. Varsayılan: "hub.aggrega.ai" |
offline | boolean | hayır | true olduğunda derleme hiçbir kayıt defteriyle iletişim kurmaz; yalnızca önbelleğe alınmış yapıtlara ve vendored katalog içeriğine başvurulur. Varsayılanı false değeridir. Varsayılan: false |
auto_pull | boolean | hayır | false olduğunda (varsayılan) aggrega build salt okunurdur: hiçbir zaman kaynak sabitlemesi yazmaz ve eksik ya da tamamlanmamış bir sürüme özgü kilit dosyası, önce aggrega pull --release <release> çalıştırılmasını söyleyen bir tanılamayla derlemeyi açıkça durdurur. true olduğunda aggrega build, derlemeden önce süreç içinde bir çekme adımı çalıştırır (Release’in bağımlılıklarını kilit dosyasına ve önbelleğe çözümleyerek); böylece bir Release’e karşı ilk kez yapılan bir derleme açık bir çekme adımı gerektirmez. Aynı tek derlemelik seçenek komut satırında aggrega build --auto-pull olarak da kullanılabilir; kilit dosyasını yazan tek komut pull olarak kalır. offline: true çekme adımını kapatmaz: adım, bir kayıt defterine ulaşmadan makinede zaten bulunanlar (önbellek ve yerel katalog dizinleri) üzerinde çalışır ve ikisinde de bulunmayan bir başvuru, derlemeyi o başvuruyu adlandıran çekmenin kendi reddiyle durdurur. Varsayılan: false |
pin_sources_at_pull | boolean | hayır | false olduğunda (varsayılan) bir çekme, bir varlığın yanına hiçbir sabitleme kaydetmez: bu çalışma alanının katalog dizinlerinden birinde bulunan ve Release’in derlediği bir Recipe veya FeatureRecipe üzerinde, varlığın yanındaki entity.lock varlığın okuduğu her girdi için bir sabitleme kaydetmediğinde durur (koordinatları tam olarak yazılmış uzak bir source:, bir artifacts girdisinin içe aktardığı bir dosya veya varlığın yanındaki yerel bir source: öğesinin her dosyası); bu durumda varlığı, her girdiyi ve sınıfını ve bunları kaydeden adım olarak aggrega pin komutunu adlandırır. Sabitleme, varlık yazarının adımıdır; bu nedenle kimsenin sabitlemediği bir varlık henüz kullanılmaya hazır değildir. true olduğunda bu çalışma alanındaki her çekme, bunun yerine aynı varlıklar üzerinde bu adımı çalıştırır ve aggrega pin komutunun yazdığı aynı entity.lock baytlarını yazar; başka birinin sabitlemediği varlıkları kullanan bir çalışma alanı, durmak yerine sabitlemelerini bir kez bu yolla kaydeder. Kendi kilit dosyasını dolduran bir derleme bir çekmedir ve bu ayara uyar. aggrega pull --pin-sources tek bir çağrı için sabitler, --pin-sources=false ise bu ayar ne derse desin tek bir çağrı için durdurur. Katalog dizini yerine önbellekten çözümlenen bir varlığın kilit yazacak bir yeri yoktur ve bir çekme tarafından hiçbir zaman sabitlenmez veya durdurulmaz. Varsayılan: false |
pin_sources_at_push | boolean | hayır | true olduğunda bu çalışma alanındaki her aggrega push, yayımladığı varlığı paketlemeden önce onun üzerinde varlık yazarının sabitleme adımını çalıştırır; böylece adımın varlığın yanına yazdığı entity.lock yayımlananın parçası olur; false olduğunda (varsayılan) push hiçbir sabitleme adımı çalıştırmaz ve entity.lock dosyası o adımın kaydedeceği her sabitlemeyi kaydetmeyen bir Recipe veya FeatureRecipe’i aggrega pin komutunu adlandırarak reddeder. Adım varlığın yanına yazar; bu nedenle yalnızca varlığın yazılabilir bir yeri olduğunda çalışır ve bir push’ta bu her zaman vardır: push, belgesiyle adlandırılan bir varlığı yayımlar. aggrega push --pin-sources tek bir çağrı için sabitler, --pin-sources=false ise bu ayar ne derse desin sabitlemez. Bu, aggrega pin komutunun çalıştırdığı aynı adımdır ve aynı baytları yazar. Varsayılan: false |
artifact_cache_dir | string | hayır | Yerel yapıt/içerik önbelleği dizini (kayıt defteri çekmeleri, OCI manifestleri, derlenmiş fikstürler). Varsayılanı .aggrega/cache değeridir. Uzlaşım gereği gitignore’a eklenmelidir. Yol, komut nereden çalıştırılırsa çalıştırılsın çalışma alanı köküne göre yorumlanır; mutlak bir değer yapılandırma yüklendiğinde reddedilir, çünkü bu ayarı okuyan her bileşen onu o köke göre çözümler ve mutlak bir yol hiçbir zaman ulaşamayacakları bir konumu adlandırır. Önbellek bir katalog dizininin içinde bulunabilir (bir katalog dizini genellikle çalışma alanı kökü olduğundan varsayılan değer de böyledir), ancak kendisi bir katalog dizini OLMAMALIDIR: katalog taraması önbelleği atlar; bu nedenle bir katalog dizinini adlandıran bir değer, o dizinin tüm içeriğini taramanın dışında bırakır. Çalışma alanı kökünün kendisini adlandıran bir değer (. veya ona indirgenen herhangi bir yazım) tam da bu nedenle yapılandırma yüklendiğinde reddedilir. Başka bir katalog dizinini adlandıran bir değer reddedilmez: sorunsuz yüklenir ve tarama ardından o dizinde hiçbir şey bulmaz; bu nedenle önbelleği workspace.catalog_dirs içinde listelenen dizinlerin dışında tutmayı sizin denetlemeniz gerekir. Daemon’un bellek içi ayrıştırma önbelleğini sınırlayan parse_cache ayarından ve makine genelindeki derlenmiş modül deposunu sınırlayan compiled_module_cache ayarından farklıdır. Varsayılan: ".aggrega/cache" |
skip_signature_verification | boolean | hayır | İmza doğrulamasından genel ve açıkça bildirilen devre dışı bırakma. True olduğunda imza doğrulaması, zorunlu hub temel politikası dahil her registry’de devre dışı bırakılır. Acil durum ve geliştirme senaryoları için tasarlanmıştır; hiçbir zaman sessiz değildir — bir pull’un imzayı denetleyeceği her yerde, doğrulamanın genel olarak devre dışı bırakıldığına dair uyarı verir. Varsayılan olarak false’tur. Varsayılan: false |
build | object | hayır | Derleme zamanı katılık ayarları ve yazım ipuçları. authoring_release, satır içi tanılamalar için LSP’ye bir current Release ipucu sağlar; halt_on_deprecated_severity, derlemenin kullanımdan kaldırılmış entity tüketimine nasıl tepki vereceğini denetler; yaml_indent, işlenen her YAML yapıtının girinti genişliğini belirler. |
plugins | object | hayır | Çalışma alanı düzeyindeki Wasm plugin eklemeleri. Her soket (governance, linter, importer) bir plugin başvuruları dizisi alır; derleme, her plugin’in belgelenmiş giriş fonksiyonunu soketinin sözleşmesine göre çağırır. providers listesi, yetenekleri onlara hizmet eden provider işleme plugin’lerine bağlar. |
lint | object | hayır | Kural başına katılık ayarları. |
parse_cache | object | hayır | Daemon ayrıştırma önbelleğinin tahliye sınırları. Her iki sınır aynı anda uygulanır — LRU tahliye döngüsü her önbellek eklemesinden sonra çalışır ve hem girdi sayısı hem de bayt toplamı sınırlar içinde kalana kadar en uzun süredir kullanılmayan girdileri kaldırır. Herhangi birinin sıfır olması unbounded on that axis anlamına gelir; bu, önbelleğin yalnızca tek bir çağrı boyunca yaşadığı CI senaryolarında kullanışlıdır. Disk üzerindeki içerik önbelleği olan artifact_cache_dir’den farklıdır. |
compiled_module_cache | object | hayır | Disk üzerindeki derlenmiş modül önbelleği için boyut sınırı; bu önbellek, bir Wasm plugin’inin her derlemede bir kez yerine makine başına bir kez derlenmesi için derleyicinin yeniden kullandığı makine kodu deposudur. Makinedeki tüm çalışma alanları arasında paylaşılır; bu nedenle makinenin tamamı için tek bir yanıt istediğinizde bu anahtar genel yapılandırma dosyasına yazılmalıdır. Sınır, çağrı başına bir kez, herhangi bir plugin yüklenmeden önce, kalan kısım sığana kadar en eski derlenmişten başlayarak girdilerin tamamı kaldırılarak uygulanır — bir derleme derleme yaparken asla uygulanmaz. Bir girdinin kaldırılmasının tek bedeli daha sonraki bir yeniden derlemedir; bu nedenle sınırı düşürmek güvenlidir. aggrega cache status deponun güncel boyutunu bildirir, aggrega cache evict --max-size ise depoyu istek üzerine komut satırında verilen bir sınıra kırpar. artifact_cache_dir (çekilen registry içeriği) ve parse_cache (daemon’un bellek içi ayrıştırma önbelleği) ayarlarından farklıdır. |
concurrency | object | hayır | Daemon istek dağıtımı eşzamanlılık ayarları. Daemon istekleri tek bir stdin akışından okur ve her birini sınırlı bir istek kuyruğunu boşaltan bir çalışan havuzu üzerinden çalıştırır; yanıtlar, tamamlanma sırasından bağımsız olarak isteklerin geliş sırasına göre gönderilir. |
serve | object | hayır | IDE entegrasyonlarının kullandığı hizmet olarak derleyici için daemon (aggrega serve) davranış ayarları. |
mcp | object | hayır | Model Context Protocol sunucusu (aggrega mcp) için ayarlar. transport, sunucuya nasıl erişileceğini — sürecin standart girdi ve çıktısı üzerinden ya da HTTP üzerinden — seçer ve hangisini seçerse seçsin okunur. announce_tools da her iki aktarımda okunur, çünkü bir istemciye hangi araçların sunulduğu, istemcinin sunucuya nasıl eriştiğinin değil sunucunun bir özelliğidir. Diğer tüm anahtarlar HTTP aktarımının başlattığı dinleyiciyi yapılandırır ve sunucu standart girdi ve çıktı üzerinden konuşurken kullanılmaz — listen de buna dahildir; orada yalnızca sunucunun, hata akışında tek satırla adresin kullanılmadığını söyleyebilmesi için okunur. Aşağıdaki her anahtar hangisi olduğunu belirtir. Düzenleyici arka uç daemon’unu yapılandıran serve’den farklıdır. |
registries | RegistryConfig[] | hayır | Registry ana bilgisayarına göre anahtarlanan, registry başına ayarlar ve imza güven politikası. Burada listelenmeyen bir registry varsayılanları kullanır: mevcut bir imza doğrulanır, eksik bir imzaya ise göz yumulur; bunun istisnası hub.aggrega.ai’dir: gömülü temel politikası, açık bir girdi olmasa bile doğrulanmış bir imza gerektirir. Bir ana bilgisayar için açık bir girdi, o ana bilgisayarın temel politikasını geçersiz kılar. Varsayılan: [] |
signing | SigningConfig | hayır | Tüm registry’lere uygulanan üst düzey imzalama bloğu: anahtarsız hizmet URL’leri, isteğe bağlı bir anahtarlı imzalama anahtarı yolu ve tüm registry’lere yönelik güven tutumu (required ve kinds). Registry başına bir signing bloğu, o ana bilgisayar için uç nokta varsayılanlarını geçersiz kılar ve kapsamı o ana bilgisayarla sınırlı aynı required/kinds tutumunu taşır — tek ad, tek görev, kapsam yerleşimden gelir. Üst düzey required/kinds politikası, yapılandırma kademesi boyunca monoton olarak birleşir. Güvenlik: bu blok hiçbir gizli malzeme içermez — OIDC kimlik belirteci hiçbir zaman bir yapılandırma alanı değildir (çalışma zamanında bir flag ya da ortamdaki OIDC ortamı aracılığıyla sağlanır) ve key_path bir anahtar dosyasının yoludur, hiçbir zaman satır içi anahtar baytları değildir. |
Ek özelliklere izin verilmez.
aggrega-config.workspace
Çalışma alanı kök işaretçisi. Yalnızca varlığı, dizini çalışma alanının kökü olarak işaretler; yalnızca kökü tanımlayan katalog dizinlerini taşır: çalışma alanının kendi dizinlerini ve bir Release’e kendine ait olarak verilen dizinleri. Kökü tanımlamayan her ayar burada değil, üst düzeyde yer alır. Vendored katalog dizini olmayan bir kökü işaretlemek için workspace: {} yazın.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
catalog_dirs | string[] | hayır | Bu çalışma alanının yerel varlıkları okuduğu isteğe bağlı katalog dizinleri; kayıt defterine başvurulmadan önce bunlara bakılır. Her girdi, kendisini bildiren dosyaya göre çözümlenen bir dosya sistemi yoludur. Liste, sıralı ve ilk eşleşenin kazandığı bir arama yığınıdır: bir kimliği bildiren en önce listelenmiş dizin o kimliğin sahibidir ve sonraki bir dizindeki aynı kimlik gölgelenir. Çalışma alanı kökündeki catalog dizini de, listelenen tüm girdilerden sonra ve yalnızca varsa okunur; listelenen bir girdi onu zaten içeriyorsa o girdinin parçası olarak okunur. Dolayısıyla bir dizini listelemek, çalışma alanının zaten okuduklarının yerini almaz, onlara ekleme yapar. Bu anahtarı atlamak ile boş liste olarak yazmak farklı ifadelerdir: atlandığında çalışma alanı yine catalog dizinini okur; [] olarak yazıldığında hiçbir yerel katalog okumaz; bir çalışma alanı hiç kataloğu olmadığını böyle belirtir. releases altında kendine ait katalog dizinleri verilen bir Release, bu liste yerine onları okur. Kök kapsamlıdır: yerel katalog dizinleri bu çalışma alanı köküne aittir, bu nedenle en üst düzeyde değil kök işaretçisinde bulunur. |
catalog_dirs_append | string[] | hayır | Etkin catalog_dirs listesine isteğe bağlı, yalnızca ekleme yapan bir ek. Her öncelik katmanında buradaki girdiler çözümlenmiş temel listenin sonuna eklenir; böylece çalışma alanı ve genel yapılandırmalar katalog dizinlerini gölgelemek yerine birleştirebilir. Aynı katmandaki etkileşim: bir katmanda hem catalog_dirs hem de catalog_dirs_append belirtildiğinde, o katmandaki çözümlenmiş değer temel listeyi izleyen ekleme listesidir. Varsayılan: [] |
releases | ReleaseCatalogConfig eşlemi | hayır | Birkaç katalog varyantını yan yana tutan ve her Release’i bunlardan birine göre derleyen bir çalışma alanı için, bir Release’e ait isteğe bağlı katalog dizinleri. Her anahtar, kendisini bildiren dosyaya göreli bir yol olarak yazılan bir Release dosyasıdır; her değer, bu bloktaki anlamlarıyla ve yalnızca o Release kapsamında catalog_dirs ve catalog_dirs_append taşır. Burada adı geçen bir Release, bu bloğun listesi yerine kendi catalog_dirs listesini, ardından kendi catalog_dirs_append listesini okur; catalog_dirs öğesini atlayan bir girdi bu bloğun listesini korur ve kendi catalog_dirs_append listesini onun ardına ekler. Arama sırası, çalışma alanı kökündeki catalog dizini ve boş bir listenin anlamı bu bloğun kendi listesiyle aynıdır; bu eşlemin adını vermediği bir Release ise bu bloğun listesini tam olarak eskisi gibi okur. Release bu dizinleri nasıl derlenirse derlensin okur: bir terminalde, aggrega serve aracılığıyla bir düzenleyiciden ya da aggrega mcp aracılığıyla; tek bir çağrı için bir --catalog dizini yine de bunlardan önce aranır. Var olmayan bir dosyayı adlandıran bir girdi, yapılandırma yüklenirken girdiyi ve dosyayı adlandırarak reddedilir; böylece bir Release’i yeniden adlandırmak, derlendiği kataloğu sessizce değiştiremez. Yapılandırma dosyaları arasında her Release’in girdisi, bu bloğun kendi anahtarlarının birleştiği şekilde birleşir: daha yakın bir dosyanın o Release için catalog_dirs değeri daha uzak bir dosyanınkinin yerini alır ve her dosyanın o Release için catalog_dirs_append değeri basamaklama sırasıyla eklenir. AGGREGA_CATALOG_DIRS bu bloğun listesini ayarlar ve buradaki hiçbir girdiye ulaşmaz. Tek bir Release ile ilgili olmayan bir işlem (tüm kataloğun lint’i veya doğrulaması, bir varlığın adıyla aranması ya da bir düzenleyicinin çalışma alanının varlıklarını listelemesi) bunları değil, bu bloğun listesini okur. |
Ek özelliklere izin verilmez.
aggrega-config.build
Derleme zamanı katılık ayarları ve yazım ipuçları. authoring_release, satır içi tanılamalar için LSP’ye bir current Release ipucu sağlar; halt_on_deprecated_severity, derlemenin kullanımdan kaldırılmış entity tüketimine nasıl tepki vereceğini denetler; yaml_indent, işlenen her YAML yapıtının girinti genişliğini belirler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
authoring_release | string | hayır | LSP’nin satır içi tanılamalar için current Release bağlamı olarak ele aldığı bir Release YAML dosyasının yolu. İsteğe bağlı. |
yaml_indent | integer | hayır | İşlenen her YAML yapıtı (docker-compose dosyaları, Helm chart şablonları ve değerleri ile Kubernetes manifestleri) için girinti genişliği (boşluk cinsinden). Varsayılanı, bu biçimler için uzlaşım olan genişlik olan 2’dir. En az: 2. En fazla: 9. Varsayılan: 2 |
halt_on_deprecated_severity | string (enum) | hayır | Sıralı warning < error < retracted kümesinde, kaydedilmiş bir kullanımdan kaldırma işaretçisinin derlemeyi durdurduğu ve üzerindeki önem düzeyi. İşaretçinin kaydedildiği her iki yeri de yönetir: bir derlemenin bayt bayt yeniden ürettiği her şey için kilit dosyası ve kabul ya da ret kararı döndüren bir rolde eklenen bir plugin için onun yanındaki plugin güven kaydı; yani ir-verdict veya render-verdict noktasındaki bir plugins.governance eki ve her plugins.linter eki. Tek ayar, tek kural, iki depo. Varsayılan olarak ayarlanmamıştır ve ayarlanmamış olması hiçbir kayıtlı işaretçinin derlemeyi durdurmadığı anlamına gelir: işaretçi sizin zaten sabitlediğiniz bir sürüme karşı kaydedilir, bu nedenle bir kez başarılı olan derleme başarılı olmaya devam eder. Bildirim ve çözümleme iki ayrı eksendir ve hiçbiri bu ayar değildir. Kayıtlardan herhangi birini okuyan her yüzey, sabitlediği her kullanımdan kaldırılmış başvuruyu ve işaretçi taşıyan her güvenilir plugin’i (her önem düzeyinde) adını, önem düzeyini ve iletisini belirterek bildirir: aggrega build, aggrega validate --release, aggrega lint --release, düzenleyiciye yönelik daemon ve yapay zekâya özgü build, describe ve validate araçları. Dolayısıyla bu eşiği yükseltmek size bildirilenleri asla azaltmaz. Bu ayar yalnızca derlemeyi yönetir: aggrega build komutunu (ve aynı işlem olan yapay zekâya özgü build aracını) durdurur; bildirim yüzeyleri ise işaretçiyi adlandırıp devam eder. Bir başvurunun hangi sürüme çözümlendiğini yalnızca retracted işaretçisi etkiler ve bunu derleme sırasında değil, aggrega pull bir sürüm seçtiğinde yapar. İzin verilen değerler: "warning", "error", "retracted" |
Ek özelliklere izin verilmez.
aggrega-config.plugins
Çalışma alanı düzeyindeki Wasm plugin eklemeleri. Her soket (governance, linter, importer) bir plugin başvuruları dizisi alır; derleme, her plugin’in belgelenmiş giriş fonksiyonunu soketinin sözleşmesine göre çağırır. providers listesi, yetenekleri onlara hizmet eden provider işleme plugin’lerine bağlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
governance | PluginRef[] | hayır | Governance soketi plugin’leri. Her girdi, bağlandığı işlem hattı role değerini adlandırır (annotation-transform, label-transform, ir-verdict veya render-verdict); rol hem plugin’in neler üretebileceğini hem de varsayılan giriş fonksiyonunu belirler (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Varsayılan: [] |
governance_append | PluginRef[] | hayır | Etkin governance listesine yalnızca ekleme yapan ek. Buradaki girdiler her öncelik katmanında çözümlenmiş temel listenin sonuna eklenir; böylece çalışma alanı ve genel yapılandırmalar governance bağlantılarını gölgelemek yerine birleştirir. Varsayılan: [] |
linter | PluginRef[] | hayır | Linter soketi plugin’leri. Varsayılan giriş fonksiyonu: lint_rules. Bir linter plugin’inin dışa aktarımlarının lint_ ile başlaması gerekir; bu nedenle bu girdilerden birindeki function: bu öneke sahip bir dışa aktarımı adlandırır. Varsayılan: [] |
linter_append | PluginRef[] | hayır | Etkin linter listesine yalnızca ekleme yapan ek. governance_append ile aynı gölgelemeden birleştirme anlamına sahiptir. Varsayılan: [] |
importer | FixedEntryPluginRef[] | hayır | Importer soketi plugin’leri. Soket import giriş fonksiyonunu çağırır; bir bağlantı giriş fonksiyonu adlandırmaz. Varsayılan: [] |
importer_append | FixedEntryPluginRef[] | hayır | Etkin importer listesine yalnızca ekleme yapan ek. governance_append ile aynı gölgelemeden birleştirme anlamına sahiptir. Varsayılan: [] |
providers | FixedEntryPluginRef[] | hayır | Yetenek başına sağlayıcı seçimleri. Her girdi bir sağlayıcı yeteneğini (bir Recipe’in spec.capability aracılığıyla bağladığı yalın yetenek adı, ör. helm veya compose) ona hizmet eden sağlayıcı-işleme plugin’inin yalın kimliğine (Plugin varlığının kimliği, yani eğik çizgiyle birleştirilmiş metadata.pluginType ve metadata.name, ör. provider/helm) bağlar; isteğe bağlı olarak sona, sürüm sabitlemesiyle aynı üç biçimde (yalın, tam :1.0.0 veya ana sürümle uyumlu aralık :^1.0.0) bir :version eklenebilir. Bu, birden fazla sağlayıcı plugin’inin aynı yeteneğe hizmet ettiği federe bir katalog için belirsizlik giderme ve geçersiz kılma yüzeyidir: bağlama, o yeteneği hangi yayıncının plugin’inin işleyeceğini seçer. Bir yeteneğe tam olarak bir sağlayıcı plugin’i hizmet ediyorsa girdi gerekmez. Birleştirilmiş listede yetenek başına tam olarak bir girdiye izin verilir; yinelenen bir yetenek çözümlemeyi açıkça durdurur. Çözümleme pull sırasında yapılır: pull çözümlenen bağlamayı Release başına kilit dosyasına kaydeder ve build kilit dosyasını okur — bir pull’dan sonra burada yapılan bir değişiklik bir sonraki pull’a kadar benimsenmez, dolayısıyla build çıktısı bu değişiklikten etkilenmez (deterministik çıktı). Bir Release’in her build’i ve her doğrulaması, bir Recipe yeteneğini isteyip istemediğinden bağımsız olarak buradaki her girdiyi de denetler: build’in elinde bulunan ancak girdinin yeteneğine hizmet etmeyen bir plugin’i adlandıran girdi, o plugin’in neye hizmet ettiğini ve varsa bir düzenleme uzaklıktaki bir yazımı adlandırarak durdurur; build’in okuduğu hiçbir sağlayıcı plugin’inin hizmet etmediği bir yeteneği plugin olmadan adlandıran girdi, durdurmak yerine uyarı olarak bildirilir, çünkü ona hizmet eden plugin yalnızca başka bir Release’in okuduğu bir plugin olabilir; bir plugin’in hizmet ettiği ama bu Release’in hiç istemediği bir yetenek için girdi geçerlidir ve hiçbir şey bildirilmez, çünkü girdiler tüm çalışma alanı için yazılır ve bir build tek bir Release içindir. İki nokta üst üste içeren bir capability, yapılandırma yüklenirken reddedilir: bir Recipe’in spec.capability değeri son iki noktaya kadar yetenek, sonrası sürüm sabitlemesi olarak okunur, bu nedenle hiçbir Recipe böyle bir girdiye ulaşamaz. Tek anlamlı olarak hizmet verilen bir yetenek için eksik girdi hata değildir; birden çok plugin’in hizmet verdiği bir yetenek için eksik girdi, aday plugin’leri listeleyerek pull’u açıkça durdurur. Sürümlerin bir arada bulunması korunur: bağlama yetenek başına plugin deposunu seçer ve her Recipe’in kendi spec.capability sürüm sabitlemesi o depodaki sürümü seçer; böylece tek bir sağlayıcının farklı sürümlerini sabitleyen iki Recipe yine bir arada bulunabilir. Varsayılan: [] |
providers_append | FixedEntryPluginRef[] | hayır | Etkin providers listesine yalnızca ekleme yapan ek. Buradaki girdiler her öncelik katmanında çözümlenmiş temel listenin sonuna eklenir; böylece çalışma alanı ve genel yapılandırmalar sağlayıcı bağlamalarını gölgelemek yerine birleştirir. governance_append ile aynı gölgelemeden birleştirme anlamına sahiptir. Yetenek başına tek girdi kuralı birleştirilmiş listeye uygulanır; bu nedenle daha alt bir katmanda zaten bağlanmış bir yeteneği adlandıran eklenmiş bir girdi çözümlemeyi açıkça durdurur. Varsayılan: [] |
cli | CLIPluginRef[] | hayır | Üst düzey aggrega komutları olarak kurulan CLI uzantısı plugin’leri. Her girdi bir CLI plugin’ini, çözümlenmiş ve sürümü sabitlenmiş yapıt başvurusu ile bu başvurunun kurulum anında çözümlendiği konuk baytlarının içerik özetiyle sabitler. Temel listesi yapılandırma zincirinde bütünüyle değiştirilen dört kesişen soket listesinin aksine CLI listesi birleşir: genel yapılandırmadaki bir CLI plugin’i komut(lar)ını her çalışma alanında kaydeder, bir çalışma alanı yapılandırmasındaki yalnızca o projede kaydeder ve ikisi birlikte kaydolur — bu nedenle _append eşine gerek yoktur. Her plugin’in sağladığı komut adları ve yardım metni, plugin’in kendi öz tanımından gelir ve digest ile anahtarlanan disk üzerindeki describe önbelleğinden okunur (önbellek soğuksa konuğun yüklenmesi yedek yoldur); liste yalnızca sabitlemeyi taşır. Komut çağrıldığında çözümlenen baytlar yeniden özetlenir ve digest ile karşılaştırılır; uyuşmazlık komutu açıkça durdurur ve yeniden sabitleme yapılmasını ister; böylece baytları sabitlendikten sonra değişen bir plugin asla fark edilmeden çalışmaz. Varsayılan: [] |
Ek özelliklere izin verilmez.
aggrega-config.lint
Kural başına katılık ayarları.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
publishing_discipline | object | hayır | Yayınlama linter’ının kural kümesi için çalışma alanı genelindeki kapılar. allow_* bayrakları tek tek caydırma denetimlerini gevşetir. Yapıt değişmezliği burada yapılandırılamaz: aggrega push yayınlanmış bir sürümün üzerine yazmayı koşulsuz olarak reddeder. |
Ek özelliklere izin verilmez.
aggrega-config.lint.publishing_discipline
Yayınlama linter’ının kural kümesi için çalışma alanı genelindeki kapılar. allow_* bayrakları tek tek caydırma denetimlerini gevşetir. Yapıt değişmezliği burada yapılandırılamaz: aggrega push yayınlanmış bir sürümün üzerine yazmayı koşulsuz olarak reddeder.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
allow_dynamic_refs | boolean | hayır | True olduğunda publishing-linter, katalog içeriğindeki $dynamicRef / $dynamicAnchor JSON Schema yapılarını kabul eder. Varsayılan false’tur; bu yapılar derleme zamanı şema birleştirmesini yerel olmaktan çıkardığı için önerilmez. Varsayılan: false |
allow_id_overrides | boolean | hayır | True olduğunda publishing-linter, bir varlığın şema içeriğindeki alt şemalarda $id geçersiz kılmalarını kabul eder. Varsayılan false’tur; $id geçersiz kılmaları, çözümleyicinin ve JSON Schema doğrulayıcısının her ikisinin de dayandığı şema başına kanonik tanımlayıcı uzlaşımını bozar. Varsayılan: false |
allow_direct_x_aggrega_extensions | boolean | hayır | True olduğunda derleme zamanı caydırma denetimi, doğrudan şema içeriğinde yazılmış x-aggrega-selector ve x-aggrega-inject anahtar sözcüklerini kabul eder. Varsayılan false’tur; önerilen yazım yolu usesSchema (bağımlılık soketleri için) veya featuresSchema’dır (kimlik bilgisi bağlamaları için); derleyici bunları bu anahtar sözcüklere dönüştürür. Varsayılan: false |
allow_aggrega_ai_prefix | boolean | hayır | True olduğunda publishing-linter, ayrılmış aggrega.ai/ ve feature.aggrega.ai/ ad alanlarını kanonik bağlamlarının dışında kullanan açıklama (annotation) anahtarlarını kabul eder. Ayrılmış önek kuralı, katalog varlıklarının metadata.annotations alanını denetler: yalın aggrega.ai/ öneki platforma özgüdür (iyi bilinen açıklama anahtarları bu bayraktan bağımsız olarak muaftır); feature.aggrega.ai/ öneki yalnızca Feature türünde kanoniktir. Varsayılan false’tur. Operatörler, kurumsal araçların meşru olarak ayrılmış bir önek kullanması gerektiğinde bunu ayarlar; bayrak her iki öneki birlikte gevşetir. Varsayılan: false |
allow_nonstandard_names | boolean | hayır | True olduğunda publishing-linter, projenin belgelenmiş adlandırma uzlaşımlarına uymayan katalog varlık adlarını kabul eder. Varsayılan false’tur; tutarlı adlandırma, çözümleyici, etiket seçimi ve inceleyici ergonomisi için temel bir öneme sahiptir. Varsayılan: false |
allow_category_mismatches | boolean | hayır | True olduğunda publishing-linter, category-matches-directory kuralını devre dışı bırakır. Standart katalog uzlaşımı, core/false |
allow_undeclared_recipe_provides | boolean | hayır | True olduğunda publishing-linter, provides-declared-by-component kuralını devre dışı bırakır. Bu kural, bir Recipe’nin spec.provides içinde yayımladığı ve spec.implements ile adlandırdığı Component’in spec.schema alanının provides sütununda bildirmediği her anahtarı raporlar. İkisi ayrı yüzeylerdir: bir Recipe’nin yayımladığı, bir tüketicinin aldığı değerdir; Component’in bildirdiği ise bir inject from: başvurusunun karşısında denetlendiği çıktı sözleşmesidir; bu yüzden bildirilmeden yayımlanan bir anahtar, böyle bir başvurunun durmasına yol açar. Component’inin bildirdiğinden fazlasını yayımlayan bir Recipe, bunun dışında derleme zamanında kabul edilir; bulgunun yayımlamayı reddetmek yerine tavsiye niteliğinde olmasının nedeni budur. Varsayılan false’tur. Varsayılan: false |
allow_connection_credential_mismatches | boolean | hayır | True olduğunda publishing-linter, connection-credential-matches-target-key kuralını devre dışı bırakır; bu kuralı aggrega lint --release, adlandırdığı Release üzerinde çalıştırır: Release, onun dağıttığı Aggregate ve bu Aggregate’in örneklerinin kullandığı Components. Hedefi, çağıranlarından istediği anahtarı bildiren her bağlantı için kural, iki ucun neye başvurduğunu karşılaştırır: bağlantının sunduğu kimlik bilgisi ile hedefin kendi yuvasında tuttuğu anahtar. Farklı gizli değerleri adlandıran iki ucu ve yalnızca bir uçta bildirilen bir anahtarı raporlar ve hiçbirini asla alıntılamaz. Hiçbir uç diğerinin eklerini göremez; bu yüzden ikisi yalnızca yazım disipliniyle uyuşur (genellikle ikisini de besleyen tek bir parametreyle) ve bir derleme onları her iki durumda da kabul eder; bulgunun tavsiye niteliğinde olmasının nedeni budur. İki ucu bilerek farklı olan bir çalışma alanı burada bu kuraldan çıkar. Varsayılan false’tur. Varsayılan: false |
Ek özelliklere izin verilmez.
aggrega-config.parse_cache
Daemon ayrıştırma önbelleğinin tahliye sınırları. Her iki sınır aynı anda uygulanır — LRU tahliye döngüsü her önbellek eklemesinden sonra çalışır ve hem girdi sayısı hem de bayt toplamı sınırlar içinde kalana kadar en uzun süredir kullanılmayan girdileri kaldırır. Herhangi birinin sıfır olması unbounded on that axis anlamına gelir; bu, önbelleğin yalnızca tek bir çağrı boyunca yaşadığı CI senaryolarında kullanışlıdır. Disk üzerindeki içerik önbelleği olan artifact_cache_dir’den farklıdır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
max_entries | integer | hayır | Önbelleğe alınan ayrıştırma sayısının üst sınırı. Varsayılan 1000’dir. 0, girdi sayısı eksenini devre dışı bırakır (girdi sayısı nedeniyle tahliye tetiklenmez). En küçük değer: 0. Varsayılan: 1000 |
max_bytes | integer | hayır | Önbelleğin tuttuğu belgelerin bayt cinsinden toplam boyutunun üst sınırı. Varsayılan 100000000’dur (100 MB). 0, bayt eksenini devre dışı bırakır (bayt toplamı nedeniyle tahliye tetiklenmez). En küçük değer: 0. Varsayılan: 100000000 |
Ek özelliklere izin verilmez.
aggrega-config.compiled_module_cache
Disk üzerindeki derlenmiş modül önbelleği için boyut sınırı; bu önbellek, bir Wasm plugin’inin her derlemede bir kez yerine makine başına bir kez derlenmesi için derleyicinin yeniden kullandığı makine kodu deposudur. Makinedeki tüm çalışma alanları arasında paylaşılır; bu nedenle makinenin tamamı için tek bir yanıt istediğinizde bu anahtar genel yapılandırma dosyasına yazılmalıdır. Sınır, çağrı başına bir kez, herhangi bir plugin yüklenmeden önce, kalan kısım sığana kadar en eski derlenmişten başlayarak girdilerin tamamı kaldırılarak uygulanır — bir derleme derleme yaparken asla uygulanmaz. Bir girdinin kaldırılmasının tek bedeli daha sonraki bir yeniden derlemedir; bu nedenle sınırı düşürmek güvenlidir. aggrega cache status deponun güncel boyutunu bildirir, aggrega cache evict --max-size ise depoyu istek üzerine komut satırında verilen bir sınıra kırpar. artifact_cache_dir (çekilen registry içeriği) ve parse_cache (daemon’un bellek içi ayrıştırma önbelleği) ayarlarından farklıdır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
max_bytes | integer | hayır | Derlenmiş modül önbelleğinin diskte tuttuğu baytların üst sınırı. Varsayılan 53687091200’dür (50 GiB); bu, hissedilmesi amaçlanan bir bütçe değil, sınırsız büyümeyi durduran bir tavandır: tek bir derlenmiş plugin yüzlerce megabayta ulaşır, bu nedenle birçok plugin sürümü derleyen bir makinede gigabaytlar birikir. Bunu tek bir derlemenin derlediğinden yüksek ayarlayın: sınır, bir derleme herhangi bir şey derlemeden önce uygulanır; bu yüzden tek bir derlemenin kendi çalışma kümesinin altındaki bir sınır, her derlemenin aynı modülleri atıp yeniden derlemesine yol açar ve depo hiçbir şey kazandırmaz. Sınır önce uygulandığı ve derleme ardından derlediğini yazdığı için depo, derlemeler arasında sınırın üzerinde kalabilir; bir sonraki derlemenin başında yeniden kırpılır. 0, sınırı devre dışı bırakır (depo sınırsız büyür ve hiçbir şey kendiliğinden kaldırılmaz). Depo her çalışma alanının paylaştığı tek bir dizin olduğundan, bu sınır bir projenin kendi dosyası taşısa bile proje başına değildir: değer diğer her anahtar gibi çözümlenir ve daha yakın dosya kazanır, ancak deponun yine de tek bir boyutu vardır. Geçerli sınır en son derlemeden gelendir; bu yüzden sınırı farklı belirleyen iki proje sırayla etkili olur ve birindeki düşük bir sınır, diğerinin derlediği makine kodunu atar. Bunu global yapılandırma dosyasında bir kez ayarlamak, tüm makineye tek bir yanıt verir. aggrega config show --origin, her ayarın etkin değerinin geldiği dosyayı adlandırır. En küçük değer: 0. Varsayılan: 53687091200 |
Ek özelliklere izin verilmez.
aggrega-config.concurrency
Daemon istek dağıtımı eşzamanlılık ayarları. Daemon istekleri tek bir stdin akışından okur ve her birini sınırlı bir istek kuyruğunu boşaltan bir çalışan havuzu üzerinden çalıştırır; yanıtlar, tamamlanma sırasından bağımsız olarak isteklerin geliş sırasına göre gönderilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
pool_size | integer | hayır | İstek kuyruğuna hizmet eden çalışan sayısı. Varsayılan 4’tür; bu değer en fazla dört isteği eşzamanlı olarak dağıtır. İstekleri geliş sırasına göre ardışık çalıştırmak için 1 olarak ayarlayın. 1’den küçük bir değer, daemon başlarken 1’e yükseltilir. En küçük değer: 1. Varsayılan: 4 |
Ek özelliklere izin verilmez.
aggrega-config.serve
IDE entegrasyonlarının kullandığı hizmet olarak derleyici için daemon (aggrega serve) davranış ayarları.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
build_on_inspect | boolean | hayır | Daemon’un bir IR grafını incelerken yapıt oluşturma aşamasını çalıştırıp çalıştırmadığı; böylece aggrega build komutunun oluşturma sırasında verdiği uyarılar düzenleyici sorunları olarak da görünür. Bir derlemenin durmasına yol açan denetimlerden hiçbirini eklemez. Her iki durumda da diske hiçbir şey yazılmaz — oluşturulmuş yapıt, çıktı dizini ya da kilit dosyası olmaz — ve oluşturma aşaması grafı hiçbir zaman değiştirmez; bu nedenle inceleme bir grafla yanıt verdiğinde bu graf her iki durumda da aynıdır. Varsayılan false’tur ve aggrega inspect ile uyumludur: terminal komutu bir grafı incelerken oluşturma aşamasına ulaşmaz, dolayısıyla böyle bir uyarı da vermez; hiç uyarı vermeyen bir düzenleyici incelemesi size terminalin gösterdiğinin aynısını gösterir. Düzenleyiciden bu ek katmanı istemek için true olarak ayarlayın. Varsayılan: false |
lint_on_validate | boolean | hayır | Daemon’un bir katalog varlığını doğrularken yayımlama uzlaşımları denetimini çalıştırıp çalıştırmadığı; böylece aggrega lint komutunun o varlık için bildirdiği bulgular düzenleyici sorunları olarak da görünür. Bulgular tavsiye niteliğindedir: bu bulgulara yol açan bir belge yine doğrulanır ve Release’i yine çözümlenir ve oluşturulur. Yalnızca yerel içeriği okuyan denetim çalışır — hiçbir kayıt defterine başvurulmaz, hiçbir şey çekilmez ve hiçbir şey yazılmaz — ve denetim diskteki dosyaya değil düzenleyicinin tuttuğu arabelleğe karşı değerlendirilir; böylece düzelttiğiniz bir ad, siz kaydetmeden önce bildirilmeyi bırakır. Varsayılan false’tur: bir düzenleyici oturumu, siz bu ikinci katmanı isteyene kadar bir belgenin doğru olup olmadığını bildirir ve bir varlığın yayımlanabilir olup olmadığı hakkında hiçbir şey söylemez. Bunu istemek için true olarak ayarlayın. Bu anahtardan bağımsız olarak bir düzenleyici denetimi her zaman doğrudan isteyebilir; daha önce yayımlanmış sürümle yayım öncesi karşılaştırmaya da bu yolla ulaşılır. Varsayılan: false |
Ek özelliklere izin verilmez.
aggrega-config.mcp
Model Context Protocol sunucusu (aggrega mcp) için ayarlar. transport, sunucuya nasıl erişileceğini — sürecin standart girdi ve çıktısı üzerinden ya da HTTP üzerinden — seçer ve hangisini seçerse seçsin okunur. announce_tools da her iki aktarımda okunur, çünkü bir istemciye hangi araçların sunulduğu, istemcinin sunucuya nasıl eriştiğinin değil sunucunun bir özelliğidir. Diğer tüm anahtarlar HTTP aktarımının başlattığı dinleyiciyi yapılandırır ve sunucu standart girdi ve çıktı üzerinden konuşurken kullanılmaz — listen de buna dahildir; orada yalnızca sunucunun, hata akışında tek satırla adresin kullanılmadığını söyleyebilmesi için okunur. Aşağıdaki her anahtar hangisi olduğunu belirtir. Düzenleyici arka uç daemon’unu yapılandıran serve’den farklıdır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
transport | string (enum) | hayır | Sunucuya nasıl ulaşıldığı: stdio, protokolü sürecin standart girdisi ve çıktısı üzerinden konuşur; komutu bir alt süreç olarak başlatan bir istemci sunucuya bu şekilde ulaşır. http ise protokolü listen anahtarının belirttiği adreste HTTP üzerinden, tls bir sertifika ve anahtar belirttiğinde de HTTPS üzerinden sunar. aggrega mcp --transport stdio|http tek bir çağrı için bu anahtarı geçersiz kılar. Varsayılan stdio’dur; bu nedenle hiçbir zaman bir aktarım belirtmeyen bir çalışma alanı, bu blok başka ne içerirse içersin standart girdi ve çıktı üzerinden sunulur — bir dinleyici yalnızca burada ya da komut satırında http seçildiğinde başlar. Başka herhangi bir değer, yapılandırma yüklenirken reddedilir. Çağıranların ağ üzerinden ulaştığı bir sunucunun yapılandırmasında http ayarlayın; bir istemcinin sunucuyu kendisi başlattığı durumlarda ise ayarlamadan bırakın: stdio seçiliyken listen içindeki bir adres kullanılmaz ve sunucu bunu hata akışında tek satırla bildirir. İzin verilen değerler: "stdio", "http" Varsayılan: "stdio" |
listen | string | hayır | HTTP aktarımı seçildiğinde dinleyicinin bağlandığı adres. Nerede dinleneceğini belirtir ve hiçbir şey seçmez: aktarımı seçmek transport anahtarının işidir ve stdio seçiliyken bu anahtar kullanılmaz. İki biçim kabul edilir: bir TCP adresi için host:port ve bir Unix etki alanı soketi için ardından bir dosya sistemi yolu gelen unix:. aggrega mcp --listen <address> tek bir çağrı için bu anahtarı geçersiz kılar. Varsayılan boştur ve HTTP aktarımı bu ikisinden birinden bir adrese ihtiyaç duyar: hiçbiri yoksa, bu aktarımı seçen bir başlatma hiçbir şey bağlanmadan önce reddedilir. Düz metin bir adres — tls altında sertifika ve anahtar olmadan ulaşılan bir adres — yalnızca geri döngüde (127.0.0.1, ::1 ya da bunlardan birine çözümlenen localhost) veya bir Unix soketinde kabul edilir; bu, öndeki bir proxy TLS’yi sonlandırdığında bir sunucunun kullandığı yapıdır. Diğer her adres, mcp.tls.cert_file ve mcp.tls.key_file adları verilerek, hiçbir şey bağlanmadan önce reddedilir. authorization.trusted_proxy ayarlandığında da sertifika olsun ya da olmasın yalnızca aynı iki biçim kabul edilir; çünkü bir başlığa ancak onu proxy’den başka hiçbir şeyin ayarlayamadığı yerde kimlik bilgisi olarak güvenilebilir. Varsayılan: "" |
tls | object | hayır | TLS’yi sunan sürecin içinde sonlandırmak için sertifika ve anahtar. HTTPS’yi doğrudan listen anahtarının belirttiği dinleyiciden sunmak için ikisini de ayarlayın. Düz metin sunmak için ikisini de ayarlamadan bırakın; bu, listen anahtarını geri döngüyle ya da bir Unix soketiyle sınırlar — öndeki bir proxy sertifikayı tuttuğunda kullanılacak yapı budur. Her iki anahtar da diskteki dosyaların yollarıdır; hiçbiri anahtar malzemesini satır içinde tutmaz. |
allowed_origins | string[] | hayır | Bir isteğin Origin başlığında kabul edilen kökenler. Origin başlığı bu listede bulunmayan bir kökeni belirten bir istek 403 ile reddedilir; listelenmiş bir kökeni belirten ya da hiç Origin başlığı taşımayan bir istek sunulur. Bir girdi başlıkla birebir karşılaştırılır; bu nedenle her girdi bir tarayıcının kökeni gönderdiği şekilde yazılır: küçük harfli bir şema, ://, küçük harfli bir ana makine — bir ad, bir IPv4 adresi ya da köşeli parantez içinde bir IPv6 adresi — ve port şemanın varsayılanı değilse : ile port; ardından hiçbir şey gelmez. Örneğin https://app.example.com ya da http://localhost:3000. Başka herhangi bir biçimdeki bir girdi, bir tarayıcının gönderdiğine hiçbir zaman eşit olamayacağından yapılandırma dosyası yüklenirken dosya ve girdi adı verilerek reddedilir: sonunda / ya da bir yol bulunan (https://app.example.com/), şeması olmayan (app.example.com) ve büyük harf ya da boşluk içeren girdiler. Varsayılan boştur; bu nedenle hiçbir köken kabul edilmez ve yalnızca Origin başlığı göndermeyen bir çağıran sunulur. Bu yüzden tarayıcı tabanlı bir istemcinin kökeninin burada listelenmesi gerekir; tarayıcı olmayan bir istemci böyle bir başlık göndermez ve bir girdiye ihtiyaç duymaz. Her girdi ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$ deseniyle eşleşir. Varsayılan: [] |
limits | object | hayır | HTTP dinleyicisinin, tek bir çağıranın sunan süreci tüketememesi için kabul ettiği trafiğe uyguladığı sınırlar. Tek bir isteğin ne kadar büyük olabileceğini, aynı anda kaç isteğin çalışabileceğini ve bir çağıranın ne kadar hızlı gönderebileceğini sınırlarlar. Hiçbiri kapatılamaz. |
authorization | object | hayır | Bu sunucunun, çağıranlarının sunduğu bearer token’lar hakkında bildirdikleri: bunları hangi yetkilendirme sunucusunun verdiği, bu sunucunun token’ların verildiği kaynak olarak kendisi için yayımladığı adres, isteğe bağlı olarak o sunucunun doğrulama anahtarlarının okunacağı bir dosya ve isteğe bağlı olarak token’ları önündeki bir proxy doğruladığında o proxy’nin ayarladığı başlıklar. issuer ve resource, HTTP aktarımı seçildiğinde her zaman gereklidir ve bunlar olmadan bir dinleyici herhangi bir bağlama yapılmadan reddedilir; standart girdi ve çıktı üzerinden konuşan bir sunucu bunların hiçbirini okumaz. İkisi de dinleyicinin sunduğu OAuth korumalı kaynak meta veri belgesinde yayımlanır; bu belge, bir HTTP çağıranının hiçbir kimlik bilgisi istenmeden aldığı tek yanıttır, çünkü bir istemci token’ı nereden alacağını öğrenmek için onu okur. Bu blok gizli bir malzeme içermez: token, çağıran tarafından yaptığı istekte sunulur ve hiçbir zaman bir yapılandırma alanı değildir; jwks_file ise imzalayan herhangi bir şeyi değil, açık doğrulama anahtarlarını belirtir. |
deny_reach | string (enum)[] | hayır | Çağıranın token’ı ne derse desin bu sunucunun taşımadığı erişim türleri. Her işlem kendi etkilerinin ne kadar uzağa ulaştığını bildirir — okuyan ya da oluşturan ve geride hiçbir şey bırakmayan bir işlem için none, bu sürecin hizmet verdiği çalışma alanı içine yazan bir işlem için workspace, yayımlayan, imzalayan ya da geri çeken bir işlem için registry ve ana makinedeki tüm çalışma alanlarının paylaştığı şeyi değiştiren bir işlem için machine — ve burada bir türün adını vermek, o türdeki her aracı bu sunucudan geri çeker. Geri çekilen bir araç, her çağıran için araç listesinde ve describe-capabilities’ın yanıtında yer almaz; yine de çağrılırsa bu ayarın adı verilerek reddedilir, çünkü hiçbir kapsam ona izin veremez. Varsayılan boştur; dolayısıyla sunucu, çağıranlarının kapsamlarının izin verdiği her şeyi taşır. Bu, kapsamların çağıran başına koyduğu sınırın üzerine sunucunun kendisine koyduğu bir sınırdır: yalnızca okuma hizmeti veren bir sunucu burada üç yazma türünü belirtir ve böylece token’ı tüm kapsamları taşıyan bir çağırana bile yayımlama yapamaz. machine belirtmek kabul edilir ve hiçbir şeyi değiştirmez — bu türden hiçbir araç HTTP üzerinden zaten sunulmaz; bu bir ayar değil, aktarımın bir özelliğidir. Dinleyici başlarken okunur: dördünün dışındaki bir değer yapılandırma yüklenirken reddedilir ve değiştirilmesi yeniden başlatma gerektirir. Sunucu standart girdi ve çıktı üzerinden konuşurken hiç okunmaz; orada çağıran, süreci başlatan kişidir. Her girdi için izin verilen değerler: "none", "workspace", "registry", "machine". Varsayılan: [] |
announce_tools | string[] | hayır | Bu sunucunun duyurduğu araçlar; tam olarak araç listesinin bildirdiği şekilde adlandırılır. Anahtarı atlarsanız bu sunucunun taşıdığı her araç duyurulur; protokolü izleyen bir istemcinin beklediği de budur: tüm araç listesini alır ve bunun ne kadarını bir modelin önüne koyacağına kendisi karar verir. Bir liste yazarsanız tam olarak o araçlar duyurulur — dışarıda bırakılan bir araç araç listesinde ve describe-capabilities’ın yanıtında yer almaz ve adıyla çağrıldığında bu ayarın adı verilerek reddedilir. Boş bir liste yazarsanız hiçbir şey duyurulmaz. Bunu, diğer uçtaki istemcinin kaydedeceği araç sayısını sınırladığı yerde ayarlayın — bazı istemciler bu sınırı aynı anda bağlı oldukları tüm sunuculara birlikte uygular — ve o istemcinin ihtiyaç duyduğu araçları belirtin. Yalnızca duyurulanı daraltır, fazlasını yapmaz: bir yeteneği tamamen geri çeken deny_reach’i ya da çağıranın token’ının taşıdığı kapsamları genişletemez. Burada adı verilen ve deny_reach’in geri çektiği türden olan bir araç araç listesinin dışında kalır ve çağrıldığında o ayarın adı verilerek reddedilir; burada adı verilen ancak çağıranın kapsamlarının izin vermediği bir araç yine listelenir ve ona yapılan çağrı, ona izin verecek kapsamın adı verilerek reddedilir. Her ad, bu ikili dosyanın taşıdığı bir ad olmalıdır: hiçbir aracın karşılık gelmediği bir ad sunucu başlarken reddedilir, çünkü aksi halde daha dar bir yüzey isteyen kişiye, bunu söyleyen hiçbir şey olmadan farklı bir yüzey sunulurdu. Ayrı bir süreçte bir aggrega komutu çalıştıran cli- ailesindeki bir ad her iki aktarımda da kabul edilir ve HTTP üzerinden hiçbir şey duyurmaz; orada bu tür bir araç hiçbir çağırana sunulmaz. Sunucu başlarken her iki aktarımda da okunur; böylece duyurulan küme sürecin ömrü boyunca sabittir ve değiştirilmesi yeniden başlatma gerektirir. |
health | object | hayır | Bir denetleyicinin bu sürecin canlı olup olmadığını ve bir çağrıyı yanıtlamaya hazır olup olmadığını sorduğu yer. İki denetim kendine ait bir adreste yanıtlanır, hiçbir zaman listen’ın belirttiği adreste değil: uç noktaya yapılan her istek bir bearer token taşır; dolayısıyla orada yanıtlanan bir yoklama, uç noktaya ulaşabilen her şeye sürecin kimlik doğrulamasız bir okumasını ve onu çalıştırmanın serbest bir yolunu verirdi. Uç nokta /healthz ve /readyz isteklerini, token’lı ya da token’sız fark etmeksizin, sunmadığı her yol için verdiği aynı 404 ile yanıtlar. |
Ek özelliklere izin verilmez.
aggrega-config.mcp.tls
TLS’yi sunan sürecin içinde sonlandırmak için sertifika ve anahtar. HTTPS’yi doğrudan listen anahtarının belirttiği dinleyiciden sunmak için ikisini de ayarlayın. Düz metin sunmak için ikisini de ayarlamadan bırakın; bu, listen anahtarını geri döngüyle ya da bir Unix soketiyle sınırlar — öndeki bir proxy sertifikayı tuttuğunda kullanılacak yapı budur. Her iki anahtar da diskteki dosyaların yollarıdır; hiçbiri anahtar malzemesini satır içinde tutmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
cert_file | string | hayır | Dinleyicinin sunduğu PEM sertifika zincirinin yolu; süreç başlarken okunur. key_file ile birlikte ayarlanır. Varsayılan boştur; bu durumda dinleyici düz metin sunar ve listen loopback ya da bir Unix soketiyle sınırlanır. Varsayılan: "" |
key_file | string | hayır | cert_file içindeki sertifikaya ait PEM özel anahtarının yolu; süreç başlarken okunur. Onunla birlikte ayarlanır. Bir dosya yoludur, hiçbir zaman satır içi anahtar malzemesi değildir. Varsayılan boştur; bu durumda dinleyici düz metin sunar ve listen loopback ya da bir Unix soketiyle sınırlanır. Varsayılan: "" |
Ek özelliklere izin verilmez.
aggrega-config.mcp.limits
HTTP dinleyicisinin, tek bir çağıranın sunan süreci tüketememesi için kabul ettiği trafiğe uyguladığı sınırlar. Tek bir isteğin ne kadar büyük olabileceğini, aynı anda kaç isteğin çalışabileceğini ve bir çağıranın ne kadar hızlı gönderebileceğini sınırlarlar. Hiçbiri kapatılamaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
max_body_bytes | integer | hayır | Dinleyicinin kabul ettiği en büyük istek gövdesi, bayt cinsinden. Gövdesi bunu aşan bir istek 413 ile reddedilir ve gövde sınırın ötesinde okunmaz. Varsayılan 4194304’tür (4 MiB); bu değer, tam bir yazım belgesi taşıyan bir araç çağrısının çok üzerinde ve tek bir çağıranın sürecin belleğinin önemli bir bölümünü tutmasına izin verecek miktarın çok altındadır. En küçük değer 1’dir; dolayısıyla sınırı kapatan bir değer yoktur; çağıranların meşru olarak daha büyük belgeler gönderdiği yerde artırın. En küçük değer: 1. Varsayılan: 4194304 |
max_concurrent_requests | integer | hayır | Dinleyicinin aynı anda çalıştırdığı istek sayısı. Bu kadar istek zaten işlenmekteyken gelen bir istek kuyruğa alınmak yerine 503 ile reddedilir; böylece çağırana, göremediği işlerin arkasında beklemek yerine yeniden denemesi söylenir. Varsayılan 16’dır; bu, küçük bir ana makineyi yanıt verir durumda tutarken birkaç eşzamanlı araç çağrısına yer bırakır; daha büyük bir ana makinede artırın. En küçük değer 1’dir; dolayısıyla sınırı kapatan bir değer yoktur. En küçük değer: 1. Varsayılan: 16 |
requests_per_minute | integer | hayır | Bir çağıranın bir dakikada gönderebileceği istek sayısı. Sunucu başına değil çağıran başına sayılır — çağıranın token’ının belirttiği özneye ya da güvenilen bir proxy’nin bildirdiği kimliğe göre — böylece meşgul bir çağıran başka birinin hakkını harcayamaz. Bir çağıran bu kadarını bir seferde gönderebilir; ardından hak düzenli olarak, her 60 / requests_per_minute saniyede bir istek daha olacak şekilde dolar ve hiç hak kalmamışken gelen bir istek 429 ile reddedilir. Varsayılan 120’dir; bu, sürekli olarak saniyede iki istek demektir: bir çalışma alanını yöneten bir asistanın gönderdiğinin çok üzerindedir ve yine de döngüye girmiş bir istemci için bir sınırdır. En küçük değer 1’dir; dolayısıyla sınırı kapatan bir değer yoktur. En küçük değer: 1. Varsayılan: 120 |
Ek özelliklere izin verilmez.
aggrega-config.mcp.authorization
Bu sunucunun, çağıranlarının sunduğu bearer token’lar hakkında bildirdikleri: bunları hangi yetkilendirme sunucusunun verdiği, bu sunucunun token’ların verildiği kaynak olarak kendisi için yayımladığı adres, isteğe bağlı olarak o sunucunun doğrulama anahtarlarının okunacağı bir dosya ve isteğe bağlı olarak token’ları önündeki bir proxy doğruladığında o proxy’nin ayarladığı başlıklar. issuer ve resource, HTTP aktarımı seçildiğinde her zaman gereklidir ve bunlar olmadan bir dinleyici herhangi bir bağlama yapılmadan reddedilir; standart girdi ve çıktı üzerinden konuşan bir sunucu bunların hiçbirini okumaz. İkisi de dinleyicinin sunduğu OAuth korumalı kaynak meta veri belgesinde yayımlanır; bu belge, bir HTTP çağıranının hiçbir kimlik bilgisi istenmeden aldığı tek yanıttır, çünkü bir istemci token’ı nereden alacağını öğrenmek için onu okur. Bu blok gizli bir malzeme içermez: token, çağıran tarafından yaptığı istekte sunulur ve hiçbir zaman bir yapılandırma alanı değildir; jwks_file ise imzalayan herhangi bir şeyi değil, açık doğrulama anahtarlarını belirtir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
issuer | string | hayır | Bu dinleyicinin kabul ettiği token’ları veren yetkilendirme sunucusunun adresi; o sunucunun kendi veren tanımlayıcısını belirttiği şekilde yazılır — örneğin https://login.example.com. Korumalı kaynak meta veri belgesinin authorization_servers listesinde yayımlanır; bir istemci bu dinleyici için token’ı nereden alacağını bu yolla öğrenir. Varsayılan boştur ve bu kullanılabilir bir değer değildir: bu anahtar şema ve ana makine dahil tam bir adres taşımadıkça bir dinleyici herhangi bir bağlama yapılmadan reddedilir. Yetkilendirme sunucusu bu makinede çalışmıyorsa bir https adresidir: düz http yalnızca localhost, 127.0.0.1 ya da ::1 gibi bir geri döngü ana makinesi için kabul edilir; başka herhangi bir ana makinedeki düz http veren, bu anahtarın adı verilerek ve bir https adresi istenerek herhangi bir bağlama yapılmadan reddedilir. Bu, anahtarlar verenden ya da jwks_file’dan okunsa da, token’ları öndeki bir trusted_proxy denetlese de geçerlidir, çünkü her istemci token’ını almak için verene yönlendirilir. Varsayılan: "" |
resource | string | hayır | Bu sunucunun, bir çağıranın ona ulaştığı şekliyle kendisi için yayımladığı adres — örneğin https://mcp.example.com/mcp. Öndeki bir proxy’nin sunduğu ana makine dahil, çağıranların gerçekten kullandığı adresi yazın, çünkü bu, bir istemcinin bu sunucu için token isterken yetkilendirme sunucusuna verdiği tanımlayıcıdır ve korumalı kaynak meta veri belgesinin resource alanı olarak değiştirilmeden yayımlanır. Bu belgenin sunulduğu yer, ana makine ile yol arasına /.well-known/oauth-protected-resource eklenerek bundan türetilir: https://mcp.example.com/mcp olarak yayımlanan bir sunucu belgeyi https://mcp.example.com/.well-known/oauth-protected-resource/mcp adresinde ve ayrıca bu iyi bilinen yolun arkasında hiçbir şey olmayan hâlinde sunar; bir istemcinin ikinci olarak baktığı yer budur. Bir token yalnızca bu adres belirttiği hedef kitleler arasındaysa kabul edilir. Varsayılan boştur ve bu kullanılabilir bir değer değildir: bu anahtar şema ve ana makine dahil tam bir adres taşımadıkça bir dinleyici herhangi bir bağlama yapılmadan reddedilir. Varsayılan: "" |
jwks_file | string | hayır | Bu sunucunun kabul ettiği token’ların doğrulandığı JSON Web Key Set’i tutan dosyanın yolu; süreç başlarken okunur. Varsayılan boştur ve olağan durum budur: anahtarlar, issuer’a onları nerede yayımladığı sorularak ve belirttiği adresten alınarak yetkilendirme sunucusunun kendisinden okunur; tutulan kümenin taşımadığı bir anahtar tanımlayıcısıyla imzalanmış bir token geldiğinde bir kez yeniden okunur. Bunu çalışma alanının çevrimdışı olduğu yerde ayarlayın; bu durumda o olmadan bir dinleyici herhangi bir bağlama yapılmadan reddedilir, çünkü çevrimdışı bir çalışma alanı hiçbir ağ isteği yapmaz ve anahtarları elde etmenin başka yolu yoktur; bu durumda dosya kabul edilen tek anahtarları tutar ve yetkilendirme sunucusuyla hiçbir zaman iletişim kurulmaz. Dosya açık doğrulama anahtarlarını tutar, hiçbir zaman imzalayan bir şeyi tutmaz. Göreli bir yol, onu bildiren yapılandırma dosyasının dizinine göre çözümlenir. Varsayılan: "" |
trusted_proxy | object | hayır | Bir bearer token’ı burada doğrulamak yerine, çağıranın kim olduğunu öndeki bir proxy’nin ayarladığı başlıklardan okur. Bunu yalnızca ikisi de geçerli olduğunda ayarlayın: öndeki bir proxy token’ları kendisi doğrular ve o proxy dışında hiçbir şey dinleyiciye ulaşamaz: bu ayarlıyken listen geri döngü ya da bir Unix soketi olmalıdır ve başka herhangi bir adres, iki ayarın da adı verilerek herhangi bir bağlama yapılmadan reddedilir. Bir başlık, tam olarak onu ayarlayabilen çağıranlar kümesi kadar güvenilirdir ve ağın ulaştığı bir adreste her çağıran istediği başlığı ayarlayabilir; dolayısıyla böyle bir adreste bu kipte çalışan bir dinleyici her çağıranın herhangi biri olduğunu iddia etmesine izin verirdi. Bu ayarlıyken hiçbir token okunmaz — ne Authorization başlığından ne başka bir yerden ve hiçbir anahtar kümesi alınmaz —; çağıranın kimliği principal_header değeridir, bu başlığı taşımayan bir istek 401 ile yanıtlanır ve yalnızca burada adı verilen iki başlık okunur. Varsayılan olduğu gibi bunu atlarsanız bu sunucu bearer token’ları kendisi doğrular. |
Ek özelliklere izin verilmez.
aggrega-config.mcp.authorization.trusted_proxy
Bir bearer token’ı burada doğrulamak yerine, çağıranın kim olduğunu öndeki bir proxy’nin ayarladığı başlıklardan okur. Bunu yalnızca ikisi de geçerli olduğunda ayarlayın: öndeki bir proxy token’ları kendisi doğrular ve o proxy dışında hiçbir şey dinleyiciye ulaşamaz: bu ayarlıyken listen geri döngü ya da bir Unix soketi olmalıdır ve başka herhangi bir adres, iki ayarın da adı verilerek herhangi bir bağlama yapılmadan reddedilir. Bir başlık, tam olarak onu ayarlayabilen çağıranlar kümesi kadar güvenilirdir ve ağın ulaştığı bir adreste her çağıran istediği başlığı ayarlayabilir; dolayısıyla böyle bir adreste bu kipte çalışan bir dinleyici her çağıranın herhangi biri olduğunu iddia etmesine izin verirdi. Bu ayarlıyken hiçbir token okunmaz — ne Authorization başlığından ne başka bir yerden ve hiçbir anahtar kümesi alınmaz —; çağıranın kimliği principal_header değeridir, bu başlığı taşımayan bir istek 401 ile yanıtlanır ve yalnızca burada adı verilen iki başlık okunur. Varsayılan olduğu gibi bunu atlarsanız bu sunucu bearer token’ları kendisi doğrular.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
principal_header | string | evet | Öndeki proxy’nin çağıranın kimliğini koyduğu başlık — örneğin X-Forwarded-User. Bir HTTP başlık adı olarak yazılır: harfler, rakamlar ve kısa çizgiler ile bir başlık adının taşıyabileceği diğer karakterler (!#$%&'*+.^_|~ ve ters tırnak); boşluk, iki nokta ya da başka bir ayırıcı içermez. Başka herhangi bir biçimdeki ad, yapılandırma dosyası yüklenirken dosyanın ve anahtarın adı verilerek reddedilir, çünkü hiçbir istek böyle bir başlık taşıyamaz. Boş bir ad da reddedilir: blok öndeki bir proxy’nin token’ları denetlediğini söylerken bu sunucunun token’ları kendisinin denetlemesine yol açardı. Bu kipi kapalı bırakmak için trusted_proxy’yi atlayın. Başlığın değeri tam olarak yazıldığı gibi alınır ve hiçbir şeyle karşılaştırılmaz; bu sunucunun kendisinin doğruladığı bir token’ın öznesinin kaydedilip hiçbir şeyle karşılaştırılmaması gibi. Bu kipte kimlik bilgisinin tamamıdır; bu nedenle trusted_proxy ayarlandığında her zaman zorunludur ve onsuz gelen bir istek 401 ile yanıtlanır. Desen: ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$. |
scopes_header | string | hayır | Öndeki proxy’nin çağırana verilen kapsamları boşluklarla ayırarak koyduğu başlık — örneğin X-Forwarded-Scopes. principal_header ile aynı biçimde bir HTTP başlık adı olarak yazılır ya da boş bırakılır. Başka herhangi bir biçimdeki ad, yapılandırma dosyası yüklenirken dosyanın ve anahtarın adı verilerek reddedilir, çünkü hiçbir istek böyle bir başlık taşıyamaz ve hiçbir çağırana hiçbir zaman bir kapsam verilmezdi. Varsayılan boştur; bu, hiçbir çağıran için kapsam bildirmez. Adı ne olursa olsun, bu başlık ve principal_header dışında hiçbir başlık okunmaz. Desen: ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. Varsayılan: "" |
Ek özelliklere izin verilmez.
aggrega-config.mcp.health
Bir denetleyicinin bu sürecin canlı olup olmadığını ve bir çağrıyı yanıtlamaya hazır olup olmadığını sorduğu yer. İki denetim kendine ait bir adreste yanıtlanır, hiçbir zaman listen’ın belirttiği adreste değil: uç noktaya yapılan her istek bir bearer token taşır; dolayısıyla orada yanıtlanan bir yoklama, uç noktaya ulaşabilen her şeye sürecin kimlik doğrulamasız bir okumasını ve onu çalıştırmanın serbest bir yolunu verirdi. Uç nokta /healthz ve /readyz isteklerini, token’lı ya da token’sız fark etmeksizin, sunmadığı her yol için verdiği aynı 404 ile yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
listen | string | hayır | Canlılık ve hazırlık denetimlerinin yanıtlandığı adres; listen’ın aldığı iki biçimle aynıdır: host:port ya da ardından bir dosya sistemi yolu gelen unix:. Varsayılan boştur; bu durumda ikinci bir dinleyici başlatılmaz ve iki denetim de hiçbir yerde yanıtlanmaz. Bir adres ayarlandığında GET /healthz, sürecin çalıştığı andan itibaren 200 ile yanıtlanır; GET /readyz ise çalışma alanı çözümlenip uç nokta bağlanana kadar 503, o andan sonra 200 ile yanıtlanır. Bir denetleyicinin ihtiyaç duyduğu ayrım budur, çünkü ayakta olan bir süreç henüz bir çağrıyı yanıtlayabilen bir süreç değildir. Her yanıt boş gövdeli bir durum kodudur, hiçbir token istenmez ve hiçbir başlık okunmaz; bu adresteki başka herhangi bir yol 404, bu ikisindeki başka herhangi bir yöntem ise 405 olur. listen’ın aksine bu adres loopback’e ya da bir Unix soketine sınırlı değildir ve bunun için hiçbir adres reddedilmez: adresi bunlardan birine yöneltin, amacı da budur; seçtiğiniz adrese ulaşabilen her şeyin bu iki yanıtı okuyabileceğini unutmayın. Varsayılan: "" |
Ek özelliklere izin verilmez.
Tanımlar
ReleaseCatalogConfig
Bir Release’in kendi katalog dizinleri: workspace bloğunun taşıdığı aynı iki anahtar, o Release ile sınırlı olarak.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
catalog_dirs | string[] | hayır | Bu Release’in yerel varlıkları çalışma alanının catalog_dirs listesi yerine okuduğu katalog dizinleri; her biri onu bildiren dosyaya göre çözümlenir. Çalışma alanının listesiyle aynı sıralı, ilk eşleşmenin kazandığı arama yığınıdır; çalışma alanı kökündeki catalog dizini, var olduğunda ve listelenen hiçbir girdi onu zaten içermediğinde, listeden sonra okunur. Belirtilmezse Release çalışma alanının listesini korur; [] olarak yazılırsa hiçbir yerel katalog okumaz. |
catalog_dirs_append | string[] | hayır | Bu Release’in listesinden sonra eklenen katalog dizinleri — girdi kendi catalog_dirs değerini yazıyorsa o, aksi halde çalışma alanınınki —; her biri onu bildiren dosyaya göre çözümlenir. Varsayılan: [] |
Ek özelliklere izin verilmez.
RegistryConfig
Tek bir OCI registry ana makinesiyle sınırlı ayarlar ve imza güven politikası.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Bu ayarların uygulandığı registry ana makinesi (ör. hub.aggrega.ai). Push/pull hedefinin registry ana makinesiyle eşleştirilir, bu yüzden bu eşleştirmenin yapıldığı yazımla yazılır: nokta içeren küçük harfli bir ana makine adı, localhost, ardından port gelen tek bir ad (registry:5000), bir IPv4 adresi veya köşeli parantez içinde bir IPv6 adresi; her biri isteğe bağlı bir :port ile — şema, yol, kimlik bilgisi, boşluk veya büyük harf olmadan. HTTPS üzerinden ulaşılan bir ana makinede 443 portu o ana makinenin varsayılan portudur ve bunu yazmak, yapılandırma yüklenirken, ana makinenin portsuz yazılmasını belirterek reddedilir; çünkü bu şekilde yazılmış bir girdi hiçbir zaman bulunan girdi olmazdı. localhost ve diğer loopback adreslerine düz HTTP üzerinden ulaşılır, bu yüzden orada 443 sıradan bir porttur ve korunur. aggrega registry add ve aggrega config init --registry, girdiyi argümanlarının belirttiği ana makine altında anahtarlar ve bu şekilde yazılmamış olanı reddeder. Ana makine yalnızca yazımına göre değerlendirilir: adın çözümlenip çözümlenmediği veya orada bir registry’nin yanıt verip vermediği denetlenmez. Desen: ^(?:(?:(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?|localhost|(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\.(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|\[(?:(?:[0-9a-f]{1,4}:){7}[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,7}:|(?:[0-9a-f]{1,4}:){1,6}:[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,5}(?::[0-9a-f]{1,4}){1,2}|(?:[0-9a-f]{1,4}:){1,4}(?::[0-9a-f]{1,4}){1,3}|(?:[0-9a-f]{1,4}:){1,3}(?::[0-9a-f]{1,4}){1,4}|(?:[0-9a-f]{1,4}:){1,2}(?::[0-9a-f]{1,4}){1,5}|[0-9a-f]{1,4}:(?::[0-9a-f]{1,4}){1,6}|:(?:(?::[0-9a-f]{1,4}){1,7}|:))\])(?::(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?|[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?:(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))$. |
name | string | hayır | Bu registry için isteğe bağlı kullanıcı dostu takma ad. Kimlik ana makinedir; name, bir registry’nin adlandırıldığı her yerde (örneğin --registry veya default_registry) bu girdinin ana makinesine çözümlenen bir kolaylık seçicisidir. Bir takma ad girdiler arasında benzersiz olmalıdır. |
trusted_identities | TrustedIdentity[] | hayır | Bu registry’den çekilen yapıtlar için kabul edilen anahtarsız imzalama kimliklerinin VEYA kümesi. Bir imza, sertifikası herhangi bir girdiyle eşleştiğinde doğrulanır. Anahtarsız doğrulama yolu tarafından kullanılır. Varsayılan: [] |
trusted_deprecation_identities | TrustedIdentity[] | hayır | Bu registry’den çekilen bir yapıt için geriye dönük bir kullanımdan kaldırma işaretini imzalamak üzere ek olarak kabul edilen anahtarsız kimliklerin VEYA kümesi. Bir kullanımdan kaldırma işareti, imzası özgün yapıtın imzalayanıyla VEYA buradaki herhangi bir girdiyle eşleştiğinde dikkate alınır — böylece bir registry sahibi veya bir güvenlik ekibi, yapıtların kendisini imzalamak için güvenilir sayılmadan, özgün yayıncının artık ulaşamadığı bir yapıtı geri çekebilir. Yalnızca kullanımdan kaldırma keşif yolu tarafından kullanılır; yapıt imzaları için güven kümesini hiçbir zaman genişletmez. Varsayılan: [] |
public_key | string | hayır | Anahtarlı modda bir registry için sabitlenmiş, cosign uyumlu açık anahtar; satır içinde bir PEM bloğu olarak yazılır: -----BEGIN PUBLIC KEY----- satırından (veya -----BEGIN RSA PUBLIC KEY-----) eşleşen -----END satırına kadar olan metin, aggrega registry add --key komutunun bir anahtar dosyasından kopyaladığı biçimde. Ayarlandığında, bu registry’den gelen imzalar anahtarsız kimliklere göre değil, bu anahtara göre çevrimdışı doğrulanır. Hiçbir -----BEGIN … PUBLIC KEY----- satırı taşımayan bir değer, yapılandırma dosyası yüklenirken dosya ve girdi belirtilerek reddedilir; yanlışlıkla buraya yapıştırılmış bir özel anahtar da öyle. Satır değerin herhangi bir yerinde bulunabilir, çünkü anahtar değerin taşıdığı PEM bloğundan okunur ve bu bloktan önceki her metin yok sayılır. Burada yalnızca bu satır denetlenir: bloğun çözülebilen bir anahtar içerip içermediği, bu registry’den gelen bir imza ona göre doğrulandığında anlaşılır. Değer hassas olarak bildirilmiştir (x-aggrega-sensitive), bu yüzden reddedilen bir değer — özellikle yanlışlıkla seçilmiş bir özel anahtar — hiçbir zaman alıntılanmaz: ret, dosyayı, girdiyi ve değerin karşılamadığı kısıtı — yukarıdaki deseni veya string türünü — belirtir ve değerin yerinde <redacted> gösterir. Yüklenen bir açık anahtar yazıldığı gibi okunur ve gösterilir. Desen: -----BEGIN [A-Z ]*PUBLIC KEY-----. |
trusted_root | string | hayır | Ağdan yalıtılmış (air-gapped) anahtarsız doğrulama için sabitlenmiş bir Sigstore güven kökü paketine isteğe bağlı yol. Ayarlandığında anahtarsız güven çapası ağ kullanılmadan bu dosyadan yüklenir; boş olduğunda kamuya açık güven kökü indirilir ve önbelleğe alınır. |
advisory | boolean | hayır | True olduğunda, bu registry için bir imza doğrulama hatası çekme işlemini durdurmak yerine bir uyarıya indirgenir. Doğrulama yine çalışır ve hata raporlanır; çekme işlemi devam eder. Varsayılan olarak false’tur. Varsayılan: false |
skip_signature_verification | boolean | hayır | İmza doğrulamasından ana makine başına acil durum devre dışı bırakma — globaldekiyle aynı skip_signature_verification anahtarı, yerleşimi gereği bu ana makineyle sınırlı. Üst düzey signing.required politikasını etkisiz kılmaz: kuruluşun zorunlu kıldığı bir imza, bu anahtardan bağımsız olarak bu ana makinede yine doğrulanır; bunu yalnızca global anahtar devre dışı bırakabilir. Bunu aynı ana makinede registry başına bir signing.required ile birlikte ayarlamaya izin verilir ve bu, push sırasında zorunlu imzayı pull sırasında atlanan doğrulamayla birleştirir: doğrulama tarafında atlama kazanır, çünkü ana makine başına zorunlu tutum (üst düzeydekinin aksine) ana makine başına atlamaya karşı bağışık değildir. Varsayılan olarak false’tur. Varsayılan: false |
signing | SigningConfig | hayır | Bu registry’nin imzalama bloğu: anahtarsız hizmet URL’leri, isteğe bağlı bir anahtarlı anahtar yolu ve ana makine başına güven tutumu. Uç nokta alanları, bu ana makineye yapılan push işlemleri için global signing bloğunu geçersiz kılar; bir CLI bayrağı ikisini de geçersiz kılar. required ve kinds kapsamlarını yerleşimden alır — bir registry girdisinin altında tek güven tutumunu bu ana makineyle sınırlar (kapsamdaki imzasız bir yapıtı yayımlamak reddedilir ve imzasız birini tüketmek reddedilir); bu, üst düzey signing bloğunun tüm registry’ler için taşıdığı kavramın aynısıdır. |
Ek özelliklere izin verilmez.
SigningConfig
Bir imzalama bloğu: anahtarsız hizmet URL’leri, anahtarlı bir anahtar dosyasına isteğe bağlı bir işaretçi ve güven duruşu (required ve kinds). Üst düzeye yerleştirildiğinde tüm kayıt defterlerine uygulanır; bir registries[] girdisinin altına yerleştirildiğinde o ana makineye uygulanır — her alan kapsamını yerleşiminden okur. required, iki yönü de kapsayan tek bir güven duruşudur (kapsamdaki imzasız bir push reddedilir ve kapsamdaki imzasız bir pull reddedilir). Güvenlik: hiçbir gizli malzeme tutmaz — OIDC kimlik belirteci hiçbir zaman bir yapılandırma alanı değildir (kısa ömürlüdür, çalışma zamanında sağlanır) ve key_path bir anahtar dosyasının yoludur, hiçbir zaman satır içi anahtar baytları değildir. Bu, doğrulama tarafının asimetrisini yansıtır: orada satır içi bir public_key’e izin verilir, ancak imzalama tarafı yalnızca bir anahtar yolu taşır. HTTP üzerinden erişilen bir aggrega mcp sunucusu iki yerleşimde de hiçbir key_path’e başvurmaz; bu nedenle böyle bir dinleyici üzerinden anahtarlı imzalamaya erişilemez: yanıtladığı bir çağrı yalnızca o çağrının taşıdığı bir kimlik belirteciyle imzalar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
fulcio_url | string | hayır | Anahtarsız imzalama için Fulcio sertifika yetkilisi URL’si. Ayarlanmadığında herkese açık Fulcio örneği kullanılır. Mutlak bir https URL’si olarak yazılır: https://, bir ana makine ve isteğe bağlı olarak bir bağlantı noktası ile bir yol, boşluk olmadan — örneğin https://fulcio.sigstore.dev. Başka herhangi bir biçimdeki değer, örneğin şeması olmayan (fulcio.example.com) ya da http:// ile başlayan bir değer, yapılandırma dosyası yüklenirken dosya ve anahtar adlandırılarak reddedilir. Dosya, üzerine başka herhangi bir şey uygulanmadan önce denetlenir; bu nedenle aynı uç nokta AGGREGA_SIGNING_FULCIO_URL ile, --fulcio-url bayrağıyla ya da bir düzenleyiciden veya bir asistandan gelen bir yayımlama isteğinde sağlandığında bu biçime tabi tutulmaz. Desen: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
rekor_url | string | hayır | Anahtarsız imzalama için Rekor şeffaflık günlüğü URL’si. Ayarlanmadığında herkese açık Rekor örneği kullanılır. Mutlak bir https URL’si olarak yazılır: https://, bir ana makine ve isteğe bağlı olarak bir bağlantı noktası ile bir yol, boşluk olmadan — örneğin https://rekor.sigstore.dev. Başka herhangi bir biçimdeki değer, örneğin şeması olmayan (rekor.example.com) ya da http:// ile başlayan bir değer, yapılandırma dosyası yüklenirken dosya ve anahtar adlandırılarak reddedilir. Dosya, üzerine başka herhangi bir şey uygulanmadan önce denetlenir; bu nedenle aynı uç nokta AGGREGA_SIGNING_REKOR_URL ile, --rekor-url bayrağıyla ya da bir düzenleyiciden veya bir asistandan gelen bir yayımlama isteğinde sağlandığında bu biçime tabi tutulmaz. Desen: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
timestamp_url | string | hayır | Anahtarsız imzalama için RFC3161 zaman damgası yetkilisi URL’si. Varsayılanı yoktur: ayarlanmadığında hiçbir zaman damgası yetkilisiyle iletişim kurulmaz ve anahtarsız bir imzanın güvenilir zamanı, şeffaflık günlüğü girdisinden gelir. Mutlak bir https URL’si olarak yazılır: https://, bir ana makine ve isteğe bağlı olarak bir bağlantı noktası ile bir yol, boşluk olmadan — örneğin https://tsa.example.com/api/v1/timestamp. Başka herhangi bir biçimdeki değer, örneğin şeması olmayan (tsa.example.com) ya da http:// ile başlayan bir değer, yapılandırma dosyası yüklenirken dosya ve anahtar adlandırılarak reddedilir. Dosya, üzerine başka herhangi bir şey uygulanmadan önce denetlenir; bu nedenle aynı uç nokta AGGREGA_SIGNING_TIMESTAMP_URL ile, --timestamp-url bayrağıyla ya da bir düzenleyiciden veya bir asistandan gelen bir yayımlama isteğinde sağlandığında bu biçime tabi tutulmaz. Desen: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
key_path | string | hayır | Çevrim dışı anahtarlı imzalama için elde tutulan bir ECDSA P-256 özel anahtar PEM dosyasının yolu. Bir dosyanın yoludur, hiçbir zaman satır içi anahtar malzemesi değildir. Ayarlanmadığında anahtarsız yol kullanılır. HTTP üzerinden erişilen bir aggrega mcp sunucusu, nerede ayarlanmış olursa olsun — üst düzey signing bloğunda, bir kayıt defteri girdisinin bloğunda ya da AGGREGA_SIGNING_KEY_PATH ile — bu anahtara hiçbir zaman başvurmaz: böyle bir dinleyicinin yanıtladığı bir çağrı yalnızca çağrının kendisinin taşıdığı bir kimlik belirteciyle imzalar ya da reddedilir. Standart girdi ve çıktı üzerinden erişilen bir sunucu, bir terminalin yaptığı gibi bu anahtarla imzalar. |
required | boolean | hayır | Bu bloğun kapsamı için tek güven duruşu: true olduğunda, kapsamdaki bir yapıt türünü yayımlamak bir imza gerektirir (kapsamdaki imzasız bir push reddedilir) ve onu tüketmek bir imza gerektirir (kapsamdaki imzasız bir pull reddedilir). Kapsam yerleşimden okunur — üst düzey signing bloğunda her kayıt defterini kapsar; bir registries[] girdisinin signing bloğunun altında o tek ana makineyi kapsar. Tek ad, tek görev, iki kapsam. Üst düzey ilke, yapılandırma kademesi boyunca monoton olarak birleşir — onu true yapan herhangi bir katman onu etkin olarak true yapar ve daha düşük öncelikli hiçbir katman onu yeniden kapatamaz — bu nedenle sıradan bir yapılandırma düzenlemesiyle kaldırılamaz. Varsayılan olarak false’tur. Varsayılan: false |
kinds | string[] | hayır | required’ı belirli yapıt türleriyle sınırlar. Boş ya da tek bir all girdisi, imzalanabilir her tür anlamına gelir; aksi halde duruş, varlığın kind: değeriyle eşleşerek tam olarak listelenen türlere uygulanır (ör. Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). Üst düzey signing bloğunda kademe boyunca bir birleşim olarak birleşir — bir katman kapsamı genişletebilir ama hiçbir zaman daraltamaz. Kapsam, required ile aynı şekilde yerleşimden okunur. Varsayılan: [] |
Ek özelliklere izin verilmez.
TrustedIdentity
Kabul edilebilir tek bir anahtarsız imzalama kimliği: ona kefil olan OIDC yayıncısıyla eşleştirilmiş bir sertifika öznesi (OIDC kimliği).
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
identity | string | hayır | Tam sertifika özne alternatif adı — kısa ömürlü imzalama sertifikasına bağlanan OIDC kimliği (ör. bir bakımcı e-postası ya da bir CI iş akışı URI’si). |
identity_regexp | string | hayır | Sertifika öznesiyle eşleştirilen, tam bir identity yerine kullanılan düzenli ifade (ör. bir kuruluş altındaki herhangi bir iş akışını kabul etmek için). |
issuer | string | evet | Kimlik belirtecini veren OIDC yayıncısının URL’si (ör. https://accounts.google.com ya da https://token.actions.githubusercontent.com). |
Ek özelliklere izin verilmez.
PluginRef
Giriş işlevini eklemenin adlandırabildiği bir sokete eklenen bir Wasm eklentisine başvuru: governance ve linter listeleri. Giriş noktası sabit olan soketler bunun yerine, aynı alanları function olmadan taşıyan FixedEntryPluginRef’i kullanır. uri ve capability birlikte eklentiyi seçer: yalnızca uri doğrudan eklemedir (o kimlikteki eklenti olduğu gibi eklenir; kesişen soketlerin yolu budur, çünkü eklentileri sunulan yetenek bildirmez); yalnızca capability, o yeteneği sunan eklentiyi çözümler (bir Recipe’nin spec.capability üzerinden bağladığı yalın yetenek adı, ör. helm); ikisi birlikte belirsizliği giderir: capability neyin çözümleneceğini adlandırır, uri ise birden fazla eklentinin yeteneği sunduğu federe bir katalogda, hangi yayıncının eklentisinin onu sunacağını o eklentinin yalın kimliğiyle seçer. function, soketin varsayılan giriş işlevini geçersiz kılar; belirtilmediğinde soketin belgelenmiş varsayılanı uygulanır; bir governance girdisinde bu varsayılan role’den çıkar. role, governance ekleme rolünü adlandırır ve yalnızca bir governance girdisinde okunur. with, eklentinin okuduğu isteğe bağlı ekleme zamanı girdilerini taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | hayır | Eklenti tanımlayıcısı: bir Plugin varlığının yalın kimliği (<pluginType>/<name> yolu, ör. governance/redact veya provider/helm), yerel bir dosya sistemi yolu ya da bir kayıt defteri takma adı. İsteğe bağlıdır: bir girdi eklentiyi bunun yerine capability ile seçebilir. İsteğe bağlı sondaki :version, sürümü her sürüm sabitlemesiyle aynı üç biçimde sabitler (yalın, tam :1.0.0 veya ana sürümle uyumlu aralık :^1.0.0). |
role | string (enum) | hayır | Bir governance eklemesinin bağlı olduğu ardışık düzen rolü; yalnızca bir governance girdisinde okunur: annotation-transform, ek açıklama genişletmesinden önce çözümlenmiş bileşenlere ek açıklamalar enjekte eder, böylece bağlı enjeksiyonlar Feature eklemelerine dönüşür; label-transform, topoloji oluşturma sırasında topoloji grafiği düğüm etiketlerini otomatik olarak etiketler; ir-verdict, statik analiz sırasında IR grafiği üzerinde kabul/ret kararı verir; render-verdict, işleme sırasında işlenmiş yapıtlar üzerinde karar verir. Eklentinin ne üretebileceğini eklentinin bildirdiği tür değil, rol belirler: bir karar rolünün çıktısı yalnızca karar olarak okunabilir, asla değişiklik olarak uygulanmaz; bir dönüştürme rolünün çıktısı ana makine tarafından kendi yönüyle (ek açıklamalar veya etiketler) sınırlandırılır. Rol ayrıca varsayılan giriş işlevini de seçer (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). İzin verilen değerler: "annotation-transform", "label-transform", "ir-verdict", "render-verdict" |
capability | string | hayır | Bu girdinin eklenti seçtiği sağlayıcı yeteneği: bir Recipe’nin spec.capability üzerinden bağladığı yalın yetenek adı (ör. helm, compose). İsteğe bağlıdır: bir girdi bunun yerine bir eklentiyi doğrudan uri ile ekleyebilir. Sağlayıcı bağlamaları bunu, federe bir katalogda bir yeteneği hangi yayıncının eklentisinin sunacağını seçmek için kullanır; kesişen soketler bunu boş bırakır ve uri ile ekler. |
function | string | hayır | Soketin varsayılan giriş işlevi için isteğe bağlı geçersiz kılma. Belirtilmediğinde soketin belgelenmiş varsayılanı uygulanır (governance annotation-transform → transform_annotations, governance label-transform → mutate, governance ir-verdict → verdict_ir, governance render-verdict → verdict_render, linter → lint_rules). Geçersiz kılma, eklentinin bildirdiği herhangi bir dışa aktarımı adlandırabilir ve adlandırdığı dışa aktarım, o soketin okuduğu çıktı biçimini döndürmelidir: bu çıktı, biçimin bildirmediği bir üst düzey alan taşıdığında derleme, çağrılan dışa aktarımı ve beklenmeyen alanı adlandırarak durur. Denetim hangi üst düzey alan adlarının bulunduğunu okur; hangilerinin eksik olduğunu veya altlarında neyin iç içe yer aldığını okumaz, dolayısıyla çıktının tam bir doğrulaması değildir. |
with | PluginRefWith | hayır | Eklentinin okuduğu isteğe bağlı ekleme zamanı girdileri. Her iki üye de isteğe bağlıdır ve soketten bağımsızdır, dolayısıyla herhangi bir soket bu yüzeyi yeniden kullanabilir. |
Ek özelliklere izin verilmez.
FixedEntryPluginRef
Giriş noktası eklemenin adlandırması yerine sabit olan bir sokete eklenen bir Wasm eklentisine başvuru: importer listesi ve providers bağlamaları. PluginRef ile aynı alanları function olmadan taşır: importer soketi, soket sözleşmesinin adlandırdığı tek giriş işlevini çağırır, bir sağlayıcı ise seçilebilir tek bir giriş yerine aşamaya göre anahtarlanmış sabit bir dışa aktarım kümesini çalıştırır; bu nedenle iki listede de function’ın adlandıracağı bir giriş yoktur ve anahtar orada kabul edilmez. uri ve capability birlikte eklentiyi seçer: yalnızca uri doğrudan eklemedir (o kimlikteki eklenti olduğu gibi eklenir; importer soketinin yolu budur, çünkü eklentileri sunulan yetenek bildirmez); yalnızca capability, o yeteneği sunan eklentiyi çözümler (bir Recipe’nin spec.capability üzerinden bağladığı yalın yetenek adı, ör. helm); ikisi birlikte belirsizliği giderir: capability neyin çözümleneceğini adlandırır, uri ise birden fazla eklentinin yeteneği sunduğu federe bir katalogda, hangi yayıncının eklentisinin onu sunacağını o eklentinin yalın kimliğiyle seçer. role burada kabul edilir ancak bu biçimin hizmet ettiği listelerin hiçbirinde okunmaz: adlandırdığı governance ekleme rolü, PluginRef kullanan bir governance girdisinde okunur; dolayısıyla bu girdilerden birinde ayarlanan rolün etkisi yoktur. with, eklentinin okuduğu isteğe bağlı ekleme zamanı girdilerini taşır; bir sağlayıcı bağlaması işleme yapılandırmasını bunun yerine Recipe’den alır, bu nedenle bir sağlayıcı bağlamasındaki with: yükleme sırasında reddedilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | hayır | Eklenti tanımlayıcısı: bir Plugin varlığının yalın kimliği (<pluginType>/<name> yolu, ör. governance/redact veya provider/helm), yerel bir dosya sistemi yolu ya da bir kayıt defteri takma adı. İsteğe bağlıdır: bir girdi eklentiyi bunun yerine capability ile seçebilir. İsteğe bağlı sondaki :version, sürümü her sürüm sabitlemesiyle aynı üç biçimde sabitler (yalın, tam :1.0.0 veya ana sürümle uyumlu aralık :^1.0.0). |
role | string (enum) | hayır | Governance ekleme rolü. Bu biçimi kullanan listelerin hiçbiri onu okumaz (rol bir governance girdisinde okunur ve bu girdiler PluginRef kullanır); dolayısıyla burada ayarlanan bir rol kabul edilir ve etkisi yoktur. İzin verilen değerler dört governance rolüdür ve her birinin anlamı PluginRef üzerinde açıklanmıştır. İzin verilen değerler: "annotation-transform", "label-transform", "ir-verdict", "render-verdict" |
capability | string | hayır | Bu girdinin eklenti seçtiği sağlayıcı yeteneği: bir Recipe’nin spec.capability üzerinden bağladığı yalın yetenek adı (ör. helm, compose). İsteğe bağlıdır: bir girdi bunun yerine bir eklentiyi doğrudan uri ile ekleyebilir. Sağlayıcı bağlamaları bunu, federe bir katalogda bir yeteneği hangi yayıncının eklentisinin sunacağını seçmek için kullanır; kesişen soketler bunu boş bırakır ve uri ile ekler. |
with | PluginRefWith | hayır | Eklentinin okuduğu isteğe bağlı ekleme zamanı girdileri. Her iki üye de isteğe bağlıdır ve soketten bağımsızdır, dolayısıyla herhangi bir soket bu yüzeyi yeniden kullanabilir. |
Ek özelliklere izin verilmez.
CLIPluginRef
Üst düzey bir aggrega komutu olarak kurulan, sabitlenmiş bir CLI uzantısı eklentisi: komutun çözümlediği ve çalıştırdığı, çözümlenmiş ve sürümü sabitlenmiş yapıt başvurusu ile bu başvurunun kurulum anında çözümlendiği konuk baytlarının içerik özeti. Bu ikisi birlikte komutun tam olarak hangi baytları yürüttüğünü sabitler; özet ayrıca, konuğu yüklemeden komutun adlarını ve yardımını sağlayan describe önbelleğinin anahtarıdır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | evet | Komutun çözümlediği ve çalıştırdığı, çözümlenmiş ve sürümü sabitlenmiş yapıt başvurusu; örneğin kurulumda sabitlenen oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0. |
digest | string | evet | Başvurunun kurulumda çözümlendiği konuk .wasm baytlarının içerik özeti; sha256: ve ardından baytların SHA-256 değerinin 64 küçük harfli onaltılık basamağı olarak yazılır. Bu, aggrega plugin add cli komutunun kaydettiği yazımdır ve çözümlenen baytlar da bu yazımla karşılaştırılır. Başka herhangi bir yazımdaki özet (sha256: öneki olmayan yalın onaltılık değer, büyük harfler veya farklı bir uzunluk) buna hiçbir zaman eşit olamayacağından, yapılandırma dosyası yüklenirken dosya ve girdi adı belirtilerek reddedilir. Komutun çalıştırdığı baytları tam olarak sabitler (baytlarının özeti farklı çıkan sonraki bir çözümleme komutu durdurur) ve konuğu yüklemeden komutun yardımını oluşturan describe önbelleğinin anahtarıdır. Desen: ^sha256:[0-9a-f]{64}$. |
Ek özelliklere izin verilmez.
PluginRefWith
Bir eklentinin okuduğu, isteğe bağlı ekleme anı girdileri. Her iki üye de isteğe bağlıdır ve bu yüzey geneldir; bu nedenle her soket onu yeniden kullanabilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
sources | string[] | hayır | Ana makinenin derleme zamanında okuyup eklentiye ilettiği tanım dosyası yolları. Her girdi, bildirimi yapan yapılandırma dosyasının dizinine göre çözümlenen bir dosya sistemi yoludur. |
settings | object | hayır | Eklentiye olduğu gibi iletilen serbest biçimli ayarlar nesnesi. Ana makine bunun yapısını yorumlamaz; okuduğu anahtarları eklenti tanımlar. |
Ek özelliklere izin verilmez.