aggrega cache
Disk üzerindeki önbellekleri inceler ve bakımını yapar
Kullanım
aggrega cacheAçıklama
Inspect and maintain the caches the compiler populates.
status lists cache contents, one element per line, then a summary line.prune reclaims artifact-cache entries no workspace lockfile references.evict trims the compiled-module cache to a size cap, oldest first.clear wipes every cache, including the compiled-module store.Alt komutlar
| Komut | Açıklama |
|---|---|
aggrega cache clear | Derlenmiş modüller dahil tüm önbellekleri siler |
aggrega cache evict | Derlenmiş modül önbelleğini, en eskiden başlayarak bir boyut sınırına indirir |
aggrega cache prune | Hiçbir kilit dosyasının başvurmadığı yapıt önbelleği girdilerini kaldırır |
aggrega cache status | Önbellek içeriğini ve toplam bir özeti listeler |
aggrega cache clear açıklaması
Wipe every cache: the workspace artifact cache (entities, source artifacts,external inputs) and the caches every project on the machine shares (compiledmodules, plugin descriptors, documentation bundles, and the cli plugins addedwhere no workspace was found). This is the total-wipe verb; unlike prune itreclaims the compiled-module cache and the documentation bundles as well.Cleared caches repopulate on the next build, and the documentation bundle onthe next read of the documentation; a cli plugin cleared from the cache isfetched again by adding it again.
Because the wipe is irreversible, clear asks for confirmation before removinganything. Pass --yes to skip the prompt for non-interactive use; without --yeson a non-interactive stdin it refuses rather than blocking on a prompt no onecan answer.aggrega cache clear bayrakları
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--yes | false | onay istemini atlar (etkileşimsiz/CI kullanımı için) |
aggrega cache evict açıklaması
Trim the compiled-module cache to a size cap by removing theleast-recently-compiled modules first, until the cache total is at or below--max-size. The compiled-module cache is machine-global: every provider guest iscompiled once and reused across every project on the machine, so over time it candominate on-disk cache use.
Unlike prune (which reclaims artifact-cache entries no lockfile references) andclear (which wipes every cache), evict is size-bounded and touches only thecompiled-module cache. Evicted modules recompile on demand on the next build, soeviction loses no irrecoverable state.
--max-size is required and accepts a binary-unit size in the same vocabulary thestatus summary prints — for example 5GiB, "4.5 GiB", or 512MiB — or a bareinteger byte count. The unit suffix is case-insensitive and an optional spacemay separate the number from the unit.
This verb is the on-demand trim, at a cap you give it once. The cache is alsoheld to a standing cap without being asked: every invocation that loads a pluginapplies the `compiled_module_cache.max_bytes` setting (53687091200 bytes, 50 GiB,by default) before it compiles anything, using this same removal order. Use thisverb to reclaim space now or below the standing cap; change the setting to movethe standing cap itself. When the cache already fits the cap, evict reports ano-op and removes nothing.aggrega cache evict bayrakları
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--max-size | — | derlenmiş modül önbelleği için boyut sınırı (ör. 5GiB, 512MiB veya bir bayt sayısı); zorunlu |
aggrega cache prune açıklaması
Remove cache entries whose content digest no workspace lockfile references,retaining every referenced entry. The reference set is the union of thedigests pinned across every lockfile (*.lock) in the workspace, together withthe digests the configuration's plugins.cli list pins, so a cli plugin youadded keeps the bytes it runs from.
Prune acts on the caches whose entries carry a content digest — the workspaceartifact cache (entities, source artifacts, external inputs), theplugin-describe cache and the cli-plugin cache, which holds the cli pluginsadded where no workspace was found — and on the compiled-module cache by reference: a compiledplugin module is reclaimed when no lockfile still references the plugin itbelongs to, and the shared runtime module every plugin depends on is reclaimedonce the last plugin referring to it is pruned. A compiled module that cannot betraced back to a plugin is retained rather than removed on a guess; thatremainder is reclaimed by "aggrega cache evict" or "aggrega cache clear".
Prune needs a pulled workspace: it fails when no lockfile is present.aggrega cache status açıklaması
List the contents of every cache, one element per line, followed by asummary line of the form "N elements, <human size>". The listing isdeterministic: identical cache state produces byte-identical output.Önbellek nedir, ne değildir
artifact_cache_dir altındaki yapıt önbelleği (varsayılan olarak .aggrega/cache), bir getirme işleminin oraya koyduklarını tutar: katalog varlıkları ve kaynak yapıtlar; her biri kendi türü ile getirildiği koordinat ve sürüm altında saklanır ve lockfile’ın kaydettiği bir özetle doğrulanır. Bir katalog dizini değildir ve katalog taraması onu atlar; bu nedenle önbellekte duran içerik, onu doğrulayan sabitleme aracılığıyla bir bağımlılık olarak okunur, asla sizin yazdığınız bir varlık olarak okunmaz.
Karşılaşmanız en olası sonuç. Önbellek, hiçbir lockfile’ın sabitlemediği bir varlık tutuyorsa bu varlık bir derleme için görünmezdir ve ona ihtiyaç duyan bir derleme, varlığın bulunamadığını söyleyerek durur. Durma mesajı varlığı adlandırır; bu yüzden eksik sabitleme mesajdan belirlenebilir.
Varlık, bir $ref: başvurusunun ulaştığı bir SchemaLibrary olduğunda, başvuruyu çözümlenmemiş olarak raporlayan her komut, raporun ardından önbellekte bulunan, hiçbir kilit dosyası girdisinin sabitlemediği ve hiçbir katalog dizininin sağlamadığı her kütüphaneyi ve o komut için işe yarayan eylemi adlandıran bir remediation: satırı yazar:
aggrega buildveaggrega validate --release <release>, Release’in kilit dosyasını okur; bu nedenle satır, kütüphaneyi çözümlemek ve girdisini kaydetmek içinaggrega pull --release <release>komutunu adlandırır.- Argümansız
aggrega validateve--releaseile ya da onsuzaggrega validate <entity-path>, kütüphaneleri yalnızca katalog dizinlerinden okur ve hiçbir kilit dosyası okumaz; bu nedenle kaydedilmiş hiçbir girdi kararlarını değiştirmez. Satır bunu belirtir ve önceaggrega pull --release <release>komutunu, ardından Release’i kilit dosyasının sabitlediklerine göre denetleyenaggrega validate --release <release>komutunu adlandırır. - Çevrimdışı duruşta
aggrega pullveaggrega build --auto-pullkütüphaneyi ne getirebilir ne de onun için bir girdi kaydedebilir; bu nedenle satır,aggrega pull --release <release>komutunun bir kayıt defterine erişilebilen bir yerde çalıştırılmasını söyler. Bağlıyken, kütüphaneyi hiçbir katalog dizininde ve okuduğu hiçbir kayıt defterinde bulamayan bir çekme işleminin kaydedecek bir girdisi yoktur.
Bu satırların her biri diğer çıkış yolunu da sunar: kütüphaneyi bir katalog dizini altında yazmak.
Ne çalıştırılmalı. aggrega pull --release <release> varlığı çözümler ve özetini kaydeder; ardından aynı derleme onu bulur. Varlık bir bağımlılık değil de sizinse, onu bunun yerine workspace.catalog_dirs içinde listelenen bir dizin altında yazın; tarama orayı okur. aggrega cache prune, hiçbir lockfile’ın başvurmadığı girdileri temizler; bu, aynı kuralın düzenleme yarısıdır.
Önbellek düzeni, artifact_cache_dir sözleşmesi ve bir çözümleme yapıtının neden bilerek yazılmış içerik olarak okunamadığı için bkz. architecture/13-catalog-and-registry.md.
Hangi önbellekler bu projeye, hangileri makineye aittir
Bu komutların üzerinde işlem yaptığı önbelleklerin tümü, içinde bulunduğunuz projeyle sınırlı değildir ve bu fark, bir geri kazanımın ne kadar uzağa erişeceğini belirler.
Yalnızca sizin. artifact_cache_dir altındaki yapıt önbelleği: bu projenin çözümlediği varlıklar, kaynak yapıtlar ve sabitlenmiş dış girdiler ile hiçbir katalog klasörü belirtmeyen bir içe aktarmanın okuduğu yayımlanmış katalog anlık görüntüleri. Buradan yer geri kazanmak bu projeyi etkiler, başka hiçbir şeyi etkilemez.
Bu makinedeki her Aggrega projesi tarafından paylaşılan. Derlenmiş modül deposu, eklenti tanımlama deposu, dokümantasyon paketi deposu ve cli eklenti deposu. Bir provider konuğu bir kez derlenir ve her proje tarafından yeniden kullanılır; herhangi bir şeyin ikinci derlemesini hızlı kılan budur. Bu nedenle bir girdiyi kaldırmak, makinedeki herhangi bir projenin sonraki derlemesinin onu yeniden derlemesi anlamına gelir. Dokümantasyon paketi (aggrega explain’in, bir düzenleyicinin açıklamalarının ve bir asistanın dokümantasyon kaynaklarının okunduğu yayımlanmış sayfalar ile aggrega scaffold --example komutunun yazdığı çalıştırılabilir örnekler) her kayıt defteri ve sürüm için bir kez tutulur, çünkü içeriği başka hiçbir şeye bağlı değildir: bunlardan hangisi onu ilk getirirse her proje için getirmiş olur ve her projeye yine de ancak kendi imza denetimi kopyayı kabul ettiğinde sunulur. Hiçbir şey kalıcı olarak kaybolmaz; kaldırılan bir modül istek üzerine yeniden oluşturulur, kaldırılan bir paket ise sonraki açıklama ya da örnek tarafından veya bir asistan sunucusu bir sonraki başlatılışında yeniden getirilir. Ancak maliyet, sonra derleme yapan kişiye düşer ve bu siz olmayabilirsiniz.
cli eklenti deposu, çalışma alanı olmayan bir klasörde aggrega plugin add cli ile eklenen her cli eklentisinin baytlarını tutar; böylece eklentinin komutu herhangi bir klasörden çalışır. Bir çalışma alanının içinde eklenen bir cli eklentisi ise baytlarını bunun yerine o çalışma alanının yapıt önbelleğinde tutar. Derlenmiş bir modülün ya da bir paketin aksine, baytları kaldırılan bir cli eklentisi kendiliğinden yeniden getirilmez: aggrega plugin add cli <name> onu yeniden ekleyene kadar komutu eksik kalır ve her komut, eklentinin eklenemediği konusunda uyarır ve onu yapılandırmanızın sabitlediği sürümde yeniden ekleyen aggrega plugin add cli komutunu adlandırır.
Makine genelindeki depolar, her platformun bir kullanıcının önbelleklerini tuttuğu yerde tutulur: Windows’ta LOCALAPPDATA ortam değişkeninin belirttiği dizinin içindeki aggrega\cache altında, macOS’ta ~/Library/Caches/aggrega altında, Linux ve diğer Unix sistemlerinde ise XDG_CACHE_HOME’un belirttiği dizinin içindeki bir aggrega dizini altında (XDG_CACHE_HOME ayarlı değilse ~/.cache/aggrega). aggrega config init, çalıştığı makinedeki dizini yazdırır. Bu değişkenlerin hiçbiri ayarlı değilse derlenmiş eklentiler yalnızca çalıştırma süresince tutulur ve hiçbir dokümantasyon paketi tutulmaz: bu durumda bir açıklama, adım adım anlatımının neden eksik olduğunu belirtir, bir asistanın dokümantasyon kaynakları bulunamadı yanıtını verir ve aggrega scaffold --example hiçbir önbellek dizininin çözümlenemediğini söyleyerek reddeder; çalışma alanı olmayan bir klasörde çalıştırılan aggrega plugin add cli de makine genelinde hiçbir önbellek konumunun çözümlenemediğini söyleyerek reddeder.
aggrega cache status, bunu addan çıkarılmaya bırakmak yerine her sınıf için belirtir: her sınıfın çalışma alanını mı yoksa makineyi mi kapsadığı bildirilir ve prune, evict ve clear’ın kaldırdığı her öğe için de aynı erişim bildirilir. evict yalnızca paylaşılan derlenmiş modül deposu üzerinde işlem yapar; prune hiçbir dokümantasyon paketini ya da bir içe aktarmanın okuduğu hiçbir katalog anlık görüntüsünü kaldırmaz, çünkü hiçbir kilit dosyası bunların hiçbirine başvurmaz, ve bu türden her sınıfı budamaya uygun değil olarak bildirir; prune, yapılandırmanızın plugins.cli listesinin sabitlediği her cli eklentisinin baytlarını, cli eklenti deposunda olduğu gibi çalışma alanının yapıt önbelleğinde de, eklenti tanımlama girdisiyle birlikte korur ve hiçbir sabitlemenin adlandırmadıklarını kaldırır; clear her şey üzerinde işlem yapar, bu yüzden başlamadan önce onay ister.
Kullanılamayan bir çalışma alanı kökü. Komuta verilen çalışma alanı kökü bir dosya ya da var olmayan bir yol olduğunda status, evict ve clear yalnızca makine genelindeki depolarda işlem yapar, aksi hâlde nasıl çıkacaklarsa öyle çıkar ve bunu, diğer her komutun o kökü reddederken kullandığı sözcüklerle standart hataya yazar:
note: —workspace-root names the workspace root
"<root>", which is not a directory:<root>; only the machine-wide caches are acted on (not: —workspace-root, dizin olmayan bir çalışma alanı kökünü adlandırıyor; yalnızca makine genelindeki önbelleklerde işlem yapılır)
Var olmayan bir yol, which is not a directory: yerine which cannot be used: ve nedeni ile okunur. prune ise çalışma alanının kilit dosyalarına ihtiyaç duyduğu için durur.
Bu, yalnızca bir terminalde değil, işlemin nereden çağrıldığından bağımsız olarak her yerde geçerlidir. Aynı işlemlere bir düzenleyici oturumundan ve bir asistanın araç çağrısından da erişilebilir ve yanıtları aynı nedenle aynı erişimi taşır. Bir asistanın bunları sizin adınıza çağırabileceği durumlar için bkz. aggrega mcp.
Yapıt önbelleğindeki bir bağlantı
Yapıt önbelleği dizini, önbellekteki her şeyin okunduğu, yazıldığı ve kaldırıldığı tek yerdir; bu, varsayılan .aggrega/cache için de, artifact_cache_dir’in adlandırdığı ve çalışma alanı kökünün dışına çıkan bir dizin (../shared-cache) için de aynıdır. İçindeki, o dizinin dışına çıkan sembolik bağlantı olan hiçbir şey (önbelleğin kendi dizinlerinden biri, örneğin .aggrega/cache/inputs, ya da bunlardan birinin içindeki bir dosya) üzerinden okuma, yazma ya da kaldırma yapılmaz; bağlantı aynı çalışma alanının başka bir dizinine çıksa bile. Bir yazmanın önbellek dizininin altında erişebileceği yer, bir kaldırmanın erişebileceği yerle tam olarak aynıdır.
- Bir çekme, bir derleme ve önbelleğe yazan diğer her işlem, bağlantıyı ve nereye çıktığını belirterek
E0320ile durur ve hiçbir şey yazmaz. status,pruneveclearböyle bir bağlantı üzerinden hiçbir şey listelemez. Bağlantı önbelleğin kendi dizinlerinden biriysestatusE0321ile durur; birpruneya daclearise herhangi bir şeyi listelemeden veya kaldırmadan önceE0320ile durur; böylece bağlantının gösterdiği hiçbir şey kaldırılmaz ve bağlantı yerinde kalır. Bağlantı bunlardan birinin içindeki bir dosyaysa üçü deE0321ile durur.- Bir derleme, bir çekme ve önbelleği okuyan diğer her işlem, başka yerde tutulan baytları okumak yerine
E0321ile durur; bu baytlar kilit dosyasının kaydettiği özetle eşleşecek olsa bile. - Önbellek dizininin içinde kalan bir bağlantı izlenir. Önbelleğin kendi dizinlerinden biri önbellek dizini içindeki başka bir dizine bağlantıysa o dizin önbelleğe aittir:
statusorada bulunanları listeler,pruneoradan kaldırır,clearise onu boşaltır, bağlantıyı korur ve orada kaldırdığı baytları bildirir.
Önbellek dizininin kendisi. Çalışma alanı kökünün içinde yazılmış bir artifact_cache_dir (varsayılan da dahil) kendisi de çalışma alanının başka bir dizinine bağlantı olabilir; bu durumda önbellek bağlantının çıktığı yerde tutulur. Çalışma alanının dışına çıkan bir bağlantı reddedilir: onunla karşılaşan işlem hangisi olursa olsun, üzerinden herhangi bir şey okunmadan veya yazılmadan önce bağlantıyı belirterek E0321 ya da E0320 ile durur. Çalışma alanı kökünün dışına çıkacak şekilde yazılmış bir dizin, kendisi bir bağlantı olsa bile, çıktığı yerde kabul edilir.
Önbelleği yerinde doldurmak için bağlantıyı kaldırın ve yeniden çekin. Önbelleği başka bir yerde tutmak için o dizine bağlantı vermek yerine artifact_cache_dir değerini, çalışma alanı köküne göre yazılmış olarak o dizine ayarlayın: orada adlandırılan bir dizin, çıktığı yerde okunur ve yazılır. Makine genelindeki depolar hiçbir çalışma alanına bağlı değildir; bir bağlantı aracılığıyla başka yerde tuttuğunuz bir depo, bağlantının çıktığı yerde listelenir, budanır ve temizlenir; clear de bağlantıyı korur. Çalışma alanı sınırı kuralın tamamını açıklar.
Ayrıca bakınız
aggrega-pull— bir Release’in bağımlılıklarını lockfile’a ve önbelleğe çözümler.aggrega-config—artifact_cache_dirve diğer önbellek ayarlarının yazıldığı yer.