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

aggrega inspect

aggrega inspect, herhangi bir Aggrega varlığının insan tarafından okunabilir bir görünümünü oluşturur: bir katalog Component’i, yazılmış bir varlık dosyası, bir kayıt defterinde yayımlanmış bir varlık ya da tamamen çözümlenmiş bir Release. Derleyicinin ne üreteceğini anlamak için kullanılan temel hata ayıklama yüzeyidir: hangi Components’in hangi tabanları genişlettiği, her türe hangi Recipe’nin eşlendiği, her düğüme hangi Features’in bağlandığı ve her Feature’ın katkılarının tam olarak nereden geldiği.

Her varlık türünün doğal bir “sözleşme” görünümü vardır. inspect bu sözleşmeyi gösterir: bir Component’in yayımladığı şema, bir Manifest’in bildirdiği eşlemeler, bir Aggregate’in kurduğu topoloji, bir Release’in çözümlendiği düğüm başına Feature bağlantıları. Öğretici ve kavramsal içerik başka yerlerde yer alır; inspect “bu varlık aslında neye çözümleniyor?” sorusunu yanıtlar.

Tek bir konumsal bağımsız değişken, içeriğin biçimine göre yönlendirilir; alt komut gerekmez. Komut, aşağıdaki buluşsal yönteme göre yönlendirme yapar:

Tanımlayıcı biçimiYönlendirmeÇıktı
./, ../ veya / ile başlar ya da .yaml / .yml ile biterDosya dalıDosyanın kind: başlığına göre yapılan dosya başına inceleme.
oci:// ile başlarKayıt defteri dalıO koordinatta yayımlanmış varlık; kayıt defterinden okunur ve kendi türündeki bir dosyanın aldığı görünümle oluşturulur. Bkz. Yayımlanmış bir varlığı okuma.
Diğer her şeyKatalog dalıTanımlayıcıyı katalog arama yığınında tüm varlık türlerinde arar; extends: zincirlerini çözümler; eşleşen türün kendi görünümünü oluşturur.

Üç ayrıntı düzeyi

--list, varsayılan düzey ve --detail, her türün uyduğu tek tip, üç düzeyli bir ayrıntı disiplini oluşturur. --list ve --detail birbirini dışlar; ikisinin birlikte verilmesi sessizce çözümlenmek yerine reddedilir.

  • --list — yalnızca tanımlayıcılar. Bir Component adını ve uses-socket adlarını listeler; bir MappingLibrary eşleme adlarını listeler; bir Aggregate bileşen adlarını türleriyle birlikte listeler.
  • varsayılan — etkileşimli kullanım için ayarlanmış yapılandırılmış bir genel bakış. Varlığın kimliğiyle ve Manifest ile Release dışındaki her tür için, varlık bir açıklama yazıyorsa bu açıklamayla başlar; açıklaması olmayan bir varlık boş bir satır yerine hiçbir şey yazdırmaz. Biçimin geri kalanı türe göredir: bir Component şemasını ve soketlerini gösterir; bir Aggregate bileşenleri, bunların değerlerini ve her bağlantının taşıdığı eklemelerle birlikte kenarlarını ve bağımlılık grafiğini gösterir; bir Release, Feature eklemeleriyle birlikte sınır başına düğüm ağacını gösterir; bir bağlantı üzerine yazılan her ekleme o bağlantının altında listelenir.
  • --detail — tam alan gövdeleri. Türün taşıdığı her şey: bir Component kendi kendine enjeksiyon mekanizmalarını, gerekli Features’ı ve etiketlerini ekler; bir MappingLibrary her eşlemenin tam şablon gövdesini genişletir; bir Recipe iş yükü gövdesini, provides’ını ve doğrulamalarını ekler.

Bazı türler bu düzeyleri, yazılmış bir gövdenin giderek daha fazlasını göstermek için kullanır. Bir MappingLibrary --list düzeyinde eşleme adlarını gösterir; varsayılan düzeyde her eşlemenin sentezlenmiş kullanım örneğini ekler; --detail düzeyinde tam şablon gövdesini genişletir.

Çözümleme: --raw ve --resolved

Her türün doğal bir varsayılan çözümleme derinliği vardır (aşağıdaki tabloya bakın). --raw ve --resolved her zaman kullanılabilen geçersiz kılmalardır ve birbirini dışlar; ikisinin birlikte verilmesi sessizce çözümlenmek yerine reddedilir:

  • --raw tüm çözümlemeyi devre dışı bırakır; varlık, doğrudan dosyadan, yazıldığı haliyle çıktılanır.
  • --resolved türün tam çözümleme derinliğini etkinleştirir.

Varsayılan olarak yazıldığı haliyle gösterilen türlerde --raw hiçbir etki yapmaz ve --resolved türün desteklediği çözümlemeyi tetikler. Varsayılan olarak çözümlenmiş gösterilen türlerde ise --raw, yazıldığı hali gösteren atlama yoludur.

--raw dosyayı yeniden üretir; bu nedenle bir yazarın hassas olarak bildirdiği bir değer, çıktıda tam olarak yazıldığı gibi görünür. Bu bir eksiklik değil, sözleşmenin kendisidir: kendisinin bir kısmını sessizce gizleyen bir yazıldığı hal görünümü, yazıldığı hal olmazdı. --raw çıktısını, geldiği varlık dosyasını nasıl ele alıyorsanız öyle ele alın. --output yaml de dosyayı aynı şekilde, Release dahil her tür için yeniden üretir.

Bir Release iki soruyu daha yanıtlar ve her biri kendi bayrağı olan ayrı bir belgedir. Bir Release’in çözümlendiği derlenmiş grafik --ir-graph, bağımlılık kapanışı ise --closure ile elde edilir. Aşağıdaki Makine tarafından okunabilir çıktı ve Bağımlılık kapanışı: --closure bölümlerine bakın.

Türe göre varsayılanlar

inspect, aşağıdaki tablodaki tek başına incelenebilen türleri tanır. Katalog türleri varsayılan olarak yazıldığı haliyle görüntülenir; dosyaları kendi içinde eksiksiz sözleşmelerdir. Örnek türleri ise varsayılan olarak çözümlenmiş bir görünüm kullanır, çünkü yazılan YAML’leri bir kademe ya da bir işlem hattı için yalnızca başlangıç noktasıdır.

TürVarsayılan“Çözümlenmiş” ne anlama gelir
Componentyazıldığı haliyleDosya kendi içinde eksiksiz bir sözleşmedir; çözümleme bir Manifest bağlamasına karşı yapılır ve --show-implements ile gösterilir.
Featureyazıldığı haliyleComponent ile aynı.
Recipeyazıldığı haliyle--show-implements, spec.implements Component başvurusunu çözümler.
FeatureRecipeyazıldığı haliyle--show-implements, spec.implements Feature başvurusunu çözümler.
MappingLibraryyazıldığı haliyleGirdiler opak Go şablonu dizeleridir; işleme, kullanım anında gerçekleşir.
SchemaLibraryyazıldığı haliyleGirdiler, kullanım anında çözümlenen yeniden kullanılabilir şema ve şablon tanımlarıdır.
WorkloadLibraryyazıldığı haliyleGirdiler, bir Recipe’in içe aktardığı, kullanım anında değerlendirilen yeniden kullanılabilir Workload gövdeleridir.
ArtifactLibraryyazıldığı haliyleGirdiler, bir Recipe’in içe aktardığı, kullanım anında işlenen yeniden kullanılabilir yapıt paketleridir.
Pluginyazıldığı haliyleDosya kendi içinde eksiksiz bir plugin sözleşmesidir: soket türleri, dışa aktarım başına yetenekler, çalışma zamanı kısıtlamaları ve imza işaretçisi. Dosya yoluyla ya da katalogdaki <pluginType>/<name> koordinatıyla adreslenebilir.
Manifestçözümlenmişextends: zinciri uygulanır; çözümlenmiş component ve feature eşlemeleri ortaya konur.
AggregateçözümlenmişTopoloji oluşturulur; uses grafiği ve sıralama hesaplanır.
Releaseçözümlenmişİşlem hattının tamamı çalışır: çözümleme, ek açıklamaları genişletme, korumaları çalıştırma, topolojiyi oluşturma, IR’yi oluşturma.

kind: değeri Workload olan bir dosya reddedilir: bir Workload yalnızca bir Recipe’nin içine gömülü olarak var olur ve tek başına incelenebilen bir varlık değildir. Workload’unu görmek için bir Recipe’yi inceleyin.

Türe göre çözümleme derinliği

