Flag global
Flag yang tersedia pada setiap subperintah aggrega.
--workspace-root <path>
Gunakan <path> sebagai root workspace, tanpa melakukan penemuan sama sekali. Jika flag ini tidak diberikan, aggrega menemukan root dengan menelusuri ke atas dari direktori saat ini — atau, jika penelusuran itu tidak menemukan apa pun dan perintah menyebut Release atau dokumennya dengan path absolut, dengan menelusuri ke atas dari folder file tersebut; lihat Konfigurasi untuk mengetahui apa yang menjadi penanda sebuah root, dalam urutan apa, dan perintah mana yang menyebut file seperti itu.
AGGREGA_WORKSPACE_ROOT adalah padanannya dalam variabel lingkungan: jika --workspace-root tidak diberikan, variabel tersebut menyediakan root. Flag yang menang jika ditetapkan.
Root tetap menjadi root di mana pun ia diberikan, termasuk pada server: permintaan ke aggrega mcp yang tidak menyebut workspace-nya sendiri dijawab di dalam root tersebut, tanpa menelusuri apa pun di atasnya. Root yang bukan folder yang ada — path yang tidak menunjuk apa pun, atau yang menunjuk sebuah file — ditolak oleh setiap perintah yang membaca workspace-nya, sebelum perintah melakukan hal lain; aggrega serve dan listener aggrega mcp menolak untuk dimulai dengan root seperti itu, sedangkan aggrega mcp melalui input dan output standar tetap dimulai dan menjawab setiap panggilan yang bertindak di workspace tersebut dengan penolakan. Penolakan itu menyebut sumber yang menyediakannya, --workspace-root atau AGGREGA_WORKSPACE_ROOT, beserta nilainya persis seperti yang diberikan. Perintah yang tidak membaca workspace, seperti aggrega version, juga tidak membaca root dan tidak ditolak karenanya.
Jika keduanya tidak diberikan dan penemuan tidak menemukan penanda apa pun, folder tempat perintah dijalankan menjadi root, dan perintah yang membaca workspace-nya menyatakan hal itu dalam satu baris di standard error, dengan menyebut folder tersebut dan flag ini; lihat Konfigurasi, yang juga menjelaskan mengapa tidak ada yang ditulis ke cache artefak di folder seperti itu.
Berkas konfigurasi global
--config <path> menyebutkan berkas konfigurasi global secara eksplisit untuk satu pemanggilan. Flag ini mengalahkan variabel lingkungan AGGREGA_CONFIG, yang pada gilirannya mengalahkan lokasi default — dan karena keduanya menyebutkan sebuah berkas secara sengaja, path yang tidak ada menjadi galat yang jelas terlihat, bukan fallback yang diam-diam. Berbeda dengan variabel pengaturan AGGREGA_*, keduanya tidak menimpa satu pengaturan pun; keduanya memilih berkas mana yang berlaku. Berkas mana pun yang terpilih, berkas konfigurasi milik proyek itu sendiri tetap dilapiskan di atasnya. Configuration memuat urutan resolusinya dan apa yang semestinya ada dalam berkas tersebut.
--config dan variabel lingkungan AGGREGA_CONFIG memilih target penulisan sekaligus sumber pembacaan: perintah yang dijalankan dengan --config <path> membaca konfigurasinya dari berkas tersebut dan menerapkan perubahannya ke berkas yang sama, sehingga apa yang ditulis sebuah perintah adalah apa yang dibaca kembali oleh perintah berikutnya dengan bentuk pemanggilan yang sama.
Perintah yang mengubah konfigurasi memilih berkas yang ditulisnya berdasarkan sifat pengaturannya: konfigurasi alat yang berlaku untuk seluruh mesin (sebuah registry) secara default ditulis ke berkas global, sedangkan konfigurasi yang ikut serta dalam build (pengikatan provider atau lampiran soket governance/linter/importer) secara default ditulis ke berkas proyek yang di-commit. Berikan --global atau --workspace untuk menimpanya, dan perintah akan mencetak lokasi tempat ia menulis.
Untuk menyiapkan konfigurasi global pada mesin baru — mendaftarkan sebuah registry beserta kebijakan kepercayaan tanda tangannya agar artefak bertanda tangan dapat ditarik dan diverifikasi tanpa menyunting YAML secara manual — jalankan aggrega config init. Untuk melihat apa yang berlaku saat ini, dan dengan --origin lapisan mana yang menentukan setiap pengaturan, jalankan aggrega config show.
--offline
Menolak setiap akses jaringan untuk satu kali eksekusi ini.
Offline adalah sikap workspace, bukan mode dari satu perintah, dan dapat diatur dari tiga tempat: flag ini, AGGREGA_OFFLINE, dan kunci tingkat atas offline dalam file konfigurasi. Ketiganya bermakna sama dan mengikuti urutan yang biasa — flag mengalahkan variabel, dan variabel mengalahkan file.
Arah mematikan sama pentingnya bagi flag ini dengan arah menyalakan. --offline=false mengizinkan jaringan untuk satu perintah ketika file konfigurasi yang di-commit atau variabel yang diekspor telah menyalakan sikap tersebut. Hal ini penting ketika file tersebut bukan milik Anda untuk diedit: proyek yang .aggrega-config.yaml-nya memuat offline: true menolak publikasi bagi setiap orang yang meng-clone-nya, dan memberikan --offline=false adalah satu-satunya jawaban yang tidak memerlukan commit maupun variabel yang diekspor.
Apa yang ditolak, dan apa yang tidak
Batasnya ditentukan oleh apa yang dibutuhkan pekerjaan, bukan oleh perintah mana yang diketik.
Ditolak, karena tidak dapat benar tanpa menjangkau registry:
--upgrade, di mana pun ia muncul. Flag ini me-resolve ulang setiap dependensi dan menaikkan masing-masing ke versi tertinggi yang saat ini ditawarkan registry, dan “tertinggi yang tersedia” adalah klaim tentang apa yang dilayani registry saat ini. Menjalankannya terhadap cache yang hangat akan mem-pin apa pun yang kebetulan ada di cache sambil melaporkan bahwa ia telah naik ke versi terbaru, dan itu lebih buruk daripada penghentian.- Perintah yang pekerjaannya sendiri adalah perjalanan pulang-pergi jaringan:
aggrega push,aggrega push-artifact, danaggrega registry update. Perintah-perintah ini menyatakannya sebelum membaca entitas Anda atau menelusuri repositori Anda, dan penolakannya menyebutkan tempat mana dari ketiganya yang mengatur sikap tersebut, sehingga seseorang yang tidak mengetik flag apa pun tahu di mana harus mencari.
Tidak ditolak, karena mesin mungkin sudah dapat memenuhinya:
aggrega pullbiasa, danaggrega build --auto-pull. Keduanya mematuhi pin yang sudah tercatat dan hanya me-resolve yang belum memilikinya, sehingga workspace yang semua referensinya ada di cache atau terdapat dalam katalogcatalog_dirsselesai tanpa menjangkau jaringan sama sekali. Jika eksekusi semacam itu memang perlu mengambil sesuatu, ia ditolak pada titik itu dan diberi tahu referensi mana yang tidak dapat dipenuhinya.aggrega buildterhadap lockfile yang terisi, yang membaca seluruh closure-nya dari cache. Satu-satunya akses jaringan yang dimilikinya adalah perbaikan: jika salinan store dari input eksternal yang di-pin telah hilang, input tersebut diambil ulang berdasarkan digest yang sudah dicatat lockfile. Di bawah sikap ini, bahkan untuk itu pun tidak ada transport, sehingga salinan yang hilang justru menghentikan build, dengan menyebutkan sikap tersebut.- Publikasi
--dry-run. Seluruh perilakunya adalah melaporkan apa yang akan dipublikasikan tanpa memanggil apa pun, sehingga ini merupakan bentuk publikasi yang aman untuk offline, bukan kontradiksi terhadap sikap tersebut.
Mesin airgapped yang menyimpan salinan lokal katalog dan artefaknya adalah kasus yang membuat pembagian ini ada agar tetap berfungsi: workspace semacam itu offline, dan hampir semua yang dilakukannya masih dapat dipenuhi.
Prioritas konfigurasi
Sebuah flag mengalahkan segalanya: variabel lingkungan, file konfigurasi, dan nilai default bawaan. Configuration memuat urutan lengkapnya, dan environment-variables.md memuat daftar variabel berawalan AGGREGA_.
aggrega config show --origin melaporkan lapisan mana yang menentukan setiap pengaturan, dan flag yang Anda ketik dilaporkan sebagai flag — jadi ketika sebuah penolakan menyebut lapisan yang tidak Anda duga, perintah itulah tempat Anda memastikannya.
Lihat juga
- configuration.md — file mana yang menjadi tempat suatu pengaturan, dan model prioritas selengkapnya.
- environment-variables.md — referensi lengkap variabel
AGGREGA_*. - aggrega-serve.md — daemon menentukan workspace-nya melalui jalur penemuan root yang sama.
| Flag | Default | Deskripsi |
|---|---|---|
--config | — | path ke file konfigurasi global, yang menimpa variabel lingkungan AGGREGA_CONFIG dan lokasi default. File konfigurasi pada pohon workspace tetap dilapiskan di atasnya |
--no-color | false | Menonaktifkan warna ANSI di semua output. Juga dipatuhi melalui variabel lingkungan NO_COLOR |
--offline | false | Menolak setiap akses jaringan untuk satu kali eksekusi ini: postur offline, diaktifkan tanpa mengedit konfigurasi. Berikan —offline=false untuk menonaktifkannya selama satu kali eksekusi bila file konfigurasi atau AGGREGA_OFFLINE sudah mengaktifkannya. Yang ditolak adalah apa yang tidak mungkin berlaku tanpa registry: —upgrade, yang seluruh tugasnya adalah menaikkan setiap dependensi ke versi tertinggi yang saat ini ditawarkan registry, serta perintah yang pekerjaannya sendiri berupa perjalanan pulang-pergi jaringan — push, push-artifact, dan registry update. Yang tetap berjalan adalah apa pun yang sudah dapat dipenuhi oleh mesin: build terhadap lockfile yang sudah terisi, —auto-pull atas referensi yang sudah ada di cache atau terdapat dalam katalog lokal, dan dry run, yang melaporkan apa yang akan dipublikasikannya tanpa memanggil apa pun |
--plain | false | Mode aksesibel: menonaktifkan warna dan menampilkan baris progres statis yang polos tanpa animasi spinner atau penggambaran ulang kursor, bahkan di terminal. Ditujukan untuk pembaca layar |
--workspace-root | — | path absolut yang digunakan sebagai root workspace (melewati penemuan) |