Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

aggrega cache

Memeriksa dan memelihara cache di disk

Sinopsis

aggrega cache

Deskripsi

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.

Subperintah

PerintahDeskripsi
aggrega cache clearMenghapus setiap cache, termasuk modul yang dikompilasi
aggrega cache evictMemangkas cache modul terkompilasi hingga batas ukuran, mulai dari yang tertua
aggrega cache pruneMenghapus entri cache artefak yang tidak dirujuk lockfile mana pun
aggrega cache statusMendaftar isi cache dan ringkasan total

Deskripsi aggrega cache clear

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.

Flag aggrega cache clear

FlagDefaultDeskripsi
--yesfalsemelewati prompt konfirmasi (untuk penggunaan non-interaktif/CI)

Deskripsi aggrega cache evict

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.

Flag aggrega cache evict

FlagDefaultDeskripsi
--max-size—batas ukuran untuk cache modul terkompilasi (mis. 5GiB, 512MiB, atau jumlah byte); wajib

Deskripsi aggrega cache prune

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.

Deskripsi aggrega cache status

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.

Apa itu cache, dan apa yang bukan

Cache artefak di bawah artifact_cache_dir (secara default .aggrega/cache) menyimpan apa yang ditaruh di sana oleh pengambilan: entitas katalog dan artefak sumber, masing-masing disimpan di bawah jenisnya serta koordinat dan versi saat diambil, dan dijamin oleh digest yang dicatat lockfile. Cache ini bukan direktori katalog, dan pemindaian katalog melewatinya — sehingga konten yang berada di cache dibaca sebagai dependensi, melalui pin yang menjaminnya, dan tidak pernah sebagai entitas yang Anda tulis.

Konsekuensi yang paling mungkin Anda temui. Jika cache menyimpan entitas yang tidak di-pin oleh lockfile mana pun, entitas tersebut tidak terlihat oleh build, dan build yang membutuhkannya berhenti dengan menyatakan bahwa entitas itu tidak ditemukan. Penghentian tersebut menyebut entitasnya, sehingga pin yang hilang dapat diidentifikasi dari pesannya.

Jika entitas tersebut adalah SchemaLibrary yang dijangkau oleh $ref:, setiap perintah yang melaporkan referensi itu sebagai tidak ter-resolve menyertai laporannya dengan baris remediation: yang menyebutkan setiap pustaka yang disimpan cache yang tidak di-pin oleh entri lockfile mana pun dan tidak disediakan oleh direktori katalog mana pun, serta tindakan yang berhasil untuk perintah tersebut:

  • aggrega build dan aggrega validate --release <release> membaca lockfile Release, sehingga baris itu menyebutkan aggrega pull --release <release> untuk me-resolve pustaka tersebut dan mencatat entrinya.
  • aggrega validate tanpa argumen, dan aggrega validate <entity-path> dengan atau tanpa --release, hanya membaca pustaka dari direktori katalog dan tidak membaca lockfile apa pun, sehingga tidak ada entri tercatat yang mengubah putusan mereka. Baris itu menyatakan hal tersebut, dan menyebutkan aggrega pull --release <release> diikuti aggrega validate --release <release>, yang memeriksa Release terhadap apa yang di-pin oleh lockfile-nya.
  • aggrega pull, dan aggrega build --auto-pull, dalam postur offline tidak dapat mengambil pustaka itu maupun mencatat entri untuknya, sehingga baris itu meminta Anda menjalankan aggrega pull --release <release> di tempat yang dapat menjangkau registry. Dalam keadaan terhubung, pull yang tidak menemukan pustaka itu di direktori katalog mana pun maupun di registry mana pun yang dibacanya tidak memiliki entri untuk dicatat.

Setiap baris tersebut juga menawarkan cara lain: tulis pustaka itu di bawah direktori katalog.

Apa yang perlu dijalankan. aggrega pull --release <release> me-resolve entitas dan mencatat digest-nya, setelah itu build yang sama menemukannya. Jika entitas tersebut milik Anda dan bukan dependensi, tulislah di bawah direktori yang tercantum di workspace.catalog_dirs sebagai gantinya — pemindaian membaca direktori itu. aggrega cache prune membersihkan entri yang tidak dirujuk lockfile mana pun, yang merupakan separuh perapian dari aturan yang sama.

Untuk tata letak cache, kontrak artifact_cache_dir, dan alasan artefak resolusi sengaja tidak dapat dibaca sebagai konten yang ditulis, lihat architecture/13-catalog-and-registry.md.

Cache mana yang milik proyek ini, dan mana yang milik mesin

Tidak setiap cache yang ditangani perintah-perintah ini terbatas pada proyek tempat Anda berada, dan perbedaan itu menentukan seberapa jauh pengosongan ruang menjangkau.