Çoğu türün bir işlem hattı yoktur: inspect dosyayı okur ve işler. Üç örnek türü anlamlı biçimde çözümlenir:

  • Manifest, extends: zincirini uygular (dosya içe aktarmalarını izleyerek) ve birleştirilmiş component ve feature eşlemelerini işler. --raw, dosyayı yazıldığı haliyle gösterir.
  • Aggregate, topolojisini oluşturur: uses grafiği kurulur ve bağımlılık sıralaması hesaplanır. Varsayılan görünüm, bileşenleri değerleri ve kenarlarıyla birlikte, ardından bağımlılık grafiğini gösterir. --raw, yazılmış alt sistem ağacını gösterir.
  • Release, IR’ye kadar tüm derleme işlem hattını çalıştırır (çözümleme, ek açıklamaları genişletme, korumaları çalıştırma, topolojiyi oluşturma, IR’yi oluşturma) ve sınır başına düğüm ağacını, her düğümün Feature eklemeleri ve bunların kökeniyle birlikte işler. Grafiği şekillendiren yönetişim eklemeleri, bir görünüm için atlanmak yerine bu işlem hattında çalışır; dolayısıyla okuduğunuz şey onların verdiği kararları yansıtır: bir label-transform eklemesinin etiketleri, herhangi bir şey bunlarla eşleştirilmeden önce yerindedir ve bir annotation-transform eklemesinin enjekte ettiği ek açıklamalar, sizin yazdığınız bir ek açıklamayla tam olarak aynı şekilde Feature eklemelerine genişler. Bu komutun plugin’ini çözümleyemediği bir ekleme, size o plugin’in kararları olmadan çizilmiş bir grafik bırakmak yerine komutu durdurur. Başka bir Release’i genişleten bir Release, bu görünümde ve --ir-graph içinde, extends: zincirinin oluşturduğu Release olarak — yani onun bir derlemesinin okuduğu Release olarak — çizilir; böylece yalnızca üst öğesini adlandıran bir Release, o üst öğenin Aggregate’ini, Manifest’ini ve sınırlarını kendi adı altında gösterir. Bir Release’in adlandırdığı Manifest de, Release herhangi bir şeyi genişletsin ya da genişletmesin, kendi extends: zinciri üzerinden oluşturulur; böylece eşlemesini o Manifest’in devraldığı bir ekleme, bir derlemenin kullandığı gerçekleştirmeyi gösterir. --raw, Release dosyasını hiçbir işlem hattı olmadan olduğu gibi çıkarır. --closure aynı Release hakkında farklı bir soru sorar ve hiçbir işlem hattı çalıştırmaz; bkz. Bağımlılık kapanımı: --closure.

Ayrı bir derinlik bayrağı yoktur; --raw / --resolved geçişi, her türün doğal varsayılanının üzerine katmanlanan tek çözümleme denetimidir.

Hata davranışı

Yüklenemeyen, başvurulan bir kardeş dosya komutu hemen durdurur: eksik bir Aggregate’e işaret eden bir Release, arama yığınındaki bozuk bir katalog varlığı gibi. Komut, kısmi çıktı oluşturmak yerine açık bir iletiyle durur ve yükleme hatası için hataya rağmen devam etme kipi yoktur: çözümlemenin ihtiyaç duyduğu bir belge okunamaz hâle geldiğinde çözümlenecek başka bir şey kalmaz. Bir adın çözümlenmesi, yüklemenin reddettiği tek bir katalog belgesinde durduğunda ileti bu reddi bir kez belirtir: kategoriyi ve ret bir koşulu adlandırıyorsa onun kısa kodunu taşıyan bir başlık, ardından belge, ardından belgedeki sorun; türünün şemasının reddettiği bir belge için bu, satır ve ihlal ettiği kısıttır. İleti, dosyayı taşımaya yönelik bir öneri içermez; katalog dosyayı okumuştur ve reddedilmesinin nedeni de budur.

Bileşimi derleyicinin denetimlerince reddedilen bir Release, oluşturulmak yerine reddedilir. Bir Release’in çözümlenmesi grafiği kurar ve bir derlemenin tamamlanmış grafik üzerinde yaptığı denetimler (hedefi soketinin selector: alanını karşılamayan bir uses: kenarı, appliesTo: alanının kabul etmediği bir bileşene eklenmiş bir Feature ve diğerleri) burada da, aynı belgelerin derlemesinin yazdırdığı tanılamayla yapılır. Ret, ilkinde durmak yerine tek bir çalıştırmada tüm bulguları adlandırır; böylece tek bir geçiş size düzeltilecek listenin yalnızca ilk girdisini değil, tamamını gösterir. Bu komutun bir dağıtım konusunda dürüst kalmasını sağlayan budur: derlemenin reddettiği bir bileşimi oluşturan bir görünüm, sorunlu bir çalışma alanını sorunsuz olarak bildirirdi. Hiçbir şey çözümlemeyen seçimler bundan etkilenmez: --raw, --output yaml ve --closure, bir grafik kurmadan yazdığınızı yeniden üretir ya da çözümler.

Kilit dosyası artık çözümlendiği sonuçla eşleşmeyen bir Release, aggrega build komutunun yazdırdığı durdurmayla reddedilir. Release’in yanında bir kilit dosyası bulunduğunda, Release’i çözümleyen her seçim — varsayılan görünüm, --resolved, --ir-graph ve --closure — bir derlemenin oluşturmadan önce yürüttüğü sapma karşılaştırmasıyla bu dosyanın Release’in çözümlendiği sonuçla eşleşmesini şart koşar. Artık eşleşmeyen bir kilit dosyası komutu derlemenin E0130 reddiyle durdurur: sapan her girdi, ardından bunu gideren aggrega pull --release <release>. Standart çıktıya hiçbir şey yazılmaz ve komut sıfır olmayan bir kodla çıkar, çünkü kataloğun mevcut hâlinden çizilen bir resim, o Release’in hiçbir derlemesinin oluşturmadığı bir şeyi gösterirdi. --raw ve --output yaml tek başlarına ne kilit dosyasını ne de kataloğu okur ve buna tabi tutulmaz. Yanında kilit dosyası olmayan bir Release, kataloğun mevcut hâli üzerinden çözümlenir.

kind: değeri tanınmayan bir dosya, bilinmeyen türü ve geldiği dosyayı bildirir. Bir Workload dosyası, türün yalnızca gömülü olarak kullanılabildiğini bildirir ve altına gömüldüğü varlığı adlandırır. Okunamayan bir oci:// tanımlayıcısı, nedenini adlandıran koşulla reddedilir; bu koşullar Yayımlanmış bir varlığın okunması bölümünde listelenir.

Katalog çözümlemesi

Katalog arama yığını katmanlı bir öncelikle oluşturulur: önce --catalog bayrakları (sırayla, başa eklenerek) gelir, ardından .aggrega-config.yaml dosyasındaki çalışma alanının catalog_dirs değeri — yapılandırmanın workspace.releases altında kendine ait dizinler verdiği bir Release için, onların yerine o Release’in dizinleri — ve son olarak çalışma alanı kökündeki catalog dizini gelir; bu dizin, herhangi bir şey onu adlandırsa da adlandırmasa da okunur. catalog_dirs değeri boş bir liste olarak yazılmış bir çalışma alanı hiçbir yerel kataloğu okumaz. Yığında ilk bulan kazanır: bir varlık kimliğini bildiren en erken dizin o kimliğin sahibidir; daha sonraki bir dizindeki kopya gölgede kalır. Katalog dalı, tanımlayıcıyı bu yığına karşı tüm varlık türlerinde sabit bir öncelikle çözümler ve ilk eşleşmeyi o türün kendi görünümüyle işler; dosya ve release dalları ise bir Manifest eşlemesinin veya extends: üst öğesinin çözümlenmesi gerektiğinde başvurulan katalog varlıklarını bu yığından yükler. Yığının içermediği bir extends: üst öğesi, bir derlemenin onu okuduğu yerden okunur: yapıt önbelleğinden, bir Release’in lockfile’ının onun için kaydettiği sabitleme altında — adı verilen Release’inki ya da hiçbiri adlandırılmadığında çalışma alanının içerdiği her Release’inki. Böylece bir kayıt defterine yayımlanmış bir temel, aggrega pull onu getirip sabitledikten sonra burada çözümlenir; bundan önce komut aggrega pull --release <release> belirtilerek reddedilir. Hiçbir şey getirilmez.

Bir adı bir Release’in koşullarında aramak

