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

aggrega cache

Disk üzerindeki önbellekleri inceler ve bakımını yapar

Kullanım

aggrega cache

Açı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

KomutAçıklama
aggrega cache clearDerlenmiş modüller dahil tüm önbellekleri siler
aggrega cache evictDerlenmiş modül önbelleğini, en eskiden başlayarak bir boyut sınırına indirir
aggrega cache pruneHiç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 (compiled
modules, plugin descriptors, documentation bundles, and the cli plugins added
where no workspace was found). This is the total-wipe verb; unlike prune it
reclaims the compiled-module cache and the documentation bundles as well.
Cleared caches repopulate on the next build, and the documentation bundle on
the next read of the documentation; a cli plugin cleared from the cache is
fetched again by adding it again.
Because the wipe is irreversible, clear asks for confirmation before removing
anything. Pass --yes to skip the prompt for non-interactive use; without --yes
on a non-interactive stdin it refuses rather than blocking on a prompt no one
can answer.

aggrega cache clear bayrakları

BayrakVarsayılanAçıklama
--yesfalseonay 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 the
least-recently-compiled modules first, until the cache total is at or below
--max-size. The compiled-module cache is machine-global: every provider guest is
compiled once and reused across every project on the machine, so over time it can
dominate on-disk cache use.
Unlike prune (which reclaims artifact-cache entries no lockfile references) and
clear (which wipes every cache), evict is size-bounded and touches only the
compiled-module cache. Evicted modules recompile on demand on the next build, so
eviction loses no irrecoverable state.
--max-size is required and accepts a binary-unit size in the same vocabulary the
status summary prints — for example 5GiB, "4.5 GiB", or 512MiB — or a bare
integer byte count. The unit suffix is case-insensitive and an optional space
may separate the number from the unit.
This verb is the on-demand trim, at a cap you give it once. The cache is also
held to a standing cap without being asked: every invocation that loads a plugin
applies the `compiled_module_cache.max_bytes` setting (53687091200 bytes, 50 GiB,
by default) before it compiles anything, using this same removal order. Use this
verb to reclaim space now or below the standing cap; change the setting to move
the standing cap itself. When the cache already fits the cap, evict reports a
no-op and removes nothing.

aggrega cache evict bayrakları

BayrakVarsayılanAçı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 the
digests pinned across every lockfile (*.lock) in the workspace, together with
the digests the configuration's plugins.cli list pins, so a cli plugin you
added keeps the bytes it runs from.
Prune acts on the caches whose entries carry a content digest — the workspace
artifact cache (entities, source artifacts, external inputs), the
plugin-describe cache and the cli-plugin cache, which holds the cli plugins
added where no workspace was found — and on the compiled-module cache by reference: a compiled
plugin module is reclaimed when no lockfile still references the plugin it
belongs to, and the shared runtime module every plugin depends on is reclaimed
once the last plugin referring to it is pruned. A compiled module that cannot be
traced back to a plugin is retained rather than removed on a guess; that
remainder 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 a
summary line of the form "N elements, <human size>". The listing is
deterministic: 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 build ve aggrega validate --release <release>, Release’in kilit dosyasını okur; bu nedenle satır, kütüphaneyi çözümlemek ve girdisini kaydetmek için aggrega pull --release <release> komutunu adlandırır.
  • Argümansız aggrega validate ve --release ile ya da onsuz aggrega 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 önce aggrega pull --release <release> komutunu, ardından Release’i kilit dosyasının sabitlediklerine göre denetleyen aggrega validate --release <release> komutunu adlandırır.
  • Çevrimdışı duruşta aggrega pull ve aggrega build --auto-pull kü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ğ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 E0320 ile durur ve hiçbir şey yazmaz.
  • status, prune ve clear böyle bir bağlantı üzerinden hiçbir şey listelemez. Bağlantı önbelleğin kendi dizinlerinden biriyse status E0321 ile durur; bir prune ya da clear ise herhangi bir şeyi listelemeden veya kaldırmadan önce E0320 ile 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 üçü de E0321 ile durur.
  • Bir derleme, bir çekme ve önbelleği okuyan diğer her işlem, başka yerde tutulan baytları okumak yerine E0321 ile 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: status orada bulunanları listeler, prune oradan kaldırır, clear ise 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_dir ve diğer önbellek ayarlarının yazıldığı yer.