Hanya milik Anda. Cache artefak di bawah artifact_cache_dir — entitas, artefak sumber, dan input eksternal yang di-pin yang telah di-resolve proyek ini, serta snapshot katalog yang diterbitkan yang telah dibaca oleh impor yang tidak menyebutkan folder katalog apa pun. Mengosongkan ruang darinya memengaruhi proyek ini dan tidak ada yang lain.

Dipakai bersama oleh setiap proyek Aggrega di mesin ini. Penyimpanan modul terkompilasi, penyimpanan deskripsi plugin, penyimpanan bundel dokumentasi, dan penyimpanan plugin cli. Guest provider dikompilasi sekali dan digunakan ulang oleh setiap proyek, yang membuat build kedua dari apa pun menjadi cepat, sehingga menghapus sebuah entri berarti build berikutnya dari proyek mana pun di mesin itu mengompilasinya ulang. Bundel dokumentasi — halaman terbitan yang menjadi sumber bacaan aggrega explain, penjelasan editor, dan sumber daya dokumentasi asisten, serta contoh yang dapat dijalankan yang ditulis oleh aggrega scaffold --example — disimpan sekali per registry dan versi, karena isinya tidak bergantung pada hal lain: siapa pun di antara mereka yang mengambilnya pertama kali mengambilnya untuk setiap proyek, dan setiap proyek tetap baru menerimanya setelah pemeriksaan tanda tangannya sendiri menerima salinan tersebut. Tidak ada yang hilang secara permanen — modul yang dihapus dibangun ulang sesuai kebutuhan, dan bundel yang dihapus diambil lagi oleh penjelasan atau contoh berikutnya, atau oleh server asisten saat berikutnya dimulai — tetapi biayanya jatuh pada siapa pun yang mem-build berikutnya, yang mungkin bukan Anda.

Penyimpanan plugin cli menyimpan byte setiap plugin cli yang ditambahkan dengan aggrega plugin add cli di folder yang bukan workspace, sehingga perintahnya dapat dijalankan dari folder mana pun; plugin cli yang ditambahkan di dalam workspace justru menyimpan byte-nya di cache artefak workspace tersebut. Berbeda dengan modul terkompilasi atau bundel, plugin cli yang byte-nya dihapus tidak diambil kembali dengan sendirinya: sampai aggrega plugin add cli <name> menambahkannya lagi, perintahnya tidak ada dan setiap perintah memperingatkan bahwa plugin itu tidak dapat ditambahkan, dengan menyebut perintah aggrega plugin add cli yang menambahkannya lagi pada versi yang di-pin oleh konfigurasi Anda.

Penyimpanan tingkat mesin disimpan di tempat setiap platform menyimpan cache pengguna: di Windows di bawah aggrega\cache di dalam direktori yang disebut variabel lingkungan LOCALAPPDATA, di bawah ~/Library/Caches/aggrega di macOS, dan di bawah direktori aggrega di dalam direktori yang disebut XDG_CACHE_HOME — ~/.cache/aggrega ketika XDG_CACHE_HOME tidak diatur — di Linux dan sistem Unix lainnya. aggrega config init mencetak direktori tersebut di mesin tempat perintah itu dijalankan. Jika tidak ada satu pun variabel tersebut yang diatur, plugin terkompilasi hanya disimpan selama proses berjalan, dan tidak ada bundel dokumentasi yang disimpan sama sekali: penjelasan kemudian menyatakan mengapa panduan langkah demi langkahnya tidak ada, sumber daya dokumentasi asisten menjawab “tidak ditemukan”, dan aggrega scaffold --example menolak, dengan menyatakan bahwa tidak ada direktori cache yang dapat ditentukan; aggrega plugin add cli yang dijalankan di folder yang bukan workspace juga menolak, dengan menyatakan bahwa tidak ada lokasi cache tingkat mesin yang dapat ditentukan.

aggrega cache status menyatakan hal ini per kelas alih-alih membiarkannya disimpulkan dari nama: setiap kelas dilaporkan mencakup workspace atau mesin, dan jangkauan yang sama dilaporkan untuk setiap elemen yang dihapus oleh prune, evict, dan clear. evict hanya bekerja pada penyimpanan modul terkompilasi bersama; prune tidak pernah menghapus bundel dokumentasi maupun snapshot katalog yang dibaca oleh impor, karena tidak ada lockfile yang merujuk keduanya, dan melaporkan setiap kelas semacam itu sebagai tidak memenuhi syarat untuk prune; prune mempertahankan byte setiap plugin cli yang di-pin oleh daftar plugins.cli dalam konfigurasi Anda — baik di penyimpanan plugin cli maupun di cache artefak workspace, beserta entri deskripsi plugin-nya — dan menghapus yang tidak disebut oleh pin mana pun; clear bekerja pada semuanya, itulah sebabnya perintah ini bertanya sebelum mulai.