Tek başına verilen bir ad, çalışma alanının kendi yığınında aranır. Yanına --release <release-path> verirseniz ad bunun yerine o Release’in yığınında aranır — çalışma alanı yapılandırmasının o Release’e verdiği dizinler, başa eklenen her --catalog ile birlikte — ve bu, o Release’in bir derlemesinin okuduğu yığındır. Bu nedenle her Release için bir katalog varyantı tutan ve her varyantı aynı varlığı bildiren bir çalışma alanı, bir ada o Release’in derlendiği varyantla yanıt verir:

aggrega inspect core/datastore/mariadb --release release-helm-synth.yaml

O Release’in yığınının çözümlemediği bir ad reddedilir ve yerel varlıkların nereden okunduğuna ilişkin açıklama, o Release’in workspace.releases altındaki girdisini adlandırır, çünkü aramanın okuduğu şey o girdidir. --release, bir adın arandığı yığını seçer; bu nedenle yalnızca tek başına bir ada uygulanır: bir dosya yolu ve bir kayıt defteri başvurusu oldukları gibi okunur ve bu bayrağı reddeder. Var olmayan bir dosyayı veya bir dizini adlandıran bir --release, herhangi bir arama yapılmadan önce reddedilir.

Yayımlanmış bir varlığı okuma

aggrega inspect oci://<host>/<repository>:<tag>, o koordinatta yayımlanmış varlığı okur; :<tag> yerine @<digest> yazmak tam olarak tek bir manifest’i adlandırır. Yalnızca bir kayıt defterinde (registry) bulunan bir varlığa bu şekilde bakarsınız: depo, Catalog and Registry §6’da açıklandığı gibi, tür kesimi ve ardından varlığın kimliğinden oluşur; aggrega push de yayımladığı referansı yazdırır ve bu referans burada önüne oci:// eklenerek okunur.

Gördüğünüz, varlığın yayımlandığı hâlidir. Bildirdiği dosyalarla birlikte yayımlanan bir varlık (yerel chart’ı veya kilidiyle bir Recipe, içe aktardığı bir şemayla bir Component) bir arşiv olarak gönderilir ve varlık bu arşivden çıkarılır: arşivin kökünde yayımlanabilir bir tür bildiren belge alınır; böylece yanında gönderilen bir chart şablonu veya compose parçası onunla karıştırılmaz. Hiçbir dosya bildirmeyen bir varlık, belgesi değiştirilmeden gönderilir; bir Plugin’in varlığı ise onunla birlikte yayımlanan yürütülebilir dosyadan değil, manifest’inden okunur. Belge daha sonra o türden bir dosyanın aldığı aynı görünümle, aynı ayrıntı düzeyleri ve aynı --raw ile --output yaml seçenekleriyle işlenir. Hiçbir kalıtım uygulanmaz: görünüm, yayımcının o koordinata koyduğu şeyindir. Okunabilir düzenler, okunan şeyle sona erer: koordinat, varlığı bir arşiv olarak mı yoksa belgenin kendisi olarak mı tuttuğu, manifest’inin bildirdiği medya türü ve o manifest’in özeti; bu özet, :<tag> yerine @<digest> olarak yazıldığında aynı baytları yeniden okur. --output yaml ise belgeyi yazdırır ve ardından hiçbir şey yazdırmaz.

Neyi denetler, neyi denetlemez. Getirilen baytlar, yapıtın kendi manifest’inin onlar için kaydettiği özete karşı denetlenir; bu, onların o manifest’in adlandırdığı baytlar olduğunu doğrular. Bu, önceden kaydedilmiş herhangi bir şeye karşı değil, kayıt defterinin sunduğuna karşı yapılan bir denetimdir: yapıta eklenmiş hiçbir imza doğrulanmaz ve ona karşı kaydedilmiş hiçbir geri çekme bildirilmez. Hiçbir şey yazılmaz (ne önbellek girdisi ne kilit dosyası); bu nedenle bir koordinatı okumak, sonraki bir derlemenin çözümlediği hiçbir şeyi değiştirmez.

Ağa erişir. Kayıt defterine, bu makinenin onun için tuttuğu kimlik bilgileriyle, aggrega push ve aggrega pull komutlarının okuduğu aynı depodan bağlanılır; bu makinedeki bir kayıt defterine ise düz HTTP üzerinden bağlanılır. Çevrimdışı olan bir çalışma alanı, herhangi bir bağlantı kurulmadan önce okumayı reddeder.

Yanıt veremeyen bir okuma sıfır olmayan bir kodla çıkar ve standart çıktıya hiçbir şey yazdırmaz. Aşağıdaki her hata, koşulunu ve bu konuda ne yapılacağını birlikte adlandırır; hiç erişilemeyen bir kayıt defteri, okumayı durduran ağ hatasıyla bildirilir:

Ne olduKoşul
Referans altında hiçbir şey yayımlanmamışE0137
Kayıt defteri kimlik bilgisini reddetti veya onun için hiçbiri saklanmamışE0138
Çalışma alanı çevrimdışıE0125
Yapıt, çıkarılamayan bir arşivE0300
Arşivin kökünde hiçbir varlık belgesi yokE0298
Arşivin kökünde birden fazla varlık belgesi varE0299
Belge, bir kayıt defterinin yayımladığı türden bir varlık değilE0301

Her kod hata başvurusunda listelenir. Hiçbir depo adlandırmayan ya da ne bir etiket ne de bir özet adlandıran bir referans, bunun yerine yazılması gereken biçim belirtilerek reddedilir. --ir-graph ve --closure, herhangi bir şey getirilmeden önce reddedilir, çünkü bir kayıt defterinin yayımladığı hiçbir tür bir Release değildir.

Kullanımdan kaldırma ve geri çekme bildirimleri

Bir yayımcı, bir yapıtı yayımladıktan sonra ona karşı, yayımlanan sürümün kullanımdan kaldırıldığını veya geri çekildiğini belirten bir işaret kaydedebilir. Katalog dalı bir varlığı çözümlediğinde inspect, bu tür her işareti varlığın kendi görünümünün altında bildirir — yalnızca bir Component için değil, adıyla çözümlediği her tür için.

Bildirim, yayımcının kaydettiği önem derecesini — warning, error veya retracted — işaretin kaydedildiği sürüm, gerekçe, belirtilmişse yerine geçen sürüm ve yayımlanma tarihiyle birlikte belirtir. Üç önem derecesinin tümü bildirilir. Bu, bir derlemenin neye çözümleneceğini değiştiren kümeden daha geniştir: retracted olarak işaretlenen bir sürüm sürüm seçiminin dışında tutulurken warning ve error yalnızca bilgilendirme amaçlıdır ve yine seçilir. inspect size bir yayımcının ne söylediğini gösterir; ne alacağınıza karar vermez.

Bildirim, varlığın çözümlendiği kayıt defterinin aggrega registry update tarafından oluşturulan yerel dizininden okunur — bu nedenle ağa ihtiyaç duymaz ve çevrimdışı bir çalışma alanında da çalışır. Dizin bir anlık görüntü olduğundan bildirim, bu anlık görüntünün ne zaman alındığını belirterek sona erer ve onu yenileyen komutu belirtir. Dizini oluşturulmamış bir çalışma alanı hiçbir şey bildirmez; dolayısıyla bildirimin olmaması “hiçbir şey kaydedilmemiş” değil, “bu anlık görüntüde hiçbir şey kaydedilmemiş” anlamına gelir.

Bir işaret, yalnızca kendi imzası kayıt defterinin güven politikasının kabul ettiği imzalayanlara karşı doğrulandığında bildirilir. İmzasız bir işaret veya imzası doğrulanmayan bir işaret bildirilmez: kimliği doğrulanamayan bir iddia gerçek olarak sunulmaz.

Bildirim, insan tarafından okunabilir görünümlere eşlik eder. Ne --output yaml ne de --ir-graph bir bildirim ekler; böylece bunlardan birini ayrıştıran bir tüketici yalnızca bir belge alır, başka hiçbir şey almaz.

Uygulamalı örnekler

Katalogda Component arama

$ aggrega inspect core/server:1.0.0 --catalog ./catalog
Component: core/server:1.0.0
Schema:
|
values: { port?: int | *8080 }
Uses sockets:
db: selector="component.aggrega.ai/type=stateful-server"

Varsayılan görünüm, Component’in bir açıklama tanımladığı yerde bu açıklamayı, ardından çözümlenmiş şemayı (varsa extends: birleştirmesinden sonra) ve bildirilen uses-soketlerini gösterir. Yukarıdaki Component hiçbir açıklama tanımlamaz; bu yüzden döküm doğrudan şemayla başlar. --detail, self-inject mekanizmalarını, gerekli Features’ı ve etiketleri ekler; --list yalnızca Component tanımlayıcısını ve soket adlarını gösterir.

Feature

