aggrega validate
aggrega validate doğruluğu denetler: şema, sütun yapısı, belgeler arası başvuru çözümlemesi, extends zincirleri, sağlayıcının girdi türü yeteneği ve (işleme yapan bir varlık için) varlığın gerçekten işlenebildiği. Argümanına göre seçilen üç kipi vardır ve bu kipler aynı doğruluk disiplinini üç kapsamda uygular: tüm katalog (argümansız), tek bir Release’in bağımlılık kapanışı (--release) ve tek bir varlık dosyası (bir varlık yolu). Her kapsam, kataloğun farklı bir dilimi üzerinde aynı soruyu yanıtlar: “bu içerik doğru mu?”
Doğruluk, uzlaşımlardan ayrı bir şeydir. aggrega validate, içeriğin iyi biçimlendirilmiş olup olmadığını ve derlenip derlenmeyeceğini sorar; aggrega lint ise içeriğin kataloğun yayımlama disiplinine (adlandırma, kategori-dizin uyumu, sürüm artışı büyüklüğü ve diğerleri) uyup uymadığını sorar. İki komut birbirinin üç kapsamını yansıtır; böylece iki boyuttan herhangi birini ihtiyaç duyduğunuz ayrıntı düzeyinde denetleyebilirsiniz.
aggrega validate diske hiçbir şey yazmaz ve hiçbir çalışma zamanı durumunu okumaz. Bir derlemenin çalıştırdığı çözümleme ve doğrulamanın aynısını çalıştırır; işlemeden önce durur (tek bir varlık için ise işlemeyi yalıtır).
Bir varlık yolu konumsal olarak verilebilir. Bir varlık yolunun yanında verilen --release, Release kapsamını seçmez: varlık yine tek başına, o Release’in koşullarında denetlenir; bkz. Bir varlığı bir Release’in koşullarında denetleme.
Tüm kataloğun doğruluğu (argümansız)
Argümansız çalıştırılan aggrega validate, yapılandırılmış katalog dizinleri altındaki her katalog varlığını yükler ve uçtan uca denetler. Herhangi bir şey yüklemeden önce bu dizinlerin altındaki her YAML dosyasını okur ve aralarında yükleyemediği bir Aggrega belgesi varsa, aşağıda açıklandığı gibi çalıştırmayı durdurur. Ardından:
- Şema sütunu yapısı — her Component’in ve Feature’ın
spec.schema:bloğu genişletilir ve doğrulanır (derlemenin uyguladığı şema sütunu denetiminin aynısı); buna kompakt biçim genişletmesi de dahildir. - Belgeler arası başvuru çözümlemesi — SchemaLibrary girdilerine yönelik
$refve$importbaşvuruları çözümlenir; çözümlenemeyen ya da başka bir nedenle geçersiz olan bir SchemaLibrary reddedilir. extendszincirleri —extendsbildiren her varlık üst öğesine göre çözümlenir ve birleştirilmiş üst+alt biçimi denetlenir. Katalog dizinlerinin içermediği bir üst öğe, bir build’in onu okuduğu yerden okunur: bir Release’in lockfile’ının onun için kaydettiği sabitlemeye göre yapıt önbelleğinden — geçişin çalıştırıldığı Releases’in lockfile’larından ya da çalışma alanı tek bir geçişte doğrulandığında çalışma alanının içerdiği her Release’in lockfile’ından. Böylece bir registry’ye yayımlanmış bir taban,aggrega pullonu getirip sabitledikten sonra doğrulanır; ikisinin de içermediği bir üst öğe iseaggrega pull --release <release>komutunu adlandırarak çalıştırmayı durdurur. Hiçbir şey getirilmez.- Bildirilen seçiciler — bir Component veya Feature belgesinin
spec.usesSchemaaltında bir bağımlılık soketinde ya daspec.featuresSchemaaltında bir ekleme slotunda bildirdiği her etiket seçicisi — bir Component’te bir soketin bildirdiği slotlar dahil — soketi bir şey bağlasa da bağlamasa da, slotu bir şey doldursa da doldurmasa da seçici dilbilgisine göre okunur. Bkz. bildirilen seçiciler. - OCI konumu çakışmaları — aynı kayıt defteri konumuna yayımlanacak iki ayrı katalog kimliği açıkça reddedilir; böylece bir derleme, bir varlığın yayımlanmış baytlarının üzerine hiçbir zaman sessizce başka bir varlığınkileri yazmaz.
- Provider girdi türü yeteneği — sentez yapamayan bir provider’a bağlı bir
workload:bloğu bildiren bir Recipe ya da FeatureRecipe, hiçbir zaman derlenemeyeceği için hata olarak işaretlenir.
Bu, derlemenin Release başına yaptığı doğrulamanın katalog genelindeki karşılığıdır; bozuk bir katalog varlığının, herhangi bir Release ona ulaşmadan önce ortaya çıkması gereken yerdir. Yükleyemediği bir Aggrega belgesinde ve herhangi bir şema sütunu ihlalinde, çözümlenemeyen ya da geçersiz bir kütüphanede, extends çözümleme hatasında, dilbilgisinin reddettiği bildirilmiş bir seçicide, konum çakışmasında veya girdi türü yeteneği hatasında açıkça durur. Şema sütunu örtüşmesi ve genişletmede daraltma bulguları ile bir Component’in veya Feature’ın şema içeriğine satır içi yazdığı her x-aggrega-* anahtar sözcüğü, çıkış kodunu hiçbir zaman değiştirmeyen, bilgi amaçlı notice: satırlarıdır.
Yüklenemeyen bir Aggrega belgesi çalıştırmayı durdurur. Bir katalog dizini altındaki YAML dosyası, satırlarından biri girintisiz olarak apiVersion: ve aggrega.ai/ ile başlayan bir değerle başlıyorsa, değer tırnak içinde olsun ya da olmasın, bir Aggrega belgesidir. Okunamayan, YAML’ı ayrıştırılamayan ya da kind veya metadata alanı bir varlık zarfının biçiminde olmayan — örneğin liste olarak yazılmış bir metadata — böyle bir dosya, dizinler okunduktan sonra çalıştırmayı E0175 ile durdurur ve bu türden her dosyayı, okumanın ya da ayrıştırıcının verdiği nedenle birlikte adlandırır; hiçbir şey denetlenmez ve catalog validation passed satırı yazdırılmaz. Yüklenen ancak hiçbir kataloğun tutmadığı bir kind bildiren bir belge — örneğin yanlış yazılmış bir Componnent ya da hiç kind olmaması — aynı çalıştırmayı E0371 ile durdurur ve bildirdiği türle birlikte bunların yanında adlandırılır; bir Manifest, bir Release ve bir Recipe’nin kendi dizininden içe aktardığı bir Workload atlanır. Diğer her YAML — işlenene kadar ayrıştırılamayan bir Helm chart’ının şablonları, chart değerleri, iş akışı tanımları — atlanır.
Hangi dizinlerin okunacağı çalışma alanının yapısına bağlıdır:
-
Yapılandırması kendine ait Release katalog dizinleri vermeyen bir çalışma alanı, arama yığını üzerinden bir kez doğrulanır: önce
--catalogdizinleri, ardındanworkspace.catalog_dirs, ardından varsa çalışma alanı kökündekicatalogdizini. -
workspace.releasesaltında Releases adlandıran bir çalışma alanı, bir kataloğun birkaç varyantını yan yana tutabilir; her birini kendi Release’i okur ve hepsini birden yüklemek her varyantı tek bir kataloğa koyar, bir varyantın varlığı diğerininkini gölgeler. Bu nedenle çalışma alanı, barındırdığı her Release için bir kez, o Release’in okuduğu dizinler üzerinden doğrulanır; her geçişte--catalogdizinleri önce gelir. Yapılandırmanın adlandırmadığı bir Release, çalışma alanının listesini okur. Her geçiş, Release’ini ve okuduğu dizinleri adlandıran bir satırın altında raporlanır ve ardından o geçişin sonucu gelir:Release release-compose.yaml reads catalog-composecatalog validation passed (schema-pillar + library + extends + oci-location)Release release-helm-synth.yaml reads catalog-helm-synthcatalog validation passed (schema-pillar + library + extends + oci-location)Tam olarak aynı dizinleri okuyan Releases tek bir geçişi paylaşır ve bu geçiş her birini adlandırır. Hiçbir dizin okumayan bir Release — girdisi
catalog_dirs: []yazar — denetlenecek bir şeyi olmadığı şeklinde raporlanır ve diğer geçişler her zamanki gibi çalışır. Önceki bir geçiş ne bulmuş olursa olsun her geçiş raporlanır, çünkü bir varyanttaki bozuk bir varlık başka bir varyant hakkında hiçbir şey söylemez; herhangi bir geçiş başarısız olduğunda komut başarısız olur ve dizinleri başarısız olan Releases’i adlandırır. Bir çalışma alanının barındırdığı Releases, onun Release belgeleridir:kinddeğeriReleaseolan, çalışma alanı kökü altında gizli dizinler ilenode_modules,vendorvedistdışında herhangi bir yerdeki YAML dosyaları.
Hiçbir geçişte okunacak bir şey olmayan bir çalıştırma, temiz bir katalog olarak raporlanmak yerine reddedilir: varlıkları catalog/ altına koyun, --catalog verin ya da workspace.catalog_dirs ayarlayın — veya Releases adlandıran bir çalışma alanında, workspace.releases altında bir Release’in kendi catalog_dirs değerini ayarlayın. Geçerli çalışma dizinini hiçbir zaman örtük olarak taramaz, dolayısıyla ilgisiz ağaçları hiçbir zaman içeri çekmez.
aggrega mcp aracının validate aracı, tüm katalog istendiğinde aynı geçişleri doğrular; Releases adlandıran bir çalışma alanında yanıtı, hepsi üzerindeki kararın yanında her geçişi passes altında taşır: Releases, okunan dizinler ve o geçişin kendi kararı.
Yalnızca yapıt önbelleğinin tuttuğu bir kütüphane
Yapıt önbelleği bir getirmenin oraya koyduğunu tutar ve önbellekteki bir SchemaLibrary, yalnızca bir Release’in lockfile’ındaki bir girdi onun özetine kefil olduğunda katalog içeriği sayılır — bkz. Önbellek nedir, ne değildir. Önbellek, hiçbir lockfile girdisinin sabitlemediği ve denetimin okuduğu hiçbir katalog dizininin sağlamadığı bir kütüphane tutarken bir $ref: hiçbir şeye çözümlenmediğinde, rapordan sonra bu tür her kütüphaneyi ve başarısız olan kapsam için işe yarayan eylemi adlandıran bir remediation: satırı gelir:
- Argüman olmadan ve
--releaseverilsin ya da verilmesin bir varlık yoluyla, validate kütüphaneleri yalnızca katalog dizinlerinden okur, hiçbir zaman bir lockfile girdisi üzerinden okumaz; bu nedenle kaydedilmiş bir girdi kararını değiştirmez. Satır bunu söyler ve kütüphaneyi bir katalog dizini altında yazmaya ya daaggrega pull --release <release>ve ardındanaggrega validate --release <release>komutlarına yönlendirir; ikincisi Release’i lockfile’ının sabitlediği kütüphanelere karşı denetler. - Yalnızca
--releaseile, validate Release’in lockfile’ını okur; bu nedenle satır, kütüphaneyi çözümleyip girdisini kaydedenaggrega pull --release <release>komutunu ya da kütüphaneyi bir katalog dizini altında yazmayı adlandırır.
Bu satır ne kararı ne de çıkış kodunu değiştirir.
Bildirilen seçiciler
Bir Component veya Feature, bağımlılık soketlerine nelerin bağlanabileceğini ve ekleme slotlarını nelerin doldurabileceğini etiket seçicileriyle kısıtlar — her spec.usesSchema girdisinin ve her spec.featuresSchema girdisinin selector: alanı ve bir Component’te bir soketin kendi featuresSchema alanı altında bildirdiği her slotun selector: alanı. Bir build bir seçiciyi yalnızca bir şeyin ona ulaştığı yerde okur: soket üzerinden çizilen bir kenar, slotu dolduran bir ekleme. Bu nedenle tüm katalog kapsamı ve tek varlık kapsamı, soketi bir şey bağlasa da bağlamasa da, slotu bir şey doldursa da doldurmasa da bir Component veya Feature belgesinin bildirdiği her seçiciyi okur ve dilbilgisinin reddettiği bir seçici — kapanış parantezi eksik bir değer listesi, çift virgül, = veya ! içeren bir anahtar — denetimi başarısız kılar. Dilbilgisi, dize dilbilgisi bölümünde öğretilen dilbilgisidir.
Ret, bir build’in aynı seçiciye ulaştığında aynı kod altında ve aynı sözcüklerle raporladığı rettir: bir soketin seçicisi için E0007 ve bir slotun seçicisi için E0008; seçiciyi, onu bildiren soketi ya da slotu ve dilbilgisinin onu neden okuyamadığını belirtir. Varlığın dosyasında bir katalog hatası olarak kaydedilir:
selector violation (
"<selector>", declared on socket"<socket>", which could not be evaluated:"<why it could not be read>"). Correct the selector on the socket’s declaration in the component type’s usesSchema. (seçici ihlali: sokette bildirilen seçici değerlendirilemedi. Seçiciyi bileşen türünün usesSchema’sındaki soket bildiriminde düzeltin.)
Her belge yazarının yazdığı biçimde okunur; bu nedenle bir temel varlığın bildirdiği seçici, onu genişleten her varlık için bir kez değil, temelin kendi dosyasına karşı bir kez raporlanır. Bir Feature’ın appliesTo ve appliesToAnyOf alanları burada okunmaz: bunlar Feature’ın bir eklemesinin değerlendirildiği her yerde okunur.
Tüm katalog kapsamı reddedilen her seçiciyi kendi selector: satırında raporlar ve bunların sayısıyla başarısız olur; tek varlık kapsamı ise bunları biçim katmanının başarısızlığı olarak raporlar — varlık yolunun yanında --release olsun ya da olmasın, çünkü bu biçim bir Release’in koşullarında çalıştırılan tek varlık kapsamıdır (bkz. bir varlığı bir Release’in koşullarında denetleme). Bir Release’in bağımlılık kapanışını doğrulayan tek başına --release ve bir build, bir seçiciyi yalnızca bir kenarın ya da bir doldurmanın ona ulaştığı yerde okur ve orada onda durur.
Release kapsamlı doğruluk (--release)
aggrega validate --release <release-path>, tüm kataloğu ya da tek bir varlığı değil, tam olarak tek bir Release’in çözümlenmiş bağımlılıklarının ulaştığı varlıkları doğrular. Kapanışı bir derlemenin kullandığı aynı mekanizma ile hesaplar; böylece denetlediği varlıklar, o Release’in bir derlemesinin çözümleyeceği varlıkların tam olarak aynısıdır ve bu kapanış üzerinde:
- kapanış kapsamlı
extendszincirlerini çözümler ve bir çözümleme hatasında başarısız olur; - çözümlenen her varlığın şema sütunlarını (kapanış kapsamlı) doğrular ve bir şema sütunu hatasında başarısız olur;
- bir derlemenin çalıştırdığı aynı render öncesi değer uygunluk denetimini çalıştırır: Release’in parametrelerini yazılmış değerlere çözümler (böylece bir
{{ .parameters.* }}değeri şablon olarak değil, çözümlenmiş hâliyle denetlenir) ve sonucu,extendskullanan bir varlık için birleştirilmiş üst+alt şemaya uygunluk da dahil olmak üzere, kapanışın birleştirilmiş şemalarına karşı doğrular. Şemasını ihlal eden bir değer sıfır olmayan bir çıkış koduyla başarısız olur; - her Recipe ve FeatureRecipe onaylamasını, Release’in çözümlendiği değerlere karşı, bir derlemenin işlemeden önce değerlendirdiği gibi değerlendirir: her bileşenin Recipe’si Manifest’in eşlediği şekilde bağlanır,
localsveprovidesdeğerleri çözümlenir ve başarısız olan ilk onaylama —failçağıran ya da şablonu bulamadığı bir anahtarda duran onaylama — doğrulamayı, bir derlemenin durduğu koşul ve cümleyle başarısız kılar. Değerlendirilemeyen birlocalsveyaprovidesşablonu da, bir derlemeyi başarısız kıldığı gibi doğrulamayı başarısız kılar. Her Recipe’nin üzerinden işlendiği sağlayıcıya, bir derlemenin sorduğu gibi, o bileşenin kaynaklarına verdiği ad sorulur, çünkü bir Recipe’ninprovidesdeğeri bu adı okuyabilir; hiçbir şey işlenmez. Bu onaylamalar yalnızca yukarıdakilerden hiçbiri henüz başarısız olmadığında değerlendirilir; böylece bir Release, bir derlemenin duracağı en erken hatayı bildirir; - şema sütunu çakışması ve extend sırasında daraltma bulgularını, çıkış kodunu asla değiştirmeyen bilgilendirici
notice:satırları olarak gösterir; - okuduğu bir varlığın şema içeriğine satır içi yazdığı her
x-aggrega-*anahtar sözcüğünü, bir derlemenin gösterdiği gibi, varlık başına bir kez birwarning:satırı olarak gösterir — bu da çıkış kodunu asla değiştirmez.
Bu, --release’i gerçek bir derleme öncesi denetim yapar: bir derlemenin reddedeceğini derlemeden önce yakalar; render olmadan derlemenin bağımlılık doğrulamasıdır. Hiçbir render çalıştırmaz ve hiçbir ağ çekmesi tetiklemez: kapanış yerel katalogdan (ve varsa Release’in lockfile sabitlemelerinden) çözümlenir; lockfile gerektiren, kayıt defterine sabitlenmiş bir bağımlılık kümesi, indirme yapmak yerine açıkça bir çözümlenemeyen başvuru hatası gösterir. Daraltma tavsiye olarak gösterilir, asla zorunlu kılınmaz.
Release’in çözümlendiği şeyle artık eşleşmeyen bir lockfile, doğrulamayı aggrega build komutunun yazdırdığı durmayla reddeder. Release’in yanında bir lockfile bulunduğunda --release, Release’in bağımlılıkları çözümlenir çözümlenmez ve yukarıdaki denetimlerden herhangi biri çalışmadan önce, bir build’in render etmeden önce çalıştırdığı sapma karşılaştırmasıyla onu Release’in çözümlendiği şeye göre sınar. Sabitlenmiş bir varlığın, kütüphanenin, eklentinin ya da Release dosyasının kendisinin saptığı bir lockfile, doğrulamayı build’in E0130 reddiyle — sapan her girdi, ardından onu gideren aggrega pull --release <release> — ve sıfırdan farklı bir çıkış koduyla durdurur; böylece bir doğrulama, build’in sapmış olarak reddettiği bir lockfile’ı asla geçerli saymaz. Argümansız ve bir varlık yoluyla çalıştırıldığında validate bir lockfile’a tabi tutulmaz: tüm katalog denetimi lockfile sabitlemelerini yalnızca bir extends üst öğesini bulmak için okur ve tek bir varlığın denetimi hiçbir lockfile okumaz.
Bir derlemenin çalıştırdığı aynı denetimleri çalıştırdığı için, aynı bağlı kapı plugin’lerini de çalıştırır; dolayısıyla bir derlemenin tabi olduğu aynı güvenilir plugin kimlikleri kaydına tabidir. Kabul ya da ret kararı döndüren bir plugin bağlayan bir çalışma alanının, Release’inin yanında bir plugin güven kaydı bulunur ve --release, bu plugin’lerden herhangi biri çalışmadan önce yapılandırmayı bu kayıtla karşılaştırır: yapılandırmanın artık bağlamadığı kayıtlı bir kapı doğrulamayı durdurur ve aggrega pull’un doldurduğu önbellekten çözümlenen, yapıtı kayıtlı olan olmayan bir plugin çalıştırılmak yerine reddedilir. Hiçbir şey kaydetmemiş bir çalışma alanının kaydı yoktur; bu, söz konusu karşılaştırma için hiçbir şeyi değiştirmez. --release ayrıca Release’in bağlı olduğu şeylere karşı kaydedilmiş her geri çekmeyi standart hata akışında bir deprecation: satırı olarak, aggrega build komutunun yazdırdığı sözcüklerle adlandırır: lockfile’ın sabitlenmiş bir başvuruya karşı kaydettiği işaret de, güven kaydının bir karar rolünde bağlanmış bir plugin’e karşı kaydettiği işaret de. Bir geri çekme ne kararı ne de çıkış kodunu değiştirir; mevcut olup okunamayan bir güven kaydı ise hiçbir şey kaydetmeyen bir kayıt sayılmak yerine doğrulamayı durdurur.
Önbellekten okunan bir plugin, yüklendiği anda, bir derlemenin yaptığı gibi, girdisinin kaydettiği imzaya da tabi tutulur. Girdisi doğrulanmış bir imza kaydediyorsa, bu bilginin önbellekte işaret ettiği imza malzemesi yeniden denetlenir ve malzemesi eksik ya da farklı olan bir plugin reddedilir; malzemesi okunandan farklı bir plugin için oluşturulmuş olan da reddedilir; başka bir girdiden kopyalanmış bir signature tam olarak böyle görünür, imzalama gereksinimi ne derse desin. Çalışma alanının güven yapılandırması imza gerektiriyorsa, önbellekten okunan ve girdisi hiç imza kaydetmeyen ya da kayıtta hiç girdisi bulunmayan (silinmiş bir kayıt dahil) bir plugin de, aggrega pull’un onu imzasız olduğu için reddetmesine yol açacak aynı ayarlar altında reddedilir; dolayısıyla skip_signature_verification ve advisory bir kayıt defteri onun çalışmasına izin verir. Bir ret doğrulamayı başarısız kılar ve tanılamaları arasında, plugin’i ve imzasını kayıt defterinde doğrulayan, kaydeden, işaret ettiği paketi önbelleğe alan ve artık özetiyle eşleşmeyen önbellekteki kopyayı yeniden yazan komut olan aggrega pull --release <release>’i adlandırarak raporlanır; katalog dizinlerinizden birinden ya da derleyici ikili dosyasının içindeki kopyadan sunulan bir plugin bu gereksinime asla tabi tutulmaz. Diğer iki kapsam bunların hiçbirine tabi değildir: çalışma alanının plugin bağlantılarını okumazlar, bu nedenle bunlarda böyle bir plugin çalışmaz.
Aynısı, grafiği yargılamak yerine değiştiren plugin’ler için de geçerlidir. Bir label-transform ya da annotation-transform bağlantısı render edilmiş çıktının ne olacağını biçimlendirir; bu yüzden lockfile hem kimliğini hem de okuduğu kaynak dosyaları sabitler ve --release bu bağlantıları bir derlemenin çalıştırdığı şekilde çalıştırır: lockfile’dan yeniden oluşturarak, her birini kayıtlı özetine tabi tutarak ve diskteki dosya yerine lockfile’ın taşıdığı kaynak içeriği okuyarak. Karşılaşmadan önce bilinmeye değer iki sonuç vardır:
.aggrega-config.yamliçinde bir dönüşüm plugin’i bağlamak, siz pull yapana kadar--release’in yaptığını değiştirmez. Bu, bir derlemenin izlediği aynı kuraldır ve aynı nedenle: bağlantı kümesi baytları belirleyen bir girdidir, bu nedenle düzenlendiği anda değil, pull sırasında benimsenir.- Baytları lockfile’ın kaydettiği özetle artık eşleşmeyen önbellekteki bir plugin reddedilir, tıpkı bir derleme sırasında olacağı gibi.
Release’in lockfile’ı yoksa --release yine de doğrular: reddetmek yerine bir plugin’in kimliğini denetleyemediği konusunda uyarır ve ne çalıştırılacağını belirtir. Bkz. uyarılar.
Derlenmiş grafiğin geri verilmesi
--ir-graph, bu doğrulamanın çözümlediği grafiği karar satırından önce standart çıktıya JSON olarak yazar. Eklemelidir: aynı denetimler çalışır, aynı tanılamalar yazılır ve çıkış kodu onsuz olanla aynıdır. Geri verilen grafik, doğrulamanın üzerinde yapıldığı grafiktir; bu nedenle kararın raporladığından farklı bir çözümlemeyi tanımlayamaz.
Yalnızca bu kapsama uygulanır; tüm katalog ve tek varlık kapsamları bir Release yerine sentezlenmiş bir düzeneği çalıştırır ve hiçbir grafik çözümlemez; başka bir yerde istenmesi sessizce yok sayılmak yerine reddedilir. Çalıştırma grafik çözümlenmeden önce durursa, standart çıktıya hiçbir şey yazılmaz ve komutun kendi tanılamaları onu neyin durdurduğunu söyler.
Yanındaki bayrağa dikkat edin. --response-format, bu komutun kendi raporunun ne kadarının yazılacağını belirler (detailed ya da concise); --ir-graph ise bu raporun yanında ikinci bir belge ister. Biri hacimdir, diğeri konu; hiçbiri kararı değiştirmez.
Bir yazarın hassas olarak bildirdiği değerler — tüketen bileşenin soketi bir yaprağı hassas olarak bildirdiğinde bir bağlantının values ve infra değerleri de dahil — aggrega inspect altında açıklanan yapılandırılmış biçimde grafikten çıkarılır. --ir-graph yanında --unredacted ise bunları aggrega inspect --unredacted’in belirttiği koşullarla yazdırır: bu komutun yazdıklarından yalnızca grafiğe ulaşır ve çıktı nereye ulaşırsa ulaşsın bu değerleri açık olarak taşır. --ir-graph olmadan verildiğinde reddedilir, çünkü açığa çıkaracağı hiçbir şey olmaz.
Tek varlık doğruluğu (bir varlık yolu)
aggrega validate <entity-path> tek bir katalog varlık dosyasını denetler. Katmanlı bir denetim kümesi uygular ve ilk engelleyici hatada durur; böylece bir şema bozulması, herhangi bir katalog işinden önce açıkça ortaya çıkar:
- Yer tutucular (her tür) — türün gerektirdiği, dosyanın boş dize olarak bıraktığı bir değer. Hepsi diğer denetimlerden önce bir kerede, her biri ne aldığıyla birlikte raporlanır; bkz. hâlâ borçlu olunan yer tutucular.
- Şema zarfı (her tür) — katalog yükleyicisinin her ayrıştırma sınırında çalıştırdığı, varlık başına aynı JSON-Schema denetimi.
- Biçim (her tür) — türe özgü yapısal doğrulama. Bir Component veya Feature için bu, dosyanın bir bağımlılık soketinde ya da bir ekleme slotunda bildirdiği her etiket seçicisinin seçici dilbilgisine göre okunmasını içerir; bkz. bildirilen seçiciler.
- Sütun yapısı (Component ve Feature) — belgeler arası
$refgenişletmesi için kataloğun SchemaLibraries’ini kullananspec.schema:sütun denetimi.
Bir Component veya Feature burada durur: şema zarfı, biçim ve sütun yapısı. Tek başına bir Component’in yalıtılmış olarak işlenecek yazılmış values veya infra değeri yoktur, dolayısıyla işlenecek bir şey yoktur — doğruluğu şema ve sütun katmanlarınca tamamen karşılanır. Şema içeriğinin satır içi yazdığı her x-aggrega-* anahtar sözcüğü, standart hatadaki bilgi amaçlı notlar arasında, anahtar sözcüğü, bulunduğu yeri ve bunun yerine yazılacak bildirimsel tabloyu adlandıran bir warning: satırı olarak bildirilir; kararı veya çıkış kodunu asla değiştirmez.
Bir Recipe ayrıca yalıtılmış olarak işlenir. Bu, tek varlık doğruluğunun ana başlığı değil, bir yönüdür: şema ve biçim katmanları geçtikten sonra validate, Recipe’in implements Component’ini katalogdan çözümler, sınanan Recipe’e bağlı o Component’in tek bir örneği etrafında asgari bir Aggregate, Manifest ve Release sentezler ve gerçek derleme hattını bunun üzerinde çalıştırır — önce çözümleme ve korumalar (işleme atlanarak), ardından yalıtılmış çıktının gerçek bir işlenmesi. Varsayılanı olmayan her gerekli değer ve her gerekli infra alanı, bildirilen türünde bir yer tutucuyla doldurulur — değerler sentezlenen Aggregate’te, infra sentezlenen Release’te — ve diğer her değer ve infra alanı şema varsayılanını çözümleyici aracılığıyla alır; Release örneği sentezlenmiş varsayılan bir sınıra yönlendirir ve hiçbir values: ile Aggregate’in bildirmediği hiçbir hesaplama bildirmez. Yer tutucu, alanın kendi bildirilmiş kısıtlarının kabul ettiği bir değerdir: sabit ya da bir enum’un listelediği ilk değer, sınırları içinde bir sayı, kendi uzunluğunda ve format’ında bir dize, pattern’i istediğinde bir anlamsal sürüm, gerektirdiği sayıda liste öğesi ve bir nesnenin gerektirdiği her özellik. Diğer her pattern, bir validate: veya when: koşulu, şemaların bileşimi ve bir listenin hangi öğeleri tuttuğuna dair bir kısıt dikkate alınmaz; dolayısıyla bunlardan birine dayanan bir alan yer tutucusunu yine de reddedebilir; validate bu reddi şemanın kendi sözleriyle raporlar. İşlenen yapıtlar yazdırılır; böylece bir yazar, varlığı tam bir Aggregate’e bağlamadan önce yalıtılmış çıktıyı görür. Tek varlık düzeneği yalnızca bu gerekli alanları doldurduğu, hiçbir bağlantı kurmadığı ve hiçbir Feature eklemediği için, şablonları yalnızca bir bağlantının veya eklenmiş bir Feature’ın sağladığı bir değeri okuyan bir Recipe yalıtılmış olarak işlenemez; validate böyle bir işlemeyi başarısız değil, denenmedi olarak raporlar. fail çağıran bir doğrulama, denetimi başarısız kılmak yerine uyarı olarak raporlanır — bkz. başarısız bir doğrulama bir uyarıdır. Başka bir nedenle duran bir işleme tamamlanmamıştır ve validate bunu, onu durduranı adlandıran cümleye kadar alttaki işleme tanılamasıyla birlikte raporlar.
source: değeri getirilmesi gereken bir Recipe hiç işlenmez ve işlemesi, yalnızca bir bağlantının veya eklenmiş bir Feature’ın sağladığı bir değeri okurken duran bir Recipe’in işlemesi bir kenara bırakılır — aşağıda bkz. tek varlık doğruluğunun denetlemedikleri.
Bir FeatureRecipe şema ve biçim açısından denetlenir; işlemesi atlanır, çünkü bir FeatureRecipe yalnızca bir ana bileşene eklendiğinde işlenir ve rastgele bir Feature için korumaları geçen bir ana bileşen sentezlenmeye çalışılmaz.
Bir varlığın bir Release’in koşullarında denetlenmesi
Bir çalışma alanı her Release’e kendine ait katalog dizinleri verebilir — bkz. Bir Release’e kendi katalog dizinlerini vermek — ve böylece her Release için bir katalog varyantını yan yana tutabilir. Tek başına verilen bir varlık yolu, çalışma alanının kendi katalog dizinleri üzerinde denetlenir; burada bu varyantlardan birine yönelik bir başvuru — bir Recipe’in uyguladığı Component, bir sütunun başvurduğu bir SchemaLibrary — bulunamaz. Varlık yolunun yanında --release verildiğinde aynı denetimler o Release’in koşullarında çalışır: varlığın başvuruları, çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri aracılığıyla, varsa --catalog başa eklenerek çözümlenir; bunlar o Release’in bir derlemesinin okuduğu dizinlerdir.
MariaDB + Adminer örneği bu tür dört varyant tutar. Synth varyantının Component’i depolama ayarlarını yalnızca synth ve chart varyantlarının taşıdığı bir SchemaLibrary’den alır; bu nedenle onunla derlenen Release’in koşullarında doğrulanır:
$ aggrega validate catalog-helm-synth/component/mariadb.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/component/mariadb.yamlKind: ComponentSchema: validPillars: validve dizinleri onu taşımayan bir Release’in koşullarında — --release release-compose.yaml ya da kendine ait katalog dizini listelemeyen bir çalışma alanında hiç --release olmadan — çözümleyemediği kütüphaneyi adlandırarak başarısız olur.
Bir Recipe de aynı şekilde denetlenir. Synth varyantının Recipe’i, çalışma alanının kendi katalog dizinlerinin tutmadığı core/datastore/mariadb’yi uygular; bu nedenle tek başına verildiğinde render: implements target "core/datastore/mariadb" not found in catalog ile başarısız olur. Onunla derlenen Release verildiğinde o Release’in Component’ini çözümler ve yalıtılmış olarak işlenir:
$ aggrega validate catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: 3 artifact(s)ardından işlenen üç yapıt gelir. O örneğin her varyantı core/datastore/mariadb’yi bildirir; bu nedenle Recipe dört Releases’inin her birinin koşullarında doğrulanır; katalog dizinleri böyle bir Component tutmayan bir Release’in koşullarında ise --release olmadığında olduğu gibi hedefi adlandırarak başarısız olur. Attachments: satırları gerekli bir ek yuvası veya bir varlık zorunluluğu altında açıklanır.
Bu hâlâ tek varlık kapsamıdır. Denetimler, rapor ve çıkış kodu bu bölümün açıkladıklarıdır — dilbilgisinin reddettiği bir soket ya da slot seçicisi taşıyan bir Component veya Feature, --release olmadan nasıl başarısız oluyorsa burada da tam olarak öyle başarısız olur, bkz. bildirilen seçiciler — ve hiçbir kapanış doğrulanmaz: --release, denetlenecek bir kapanışı değil, varlığın başvurularının katalog dizinleri aracılığıyla okunduğu Release’i adlandırır; --ir-graph’ın bir varlık yolunun yanında reddedilmesinin nedeni budur. Var olmayan bir dosyayı ya da bir dizini adlandıran bir --release, herhangi bir şey denetlenmeden önce reddedilir.
Çalışma alanı yapılandırmasının listelediği ve dizin olmayan bir dizin — örneğin orada hiçbir şey bulunmadığında — o Release için ya da --release verilmediğinde çalışma alanı için, herhangi bir şey denetlenmeden önce reddedilir; tıpkı o kataloğu okuyan her komutun onu reddettiği gibi (Yerel varlıkların okunduğu yer): ret; girdiyi, onu listeleyen yapılandırma dosyasını ve satırı ve ayarı adlandırır ve hiçbir karar verilmez. aggrega serve aracılığıyla düzenleyicinin varlık denetimi aynı reddi, varlığın dosyasındaki tek girdi olarak hata düzeyinde verir ve aggrega mcp’nin validate aracı çağrıyı bununla reddeder.
Hâlâ doldurulması gereken yer tutucular
Türün gerektirdiği ve dosyanın boş bir dize olarak bıraktığı bir değer yer tutucudur ve validate bunu her şeyden önce bildirir. aggrega scaffold ile taslağı hazırlanan bir belge, türünün yalnızca sizin sağlayabileceğiniz bir değere ihtiyaç duyduğu her yerde bir yer tutucu taşır; bu nedenle hangilerinin kaldığını burada öğrenirsiniz. Aşağıda yalnızca sürümü doldurulmuş, taslak halindeki bir FeatureRecipe görülmektedir:
Entity: my-feature-recipe.yamlKind: FeatureRecipe2 placeholders still owed in my-feature-recipe.yaml; an empty required value is not a value, so each of these needs one before the document validates: 7:3: spec.capability takes what its schema describes: The explicit provider capability this recipe binds to (e.g., 'helm', 'terraform', 'compose') — the provider kind that renders it. 8:3: spec.implements takes what its schema describes: Declares which catalog Feature type this recipe is able to implement (including credential Features labeled feature.aggrega.ai/kind: secret; exact version, major-compatible range '^', or unversioned).Dosyadaki her yer tutucu, belge sırasıyla, satırı ve sütunuyla ve ne aldığıyla birlikte tek seferde adlandırılır. Ne aldığı türün kendi şemasından okunur: şemanın listelediği yerlerde kabul ettiği değerler, şemanın istediği yerde 1.0.0 gibi bir anlamsal sürüm, aksi halde şemanın alanı kendi açıklamasının ilk cümlesi.
Hangi değerlerin sayılacağı da şemadan okunur. Bir değer, tür onu belgenin en üst düzeyinde ya da türün yine gerektirdiği bir nesnenin içinde gerektirdiğinde ve dosya onu boş dizeye ayarladığında sayılır. Dosyanın tamamen dışarıda bıraktığı bir anahtar, şema denetimi tarafından eksik özellik olarak bildirilir. Boş bırakılmış isteğe bağlı bir alan yer tutucu değildir; yalnızca yazmayı seçtiğiniz bir liste ya da eşlem içinde gerekli olan bir alan da öyle. Şemanın kendisi boş dizeyi bir alanın kabul ettiği değerler arasında listelediğinde, boş bir değer yer tutucu değil bir değerdir.
Şema boş kabul etse bile bir değer doldurulmalıdır. Şema, bir Recipe’in ya da FeatureRecipe’in capability ve implements alanları için boş dizeye izin verir; ancak boş bir değer hiçbir sağlayıcıyı ve hiçbir türü adlandırmaz, bu nedenle validate ikisini de diğerleri gibi yer tutucu olarak bildirir. Şema denetimi aynı dosyayı da reddettiğinde (boş bir sürüm, değeri olmayan bir tür etiketi) rapor, aggrega scaffold üzerindeki örneğin gösterdiği gibi o denetimin kodunu, E0215’i taşır; şema denetimi dosyayı kabul ettiğinde, yukarıdaki gibi, rapor hiçbir kod taşımaz. Aynı dosyada boş bir değerle ilgili olmayan bir bulgu da yine, şema denetiminin kendi sözleriyle, listeden önce bildirilir.
Bu okuma, varlık yolunun yanında --release olsun ya da olmasın, tek varlık doğrulamasına aittir. Aynı belgeyle karşılaşan tüm katalog çalıştırması şema denetiminin bildirdiğini bildirir; bu nedenle bir katalog dizinindeki boş implements alanlı bir FeatureRecipe bu çalıştırmadan geçer; Release kapsamı ve aggrega build de bu okumayı uygulamaz.
Bu kapsamın almadığı bir tür
Tek varlık doğrulaması Component, Feature, Recipe, FeatureRecipe, Workload ve Plugin kabul eder. Başka herhangi bir türdeki dosya reddedilir ve ret mesajı kabul ettiği türleri ve bir varlık türü için o türdeki bir belgeyi denetleyen kapsamı adlandırır:
kind "Aggregate" in "aggregate.yaml" is not a single-entity validation target; the kinds this scope accepts are Component, Feature, Recipe, FeatureRecipe, Workload and Plugin. An Aggregate is checked by the whole-catalog scope when it sits in a catalog directory, and by the Release scope over a Release that deploys itTüm katalog kapsamı argümansız bir çalıştırmadır, Release kapsamı ise varlık yolu olmadan --release’tir:
| Tür | Denetleyen |
|---|---|
| Aggregate | bir katalog dizininde bulunduğunda tüm katalog çalıştırması; onu dağıtan bir Release üzerinde --release |
| Manifest | onu adlandıran bir Release üzerinde --release |
| Release | --release <release-path> |
| SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary | bir katalog dizininde bulunduğunda tüm katalog çalıştırması |
Tüm katalog çalıştırması yalnızca yapılandırılmış katalog dizinlerinin içindekileri okur; bu nedenle çalışma alanının kökünde Release’inin yanında tutulan bir Aggregate, o Release üzerinde --release ile denetlenir.
Başarısız bir onaylama bir uyarıdır
fail çağıran bir onaylama (Recipe’in bildirdiği ya da onun implements Component’inin bildirdiği) uyarı olarak bildirilir ve denetim bu yüzden başarısız olmaz. Sentezlenen Release, gerçek bir Release’in ayarladığı değerlerin yerine yer tutucular ve şema varsayılanları taşır; bu nedenle böyle bir değer, bir imaj ya da bir önkoşulun varlığı üzerindeki bir onaylama, Recipe sağlam olsun ya da olmasın burada başarısız olur ve validate bir Release’i bekleyen onaylamayı bozuk olandan ayırt edemez. Onaylamaya ilişkin karar, her zaman bir Release’i olan bir derlemeye bırakılır.
Uyarı, varsa danışma notlarından sonra, warning: ile başlayarak standart hataya yazılır. Onaylamanın tam mesajını (varlık, örnek, onaylamanın adı ve yazarının yazdığı cümle) taşır ve bir cümle daha ile kapanır:
A Release must satisfy this assertion before a build of it can pass.Standart çıktıdaki rapor çalıştırmanın nerede durduğunu söyler ve komut 0 ile çıkar. Recipe’in kendi onaylaması işlemeyi durdurur, bu nedenle rapor Resolution: valid satırından sonra Render: stopped on a failed assertion, reported as a warning okur. Bir Component’in onaylaması herhangi bir şey işlenmeden önce değerlendirilir, bu nedenle rapor Resolution: stopped on a failed assertion, reported as a warning ve ardından Render: not attempted (the run stopped on that assertion) okur. Her iki durumda da hiçbir şey işlenmez, dolayısıyla hiçbir yapıt yazdırılmaz.
Yalnızca fail çağıran bir onaylama uyarıdır. Okuduğu ama bulamadığı bir anahtarda duran ya da ayrıştırılamayan bir onaylama, başarısız bir onaylama değil onaylamanın kendi metnindeki bir hatadır ve diğer her durma gibi değerlendirilir. Diğer her hata, denetimin kararı olarak yerini korur.
Onaylamayı karşılamayan bir Release’in aggrega build işlemi, her zaman olduğu gibi onaylamayı adlandıran ve yazarının cümlesini taşıyan bir hatayla bu onaylamada durur ve o Release üzerinde aggrega validate --release de aynı hatayla bu onaylamada başarısız olur. aggrega serve üzerinden düzenleyicinin varlık denetimi aynı uyarıyı, Recipe onaylamayı bildiriyorsa onaylamanın kendi anahtarı üzerinde gösterir ve aggrega mcp aracının validate aracı, uyarıyı notices arasında barındırarak valid: true yanıtını verir.
Tek varlık doğruluğunun denetlemedikleri
Gerçek bir derlemenin dört denetimi, tek varlıklı bir derlemenin erişiminin dışındadır ve validate, arkasında duramayacağı bir bulguyu bildirmek yerine her birini yapmaktan kaçınır.
Getirilmesi gereken bir kaynak
Tek bir varlığı doğrulamak hiçbir kilit dosyası okumaz, hiçbir önbellek okuyup yazmaz ve hiçbir ağ isteği yapmaz. Bu nedenle source: alanı bir aktarım üzerinden alınan bir şeyi (bir OCI ya da HTTPS chart deposu, bir Git deposu) adlandıran bir Recipe’in işleyebileceği altyapı kodu yoktur: chart ya da modül, çalıştırmanın erişebileceği hiçbir yerde bulunmaz ve denetlenen dosyadaki hiçbir şey hatalı değildir. Validate bunu belirtir, işlemeden ayrı bir sonuç olarak yazdırır ve 0 ile çıkar:
Entity: catalog/recipe/helm/openbao/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validResolution: validRender: not attempted (this Recipe's source is fetched) Validating one entity on its own reads no lockfile, reads and writes no cache, and makes no network request, so the chart or module this Recipe names is never retrieved and there is nothing to render from. To render it, build a Release that deploys a component this Recipe implements.O satırın üzerindeki her şey denetlenmiştir ve geçerli olarak bildirilir. Bu nedenle çıkış kodunun böyle bir Recipe için anlamı, işlenmiş olana göre daha dardır (şema, biçim ve çözümleme geçerlidir; işleme kanıtlanmamıştır) ve rapor ikisinden hangisini okuduğunuzu belirtir.
Çalışma alanının zaten barındırdığı bir kaynaktan kaçınılmaz. Göreli bir source: ./module getirme gerektirmez, bu nedenle işlemesi diğerleri gibi denenir ve içindeki bir başarısızlık, sıfır olmayan bir çıkışla Render: not completed in isolation olarak bildirilen gerçek bir bulgudur. Yukarıdaki satır yalnızca alınması gereken bir kaynak için görünür.
Getirilen kaynaklı bir Recipe’i gerçekten işlemek için, Recipe’in uyguladığı bir bileşeni dağıtan bir Release üzerinde aggrega build çalıştırın: bir derleme kaynağı Release’in kilit dosyası ve yerel önbellek üzerinden çözümler; validate’in elde etme yolu olmayan baytları sağlayan budur.
Zorunlu bir uses soketi
İkincisi, implements Component’inin required: true olan uses soketlerinin doldurulup doldurulmadığıdır.
Zorunlu bir soket, başka bir bileşene bir kenar bağlanarak doldurulur — Aggregate’in kendi uses bloğundan ya da Component’in bildirdiği bir soketi bağlayan bir Release’ten. Sentezlenen düzenek tek bir örnek içerir; bu nedenle böyle bir kenarın hedefleyebileceği ikinci bir bileşen içermez ve sentezlenen belgeler nasıl yazılırsa yazılsın böyle bir bileşen üretilemez: bir eş uydurmak, düzeneğin hiç bildirmediği bir hesaplama kaynağı uydurmak anlamına gelirdi. Bu yüzden validate denetlemediği soketleri adlandırır ve çözümleme ile işleme adımlarına devam eder:
Sockets: required uses sockets not checked (backend, cache, registry) Validating a Recipe on its own places its Component in a build of one, so no other component exists for a required socket to be wired to. Whether each of these sockets is populated is checked when the Component is deployed in an Aggregate.Satır yalnızca Component en az bir zorunlu soket bildirdiğinde görünür ve yalnızca zorunlu olanları adlandırır — isteğe bağlı bir soket hiçbir zaman listelenmez, çünkü onu bağlamadan bırakmak hiçbir kapsamda bir bulgu değildir. Component’i hiç zorunlu soket bildirmeyen bir Recipe böyle bir satır üretmez ve raporu değişmez.
Kuralın kendisi ne gevşetilir ne de yinelenir; onu yanıtlayabilecek kapsamda sorulur. aggrega build kuralı Aggregate’in ve Release’in kenar yüzeyleri üzerinde birlikte tam olarak uygular ve hiçbir şeyin bağlamadığı zorunlu bir sokette durur. Dolayısıyla tek varlık doğrulamasını geçen bir Recipe, Component’i dağıtıldığında yine de zorunlu soket kuralını karşılamak zorundadır ve rapor, validate’in denetledikleri ile bir derlemenin denetleyecekleri arasında sessiz bir fark bırakmak yerine bunu açıkça söyler.
Zorunlu bir ekleme yuvası ya da bir varlık zorunluluğu
Üçüncüsü, implements Component’inin required: true olan ekleme yuvalarının — featuresSchema’sının bildirdiği adlandırılmış bağlama noktalarının — doldurulup doldurulmadığı ve varlık zorunluluklarının talep ettiği her Feature türünden bir eklemenin bulunup bulunmadığıdır.
Zorunlu bir yuva, o ada bir Feature eklenerek doldurulur; bu ekleme Aggregate’te ya da Release’te, bileşen üzerinde ya da onun üstündeki bir kapsamda yapılır — yani Recipe’te değil, Component’in dağıtıldığı yerde. Sentezlenen düzenek hiçbir Feature eklemez, bu nedenle onun derlediği hiçbir şey böyle bir yuvayı dolduramaz. Bu yüzden validate, zorunlu soketlerde yaptığı gibi, denetlemediği yuvaları adlandırır ve çözümleme ile işleme adımlarına devam eder:
Attachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Satır yalnızca Component en az bir zorunlu yuva bildirdiğinde görünür ve yalnızca zorunlu olanları adlandırır; Component’i hiç bildirmeyen bir Recipe böyle bir satır üretmez. Yalnızca zorunluluk bir kenara bırakılır: bir yuvanın etiket kısıtı ve izin verilen teslim mekanizmaları bildirildiği gibi korunur. Ayrıştırılamayan bir şablon çalıştırmayı yine başarısız kılar; sağlayıcının sentezleyemediği bir Workload gibi Recipe’in kendine ait bir hatası da öyle — Recipe yalnızca bir bağlantının ya da eklenmiş bir Feature’ın sağladığı bir değeri de okumadıkça; bu durum sonraki bölümde açıklanır.
Bir varlık zorunluluğu — Component üzerindeki, bir eklemenin adlandırdığı Feature türünü taşımasını talep eden bir features.aggrega.ai/requiredType.<label> ek açıklaması — aynı nedenle bir kenara bırakılır: düzenek hiçbir şey eklemez, bu nedenle onun derlediği hiçbir şey o türü taşıyamaz. Validate denetlemediği her zorunluluğu etiketi ve talep ettiği türle adlandırır ve çözümleme ile işleme adımlarına devam eder. Standart kütüphanenin example/compute/service bileşeni böyle bir zorunluluk bildirir; bu nedenle Recipe’i, işlenmiş iki yapıtından önce şunu raporlar:
$ aggrega validate aggrega-catalog/recipe/helm/service/1.0.0/recipe.yaml --catalog aggrega-catalogEntity: aggrega-catalog/recipe/helm/service/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: presence mandates not checked (monitoring: core/prometheus-exporter) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to carry a type the Component requires. Whether an attachment of each of these types is present is checked when a Release that deploys the Component is built.Resolution: validRender: 2 artifact(s)Bildirimi değerlendirilemeyen bir zorunluluk — ardından etiket gelmeyen ek açıklama öneki ya da Feature türü olmayan bir değer — bir kenara bırakılmaz: bu, Component’in kendine ait, hiçbir eklemenin onaramayacağı bir hatadır ve validate, bir derlemenin yaptığı gibi çalıştırmayı bu nedenle başarısız kılar.
Her kural, yanıtlanabileceği yerde sorulur. aggrega pull, aggrega build ve aggrega validate --release her ikisini de Release’in gerçek eklemeleri üzerinde değerlendirir ve her biri hiçbir şeyin doldurmadığı zorunlu bir yuvada ve hiçbir eklemenin taşımadığı zorunlu bir türde durur.
Yalnızca bir bağlantının ya da eklenmiş bir Feature’ın sağladığı bir değer
Dördüncüsü, bağlantıları ve eklenmiş Features şablonlarının okuduklarını sağladığında bir Recipe’in işlenip işlenmediğidir.
Bir Recipe’in şablonları, bir bağlantının .context.inject ve .context.uses altında teslim ettiklerini ve eklenmiş bir Feature’ın .features altında teslim ettiklerini okur. Sentezlenen düzenek hiçbir bağlantı kurmaz ve hiçbir Feature eklemez, bu nedenle bu tür her okuma hiçbir şey bulamaz: .context.inject.env altındaki bir okuma boş bir teslim borusuyla karşılaşır ve .context.uses üzerindeki bir range hiçbir bağlantıyla karşılaşmaz. Validate önce Recipe’i işler ve tamamlanan bir işleme her zamanki gibi raporlanır. İşleme durduğunda ve Recipe’in şablonları — içe aktardıkları dosyalar ve kütüphane girdileri dahil — bu üçünün altında herhangi bir şey okuduğunda, validate işlemeyi denenmedi olarak raporlar, Recipe’in orada okuduğu değerleri adlandırır, işlemenin durduğu cümleyi yazdırır ve 0 ile çıkar. MariaDB + Adminer örneğinin chart çeşidi, veritabanı kimlik bilgilerini eklenmiş iki gizli bilgisinin doldurduğu teslim borusundan okur:
$ aggrega validate catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml --release release-helm-chart.yamlEntity: catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: not attempted (this Recipe reads values a build of one cannot supply) Validating a Recipe on its own places its Component in a build that wires no connection and attaches no Feature, so nothing supplies what its templates read under .context.inject, .context.uses or .features. Its render stopped, and whether on one of those values or on a fault of its own is not judged here. To render it, build a Release that deploys a component this Recipe implements. Reads: .context.inject.env.MARIADB_PASSWORD, .context.inject.env.MARIADB_ROOT_PASSWORD The render stopped: rendering: [CATALOG_ERROR] instance instance: rendering node "instance": [CATALOG_ERROR] catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml: recipe "mariadb-chart" valuesMapping: [CATALOG_ERROR] valuesMapping[mariadb-chart]: template "valuesMapping[mariadb-chart]" execute: template: valuesMapping[mariadb-chart]:7:30: executing "valuesMapping[mariadb-chart]" at <.context.inject.env.MARIADB_ROOT_PASSWORD>: nil pointer evaluating interface {}.MARIADB_ROOT_PASSWORDHiçbir şey bulmayan ve hiçbir şeyi durdurmayan bir okuma bir kenara bırakılmaz: tamamlanan bir işlemede hiçbir şey işlemeyen, .context.uses üzerindeki bir range, olduğu işleme olarak raporlanır.
Belirleyici olan, işlemenin neyde durduğu değil, Recipe’in ne okuduğudur ve bunun, karşılaşmadan önce bilinmeye değer bir sonucu vardır: böyle bir değeri de okuyan bir Recipe’teki Recipe’in kendine ait bir hata — örneğin yanlış yazılmış bir anahtar — başarısızlık olarak değil, geri kalanla birlikte denenmedi olarak raporlanır. The render stopped: satırı, hangisi olduğunu görebilmeniz için işlemenin kendi cümlesini taşır ve Component’i dağıtan bir Release’in derlemesi işlemeyi tam olarak değerlendirir.
İki hata, Recipe ne okursa okusun çalıştırmayı yine başarısız kılar, çünkü hiçbir bağlantı ya da Feature bunları değiştirmez: ayrıştırılamayan bir şablon ve işlemenin reddettiği bir başvuru — işleme bağlamının tanımlamadığı bir kök ya da biçimi sabit olan bir kökün altında yanlış yazılmış bir anahtar, örneğin .context.instance_idd. Recipe’in bildirdiği ve fail çağıran bir doğrulama, Recipe ne okursa okusun ne bir kenara bırakılır ne de başarısızlıktır: başarısız bir doğrulamanın her zaman olduğu gibi uyarı olarak raporlanır. Şablonları bu üçünden hiçbirini okumayan bir Recipe’in işlemesi tam olarak değerlendirilir ve duran bir işleme, nedeni adlandıran cümleyle başarısız olur.
validate aracı, aggrega mcp içinde, aynı Recipe için aynı kararı verir: bu şekilde bir kenara bırakılan bir render, tanılarında hiçbir şey olmadan geçerli olarak yanıtlanır ve yukarıdaki satırlar, aracın bunların yanında döndürdüğü metinde yer alır.
Tek varlık kipinin katalog yüklemesi hoşgörülüdür: katalogda başka bir yerdeki ilgisiz, bozuk bir varlık denetimi iptal etmek yerine atlanır; bu nedenle hedefin yalıtılmış olarak doğrulanmasını hiçbir zaman engellemez.
Atlanan bir dosya, kendisi yüzünden kaybolan bir Component’i yine de açıklar. Bir Recipe’in implements hedefi bulunamadığında ve atlanan tam olarak bir dosya o Component’i bildirdiğinde, rapor o dosyanın kendi reddiyle başlar — yolu, ihlal ettiği kısıt ve başlıkta koşulun kısa kodu —; ardından dosyanın yükleme sırasında atlandığını, dolayısıyla kataloğun dosyanın bildirdiği kimlik altında hiçbir şey tutmadığını söyleyen bir note: gelir, sonra da dosyanın neden gerekli olduğunun gerekçesi olarak implements target … not found in catalog hatası gelir. Atlanan hiçbir dosya o Component’i bildirmiyorsa ya da birden fazlası bildiriyorsa, bulunamadı hatası başta gelir ve atlanan her dosya onun altında note: catalog files skipped at load altında listelenir. Bu, aggrega build komutunun atladığı bir dosya için verdiği açıklamadır; düzenleyicinin aggrega serve üzerinden yaptığı varlık denetimi ve aggrega mcp komutunun validate aracı da aynı açıklamayı verir. Hiçbir şeyin atlanmadığı bir katalog, aksi hâlde nasıl raporlayacaksa tam olarak öyle raporlar.
validate’in lint ve build ile ilişkisi
Üç komut üç farklı soruyu yanıtlar:
aggrega validate— bu doğru mu? Şema, sütunlar, başvurular,extends, girdi türü yeteneği ve yalıtılmış render. Hiçbir çalışma zamanı durumunu okumaz ve hiçbir yapıt üretmez.aggrega lint— bu, katalog yayımlama uzlaşımlarına uyuyor mu? Adlandırma, kategori-dizin uyumu, ek açıklama önekleri, sürüm artışının büyüklüğü ve isteğe bağlı yayımlama disiplininin geri kalanı. Lint, validate’in üç kapsamını yansıtır ancak doğruluğu hiçbir zaman denetlemez.aggrega build— eksiksiz bir dağıtımı derle. Build, tam bir Aggregate + Manifest + Release kapanışına ihtiyaç duyar ve sağlayıcıya özgü yapıtlar üretir. Derlemenin bir parçası olarak kendi bağımlılık kapanışını doğrular, ardından render eder.aggrega validate --release, render olmadan yalnızca bu bağımlılık doğrulamasıdır; tek varlıklı validate ise tek bir Recipe’in render’ını tam bir Aggregate olmadan yalıtır.
Örnekler
Kataloğun tamamını doğrulayın:
aggrega validate --catalog ./catalogBir Release’i derlemeden önce tam olarak neye bağlı olduğunu doğrulayın:
aggrega validate --release releases/production.yamlTek bir varlığı doğrulayın ve — bir Recipe için — onun yalıtılmış olarak işlenmiş çıktısını görün:
aggrega validate core/datastore/postgres/recipes/helm.yamlTek bir varlığı, çalışma alanı yapılandırmasının kendi katalog dizinlerini verdiği bir Release’in koşullarında doğrulayın:
aggrega validate core/datastore/postgres/recipes/helm.yaml --release releases/production.yamlAyrıca bakınız
- ./aggrega-lint.md — aynı üç kapsamdaki uzlaşım karşılığı.
- ./aggrega-build.md — eksiksiz bir Aggregate + Release’i yapıtlara derler; derlemenin bir parçası olarak bağımlılık kapanışını doğrular.
- ./aggrega-inspect.md — çözümlemeden sonra, işlemeye geçmeden IR grafını sorgular.
- ../errors/warnings.md — validate komutunun
notice:satırları olarak gösterdiği tavsiye niteliğindeki bulgular.
Kullanım
aggrega validate [entity-path] [flags]Açıklama
Check CORRECTNESS across three symmetric scopes.
With no argument, validate checks the WHOLE catalog: schema-pillarstructure, cross-document library resolution, extends chains, and providerinput-kind capabilities, over every catalog entity. Where the workspaceconfiguration gives its Releases catalog directories of their own underworkspace.releases, it checks the catalog once for each Release, over thedirectories that Release reads, and reports each pass under a line namingits Releases and those directories; Releases reading the same directoriesshare one pass.
With --release, validate checks the entities a Release's dependency closurereaches: closure-scoped pillars, extends, and pre-render authored-valueconformance — the same correctness a build applies, scoped to that Release.It then evaluates the Recipe and FeatureRecipe assertions against the valuesthat Release resolves to, as a build does before it renders, and reports afailing assertion as a build reports it. Nothing is rendered.
With an entity path, validate checks one entity file. The kinds it acceptsas a single-entity target are Component, Feature, Recipe, FeatureRecipe,Workload and Plugin. A value the kind requires that the file leaves empty isreported first, as a placeholder still owed: every one is named at once, withwhat it takes, read from the kind's own schema. That reading is this scope'salone; a whole-catalog run, a Release's closure and a build do not apply it.Each kind then has its schema checked, then the checks its own kind carries:pillar structure for a Component or Feature; shape for a Workload,FeatureRecipe or Plugin; and for a Recipe, shape plus an end-to-end compileagainst a minimal generated harness, so its resolution, its guards and arender of its output are all exercised. Where that Recipe's source is onethat has to be fetched, the render is reported as not attempted instead:validating one entity on its own reads no lockfile, reads and writes no cacheand makes no network request, so the chart or module it names is neverretrieved and there is nothing to render from. A render that stops while theRecipe's templates read what only a connection or an attached Featuresupplies — anything under .context.inject, .context.uses or .features — isreported as not attempted too: the generated harness wires no connection andattaches no Feature, so that render cannot be judged there, and a fault ofthe Recipe's own beside such a read is set aside with it. A template thatdoes not parse and a reference the render refuses still fail. An assertionthat calls fail, the Recipe's own or one its Component declares, is printedas a warning closed by a sentence saying a Release must satisfy it before abuild can pass, and does not fail the check: the generated harness sets noneof a real Release's values, so it cannot tell an assertion waiting on one fromone that is broken, and a build still halts on it. Any other kind is refused heretoday, and the refusal names the scope that checks it instead: a whole-catalogrun reaches an Aggregate and the library kinds when they sit in a catalogdirectory, and --release reaches a Release, the Manifest it names and theAggregate it deploys.
With an entity path and --release together, the entity is checked in thatRelease's terms: its references — the Component a Recipe implements, alibrary a pillar refers to — resolve through the catalog directories theworkspace configuration gives that Release rather than the workspace's own,so a workspace keeping one catalog variant per Release checks an entityagainst the variant that Release builds with. The checks are the entitypath's; no closure is validated.
The command writes nothing to disk.Bayraklar
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--catalog | [] | Katalog dizini; tekrarlanabilir. Her —catalog <dir>, katalog arama yığınının başına eklenir (ilk eşleşme kazanır): çalışma alanının catalog_dirs değeri ya da çalışma alanı yapılandırmasının workspace.releases altında kendi dizinlerini verdiği bir Release için o Release’inkiler; yığın, varsa çalışma alanı kökündeki catalog adlı dizinle biter. Boş yazılmış bir catalog_dirs listesi hiçbir yerel kataloğu okumaz. |
--ir-graph | false | Bu komutun zaten ürettiği her şeye ek olarak, bu çalıştırmanın hesapladığı IR grafını da JSON olarak stdout’a yazar. Bir yazarın hassas olarak bildirdiği değerler grafa konmaz; bunun yerine onları yazdırmak için —unredacted verin. Bir Release’i bir grafa çözümleyen tek kapsam olan —release kapsamına uygulanır. Bir BELGE seçer; —response-format ise bu komutun kendi raporunun ne kadarının yazılacağını belirler; hiçbiri sonucu ya da çıkış kodunu etkilemez |
--no-unsupported-field-warnings | false | Desteklenmeyen alan uyarı sınıfını susturur: bir hedefin, sizin yazdığınız ama karşılayamadığı bir şey için verdiği bildirimler — ifade edemediği bir Workload alanı (compose gibi daha düşük doğruluklu bir hedefin yaptığı gibi) ya da düğümün girdi türü için uygulamadığı bir aggrega.ai/ ek açıklaması. Diğer işleme uyarıları yine gösterilir. Yalnızca görüntülemeye yöneliktir; işlenen çıktıyı değiştirmez. İşleme yapan tek kapsam olan varlık kapsamına uygulanır |
--plugin | — | describe() öz raporuna karşı doğrulanacak ham bir .wasm dosyasının yolu — yayın öncesi yazım denetimi. Tek başına —type gerektirir; bir Plugin varlık argümanıyla birlikte ikili dosyayı varlığın bildirilen türü, yetenek beyanı, komut yansısı ve ana makine işlevi kaydıyla çapraz denetler. |
--release | — | Bir Release YAML dosyasının yolu. Tek başına, çözümlenmiş bağımlılık kapanışı üzerinde doğrulama yapar; bir varlık argümanıyla, o varlığı Release’in koşullarında denetler ve başvurularını çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri üzerinden çözümler. Göreli bir yol, çalışma alanı köküne göre değil, komutu çalıştırdığınız dizine göre çözümlenir. Bu dizin hiçbir çalışma alanında değilse ve bir kök belirtilmemişse, mutlak bir yol çalışma alanını Release’in kendi klasöründen bulur |
--response-format | detailed | Varlık argümanı olmayan bir Release kapanışı olan —release kapsamı için çıktı hacmi: detailed (varsayılan) her tanılamayı ve tavsiye satırlarını raporlar; concise yalnızca tanılama sayısını ve ilk tanılamayı raporlar. Sonuç ve çıkış kodu her ikisinde de aynıdır. |
--type | — | Yalnızca ikili dosyaya yönelik bir —plugin denetimi için Plugin türü; ikili dosyanın kendi bildirdiği türe karşı doğrulanır. Yalnızca —plugin ile anlamlıdır; türü bir Plugin varlığı sağladığında bunu belirtmeyin (uyuşmayan bir değer işlemi durdurur). |
--unredacted | false | Bir yazarın hassas olarak bildirdiği değerleri gizlemek yerine yazdırır. Bu durumda çıktının ulaştığı her şey — bir terminal, bir boru, bir dosya, bir ekran kaydı — bu değerleri açık olarak taşır. Yalnızca —ir-graph’ın yazdığı grafa ulaşır, başka hiçbir şeye ulaşmaz; bu nedenle —ir-graph gerektirir |