Root workspace yang tidak dapat digunakan. Bila root workspace yang diberikan ke perintah adalah sebuah file atau path yang tidak ada, status, evict, dan clear hanya bertindak pada penyimpanan tingkat mesin, keluar sebagaimana biasanya, dan menyatakannya di standard error, dengan kata-kata yang sama yang digunakan setiap perintah lain untuk menolak root tersebut:

note: —workspace-root names the workspace root "<root>", which is not a directory: <root>; only the machine-wide caches are acted on (catatan: —workspace-root menyebut root workspace yang bukan direktori; hanya cache tingkat mesin yang ditindaklanjuti)

Path yang tidak ada akan terbaca which cannot be used: beserta alasannya sebagai pengganti which is not a directory:. prune justru berhenti, karena memerlukan lockfile workspace.

Ini berlaku dari mana pun operasi dipanggil, bukan hanya di terminal. Operasi yang sama dapat dijangkau dari sesi editor dan dari pemanggilan alat oleh asisten, dan jawabannya membawa jangkauan yang sama karena alasan yang sama. Untuk kapan asisten dapat memanggilnya atas nama Anda, lihat aggrega mcp.

Direktori cache artefak adalah satu-satunya tempat segala isi cache dibaca, ditulis, dan dihapus — baik .aggrega/cache default maupun direktori yang disebut artifact_cache_dir yang keluar dari root workspace (../shared-cache). Apa pun di dalamnya yang berupa tautan simbolik yang mengarah ke luar direktori itu — salah satu direktori milik cache, seperti .aggrega/cache/inputs, atau file di dalamnya — tidak dibaca, ditulis, maupun dihapus melaluinya, bahkan ketika tautan tersebut mengarah ke direktori lain di workspace yang sama. Apa yang dapat dijangkau penulisan di bawah direktori cache sama persis dengan apa yang dapat dijangkau penghapusan.

  • Pull, build, dan setiap operasi lain yang menulis ke cache berhenti dengan E0320, dengan menyebut tautan dan ke mana tautan itu mengarah, dan tidak menulis apa pun.
  • status, prune, dan clear tidak mendaftar apa pun melalui tautan seperti itu. Jika salah satu direktori milik cache adalah tautannya, status berhenti dengan E0321, dan prune atau clear berhenti dengan E0320 sebelum mendaftar atau menghapus apa pun — sehingga tidak ada yang ditunjuk tautan itu yang dihapus, dan tautannya tetap di tempatnya. Jika file di dalamnya yang menjadi tautan, ketiganya berhenti dengan E0321.
  • Build, pull, dan setiap operasi lain yang membaca cache berhenti dengan E0321 alih-alih membaca byte yang disimpan di tempat lain, bahkan ketika byte tersebut cocok dengan digest yang dicatat lockfile.
  • Tautan yang tetap berada di dalam direktori cache akan diikuti. Jika salah satu direktori milik cache adalah tautan ke direktori lain di dalam direktori cache, direktori itu milik cache: status mendaftar apa yang ada di sana, prune menghapus dari sana, dan clear mengosongkannya, mempertahankan tautannya, dan melaporkan byte yang dihapusnya di sana.

Direktori cache itu sendiri. artifact_cache_dir yang ditulis di dalam root workspace — termasuk default-nya — boleh berupa tautan ke direktori lain di workspace, dan cache kemudian disimpan di tempat tujuan tautan itu. Tautan yang mengarah ke luar workspace ditolak: operasi mana pun yang menemuinya berhenti dengan E0321 atau E0320, dengan menyebut tautannya, sebelum apa pun dibaca atau ditulis melaluinya. Direktori yang ditulis keluar dari root workspace dihormati di tempat tujuannya, bahkan ketika direktori itu sendiri adalah tautan.

Hapus tautan tersebut dan lakukan pull lagi untuk mengisi cache di tempatnya. Untuk menyimpan cache di tempat lain, atur artifact_cache_dir ke direktori tersebut, ditulis relatif terhadap root workspace, alih-alih membuat tautan ke sana: direktori yang disebut di sana dibaca dan ditulis di tempat tujuannya. Penyimpanan tingkat mesin tidak terikat pada workspace mana pun; penyimpanan yang Anda simpan di tempat lain melalui tautan didaftar, dipangkas, dan dikosongkan di tempat tujuan tautan itu, dan clear mempertahankan tautannya. Batas workspace menyatakan aturan tersebut secara utuh.

Lihat juga

  • aggrega-pull — me-resolve dependensi Release ke dalam lockfile dan cache.
  • aggrega-config — tempat artifact_cache_dir dan pengaturan cache lainnya ditulis.