$ aggrega inspect ./features/metrics.yaml
Feature: core/metrics:1.0.0
Schema:
|
values: { port?: int | *9090 }
Uses sockets:
backend: selector="component.aggrega.ai/type=stateful-server"
inject: [env]
Secret slots:
token (required)
Targeting:
appliesTo: component.aggrega.ai/type=server
Labels:
feature.aggrega.ai/category: observability

--show-implements ile Recipe

Bir Recipe’in varsayılan görünümü, bildirdiği her girdi modu için bir bölüm, yeteneğini ve değer eşlemesini gösterir. --show-implements, spec.implements başvurusunu kataloğa karşı çözümler ve bağlı Component’i, o Component’in gerektirdiği eklerle birlikte gösterir:

$ aggrega inspect ./recipes/api-server-recipe.yaml --show-implements --catalog ./catalog
Recipe: core/api-server-recipe:1.0.0
Implements: core/api-server:1.0.0
Capability: helm
## Synthesized
workload: inline
valuesMapping: (none)
Implements Component: core/api-server:1.0.0
requires attachment (observability): core/metrics

Birden çok girdi modu bildiren Recipe

Bir Recipe’in girdi modları toplama yoluyla birleşir: işlenecek bir source:, sentezlenecek bir workload: ve bir artifacts: eşlemesi her biri çıktıya katkıda bulunur ve bir Recipe bunların herhangi bir bileşimini bildirebilir. inspect, birini seçmek yerine Recipe’in bildirdiği her modu raporlar; böylece gördüğünüz, yazdığınız kümedir:

$ aggrega inspect ./recipes/api-server-composed.yaml
Recipe: core/api-server-composed:1.0.0
Implements: core/api-server:1.0.0
Capability: helm
## Sourced
source: oci://charts.example.com/api-server:2.1.0
## Synthesized
workload: inline
valuesMapping: inline template
Artifacts: 2
- servicemonitor.yaml
- networkpolicy.yaml

Bölümler source: → workload: → artifacts: sırasıyla dizilir; bu, bir derlemenin bir Recipe’i tek bir mod adına çözümlerken ve bildirilen hangi modu bağlı sağlayıcının karşılayamadığını raporlarken uyguladığı sırayla aynıdır. Böylece bu görünüm ile bir derlemenin tanılamaları modları aynı sırayla adlandırır. Ne source: ne de workload: bildiren bir Recipe yalnızca artifacts olarak raporlanır; görünümün tek bir mod adlandırdığı tek durum budur.

Manifest (varsayılan olarak çözümlenmiş)

$ aggrega inspect ./prod-manifest.yaml
Manifest: prod-manifest:1.0.0
Component Mappings:
Type → Recipe
core/compute/api-server helm-api-server-synthesized-with-artifacts:1.0.0
core/compute/web-ui helm-web-ui-synthesized-with-artifacts:1.0.0
core/datastore/postgres helm-postgres-synthesized-with-artifacts:1.0.0
Feature Mappings:
Type → FeatureRecipe
core/k8s-dns-resolver k8s-dns-patcher:1.0.0
Annotation Bindings:
(none)

Varsayılan görünüm, Manifest’in extends: zincirini uygular ve çözümlenmiş bileşen ve özellik eşlemelerini, ek açıklama bağlamalarıyla birlikte sunar. --raw, dosyayı extends çözümlemesinden önce, yazıldığı haliyle gösterir.

Aggregate (varsayılan olarak çözümlenmiş)

$ aggrega inspect ./fullstack-app.yaml
Aggregate: fullstack-app:1.0.0
Components:
backend (type: core/compute/api-server)
Values: (none)
Uses:
databases:
- data.main-db
frontend (type: core/compute/web-ui)
Values: (none)
Uses:
apis:
- my-api → backend
main-db (type: core/datastore/postgres)
Values:
database_name: app_production
Uses: (none)
Dependency Graph:
data.main-db
↑ backend
backend
↑ frontend

Varsayılan görünüm topolojiyi oluşturur ve her bileşeni değerleri ve uses-kenarlarıyla, ardından hesaplanan bağımlılık grafiğiyle gösterir. Alt sistem ağacı iç içe olarak gösterilir; --flat her düğüm için, her biri tam noktalı yoluyla anahtarlanmış bir bölüm gösterir.

Uzun biçimde yazılmış bir bağlantının ardından taşıdığı ekler gelir; her biri tüketen bileşende aldığı ad altında (bağlantının takma adı ile slotun bir noktayla birleşimi), adlandırdığı Feature türüyle ve doldurduğu slotu ve bildirilmiş hassas malzemeyi işleyip işlemediğini belirten bir ibareyle gösterilir:

gateway (type: conn/gateway)
Values:
region: eu
Uses:
models:
- gpt → model
- gpt.credential (feature.conn/token) [slot: credential, sensitive]

Slot ve işaret, bu Aggregate’i dağıtan bir Release’in derlemesinin ek için kaydettiği olgulardır ve Release görünümünün okuduğu şekilde okunur (bkz. Ek bağlantısı, slot ve hassasiyet ibaresi); soketin slot bildiriminden ve Feature’ın kendi bildiriminden gelirler, bu nedenle Aggregate’i hangi Release’in dağıttığına bağlı değildirler. Bir Aggregate hiçbir Manifest adlandırmaz; bu yüzden bir Release’in Manifest’inin ek için seçtiği gerçekleştirme burada gösterilmez. Bu görünüm bir bileşenin bağlantılarını ve bunların ne taşıdığını listeler; bir bileşenin kendi bloğundaki ekler Release görünümünde yer alır.

Release (varsayılan olarak çözümlenmiş)

Release görünümü, riski en yüksek incelemedir. Tam işlem hattını çalıştırır ve her sınır için her Component düğümünü, uses-kenarlarını ve o düğüme eklenmiş her Feature’ı (bir bağlantı üzerine yazılmış olanı o bağlantının kenarının altında) gösterir; her biri doldurduğu ek slotu, bildirilmiş hassas malzemeyi işleyip işlemediği ve onu gerçekleştiren FeatureRecipe ile birlikte, ekin nereden geldiğini ortaya koyan bir köken parantezi içerir:

$ aggrega inspect ./prod-release.yaml --catalog ./catalog
Release: prod-release:1.0.0
Boundary: backend-ns
Directory: ./dist/backend
Annotations (provider-consumed):
aggrega.ai/namespace: backend-zone
Component: backend (type: core/compute/api-server:1.0.0)
Uses:
data.main-db → data.main-db [cross-boundary]
Features: (none)
Boundary: frontend-ns
Directory: ./dist/frontend
Annotations (provider-consumed):
aggrega.ai/namespace: frontend-zone
Component: frontend (type: core/compute/web-ui:1.0.0)
Uses:
my-api → backend [cross-boundary]
Features:
- cross-namespace-routing (core/k8s-dns-resolver:1.0.0) [free, realization: k8s-dns-patcher:1.0.0] [explicit]
Boundary: data-ns
Directory: ./dist/data
Annotations (provider-consumed):
aggrega.ai/namespace: database-zone
Component: data.main-db (type: core/datastore/postgres:1.0.0)
Features: (none)

Her sınır, çıktı dizinini ve sağlayıcının tükettiği ek açıklamaları taşır; bir sınırın altındaki her bileşen Aggregate bileşen türünü, uses-kenarlarını (sınırlar arası kenarlar işaretli) ve her birinin ardından o bağlantının taşıdığı ekleri, ayrıca kendi Feature eklerini taşır; her ek, olgu ibaresi ve köken parantezi ile gösterilir. --flat, sınır ağacını her sınır için tam yoluyla anahtarlanmış bir bölüme indirger. --raw, Release dosyasını işlem hattı çalıştırmadan aynen çıktılar.

YAML çıktısı

$ aggrega inspect core/server:1.0.0 --output yaml --catalog ./catalog
apiVersion: aggrega.ai/v1beta1
kind: Component
metadata:
name: core/server
version: 1.0.0
labels:
component.aggrega.ai/type: server
spec:
usesSchema:
db:
selector: component.aggrega.ai/type=stateful-server
schema:
values:
port: {type: integer, default: 8080}

Katalogdan adıyla belirtilen bir Component, kataloğun çözümlediği varlık olarak yazdırılır; bu nedenle bir extends: birleştirmesinden sonra yazılan dosyayı değil, birleştirilmiş varlığı görürsünüz; bir Component dosyası ise yazıldığı gibi yazdırılır.

Makine tarafından okunabilir çıktı

İki bayrak makine tarafından okunabilir çıktı üretir ve farklı sorulara yanıt verir. --output, bu komutun zaten oluşturduğu belge için bir biçim seçer; --ir-graph ise ona ek olarak farklı bir belge ister: bir Release’in çözümlendiği derlenmiş grafik. Bunlar birbirinden bağımsızdır: ikisini birlikte vermek size grafiği ve yazıldığı hâliyle YAML’ı birer kez verir.

--output yaml, varlığı yazıldığı hâliyle, borulamaya ve fark almaya uygun biçimde yayar. Bu çıktı birebirdir ve bir yazarın hassas olarak bildirdiği değerleri de içerir: girdiyi yeniden ürettiğini öne süren bir çıktı, onun bir kısmını saklayıp hâlâ yeniden üretiyor olamaz. Bu çıktıyı, geldiği varlık dosyasını nasıl borulayıp saklayıp paylaşıyorsanız öyle borulayın, saklayın ve paylaşın.

Derlenmiş grafik: --ir-graph

aggrega inspect <release> --ir-graph, çalıştırmanın çözümlendiği grafiği, komutun her durumda oluşturduğu görünümden önce, JSON olarak standart çıktıya yazar. Tek bir JSON belgesi ve sonda tek bir yeni satır vardır; böylece akışı çözen bir tüketici grafiği okur ve durur.

Bu, bir grafiğe çözümlenen tek tür olan Release için geçerlidir. Başka bir tür için ya da adıyla bir katalog varlığı için istendiğinde komut, o varlığın kendi görünümünü oluşturup isteği sessizce düşürmek yerine reddeder ve bunu belirtir.

Derleyicinin denetimlerinin reddettiği bir bileşim grafik üretmez. Hata davranışı altında anlatılan ret, bu akışa herhangi bir şey yazılmadan önce gerçekleşir; bu nedenle akışı okuyan bir işlem hattı, aynı belgelerin bir derlemesinin reddedeceği bir grafiği hiçbir zaman almaz: bir derlemenin raporlayacağı bulguların aynısını ve sıfır olmayan bir çıkış kodunu alır.

Aynı bayrak, aynı anlamla aggrega build ve aggrega validate komutlarında da bulunur: her biri, o komutun ürettiği diğer her şeye ek olarak, o çalıştırmanın hesapladığı grafiği geri verir. Bir düzenleyici entegrasyonu aynı grafiği arka plan hizmetinin protokolü üzerinden okur.

--output yaml grafiği yaymaz. Diğer her türde yaptığı gibi, yazılmış Release’i aynen yeniden üretir. Grafiği isteyen bir işlem hattı onu bunun yerine --ir-graph üzerinden okur ve YAML yerine JSON alır.

Grafik değerleri saklar. Grafik kimsenin yazdığı bir dosya değildir; derlemenin Aggregate’ten, Release’ten ve katalogdan hesapladığı şeydir. Bu nedenle korunacak bir yazıldığı hâliyle sözleşmesi yoktur ve okunabilir düzenleri yöneten bildirimler onu da yönetir. Grafiğin bir yazarın hassas olarak bildirdiği bir yaprağı taşıdığı her yerde değer, onu saklanmış olarak adlandıran tek anahtarlı bir nesneyle değiştirilir:

"values": {
"secretName": "db-creds",
"vault": {
"token": { "aggrega_withheld": "declared" }
}
}

Anahtar korunur; böylece grafik, bir düğümün ve eklerinin hangi yaprakları taşıdığını hâlâ yanıtlar; yalnızca değer kaybolur. Aynı yükteki bildirilmemiş bir kardeş öğe yazıldığı hâliyle yayılır: yukarıdaki secretName, yazarının bildirilmemiş bıraktığı genel bir konum belirleyicidir ve yazdırılır. İşaretçiye eşlik eden neden, değerin neden bulunmadığını söyler: bir bildirimin kapsadığı bir yaprak için declared, yükün bu komutun okuyamadığı bir biçimde geldiği durumlarda ise unreadable; bu son durumda yükün herhangi bir kısmı tahmin edilmek yerine yükün tamamı saklanır.

Bir bağlantının kendi yapılandırması da aynı şekilde gizlenir. Bir Aggregate’in bir uses girdisine yazdığı bağlantı başına values ve bir Release’in ona yazdığı bağlantı başına infra, hiçbir zaman hedefin bildirimleri tarafından değil, tüketen bileşenin soketi tarafından — onun bildirdiği valueSchema ve infraSchema, yani bu yapılandırmanın doğrulandığı sözleşmeler tarafından — yönetilir. Sözleşmelerden herhangi birinin sensitive: true olarak bildirdiği bir yaprak, kenarın values ve infra alanlarında ve değerleri yazarın yazdığı gibi taşıyan tüketen düğümün uses girdisinde işaretçiyle değiştirilir; her kenar gizlediği yaprakları, bir düğümün kendi yaprakları için kullandığı alan olan sensitive_payload_leaves altında listeler. Soketi onu okunabilir olarak bildiren bir bağlantıdaki aynı adlı bir yaprak yazıldığı gibi çıkarılır.

Bir işlem hattının değerlere gerçekten ihtiyaç duyduğu yerde --unredacted verin ve ürettiği şeyi varlık dosyalarının kendisine davrandığınız gibi ele alın. aggrega build ve aggrega validate, aynı bayrağı --ir-graph ile birlikte aynı koşullarda alır: geri verdikleri grafik, bu bayrak verilmedikçe değerleri saklar.

Arka plan hizmetinin protokolü aynı grafiği aynı kural altında verir. aggrega/irGraph bu değerleri saklanmış olarak yanıtlar ve onları açık olarak yalnızca unredacted alanını (protokolün bu bayrak için kullandığı yazım) ayarlayan bir isteğe döndürür. Böylece bir düzenleyici panelinin çizdiği şey aynı bildirimleri izler ve değerleri gösteren bir istemci bunu onları istediği için yapar.

Bağımlılık kapanışı: --closure

aggrega inspect <release> --closure, Release’in bağımlılık kapanışını raporlar: ulaştığı her katalog varlığını, her birinin çözümlendiği sürümle birlikte; ayrıca iki işaretçisinin çözümlendiği Aggregate ve Manifest kimliklerini ve bu varlıkların yararlandığı paylaşılan belgeleri. Hiçbir şey işlenmez ve hiçbir yapıt üretilmez: kapanış derlenmez, çözümlenir; bu nedenle onu yanıtlamak için hiçbir sağlayıcı yüklenmez.

Kapanış ve çözümlenmiş görünüm farklı belgelerdir ve hiçbiri diğerinden elde edilemez. Çözümlenmiş görünüm (bu komutun bir Release için varsayılan olarak işlediği şey) dağıtımın neye benzediğini söyler: sınırlarını, bileşen düğümlerini, neyin neye bağlandığını ve her düğüme neyin eklendiğini. Kapanış ise onu derlemek için nelerin ve hangi sürümlerde çekildiğini söyler. Bir varlığa, hiçbir zaman düğüm olarak görünmeden ulaşılabilir: bir Manifest’in bir bileşen türünü eşlediği Recipe’e her derlemede ulaşılır, ancak hiçbirinde düğüm değildir. Bir düğüm de bildirildiği bileşen türünü kaydeder, o türün çözümlendiği sürümü değil. Dolayısıyla “bu sürüm neden değişti?”, “bu paylaşılan belgeyi değiştirmek neyi etkiler?” ya da “bu dağıtım gerçekte neye bağlı?” diye soran bir okuyucu kapanışı istemektedir; çözümlenmiş görünüme sahip bir okuyucu, onu daha dikkatli okuyarak bu bilgiye ulaşamaz.

Aynı sözcük her yüzeyde aynı belgeyi ister. Buradaki --closure, daemon protokolü üzerinden aggrega/releaseClosure (aggrega serve “Kapanış, grafik değildir” bölümüne bakın) ve asistan araç protokolü üzerinden describe aracının release kipi, bir Release hakkındaki bu soruyu yanıtlar; bunların herhangi biri üzerinden verilen bir Release adı aynı çözümlemeye ulaşır, bu nedenle üçü bir Release’in neye bağlı olduğu konusunda farklı sonuçlara varamaz. Release’in çözümlendiği şeyle artık eşleşmeyen bir lockfile karşısında bu komut ve describe aracı, build’in sapma durdurmasıyla reddeder; bir düzenleyiciye o düzenleme yaparken hizmet eden daemon ise yanıt verir.

Tek bir belgedir, bu nedenle tek başına istenir. --closure, çözümlenmiş görünüm yerine kapanışı seçer ve --raw, --resolved, --output ya da --ir-graph ile birlikte kullanılamaz: bunların her biri aynı Release hakkında farklı bir belge ister ve iki isteği kabul eden bir komut bunlardan birini sessizce yanıtlamak zorunda kalırdı. Birlikte kullanılmaları, çift adlandırılarak reddedilir.

Yalnızca bir Release’e uygulanır. Bir katalog varlığı, bir Aggregate dosyası, bir Manifest: bunların hiçbiri bir kapanış çözümlemez, bu nedenle istek, o öznenin kendi görünümü işlenip istek bırakılarak yanıtlanmaz, reddedilir. Bırakılan bir istek, çağırana tam olarak kapanışı boş olan bir özne gibi görünür.

Her sonuç birbirinden ayrılır. Çözümlenen bir Release, listeyle yanıtlanır. Hiçbir dosyayı adlandırmayan bir Release yolu, dosyanın orada olmadığı belirtilerek reddedilir. Var olan ancak kapanışı çözümlenemeyen bir Release, neyin çözümlenemediği ve başvurunun nereden geldiği belirtilerek reddedilir; ardından katalog yüklemesinin reddettiği dosyalar gelir, çünkü reddedilen bir dosya, Release’in ulaştığı bir varlığın eksik olmasının olağan nedenidir. Release’in yanında var olan ancak okunamayan bir eklenti güven kaydı, neyin okunamadığı belirtilerek reddedilir; çünkü onu atlayan bir liste, hiçbirinin denetlenemediği yerde geri çekilmiş hiçbir eklenti olmadığını raporlardı. Lockfile’ı artık çözümlendiği şeyle eşleşmeyen bir Release, Hata davranışı bölümünün açıkladığı gibi bir build’in yazdırdığı sapma durdurmasıyla reddedilir; çünkü listelenen sürümler, o Release’in hiçbir build’inin kullanmadığı sürümler olurdu. Bunlardan hiçbirinin yanıtı boş bir liste değildir: boş liste, yanlış yazılmış bir yolu ya da bozuk bir çalışma alanını hiçbir şeye bağlı olmayan bir Release olarak raporlardı.

Üç ayrıntı düzeyi, her türde olduğu gibi uygulanır. --list, yönlendirme için yalnızca başvuruları, satır başına bir tane olacak şekilde yazdırır. Varsayılan düzey; çözümlenmiş kimlikleri, her başvurunun çözümlendiği sürümü, yararlanılan paylaşılan belgeleri, hedefi eşlendiği türü uygulamayan Manifest eşlemelerini ve Release’in bağımlı olduğu şeylere karşı — kilit dosyasında sabitlenmiş bir başvuruya karşı, yanındaki eklenti güven kaydında ise kabul ya da ret kararı döndüren bir rolde eklenmiş bir eklentiye karşı — kaydedilmiş kullanımdan kaldırma ya da geri çekme bildirimlerini, aggrega build komutunun aynı işaret için yazdırdığı sözcüklerle ekler. --detail, başvuru konumunun bir tür kaydettiği yerlerde her başvurunun türünü ekler: bir belgedeki bazı konumlar neyi işaret ettiklerini söyler, bazıları söylemez; bu nedenle tür, adın biçiminden tahmin edilmez, bilindiği yerde raporlanır.

$ aggrega inspect ./release.yaml --catalog ./catalog --closure
Release: prod-release:1.0.0
Aggregate: fullstack-app
Manifest: prod-manifest
Environment: production
Entities (11):
./aggregate.yaml
./manifest.yaml
core/compute/api-server (1.0.0)
core/compute/web-ui (1.0.0)
core/datastore/postgres (1.0.0)
core/k8s-dns-resolver (1.0.0)
db-module (1.0.0)
helm-api-server-synthesized-with-artifacts:1.0.0 (1.0.0)
helm-postgres-synthesized-with-artifacts:1.0.0 (1.0.0)
helm-web-ui-synthesized-with-artifacts:1.0.0 (1.0.0)
k8s-dns-patcher:1.0.0 (1.0.0)

Bir çalışma alanı bir Release’in hangi sürümlere çözümlendiğini kaydetmişse, bu kayıt çözümlemenin başlangıcını oluşturur; böylece raporlanan sürümler, kataloğun bugün içerdiği sürümler değil, bu dağıtımın derlendiği sürümler olur. Böyle bir kaydı olmayan bir çalışma alanı, kataloğun mevcut hâli üzerinden çözümlenir.

Ek bağlantısı, yuva ve hassasiyet ibaresi

Release görünümündeki her Feature eki, derleyicinin ekin kendisi hakkında kaydettiği olguları adlandıran bir ibare taşır: hangi ek yuvasını doldurduğu, beyan edilmiş hassas malzemeyi işleyip işlemediği ve onu gerçekleştiren FeatureRecipe; bileşenin bağlantılarından birine yazılmış bir ek için ise üzerine yazıldığı bağlantı. İbare, ekin adı ile köken parantezi arasında yer alır ve aşağıdaki her iki köken biçiminde de aynı şekilde okunur.

Bir bağlantıya yazılmış ek, Features: altında değil, Uses: içindeki o bağlantının satırının altında listelenir; böylece Features: yalnızca bileşenin kendi eklerini tutar. Üstündeki satır bağlantıyı takma adıyla ve ulaştığı bileşenle adlandırır; geri kalanını ekin kendi ibaresi söyler:

  • [socket: <socket>] — bağlantının üzerinden kablolandığı, bağlantı satırının adlandırmadığı soket. İbarenin başında yer alır, çünkü geri kalanının nasıl okunacağını değiştirir: ardından gelen yuva yarısı, bileşenin kendi ekleri için beyan ettiği bir yuvayı değil, bağlantının soketinin beyan ettiği bir yuvayı adlandırır.
  • [connection: <alias> through socket <socket>] — Uses: bloğunun bağlantısı için satır göstermediği bir ekle ilgili aynı olgu; bu ek bu durumda Features: altında listelenir ve bağlantısını bunun yerine burada adlandırır. Her iki durumda da bir bağlantı ek başına bir kez adlandırılır, asla iki kez değil.
  • [slot: <name>] — ek, <name> adlı yuvayı doldurur. Bir yuva, bir Feature’ın yuvanın kendi adı altında eklenmesiyle doldurulur; dolayısıyla <name>, ekin altında yazıldığı addır ve beyan edilmiş yuvalarla eşleştirilir: kendi eklerinden biri için ana Component’in featuresSchema’sı, bir bağlantıya yazılmış ek için ise bağlantının soketinin beyan ettiği featuresSchema.
  • [free] — ek, beyan edilmiş hiçbir yuvayı doldurmaz: çözümlenen Component o adda bir featuresSchema yuvası beyan etmez. Bu bir tanılama değil, bir bulgudur. Serbest biçimli bir ek kabul edilir; bunu yasaklamak isteyen bir operatör, aracın reddetmesine güvenmek yerine bunu bir yönetişim politikası olarak ifade eder.
  • [sensitive] — ek, bir yazarın hassas olarak beyan ettiği malzemeyi işler; çünkü eklenen Feature hassas bir yaprak beyan eder, çünkü doldurduğu yuva sensitive: true beyan eder ya da her ikisi.
  • [realization: <name>:<version>] — Release’in Manifest’inin ek için bağladığı FeatureRecipe: Manifest o adı eşliyorsa ekin kendi adıyla (bir bağlantıya yazılmış ek için, nokta ile birleştirilmiş takma ad ve yuva), aksi halde Feature türüyle. Aynı belgelerin bir derlemesinin eki işlerken kullandığı gerçekleştirme budur ve derlenmiş grafiğin ek üzerinde realization olarak taşıdığı değerle aynıdır (bkz. --ir-graph); dolayısıyla bu görünüm ile grafik farklı gerçekleştirmeler adlandıramaz. İbarede en son gelir.

Birden fazla olgu geçerli olduğunda tek bir ibareyi paylaşırlar. core/storage/s3-object-store, sensitive: true olarak işaretlenmiş bir secret_access_key yuvası beyan eder; bu nedenle o ad altında eklenen bir kimlik bilgisi her iki olguyu da bildirirken, Component’in yuva beyan etmediği bir ad altında eklenen bir Feature ne yuva ne de hassasiyet bildirir. Her Feature türünü bir FeatureRecipe’e eşleyen bir Manifest ile her satır ayrıca gerçekleştirmesini de adlandırır:

Features:
- secret_access_key (core/generated-secret:1.0.0) [slot: secret_access_key, sensitive, realization: generated-secret:1.0.0] [explicit]
- cross-namespace-routing (core/k8s-dns-resolver:1.0.0) [free, realization: k8s-dns-patcher:1.0.0] [explicit]

models soketi sensitive: true olarak işaretlenmiş bir credential yuvası beyan eden ve bu yuvayı dolduran bir bağlantıyı gpt takma adı altında kablolayan bir bileşen, o eki bağlantının altında listeler; Features: altında kalan kendi kimlik bilgisinin yanında:

Uses:
gpt → model
- gpt.credential (feature.conn/token:1.0.0) [socket: models, slot: credential, sensitive, realization: conn-token-compose:1.0.0] [explicit]
Features:
- db_password (feature.conn/token:1.0.0) [slot: db_password, sensitive, realization: conn-token-compose:1.0.0] [explicit]

Bir bağlantıya yazılmış ek asla [free] bildirmez: bir soket yalnızca beyan ettiği yuvaları kabul eder ve başka bir ad taşıyan bağlantı, derleme yüklenirken reddedilir.

Olguların hiçbiri geçerli olmadığında ibare tamamen atlanır ve her yarı bağımsız olarak atlanır:

  • Soket ya da bağlantı yarısının olmaması, ekin bileşenin kendi bloğuna yazıldığı ya da bileşene daha geniş bir kapsamdan veya ek açıklama güdümlü genişletmeyle ulaştığı anlamına gelir.
  • Yuva yarısının olmaması, ana Component’in beyan edilmiş yuva kümesinin çözümlenemediği anlamına gelir; örneğin türü hiçbir katalog varlığıyla eşleşmiyordur. Bu, kasıtlı olarak [free]’den farklıdır: [free] “o adda bir yuva beyan edilmemiş” yanıtını verirken, eksik bir yarı sorunun hiç yanıtlanamadığı anlamına gelir.
  • sensitive olmaması, hiçbir beyanın eki işaretlemediğini kaydeder. Bu, ekin gizli hiçbir şey taşımadığı yargısından daha dardır; eksen beyanları bildirir ve bir alanın adından ya da değerinden hiçbir çıkarım yapılmaz.
  • Gerçekleştirme yarısının olmaması, Manifest’in eki kataloğun tuttuğu hiçbir FeatureRecipe’e bağlamadığı anlamına gelir.

Beyan edilmiş adı harfiyen free olan bir yuva da [free] olarak işlenir ve serbest biçimli bir ekten ayırt edilemez; yuva ad alanında hiçbir şey bu sözcüğü ayırmaz.

IR köken parantezi dilbilgisi

Release görünümündeki her Feature eklentisi bir köken parantezi taşır. Parantez kompakt biçimde (eklentinin kökeni tüm yapraklarda tekdüze olduğunda Feature başına bir parantez) ya da yaprak başına biçimde (eklentinin yaprakları farklı kaynaklardan geldiğinde yaprak başına bir parantez) olabilir. Üç parantez gövdesi vardır; her iki biçime de aynı şekilde uygulanırlar.

Üç parantez gövdesi

  • [explicit] — Feature eklentisi yazar tarafından bildirilmiştir. Aggregate ya da Release, Feature’ı etkilenen düğümde açıkça adlandırmıştır. Açık eklentiler en yüksek öncelikli kaynaktır; aynı yaprakta açıklama güdümlü katkılara karşı her zaman kazanırlar.

  • [annotation: <key> from <source>] — Feature eklentisi açıklama güdümlüdür. Derleyici onu, <source> üzerindeki bir açıklama bu Feature’ı bildiren bir Manifest bağlamasıyla eşleştiği için sentezlemiştir. <key>, bağlamayı tetikleyen açıklama anahtarıdır (örneğin business.aggrega.ai/team); <source> ise açıklamayı taşıyan varlıktır (aggregate, release, component veya manifest). Sentezlenen eklenti yapısal olarak açık bir eklentiyle aynıdır — sonraki işleme ikisini de aynı şekilde ele alır — ancak köken parantezi, hata ayıklamanın belirlenebilir kalması için onları ayırt eder.

  • [explicit; overrides annotation: <key> from <source>] — bir yaprakta açık bir yazar bildirimi, aksi hâlde aynı yaprağı ayarlayacak bir açıklama katkısını bastırdığında devreye giren yaprak başına biçimdir. Bu durumu taraflar arası birleştirme üretir: bir Aggregate açıklaması bir Feature’ın values: sütununu sağlayabilir, bir Release açıklaması onun infra: sütununu sağlar ve aynı Feature üzerindeki açık bir Release bildirimi bir infra yaprağını geçersiz kılar. Yaprak parantezi hem açık yazarı hem de bastırılan açıklamayı kaydeder; bastırılan açıklama işlenen çıktıya katkıda bulunmaz, ancak operatörün hangi açıklamanın nerede geçersiz kılındığını görebilmesi için varlığı inspect görünümünde yer alır.

Kompakt biçim ve yaprak başına biçim

Derleyici, eklentinin yaprak başına kökenini dolaşıp tekdüzeliği denetleyerek kompakt ve yaprak başına gösterim arasında seçim yapar. Bir eklentinin kökeni, doldurulmuş her yaprak (Feature’ın values: ve infra: sütunları genelinde) aynı kökeni (açık ya da açıklama), açıklama güdümlüyse aynı açıklama anahtarını ve aynı kaynak varlığı paylaştığında ve hiçbir yaprak “overrides annotation” işaretçisi taşımadığında tekdüzedir. Köken tekdüze olduğunda derleyici eklenti başına bir parantez yayar:

- core/rate-limiter [annotation: business.aggrega.ai/team from aggregate]

Köken ayrıştığında — tipik bir örnek, aynı Feature üzerinde bir Aggregate açıklamasının values:, bir Release açıklamasının da infra: sağladığı taraflar arası birleştirmedir — derleyici doldurulmuş yaprak başına bir parantez yayar:

- core/pii-redaction
values.fields_to_mask: ["ssn", "card_number"] [annotation: compliance.aggrega.ai/data-class from aggregate]
values.classifier_endpoint: "redact-v2" [explicit; overrides annotation: compliance.aggrega.ai/data-class from aggregate]
infra.audit_bucket: "s3://..." [annotation: compliance.aggrega.ai/audit-bucket from release]

Dolaşma sırası önce values sütunu (yazar sırasıyla), ardından infra sütunudur (aynı düzenle). Sütun öneki (values. / infra.) ve sütun içindeki noktalı yol, her parantezin hangi yaprağı açıkladığını tam olarak belirtir.

Hassas olarak bildirilen değerler

Şeması sensitive: true bildiren bir yaprak, değerinin yerine sabit <redacted> metnini yazdırır. Anahtar, sütun öneki ve köken parantezi korunur — yalnızca değer değiştirilir — böylece düzen, bir varlığın hangi yaprakları taşıdığını ve her birinin nereden geldiğini yine yanıtlar. Okunabilir iki yüzey bundan etkilenir: bir Aggregate’in düğüm başına Values: bloğu ve çözümlenmiş bir Release’in yaprak başına ek bloğu — buna bir bağlantı üzerine yazılmış ve o bağlantının satırının altında yazdırılan ek de dahildir; bu ek, aynı Feature’ın, bileşen onu kendisi taşıdığında gizlediği yaprakların tam olarak aynısını gizler. Bir Release’in --ir-graph altındaki derlenmiş grafiği aynı yaprakları Makine tarafından okunabilir çıktı bölümünde açıklanan yapılandırılmış biçimde gizler.

Components:
app (type: core/app)
Values:
appName: demo
dbPassword: <redacted>
tuning.poolSize: 25
tuning.adminToken: <redacted>

Yalnızca bildirilmiş bir yaprak gizlenir; ek düzeyindeki [sensitive] ifadesi bir gizleme talimatı değildir: ekin gizli malzeme işlediğini söyler, yapraklarından hangisinin onu taşıdığını değil. Bir kimlik bilgisi Feature’ının yayımlanan konum belirleyicileri — kaynak adı ve veri anahtarı — herkese açıktır ve standart kütüphane kataloğunda bilinçli olarak bildirilmeden bırakılmıştır; bu nedenle gizli olmayan bu bilgiler, gizli malzemenin yanında açık olarak yazdırılır:

- credentials (feature.test/db-credential)
values.secretName: db-creds [explicit]
values.literalPassword: <redacted> [annotation: feature.test/pw from aggregate.yaml:components.app.annotations.feature.test/pw]

Bir alanın adından hiçbir çıkarım yapılmaz: hiçbir bildirim taşımayan password adlı bir alan değerini yazdırır, bildirilmiş key adlı bir alan ise yazdırmaz. Gizleme, aracın yazdırdıklarını kapsar; işlenmiş bir yapıta hiçbir zaman ulaşmaz ve dist/, işleme sürecinin ürettiği haliyle tam olarak yayımlanır. Anahtar sözcük ve onu bildirmenin sağladıklarının tam sınırı vocabulary/compact-form-authoring.md içindeki “Declaring a leaf sensitive” bölümündedir.

Gizlenen değerleri gösterme

--unredacted, hassas olarak bildirilen değerleri gizlemek yerine, tüm inspect yüzeylerinde aynı anda yazdırır — yukarıdaki okunabilir düzenlerde de, bir Release’in derlenmiş grafiğinde de. Bu bayrak, gizlenen değer bazen tam da incelenen değer olduğu için vardır: yanlış ekten gelen bir kimlik bilgisi, ikisi de gizli olarak okunduğunda doğru olanla aynı görünür.

Kapsamı, iletildiği komutla sınırlıdır. aggrega build ve aggrega validate da bu bayrağı alır; orada yalnızca --ir-graph’ın geri verdiği grafiğe ulaşır, başka hiçbir şeye ulaşmaz ve hiçbir grafik istenmediğinde reddedilir. aggrega build --trace-unredacted, aynı fikrin derlemenin iz dosyalarına uygulanmasıdır ve derlemenin bu iki bayrağından hiçbiri diğerinin çıktısına ulaşmaz; dist/ altındaki işlenmiş bir yapıt bunların hiçbirinden etkilenmez, çünkü ne iletilirse iletilsin işleme sürecinin ürettiği haliyle tam olarak yayımlanır.

Bu durumda çıktının ulaştığı her yer — bir terminal, bir boru, bir dosya, bir ekran kaydı, yapıştırılmış bir hata raporu — bu değerleri açık olarak taşır. Her biri gizlenmeden yakalandığını belirten bir üst bilgiyle açılan iz dosyalarının aksine, terminaldeki çıktı böyle bir işaret taşımaz: bayrağın iletildiğini yalnızca komut satırı gösterir.

inspect ne zaman kullanılmalı

  • “Bu Feature neden burada?” sorusunda hata ayıklama — açıklama (annotation) güdümlü eklemeler Aggregate ve Release YAML dosyalarında görünmez (açıklamalar oradadır, ancak onların sentezlediği Feature eklemeleri yalnızca IR’da yaşar). Inspect bunları kökenleriyle birlikte gösterir.
  • Şema kalıtımını doğrulama — aggrega inspect <ComponentName>, extends: zinciri çözümlendikten sonraki birleştirilmiş şemayı gösterir; yazılan dosya tek başına yalnızca yerel farkı gösterir.
  • Taraflar arası birleştirme sürprizlerini teşhis etme — bir Aggregate açıklaması ve bir Release açıklamasının ikisi de aynı Feature üzerinde sütun yükleri sağladığında, çözümlenmiş yaprakları zihinde yeniden kurmak kafa karıştırıcı olabilir. Yaprak başına köşeli parantez biçimi çözümlemeyi açık hâle getirir.
  • Dağıtım öncesi doğrulama denetimi — aggrega inspect ./prod-release.yaml, aggrega build yapıtları üretmeden önce her Component üzerindeki her Feature’ı listeler; operatör, işlenmiş manifestleri GitOps’a göndermeden önce topolojinin amaca uyduğunu doğrulayabilir.

Altta yatan mekanizmalar için — açıklamaların nasıl aşağı aktarıldığı, taraf-sütun bölümlemesinin açıklama değerlerini Feature sütunlarına nasıl yönlendirdiği ve açık-ekleme-kazanır disiplininin açıklama güdümlü katkılarla nasıl etkileştiği — bkz. providers/well-known-annotations.md ve entities/manifest.md “Annotation-Driven Feature Bindings”.

Kullanım

aggrega inspect [identifier] [flags]

Açıklama

Render a readable view of any Aggrega entity — a catalog entity by name, an
authored entity file by path, an entity published in a registry, or a
fully-resolved Release.
It answers "what does this entity actually resolve to?": which entities extend
which bases, which Recipe maps to each type, which Features attach to each node,
and where each Feature's contributions came from.
A single argument routes by its shape. A path — anything starting with ./, ../
or /, or ending in .yaml or .yml — is read as a file and inspected by its own
kind: header. A registry reference — oci://<host>/<repository>:<tag>, or
@<digest> in place of :<tag> — is read from the registry that publishes it.
Anything else is looked up by name in the catalog search stack: the
workspace's own, or, with --release, the one the workspace configuration
gives that Release, so a name several catalog variants declare, one per
Release, resolves to the variant that Release builds with.
A registry reference shows the entity exactly as it was published: unpacked
from the archive its kind is published as where it is one, and rendered by the
same view a file of that kind gets. Reading it reaches the network, using the
credentials this machine holds for that registry, and an offline workspace
refuses it. The fetched bytes are checked against the digest the artifact's
own manifest records for them, which establishes that they are the bytes that
manifest names and nothing more: no signature attached to the artifact is
verified, no withdrawal recorded against it is reported, and nothing is
written — no cache entry and no lockfile.
Three verbosity levels apply to every kind: --list for identifiers only, the
default for a structured overview, and --detail for full field bodies. --list
and --detail are mutually exclusive. Resolution depth has its own pair, --raw
for the entity exactly as authored and --resolved for the kind's full depth,
also mutually exclusive.
Note that --raw reproduces the file as written, so a value the author declared
sensitive appears as authored. That is what as-authored means; handle such
output as you would the entity file itself. --output yaml reproduces the file
the same way for every kind, a Release included.
A Release answers two further questions, and each has its own flag because
neither answer contains the other. --ir-graph asks for the IR graph a Release
resolves to — what the Release looks like, as JSON on stdout in addition to
whatever else this command produces. --closure asks for the Release's dependency
closure — every catalog entity it reaches and the version each resolved to,
which is what was pulled in to build the Release. An entity can be reached
without appearing as a node, and a node does not carry the version its type
resolved to, so holding one of the two is not holding the other.
--ir-graph is orthogonal to --output, which picks the format of the command's
own view. Values an author declared sensitive are withheld from the graph, as
they are from the readable layouts. Pass --unredacted to print them instead.

Bayraklar

BayrakVarsayılanAçı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.
--closurefalseÇözümlenmiş düğüm görünümü yerine Release’in bağımlılık kapanışını — eriştiği her katalog varlığını, her birinin çözümlendiği sürümle — raporlar. Bir kapanış çözümleyen tek tür olan Release’e uygulanır; başka herhangi bir tür isteği sessizce yok saymak yerine reddeder.
--colorautoÇıktıyı renklendir: auto|always|never.
--detailfalseAlan gövdelerini tam olarak işle.
--flatfalseAğaç biçimli bir varlığı (Aggregate, Release) düz bir liste olarak işler; her düğümün önüne tam noktalı yolu eklenir. Tablo biçimli türlerde etkisi yoktur.
--ir-graphfalseBu komutun zaten ürettiği her şeye ek olarak, bu çalıştırmanın hesapladığı IR grafiğini JSON olarak stdout’a da yazar. Bir yazarın hassas olarak bildirdiği değerler ondan gizlenir; bunun yerine onları yazdırmak için —unredacted verin. Bir grafiğe çözümlenen tek tür olan Release’e uygulanır; başka herhangi bir tür isteği sessizce yok saymak yerine reddeder
--listfalseYalnızca tanımlayıcıları işle.
--no-colorfalseRenkli çıktıyı devre dışı bırak (—color=never için takma ad).
--output, -otextÇıktı biçimi: text|yaml.
--plugin—Ham bir <file.wasm> yapıtının dosya sistemi yolu; aggrega plugin sync bunları bir Plugin varlığına kaydetmeden önce, içe aktardığı ana makine işlevlerini türetir ve yazdırır. Tanımlayıcı bağımsız değişkeni almaz.
--rawfalseVarlığı çözümleme yapmadan, yazıldığı gibi işle.
--release—Bir katalog adını bu Release dosyasının koşullarında arar: çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri üzerinden, başına —catalog eklenerek. Bir ada uygulanır; bir dosya veya kayıt defteri başvurusu olduğu gibi incelenir ve bunu reddeder. 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. O 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
--resolvedfalseVarlığı tamamen çözümlenmiş olarak işle.
--show-implementsfalseBir Recipe veya FeatureRecipe için spec.implements’i kataloğa karşı çözümler ve bağlı Component’i veya Feature’ı işler.
--unredactedfalseBir yazarın hassas olarak bildirdiği değerleri gizlemek yerine yazdırır. Çıktının ulaştığı her şey — bir terminal, bir boru hattı, bir dosya, bir ekran kaydı — bu değerleri açık olarak taşır.