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

aggrega build

aggrega build mengompilasi pasangan Aggregate + Release menjadi artefak native provider (manifest Helm, chart Helm yang dapat didistribusikan ulang, YAML docker-compose) di bawah dist/ pada root workspace, sebagaimana dijelaskan di Output. Release adalah satu-satunya titik masuk: Release menamai Aggregate dan Manifest, mendeklarasikan batas, dan merutekan komponen ke provider.

Flag umum

Dua flag memiliki perilaku yang tidak dapat disampaikan oleh referensi flag di bawah dengan sendirinya:

  • --catalog <dir> — direktori yang berisi entitas katalog — jenis authoring Component, Feature, Recipe, dan FeatureRecipe beserta jenis pustaka, Aggregates, dan Plugins — yang dimuat secara rekursif. Setiap direktori --catalog dicari sebelum direktori yang dikonfigurasi, sesuai urutan yang diberikan. Untuk mencari katalog lokal proyek bersama katalog bersama, berikan keduanya (--catalog ./catalog --catalog ../shared-catalog) atau cantumkan di bawah catalog_dirs. Dengan --detail, setiap entitas yang dibayangi oleh direktori dengan prioritas lebih tinggi dilaporkan di stderr, bersama peringatan build lainnya. Direktori --catalog yang tidak ada akan menghentikan build, dengan menyebut namanya. Begitu pula direktori yang tercantum di bawah catalog_dirs yang ternyata bukan direktori: build dihentikan sebelum apa pun dibaca atau ditulis, dengan menyebut entri tersebut serta file konfigurasi dan baris yang mencantumkannya — lihat Dari mana entitas lokal dibaca. Build yang berhenti karena sebuah referensi tidak ter-resolve ke apa pun menyebutkan, dalam catatan di bawah penghentian itu, setiap file di direktori-direktori tersebut yang mendeklarasikan apiVersion Aggrega — sebuah baris yang diawali, tanpa indentasi, dengan apiVersion: dan nilai yang dimulai dengan aggrega.ai/ — dan tidak dapat dimuat, misalnya file yang tidak dapat di-parse sebagai YAML, beserta alasan dari parser itu sendiri, di antara file katalog yang dilewati saat pemuatan; file YAML yang mendeklarasikan apiVersion lain, atau tidak mendeklarasikannya sama sekali, bukan dokumen Aggrega dan tidak pernah disebutkan di sana.
  • --detail — melaporkan apa yang dilakukan langkah pull, diagnostik peristiwa pull sementara yang sama dengan yang dikeluarkan aggrega pull --detail. Yang menentukan apakah ada sesuatu untuk dilaporkan adalah apakah langkah pull diminta — dengan --auto-pull, atau dengan mengaktifkan auto_pull — dan bukan apakah lockfile sudah ada: langkah pull yang diminta tetap berjalan, mengisi lockfile yang belum ada dan mematuhi pin pada lockfile yang sudah ada. Ketika tidak ada langkah pull yang berjalan, flag ini mencetak catatan satu baris ke stdout dan melanjutkan — flag ini tidak pernah mengarang tingkat resolusi yang tidak dimuat oleh lockfile yang di-commit. Untuk status resolusi pasca-pull dari dependensi sebuah Release, gunakan aggrega inspect.

--dry-run dibahas di Mempratinjau build tanpa menulisnya, sedangkan --trace dan --trace-unredacted di Output trace dan Menampilkan nilai yang disembunyikan di bawah.

Mengisi lockfile sebagai bagian dari build

Secara default, build bersifat baca-saja terhadap dependensi: build memerlukan lockfile dan tidak menulisnya. --auto-pull, dan pengaturan workspace auto_pull, menambahkan langkah pull ke build, sehingga satu perintah menyelesaikan dependensi Release dan mengompilasi berdasarkan hasil resolusinya.

Suntingan pada Release adalah sesuatu yang diketahui lockfile. Lockfile mencatat Release — dan setiap Release yang diperluasnya — berdasarkan digest kontennya, sehingga build baca-saja atas Release yang telah disunting sejak pull akan berhenti sebelum apa pun di-render, dengan menyebut file tersebut dan meminta Anda menjalankan aggrega pull --release <release>, yang mencatat suntingan itu sambil tetap mematuhi setiap pin lainnya. Komentar atau perubahan spasi pun dihitung, karena digest mencakup byte apa adanya. Build dengan auto-pull menjalankan sendiri langkah pull tersebut, sehingga build mencatat suntingan dan melakukan build.

Release di-render satu kali. Input eksternal mana yang dikonsumsi sebuah Release ditentukan dengan me-render-nya, bukan dari apa pun yang dideklarasikan dokumennya, sehingga langkah pull me-render Release untuk mengetahuinya — dan render tersebut adalah render milik build. Karena itu, build dengan auto-pull memerlukan satu render, sama seperti build biasa atas lockfile yang sudah ada.

Flag yang membentuk sebuah render berlaku untuknya. --trace, --verify-determinism, --disable-plugin-cache, dan --no-unsupported-field-warnings menjangkau render yang dilakukan build dengan auto-pull dengan ketentuan yang sama seperti render build biasa, sehingga meminta trace atau pemeriksaan determinisme pada build satu perintah akan memberikannya kepada Anda. --dry-run adalah pengecualiannya, dan pengecualian ini berupa penolakan, bukan diam: dry run tidak menulis apa pun sementara langkah pull menulis, sehingga kombinasi tersebut berhenti sebelum pekerjaan apa pun (lihat Mempratinjau build tanpa menulisnya).

Cara build membaca apa yang di-pin oleh lockfile

Pin lockfile menyebut konten — sebuah digest — bukan lokasi. Untuk entitas, pin adalah digest dari apa yang dimuat oleh publikasinya, yaitu dokumennya dan file yang disebutnya, sehingga salinan entitas di direktori katalog dan entri cache yang berisi publikasinya membawa pin yang sama, sebagaimana dijelaskan Lockfile. Build membaca setiap dependensi yang di-pin dari sumber yang sudah ada di mesin: pertama direktori katalog, seperti di tempat lain, lalu cache konten di bawah .aggrega/cache. Membacanya tidak menghubungi registry mana pun; hanya langkah pull, jika build menjalankannya, yang mengunduh.

Entri cache yang tidak lagi memuat pin-nya akan dilewati. Entitas yang disunting di tempat — isi baru di bawah version yang sama — membuat cache konten tetap menyimpan isi sebelumnya di bawah nama dan versi tersebut. Jika sebuah direktori katalog berisi salinan yang digest kontennya sama dengan pin, build membaca salinan tersebut dan tidak pernah membaca entri itu, dan build menyatakannya di standard error, dengan menyebut entri dan kedua digest:

reuse: cache entry for <name>:<version> holds <digest the entry holds>, not the pinned <pinned digest>; passed over for <catalog file>, which holds the pinned bytes

Jika tidak ada direktori katalog yang berisi entitas tersebut, entri cache lengkap yang memuat tepat byte yang di-pin dibaca sebagai dependensinya, sehingga entitas yang dihapus dari direktori katalognya setelah salinan terpublikasinya diunduh tetap di-build dari salinan tersebut.

Jika tidak ada sumber yang memuat byte yang di-pin, build berhenti sebelum apa pun di-render, dengan E0135 — atau E0133 jika manifest entri cache bukan manifest yang di-pin oleh lockfile. Penghentian ini menyebut pin, entri cache dan digest yang dimuatnya, serta setiap salinan entitas di direktori katalog beserta digest-nya, atau bahwa tidak ada direktori katalog yang memuatnya. Solusinya adalah pull dengan registry yang dapat dijangkau, yang mengunduh kembali versi yang di-pin dan mencocokkan hasil unduhannya dengan pin; lihat Mematuhi vs. memperbarui untuk apa yang dilakukan pull ketika registry tidak lagi menyajikan byte tersebut.

Render yang dijalankan aggrega pull untuk menemukan input eksternal, serta build atau pratinjau melalui aggrega serve atau aggrega mcp, membaca pin-nya dengan cara yang sama.

Input eksternal saat build

Sebuah render dapat meminta konten dari URL jarak jauh — misalnya skema values sebuah chart dengan referensi jarak jauh — dan build tidak pernah mengunduhnya untuk menambahkannya ke apa yang boleh dibaca render. Permintaan untuk URL yang sudah di-pin oleh lockfile dilayani dari penyimpanan input workspace dan diverifikasi terhadap digest yang tercatat sebelum satu byte pun mencapai render. Permintaan untuk URL yang tidak di-pin akan berhenti, dengan menyebut URL dan langkah yang mem-pin-nya; tidak ada pengaturan yang mengubah penghentian tersebut menjadi pengunduhan, karena diam-diam memperluas kumpulan input yang dibaca build adalah satu hal yang tidak boleh dilakukan build yang dapat direproduksi.

Jika salinan input yang di-pin di penyimpanan hilang, hanya input tersebut yang diunduh ulang berdasarkan digest yang sudah dicatat lockfile dan diperiksa terhadapnya sebelum apa pun ditulis atau dikembalikan. Hal itu tidak dapat mengubah apa yang dilihat render — digest sudah ditetapkan saat input di-pin — sehingga langkah ini memperbaiki penyimpanan alih-alih menambah closure, dan lockfile tetap tidak berubah byte demi byte. Dalam mode offline bahkan untuk itu pun tidak ada transport, dan salinan yang hilang justru menyebabkan penghentian, yang menyebut mode tersebut.

Pinning terjadi saat dependensi Release diselesaikan, sehingga apa yang boleh dibaca build sudah ditetapkan sebelum build dimulai. aggrega pull adalah langkah tersebut, dan merupakan satu-satunya.

Catatan kepercayaan plugin

Beberapa perilaku build bergantung pada plugins-trust.yaml, file yang di-commit di samping lockfile Release yang mencatat ke plugin mana setiap lampiran yang mengembalikan putusan diselesaikan — lampiran plugins.governance dalam peran ir-verdict atau render-verdict, dan setiap lampiran plugins.linter. aggrega pull menulisnya dan skema catatan kepercayaan plugin menjelaskan field-nya; yang berikut hanya tentang apa yang dilakukan build itu sendiri dengannya.

Build dicocokkan dengan catatan tersebut sebelum salah satu plugin itu berjalan. Plugin yang disajikan dari cache yang digest artefaknya bukan digest yang tercatat akan ditolak alih-alih dijalankan — itulah resolusi yang biasanya diambil lampiran semacam itu, dan aggrega pull menjelaskan cara-cara lain untuk menyelesaikannya yang tidak diatur oleh digest yang tercatat. Selain itu, entri tercatat yang tidak lagi diwakili oleh lampiran mana pun di .aggrega-config.yaml akan menghentikan build: menghapus sebuah gerbang tidak mengubah satu byte pun hasil render, sehingga output yang dihasilkan tanpa gerbang yang telah ditinjau tampak persis sama dengan output yang disetujui gerbang tersebut. Penghentian ini menyebut plugin tersebut dan menawarkan dua solusi yang berbeda menurut maksud Anda — lampirkan kembali jika penghapusannya keliru, atau minta penghapusan secara eksplisit jika tidak — dan mencetak perintah yang siap dijalankan. Lampiran yang belum dimuat catatan merupakan penampakan pertama, dan tidak satu pun dari kedua perbandingan berhenti karenanya.

Build mencocokkan setiap plugin tersebut dengan tanda tangan yang dicatat entrinya, persis seperti build mencocokkan entri lockfile dengan yang dicatat entri itu. Jika sebuah entri mencatat signature yang terverifikasi, build menghitung ulang hash bundle tanda tangan yang disebut fakta tersebut di cache sebelum apa pun di-render, dan berhenti dengan E0144 jika bundle tidak ada atau berbeda. Untuk plugin yang dibacanya dari cache konten, build juga membaca dari bundle itu untuk artefak mana tanda tangan dibuat, dan berhenti dengan E0332 jika tanda tangan dibuat untuk plugin yang berbeda dari yang dibaca build — begitulah tampilan signature yang disalin dari entri lain — apa pun yang dinyatakan persyaratan tanda tangan. Untuk plugin yang disajikan cache konten, kedua penolakan tersebut menyebut aggrega pull --release <release>: pull berikutnya memverifikasi ulang tanda tangan plugin, mencatat tanda tangan milik plugin itu sendiri, dan menyimpan ke cache bundle yang disebutnya, sambil menulis ulang salinan cache yang tidak lagi cocok dengan digest-nya. Jika konfigurasi kepercayaan workspace mensyaratkan tanda tangan untuk plugin yang dibaca build dari cache konten — dengan pengaturan yang sama yang akan membuat aggrega pull menolaknya tanpa tanda tangan, sehingga skip_signature_verification dan registry advisory membiarkan build berlanjut sebagaimana keduanya membiarkan pull berlanjut — entri yang tidak mencatat tanda tangan, atau tidak adanya entri sama sekali untuk plugin tersebut, menghentikan build dengan E0331, dengan menyebut plugin, plugins-trust.yaml, dan pengaturan yang mensyaratkan tanda tangan. Solusinya adalah aggrega pull --release <release>, yang memverifikasi tanda tangan plugin di registry-nya pada setiap eksekusi dan mencatatnya. Plugin yang disajikan dari salah satu direktori katalog Anda, atau dari salinan di dalam biner kompiler, tidak pernah tunduk pada persyaratan tersebut. Seperti bagian build lainnya, proses ini membaca file yang sudah ada di mesin dan tidak menanyakan apa pun kepada registry.

Build menyebutkan setiap penarikan yang dimuat catatan itu, di samping setiap penarikan yang dimuat lockfile. Penanda yang dicatat aggrega pull terhadap salah satu plugin tersebut dilaporkan sebagai baris deprecation: yang menyebutkan plugin, tingkat keparahan yang tercatat, dan pesan penerbit, pada setiap tingkat keparahan, dan build.halt_on_deprecated_severity menentukan apakah penanda itu juga menghentikan build, dengan aturan yang sama yang diterapkannya pada referensi yang di-pin. Setiap permukaan lain yang melaporkan tentang Release menyebutkan himpunan yang sama dengan kata-kata yang sama, dan tidak satu pun dari permukaan itu berhenti karenanya: aggrega validate --release, aggrega lint --release, aggrega inspect --closure, jawaban validasi dan closure dari language server, serta describe dan validate dari alat asisten. Catatan yang ada tetapi tidak dapat dibaca menghentikan build alih-alih diloloskan sebagai catatan yang tidak mencatat apa pun.

aggrega build --upgrade menulis ulang file tersebut. Perintah ini menyiratkan --auto-pull dan menjalankan penyegaran penuh tanpa argumen, yang menyelesaikan ulang setiap dependensi sehingga menyelesaikan ulang dan menulis ulang setiap identitas yang tercatat, serta membuang setiap entri yang tidak diwakili lampiran mana pun. Jadi, jika file ini tampak berubah setelah build upgrade, itulah sebabnya: jangkauan flag ini adalah setiap dependensi, dan identitas yang tercatat merupakan bagian dari apa yang diselesaikan ulang meskipun bukan pin lockfile. Tidak seperti aggrega pull --upgrade, flag build tidak menerima target, sehingga tidak dapat dipersempit ke satu plugin: untuk mengadopsi atau membuang satu identitas, jalankan aggrega pull --upgrade --release <release> <plugin> sebagai gantinya, yang membiarkan setiap pin lain dan setiap identitas tercatat lainnya tidak tersentuh.

Karena jangkauannya mencakup segalanya, perintah ini bertanya sebelum dimulai. aggrega build --upgrade mengonfirmasi penyegaran dengan ketentuan yang sama seperti aggrega pull --upgrade tanpa argumen — keduanya adalah tindakan yang sama, sehingga mengajukan pertanyaan yang sama. Berikan --yes untuk menjawab sebelumnya pada penggunaan non-interaktif; jika input standar bukan terminal dan tidak ada --yes, build menolak alih-alih menunggu jawaban yang tidak dapat diberikan siapa pun. Build yang tidak melakukan penyegaran tidak menanyakan apa pun.

Resolusi workspace dan determinisme

Referensi manifest: milik Release yang diwajibkan skema diselesaikan relatif terhadap file Release. Entri catalog_dirs yang relatif (dan path plugin relatif pada sistem file) diselesaikan terhadap direktori .aggrega-config.yaml yang mendeklarasikannya — “relatif” selalu berarti relatif terhadap file tempat Anda menuliskannya, sehingga sebuah path bermakna sama dari mana pun Anda memanggil aggrega. Flag --catalog, yang tidak memiliki file pendeklarasi, diselesaikan terhadap direktori kerja saat ini. Referensi registry (oci://…, referensi hub) dibiarkan apa adanya.

Root workspace adalah direktori dari .aggrega-config.yaml leluhur terdekat yang memuat blok workspace:, atau direktori yang disebut oleh --workspace-root. Ketika root ditetapkan dengan cara ini, build bersifat independen terhadap lokasi pemanggilan: menjalankan aggrega build dari root proyek dan dari subdirektori menghasilkan IR dan artefak hasil render yang identik byte demi byte, karena katalog yang dicari dan path sumber yang dicatat dalam output tidak bergeser mengikuti direktori kerja. (Tanpa penanda workspace: dan tanpa --workspace-root, direktori kerja menjadi root, sehingga output dijangkarkan di sana — kecuali direktori kerja tidak menjangkarkan apa pun dan --release menyebut Release dengan path absolut: root kemudian ditemukan kembali dari folder milik Release itu sendiri, sehingga katalog yang dicari dan path yang dicatat dalam output adalah milik proyek tempat Release tersebut berada, dari mana pun Anda menjalankan perintah. Lihat configuration.md.) Jika dengan cara itu pun tidak ditemukan workspace dan tidak ada yang menyebutnya, build memperingatkan di standard error bahwa folder yang digunakannya sebagai root tidak berada di dalam workspace, dan menyebut perintah yang menjadikannya workspace; build yang diminta untuk menyelesaikan dependensinya terlebih dahulu ditolak sebelum apa pun diunduh, karena cache yang diisi oleh resolusi tersebut akan ditulis di folder itu dan menjadikannya workspace. Build yang tidak menyelesaikan apa pun terlebih dahulu tetap me-render, tetapi dengan alasan yang sama, input eksternal yang di-pin lockfile dan tidak lagi dimuat cache tidak diunduh ulang: plugin yang memintanya diberi kalimat penolakan sebagai gantinya, sebagaimana plugin itu diberi kalimat mode offline, dan build melaporkan apa yang dilakukan plugin tersebut terhadapnya. --workspace-root atau AGGREGA_WORKSPACE_ROOT yang menyebut folder yang tidak ada akan ditolak sebelum build melakukan hal lain, dengan menyebut mana di antara keduanya yang memberikannya.

Variabel lingkungan

Pengaturan workspace yang dibaca build dapat ditimpa melalui lingkungan, di atas konfigurasi yang di-commit dan di bawah flag apa pun: AGGREGA_OFFLINE, AGGREGA_AUTO_PULL, AGGREGA_CATALOG_DIRS (dipisahkan sesuai daftar path sistem operasi; berikan path absolut), AGGREGA_ARTIFACT_CACHE_DIR, AGGREGA_DEFAULT_REGISTRY, dan AGGREGA_WORKSPACE_ROOT. Lihat environment-variables.md untuk daftar lengkap dan model prioritasnya.

Output

Artefak hasil render ditempatkan di bawah dist/ di bawah root workspace, dari folder mana pun perintah dijalankan — root itu sendiri, folder di bawahnya, atau folder di tempat lain dengan root yang disebut oleh --workspace-root atau AGGREGA_WORKSPACE_ROOT — dan baris penutup menyebut direktori tersebut secara lengkap:

Build completed: 4 files written to <workspace>/dist

<workspace> di sini mewakili root workspace, yang dituliskan baris tersebut sebagai path lengkap. Jika tidak ada workspace yang ditemukan dan tidak ada yang menyebutnya, folder tempat perintah dijalankan menjadi root, sehingga dist/ ditulis di sana. dist yang merupakan tautan yang mengarah ke luar workspace ditolak sebelum apa pun di dalamnya dihapus atau ditulis. Release yang tidak mendeklarasikan batas menulis per provider: dist/<provider>/<files>. Batas yang dideklarasikan tanpa directory: menulis per batas, per provider: dist/boundaries/<boundary-path>/<provider>/<files>. Override directory: dan subDirectory: yang ditulis operator pada batas Release mengubah path tujuan; penggabungan per (path, provider) menyatukan kontributor yang diselesaikan ke path terevaluasi yang sama.

File yang tidak ditulis oleh build

Build menulis file miliknya sendiri dan tidak menghapus apa pun yang tidak ditulisnya, dengan satu pengecualian: dist/boundaries/, yang dibuat ulang sepenuhnya oleh build, dikosongkan sebelum penulisan, sehingga file yang ditinggalkan di sana oleh build varian lain tidak terbawa ke pohon yang tidak lagi menghasilkannya. Semua hal lain di dist/ dibiarkan apa adanya — baik file yang ditulis build sebelumnya yang tidak lagi dihasilkan build ini, file yang ditempatkan di sana oleh directory: milik sebuah batas pada proses sebelumnya, maupun file yang Anda letakkan sendiri di sana — karena build tidak dapat membedakan sisa dari file yang sengaja Anda simpan di sana.

Sebagai gantinya, build memberi tahu Anda. Setelah file-filenya ditulis, build memeriksa dist/ itu sendiri dan setiap direktori di bawahnya yang ditulisi file olehnya atau yang dilewatinya untuk menulis file lebih dalam, lalu menyebutkan setiap file di sana yang tidak ditulisnya pada proses ini, dalam satu peringatan di standard error. File disebutkan berdasarkan jalurnya relatif terhadap dist/, diurutkan, sehingga pohon yang sama dilaporkan dengan cara yang sama pada setiap proses:

warning: the output directory holds 2 file(s) this build did not write, in directories it wrote into; nothing was removed, so they sit beside this build's output: "app/stale-from-earlier-run.yaml", "beside-the-tree.txt"

Baris penutup kemudian menghitungnya:

Build completed: 1 file written to <workspace>/dist, beside 2 files this build did not write

Direktori yang tidak ditulisi apa pun oleh build, dan tidak ada apa pun yang ditulis di bawahnya, tidak diperiksa, sehingga folder milik Anda sendiri yang disimpan di bawah dist/ tidak dicantumkan file demi file. Build yang tidak menemukan file semacam itu tidak mencetak peringatan, dan baris penutupnya adalah baris yang ditampilkan di bawah Keluaran. Dalam kedua kasus, file yang ditulis build adalah byte yang sama. Untuk membandingkan dua build, atau untuk memulai dari nol, hapus dist/ sebelum melakukan build.

Permintaan aggrega/build milik aggrega serve dan tool build milik asisten (aggrega mcp) menulis melalui langkah yang sama, sehingga keduanya menyebutkan file yang sama dalam kalimat yang sama: daemon sebagai salah satu notices pada jawabannya, dan tool sebagai yang terakhir dari advisories-nya. Dry run tidak menulis apa pun, sehingga tidak melaporkan semua ini.

Indentasi YAML

Setiap artefak YAML hasil render — file docker-compose, template dan values chart Helm, serta manifest Kubernetes — dikeluarkan dengan lebar indentasi yang seragam. Lebarnya diatur oleh build.yaml_indent di .aggrega-config.yaml dan default-nya 2 (lebar konvensional untuk format-format tersebut):

build:
yaml_indent: 2 # default; accepts 2 through 9

Lebar ini diterapkan pada satu titik serialisasi yang digunakan bersama oleh semua renderer, sehingga output tetap identik byte demi byte di setiap eksekusi dengan input yang sama. Nilai di luar rentang [2, 9] ditolak oleh validasi skema konfigurasi.

Mengembalikan graf yang dikompilasi

--ir-graph menulis graf yang diselesaikan build ini ke standard output sebagai JSON. Flag ini bersifat aditif: artefak tetap ditulis ke dist/, ringkasan tetap dicetak, dan byte hasil render tidak berubah. Graf dikeluarkan sebelum semua hal lain yang dicetak build di sana — satu dokumen JSON dan satu baris baru di akhir — sehingga konsumen yang mendekode aliran tersebut membacanya lalu berhenti.

Graf yang dikembalikan adalah graf yang dikonsumsi render, sehingga graf ini menggambarkan persis build yang menghasilkan artefak di sampingnya, bukan resolusi kedua dari Release yang sama. Flag ini dapat dikombinasikan dengan --dry-run: graf ditulis dan laporan artefak menyusul, tanpa ada yang ditulis ke disk.

Nilai yang dideklarasikan sensitif oleh penulis disembunyikan di dalamnya — termasuk values dan infra milik sebuah koneksi, jika socket komponen yang mengonsumsi mendeklarasikan sebuah leaf sebagai sensitif — dalam bentuk terstruktur yang dijelaskan di aggrega inspect. --unredacted di samping --ir-graph mencetaknya sebagai gantinya, dengan ketentuan yang dinyatakan aggrega inspect --unredacted: flag ini menjangkau graf dan tidak ada yang lain — file trace memiliki --trace-unredacted sendiri, dan artefak hasil render tidak pernah disembunyikan — dan apa pun yang dijangkau output kemudian memuat nilai-nilai tersebut dalam teks biasa. Jika diberikan tanpa --ir-graph, flag ini ditolak, karena tidak ada yang bisa diungkapkannya.

Flag yang sama, dengan makna yang sama, ada di aggrega inspect dan aggrega validate.

Mempratinjau build tanpa menulisnya

--dry-run menjalankan kompilasi yang sama dengan yang dijalankan build — gerbang dependensi yang sama, render yang sama, provider yang sama — dan mencetak apa yang akan dikeluarkannya alih-alih menulisnya. Setiap artefak dilaporkan beserta path yang akan ditempatinya dan konten yang akan dimuatnya:

aggrega build --release releases/production.yaml --dry-run
==> <workspace>/dist/main/helm/webapp-configmap-webapp.yaml <==
apiVersion: v1
kind: ConfigMap
...
Total build time: 2.5s
Dry run: 1 file would be written to <workspace>/dist; nothing was written

Artefak dilaporkan sesuai urutan build menuliskannya, sehingga input yang sama melaporkan byte yang sama dalam urutan yang sama, dan path yang dilaporkan adalah path yang akan ditulis oleh build — di bawah root workspace, dituliskan lengkap di tempat <workspace> muncul di atas.

Apa yang tidak ditulis. Direktori output dibiarkan persis seperti adanya — direktori itu juga tidak dibersihkan, sehingga output build sebelumnya tetap utuh setelah dry run. Lockfile tidak ditulis. Tidak ada yang ditulis ke .trace/.

Input eksternal berperilaku persis seperti pada build biasa, dengan ketentuan yang dijelaskan di Input eksternal saat build. Karena itu, dry run membaca closure yang di-pin yang sama dengan yang akan dibaca build yang diwakilinya, dan apa yang ditampilkannya adalah apa yang akan ditulis build tersebut.

Jika sebuah referensi ditolak, eksekusi menyebut setiap referensi yang tidak dapat dijangkaunya dan menunjuk ke perintah yang mem-pin-nya:

note: the lockfile does not pin every external reference this render requested, so the following were declined and the render stopped short of the artifacts it would otherwise emit:
- https://charts.example.com/values-schema.json
Run `aggrega pull --release releases/production.yaml` to pin the inputs the render needs, then run the dry run again

Jalankan aggrega pull sekali dan dry run memiliki semua yang dibutuhkannya; tidak ada hal lain yang berubah.

Dry run memerlukan lockfile dan tidak pernah mengisinya. Build bersifat baca-saja secara default, dan dry run tetap berpegang pada hal itu bagaimana pun pengisian diminta. --auto-pull dan --upgrade ditolak mentah-mentah (di bawah); pengaturan workspace auto_pull diabaikan untuk satu pemanggilan tersebut, sehingga workspace yang secara default mengisi tetap dapat dipratinjau. Tanpa lockfile, dry run berhenti dengan solusi yang sama dengan yang diberikan build baca-saja biasa: jalankan aggrega pull terlebih dahulu.

Flag yang ditolaknya. Tiga flag melakukan penulisan, sehingga memasangkannya dengan dry run tidak memiliki hasil yang jujur — mengabaikan penulisan akan membuat pengisian yang diminta lenyap, dan mematuhinya akan melanggar satu-satunya janji yang dibuat dry run. Setiap pasangan berhenti sebelum pekerjaan apa pun, dengan menyebut flag yang Anda berikan dan langkah yang harus dijalankan sebagai gantinya:

Dipasangkan denganAlasan penolakan
--auto-pullmengisi lockfile; jalankan aggrega pull sebagai langkah tersendiri
--upgrademenyelesaikan ulang setiap dependensi dan menulis ulang lockfile; jalankan aggrega pull --upgrade sebagai langkah tersendiri
--tracemenulis file per node ke .trace/; jalankan build dengan trace tanpa --dry-run

Semua hal lain dapat dikombinasikan seperti biasa. --verify-determinism me-render setiap node dua kali dan membandingkan byte-nya tanpa menulis satu pun, dan --catalog, --quiet, --progress, --debug, serta filter peringatan berperilaku persis seperti pada build yang menulis.

Untuk apa dry run, dan untuk apa bukan. Dry run menjawab “apa yang akan dikeluarkan Release ini”, pertanyaan yang hanya dapat dijawab oleh render — jadi dry run bukan pengganti aggrega validate, yang memeriksa kebenaran tanpa me-render, atau aggrega inspect, yang mengkueri graf sebelum render. Gunakan dry run ketika jawaban yang Anda inginkan adalah artefak itu sendiri: meninjau apa yang dilakukan perubahan Release terhadap output, atau memeriksa suntingan Recipe sebelum meng-commit apa pun ke dist/.

Output trace

Flag --trace mengaktifkan dump debug per node yang merekam setiap status antara kompiler. Output berada di .trace/ di bawah root workspace, di samping dist/ (tidak pernah di bawahnya; tata letak berdampingan ini mengikuti konvensi .git/, .terraform/, node_modules/ dan menjaga dist/ tetap murni dapat di-deploy).

Tata letak direktori adalah per batas, per instans:

.trace/
└── boundaries/
└── <boundary-path>/
└── <instance-id>/
├── 01-pillars-initial.yaml
├── 02-provides-evaluation.yaml
├── 03-inject-hydration.yaml
├── 04-inject-mapping.yaml
├── 05-source-resolution.yaml
├── 06-source-locals.yaml
├── 07-values-mapping.yaml
├── 08-workload-synthesis.yaml
├── 09-artifact-evaluation/
│ └── <per-artifact-file>.yaml
├── 09b-feature-rendering-boundary.yaml
├── 10-engine-synthesis/
│ └── <per-synthesized-file>.yaml
├── 11-engine-emission.log
└── 12-labels-injected.log

Setiap slot merekam status kompiler tertentu:

  • 01-pillars-initial.yaml — snapshot per node dari konteks yang dibaca template, diambil setelah resolusi dan sebelum mutasi per tahap apa pun. Memuat .values, .infra, .context, .parameters, .metadata.
  • 02-provides-evaluation.yaml — output provides: yang telah diselesaikan setelah evaluasi provides.
  • 03-inject-hydration.yaml — pipe .context.inject yang telah digabungkan setelah hidrasi inject (tampilan sisi konsumen dari provides hulu).
  • 04-inject-mapping.yaml — pipe .context.inject setelah penulisan ulang injectMapping milik FeatureRecipe.
  • 05-source-resolution.yaml — konten source: yang telah di-parse yang akan dikonsumsi provider. Hanya ada jika Recipe mendeklarasikan source:.
  • 06-source-locals.yaml — blok locals: yang telah diselesaikan. Resolusi sumber memublikasikan .locals sebelum mengevaluasi template source:, itulah sebabnya slot ini ditulis baik Recipe mendeklarasikan source: maupun tidak.
  • 07-values-mapping.yaml — output hasil render valuesMapping: (kamus yang diterima provider). Hanya ada jika Recipe mendeklarasikan valuesMapping:.
  • 08-workload-synthesis.yaml — konteks sebagaimana adanya saat template workload: dievaluasi dan output-nya di-parse. Hanya ada jika Recipe mendeklarasikan workload: (inline atau dimuat dengan $import:). Workload hasil parse itu sendiri tidak ada di slot ini: ia muncul mulai dari 09-artifact-evaluation/, setelah sudah mapan dan tidak lagi dalam proses.
  • 09-artifact-evaluation/ — satu file per artefak yang dievaluasi. Hanya ada jika Recipe mendeklarasikan artifacts: (dengan entri inline atau dimuat per entri dengan $import:).
  • 09b-feature-rendering-boundary.yaml — konteks saat render node berakhir, setelah FeatureRecipes yang dilampirkan padanya menghasilkan sumber dayanya, dengan workload yang telah di-parse di sampingnya. Ditulis untuk setiap node.
  • 10-engine-synthesis/ — satu file per manifest tersintesis yang dihasilkan provider dari Workload (mode workload helm/compose). Hanya ada jika provider menjalankan jalur sintesis.
  • 11-engine-emission.log — ringkasan pasca-emisi (jumlah file, path output) untuk node tersebut.
  • 12-labels-injected.log — label dan anotasi provenans yang ditulis ke output hasil render untuk node tersebut.

Mulai dari 03-inject-hydration.yaml dan seterusnya, slot yang menampilkan konteks node memuat blok .context.inject setiap kali pipa yang ditangkapnya mengirimkan setidaknya satu kunci, di bawah mekanisme apa pun: env, file, arg, atau mekanisme dengan nama lain yang ditulisi oleh mapping inject, oleh injectMapping milik FeatureRecipe, atau oleh blok inject: milik komponen itu sendiri. Node yang satu-satunya pengirimannya adalah mekanisme kustom semacam itu juga menampilkan blok tersebut, dengan mekanisme itu di bawah namanya sendiri dan kunci-kuncinya di all, dan nilai yang dideklarasikan sensitif terbaca sebagai <redacted> di kedua tempat. Slot yang diambil saat pipa tidak mengirimkan apa pun tidak memiliki blok .context.inject.

Penulis trace bersifat non-blocking: trace ditulis ke disk berdampingan dengan kompilasi, bukan di jalurnya. Latensi kompilasi tidak terpengaruh oleh I/O trace — kompilasi yang sama selesai dalam waktu nyata yang sama, baik --trace aktif maupun tidak.

Nilai yang dideklarasikan sensitif di dalam trace

Datum yang dideklarasikan sensitif oleh penulis — leaf skema yang membawa sensitive: true, atau kunci pengiriman yang materialnya berasal dari kunci provides yang membawanya — ditulis ke trace sebagai teks tetap <redacted>. Kuncinya dipertahankan dan hanya nilainya yang diganti, sehingga slot tetap menunjukkan leaf dan kunci pengiriman mana yang dibawa sebuah node. Saudara yang tidak dideklarasikan di blok yang sama mencetak nilainya apa adanya; penggantian mengikuti deklarasi dan tidak ada yang lain.

Nilai yang dikirim FeatureRecipe melalui injectMapping miliknya sendiri juga disembunyikan. Itulah jalur yang diserahi pengiriman oleh slot yang mendeklarasikan daftar inject kosong, dan jalur yang ditempuh realisasi kredensial khusus inject. Kunci pengiriman yang ditulis mapping semacam itu sendiri merupakan template, sehingga tidak ada deklarasi yang menyebutnya; yang dibaca sebagai gantinya adalah teks mapping itu sendiri. Ketika teks tersebut mereferensikan leaf values atau infra yang dideklarasikan sensitive: true oleh Feature yang dilampirkan, setiap kunci pengiriman yang dihasilkan mapping dibaca sebagai <redacted> — termasuk kunci yang tidak membawa apa pun yang sensitif, karena pembacaannya per lampiran, bukan per kunci. Mapping yang tidak mereferensikan apa pun yang dideklarasikan mencetak kuncinya apa adanya.

Nilai yang dihitung template dari datum yang dideklarasikan sensitif juga disembunyikan, meskipun kuncinya sendiri tidak membawa deklarasi. Yang mengidentifikasinya adalah referensi yang ditulis penulis: entri locals: yang template-nya membaca leaf yang dideklarasikan sensitif disembunyikan, demikian pula field source: yang melakukannya. Pembacaannya konservatif — template yang menjangkau seluruh objek menjangkau setiap leaf yang dideklarasikan di bawahnya, sehingga {{ range $k, $v := .values.creds }} menyembunyikan output-nya ketika ada apa pun di bawah creds yang dideklarasikan — dan entri locals: yang membaca saudara yang sudah disembunyikan pada gilirannya ikut disembunyikan. Entri saudara dengan bentuk yang sama yang tidak membaca apa pun yang dideklarasikan dicetak apa adanya.

Nilai yang melintasi edge uses disembunyikan berdasarkan deklarasi target, bukan node yang mengonsumsi, dan disembunyikan di kedua permukaan tempat edge membawanya. .context.uses.<alias>.provides mereproduksi apa yang dipublikasikan komponen target, sehingga yang mengatur nilai-nilai itu adalah skema target: kunci provides yang dideklarasikan sensitif oleh target dibaca sebagai <redacted> di slot konsumen bahkan ketika konsumen sama sekali tidak mendeklarasikan apa pun. Ketika blok inject milik edge itu sendiri merutekan kunci tersebut ke kunci pengiriman komponen yang mengonsumsi, .context.inject juga menyembunyikan kunci pengiriman itu — aturan yang sama yang sudah diikuti mapping inject sebuah lampiran, dengan membaca deklarasi yang sama. Penyembunyian dilakukan per edge, sehingga dua edge yang memublikasikan nama kunci provides yang sama diselesaikan secara independen: edge yang target-nya mendeklarasikannya disembunyikan dan yang lain dicetak apa adanya. Bagian lain dari edge — target-nya, socket-nya, label-nya, dan nama-nama kunci milik mapping inject itu sendiri — bukanlah yang diatur oleh deklarasi provides milik target, dan dicetak apa adanya.

Sebaliknya, values dan infra per koneksi yang ditulis pada edge itu sendiri diatur oleh socket komponen yang mengonsumsi: valueSchema dan infraSchema yang dideklarasikan socket itu, yang merupakan kontrak tempat konfigurasi tersebut divalidasi. Leaf yang dideklarasikan sensitive: true oleh salah satu kontrak terbaca sebagai <redacted> di .context.uses.<alias>.values atau .context.uses.<alias>.infra, dengan kuncinya tetap ada, begitu pula leaf yang berada pada nilai default yang dideklarasikan kontrak; sibling yang tidak dideklarasikan dicetak apa adanya. Deklarasi target tidak berperan di sini, dan penyembunyian dilakukan per koneksi, sehingga leaf dengan nama yang sama pada koneksi yang socket-nya mendeklarasikannya sebagai dapat dibaca dicetak apa adanya.

Lampiran yang ditulis pada sebuah koneksi ditampilkan di bawah edge koneksi tersebut, di .context.uses.<alias>.features.<slot>, dan masing-masing disembunyikan berdasarkan deklarasi Feature miliknya sendiri — deklarasi yang sama yang mengatur Feature tersebut ketika sebuah komponen memegangnya secara langsung. Leaf values atau infra yang dideklarasikan sensitive: true oleh Feature dibaca sebagai <redacted>, demikian pula kunci dari provides lampiran yang telah diselesaikan yang dideklarasikan sensitif oleh Feature; setiap kunci dipertahankan. Tipe, versi, dan label lampiran, serta setiap leaf dan kunci provides yang tidak dideklarasikan oleh Feature-nya, dicetak apa adanya, sehingga locator yang dipublikasikan tetap terbaca di samping material yang ditunjuknya. Penyembunyian dilakukan per koneksi dan slot, sehingga Feature yang sama yang ditulis pada dua koneksi diselesaikan pada masing-masing. Slot yang mendeklarasikan sensitive: true — pada komponen atau pada socket-nya — menyatakan bahwa lampiran tersebut menangani material rahasia dan tidak menyembunyikan leaf apa pun dengan sendirinya: leaf mana yang disembunyikan adalah wewenang Feature untuk mendeklarasikannya. Lampiran milik komponen itu sendiri tidak termasuk blok yang ditampilkan slot, karena trace tidak membawa blok .features; apa yang dibaca template workload: dari salah satunya dicakup oleh render ulang di bawah.

Workload hasil parse adalah render ulang, bukan tangkapan dokumen yang dikeluarkan build, dan slot yang membawanya — 09-artifact-evaluation/, 10-engine-synthesis/, dan 09b-feature-rendering-boundary.yaml — menyatakannya dalam entri workload_note di sampingnya. Dokumen hasil render tidak mencatat apa pun tentang dari deklarasi mana suatu karakter berasal, sehingga tidak ada kunci di dalamnya tempat penggantian dapat dilakukan. Yang ditampilkan trace sebagai gantinya adalah template workload: yang sama yang dievaluasi untuk kedua kalinya, terhadap konteks yang data sensitif terdeklarasinya sudah dibaca sebagai <redacted>. Karena template melihat string di tempat yang memang berisi string, hasilnya mempertahankan bentuk dokumen yang dikeluarkan: field yang sama, di tempat yang sama, dengan <redacted> berada tepat di posisi datum yang disembunyikan dan teks literal di sekitarnya tidak berubah.

Dua hal yang membedakan render ulang tersebut dari apa yang dikeluarkan, keduanya dinyatakan dalam catatan:

  • Template yang bercabang berdasarkan konten sebuah nilai akan me-render secara berbeda. eq terhadap nilai tertentu, uji panjang, hash, atau encoding nilai tersebut: masing-masing melihat <redacted> dan menghasilkan hasil yang berbeda — cabang yang berbeda, panjang yang berbeda, digest yang berbeda. Inilah sebabnya trace tidak pernah mengklaim menampilkan dokumen yang dikeluarkan.
  • Data yang tidak disebut oleh deklarasi apa pun diteruskan tanpa perubahan. Penggantian mencakup apa yang disebut oleh sumbu — leaf values / infra yang dideklarasikan, kunci pengiriman yang ditandai, kunci provides yang dideklarasikan sensitif oleh Component milik komponen itu sendiri, provides yang dideklarasikan dari target yang dikonsumsi, leaf dari values atau infra milik koneksi itu sendiri yang dideklarasikan sensitif oleh socket-nya, leaf atau kunci provides yang dideklarasikan dari lampiran yang dipegang komponen itu sendiri (dibaca di .features.<name>) atau dari lampiran yang ditulis pada koneksi, dan nilai locals: atau source: yang dihitung dari salah satunya. Itulah data yang sama yang menjadi dasar penyembunyian penolakan yang dimunculkan oleh template. Datum yang mencapai template melalui jalur lain, seperti kunci provides yang tidak disebut deklarasi apa pun yang nilainya dihitung sebuah Recipe dari leaf yang dideklarasikan, muncul dalam render ulang persis seperti kemunculannya dalam dokumen yang dikeluarkan.

Ketika render ulang sama sekali tidak dapat dihasilkan, slot mempertahankan kunci workload: dan mengganti dokumen dengan satu baris yang menyatakan hal itu dan menyebut --trace-unredacted. Pernyataan ini disengaja: proyeksi yang begitu saja lenyap tidak akan dapat dibedakan dari Recipe yang sama sekali tidak mendeklarasikan workload:.

Ada satu batasan yang perlu dibaca sebelum menganggap .trace/ aman: dist/ tidak disamarkan. Artefak hasil render dikeluarkan persis seperti yang dihasilkan render, karena artefak itulah yang di-deploy, dan render ulang trace tidak pernah menjangkaunya — input yang sama di-render secara identik byte demi byte, baik --trace aktif maupun tidak.

Perlakukan .trace/ sebagai pembawa material sensitif dan tangani seperti cara dist/ ditangani.

Menampilkan nilai yang disembunyikan

--trace-unredacted, bersama --trace, menulis nilai yang dideklarasikan sensitif ke dalam file trace alih-alih teks yang menggantikannya. Opsi ini ada karena nilai yang disembunyikan terkadang justru nilai yang sedang di-debug — kredensial yang datang dari lampiran yang salah terlihat sama persis dengan yang benar ketika keduanya tampil sebagai disembunyikan.

Ini juga cara menangkap dokumen yang benar-benar dikeluarkan oleh build: tanpa ada yang disembunyikan, tidak ada yang perlu disubstitusi, sehingga slot workload: memuat dokumen yang dikeluarkan alih-alih render ulangnya, dan entri workload_note tidak ada.

Tiga sifat membatasinya:

  • Setiap file yang ditulisnya menyatakan apa dirinya. Setiap file trace yang dihasilkan oleh proses dibuka dengan komentar yang menyebut flag tersebut dan menyatakan bahwa nilai yang dideklarasikan sensitif muncul di bawahnya dalam bentuk teks biasa, sehingga file yang kemudian dilampirkan ke laporan bug atau ditinggalkan di direktori bersama membawa peringatannya sendiri. Komentar tersebut valid dalam format file itu sendiri, sehingga file tetap dapat di-parse.
  • Opsi ini menjangkau .trace/ dan tidak ada yang lain. Artefak yang dirender identik byte demi byte dengan maupun tanpa opsi ini — opsi ini mengubah apa yang ditampilkan file debug, tidak pernah mengubah apa yang dihasilkan build — dan tata letak aggrega inspect serta teks diagnostik yang dicetak oleh build yang gagal identik dalam kedua keadaan.
  • Opsi ini hanya berlaku pada pemanggilan. Tidak ada pengaturan konfigurasi untuknya, sehingga opsi ini tidak dapat diaktifkan sekali lalu dibiarkan aktif bagi semua orang yang mem-build workspace sesudahnya. Memintanya tanpa --trace menghentikan build dengan pesan yang menyebut kedua flag, alih-alih menerima permintaan yang tidak dapat dipenuhinya.

Terpisah dari trace, build mencetak satu pemberitahuan untuk setiap kunci pengiriman yang membawa materi yang dideklarasikan sensitif sebagai nilai literal, dengan menyebut komponen, target, lampiran, dan kunci pengiriman. Pemberitahuan ini tidak pernah menghentikan build dan --no-unsupported-field-warnings tidak membungkamnya — flag tersebut mencakup apa yang tidak dapat dipenuhi target dari hal-hal yang Anda tulis, kelas yang berbeda.

Kata kunci tersebut, dua tempat penulisannya, kata-kata persis pemberitahuannya, dan batas lengkap dari apa yang dicapai dengan mendeklarasikannya ada di vocabulary/compact-form-authoring.md, “Mendeklarasikan daun sebagai sensitif”.

Kapan menggunakan --trace

  • Mendiagnosis mengapa manifest yang dirender tidak memuat nilai yang diharapkan: telusuri dump per pass untuk menemukan slot pertama tempat nilai tersebut hilang.
  • Memverifikasi determinisme setelah peningkatan compiler: dua kompilasi dari input yang sama dengan --trace menghasilkan dump trace yang identik byte demi byte; setiap perbedaan per slot melokalisasi regresinya.
  • Iterasi penulisan katalog: membandingkan snapshot 04-inject-mapping.yaml dan 06-source-locals.yaml menunjukkan apa yang dilihat template Recipe pada saat evaluasi.

Contoh

Mengompilasi Release terhadap katalog lokal:

aggrega build --release releases/production.yaml

Mengompilasi dengan direktori katalog terpisah:

aggrega build --release releases/production.yaml --catalog ../platform-catalog/

Melihat apa yang akan dikeluarkan Release tanpa menulis apa pun darinya:

aggrega build --release releases/production.yaml --dry-run

Mengompilasi dengan dump trace untuk debugging:

aggrega build --release releases/production.yaml --trace

Setelah kompilasi, periksa .trace/boundaries/<boundary>/<instance>/ untuk status per pass. Direktori .trace/ ditimpa pada setiap proses --trace; status trace sebelumnya tidak dipertahankan antarkompilasi.

Rujukan silang

  • aggrega-pull — mengambil entitas katalog dari registry OCI ke dalam katalog lokal.
  • aggrega-validate — memeriksa kebenaran katalog, penutupan Release, atau satu entitas tanpa mengeluarkan artefak; validasi dependensi yang dijalankan build, tanpa render.
  • aggrega-lint — memeriksa konvensi publikasi katalog di tiga cakupan yang sama.
  • aggrega-inspect — mengkueri graf IR setelah finalisasi graf tanpa melanjutkan ke render.
  • Error — format penyajian error terkategori yang muncul di CLI.

Sinopsis

aggrega build [flags]

Deskripsi

Compile an Aggregate and Release pair into provider-native artifacts under each
boundary's output directory.
The Release is the single entry point: it names the Aggregate and the Manifest,
declares the boundaries, and routes each component to a provider. What a
provider emits is the provider's own shape — Helm manifests, a redistributable
Helm chart, docker-compose YAML — so the output directory holds whatever the
providers this Release routes to produce.
The output directory is dist/ beneath the workspace root, whichever folder the
command is run from, and the closing line names it in full. A run that finds no
workspace uses the folder it was run from as the root, and writes dist/ there.
Build is read-only by default and needs a lockfile. Run "aggrega pull" first to
create one, or pass --auto-pull to fill it in-process for this build.
Given identical input, build writes byte-identical output, which is what makes
the rendered tree reviewable as a diff.

Flag

FlagDefaultDeskripsi
--auto-pullfalseMenjalankan langkah pull sebelum build: me-resolve dependensi Release ke dalam lockfile dan cache di dalam proses, lalu mem-build terhadapnya. Ini adalah pengisian di dalam proses yang sama dengan yang dilakukan pengaturan auto_pull workspace, diaktifkan untuk satu build tanpa mengedit konfigurasi workspace. Dengan sendirinya ini adalah pengisian inkremental — pin yang ada dihormati, dan referensi tanpa pin di-resolve dan ditambahkan
--catalog[]Direktori katalog; dapat diulang. Setiap —catalog <dir> ditambahkan di awal tumpukan pencarian katalog (kecocokan pertama yang menang): catalog_dirs milik workspace, atau, untuk Release yang diberi direktori sendiri oleh konfigurasi workspace di bawah workspace.releases, milik Release tersebut; tumpukan diakhiri dengan direktori bernama catalog di root workspace jika ada. Daftar catalog_dirs yang ditulis kosong tidak membaca katalog lokal sama sekali.
--debugfalseMengeluarkan diagnostik verbose yang dapat dibaca manusia di stderr — waktu nyata per fase dan jumlah entitas/dependensi. Mengalahkan —quiet: output verbose selalu dikeluarkan. Berbeda dari —trace, yang menulis file perantara per node yang dapat dibaca mesin ke .trace/
--detailfalseBuild bersifat hanya-baca secara default dan tidak mencetak detail resolusi. Ketika langkah pull berjalan — karena —auto-pull diberikan atau workspace mengaktifkan auto_pull — build mengisi lockfile di dalam proses, baik sudah ada maupun belum, dan flag ini mencetak untuk setiap entitas yang di-resolve apa yang dilakukan pengisian tersebut: diambil baru dari registry, menggunakan ulang slot cache, ditemukan di katalog lokal, disajikan dari dalam biner compiler, atau eksternal (Aggregate atau Manifest milik Release itu sendiri, dibaca dari file atau entri yang disebut Release). Ketika tidak ada langkah pull yang berjalan, flag ini mencetak satu baris yang menyatakan hal itu alih-alih baris per entitas. Hanya stdout; tidak disimpan
--disable-plugin-cachefalseMelewati cache kompilasi plugin persisten di disk untuk build ini dan mengompilasi guest plugin dari awal dalam cache di memori yang dibuang ketika build selesai. Nonaktif secara default, yang menggunakan ulang cache bersama di disk antarbuild. Tidak mengubah output yang dirender
--dry-runfalseMerender Release dan mencetak apa yang akan dikeluarkannya alih-alih menulisnya: path calon setiap artefak dan isinya dikirim ke stdout, serta direktori output dan lockfile dibiarkan tidak tersentuh. Input eksternal berperilaku persis seperti pada build biasa — input yang di-pin disajikan dari penyimpanan beralamat konten (dan diisi ulang berdasarkan digest ketika blob hilang), dan render yang meminta URL eksternal yang tidak di-pin berhenti dengan menyebutnya — sehingga apa yang ditampilkan dry run adalah apa yang akan ditulis build. Menolak digabungkan dengan —auto-pull, —upgrade, atau —trace, yang masing-masing menulis — jalankan pengisian dependensi, atau build dengan trace, sebagai langkah tersendiri. Dapat digabungkan dengan —policy-input, yang berkasnya kemudian menjadi satu-satunya hal yang ditulisnya
--ir-graphfalseJuga menulis graf IR yang dihitung proses ini ke stdout, sebagai JSON, selain semua yang sudah dihasilkan perintah ini. Nilai yang dideklarasikan sensitif oleh penulis disembunyikan darinya; berikan —unredacted untuk mencetaknya sebagai gantinya. Artefak tetap ditulis dan ringkasan tetap dicetak; graf ditulis sebelum keduanya
--no-unsupported-field-warningsfalseMembungkam kelas peringatan bidang yang tidak didukung: pemberitahuan yang dimunculkan target untuk sesuatu yang Anda tulis tetapi tidak dapat dipenuhinya — bidang Workload yang tidak dapat diekspresikannya (seperti pada target berfidelitas lebih rendah seperti compose), atau anotasi aggrega.ai/ yang tidak ditindaklanjutinya untuk jenis input node. Peringatan render lainnya tetap muncul. Hanya tampilan; tidak mengubah output yang dirender
--policy-input—Menulis ke direktori ini payload yang diserahkan setiap peran tata kelola kepada plugin yang dilampirkan di sana, sebagai satu baris JSON: persis apa yang diserahkan build kepada plugin, dengan setiap nilai yang disembunyikan build darinya tetap disembunyikan. Untuk annotation-transform, label-transform, dan ir-verdict, file tersebut adalah dokumen input yang dibaca kebijakan pada peran itu. Untuk render-verdict, mesin kebijakan membentuk ulang payload sebelum kebijakan membacanya — documents setiap artefak di-parse darinya — sehingga kebijakan render-verdict pada mesin bawaan diuji dalam build, dilampirkan sedemikian rupa sehingga melapor pada warn atau info; untuk plugin yang .wasm-nya Anda build sendiri, aggrega plugin run-local --plugin <plugin.wasm> --export verdict_render --with @<dir>/render-verdict.json menjalankannya pada file tersebut. Peran tanpa lampiran apa pun juga ditulis, sebagai payload yang akan diterima lampiran tanpa sumber dan tanpa pengaturan, sehingga kebijakan dapat ditulis sebelum dilampirkan. Setiap peran ditulis ke <role>.json (annotation-transform, label-transform, ir-verdict, render-verdict); bila lampiran pada satu peran menerima payload yang berbeda — salah satunya membawa sumber atau pengaturannya sendiri, atau sebuah transformasi mengubah apa yang dibaca lampiran berikutnya — masing-masing ditulis ke <role>.<position>.<plugin>.json sebagai gantinya, dengan position menghitung lampiran peran itu mulai dari 1 sesuai urutan konfigurasi workspace mencantumkannya dan plugin sebagai segmen terakhir referensi plugin tanpa versinya, dengan setiap karakter yang tidak dapat dimuat nama file di-escape. File dengan nama tersebut yang sudah ada di direktori diganti dan tidak ada hal lain di sana yang disentuh. File ditulis baik build selesai maupun berhenti, dan build yang berhenti sebelum sebuah peran berjalan menyebutkan setiap peran yang tidak ia tulisi file. Meminta file ini tidak mengubah artefak apa pun maupun putusan apa pun. Dapat digabungkan dengan —dry-run, yang kemudian hanya menulis file ini dan tidak ada yang lain: direktori output dan lockfile dibiarkan tidak tersentuh
--progressfalseMemaksa tampilan progres build tetap aktif bahkan ketika stderr bukan terminal, dengan mencetak satu baris sederhana per langkah saat langkah itu selesai, beserta waktunya. Default-nya adalah auto: daftar periksa fase interaktif hanya ditampilkan ketika stderr adalah terminal yang menafsirkan escape sequence, terminal yang tidak menafsirkannya mendapat baris sederhana yang sama, dan output yang dialihkan atau di-pipe tidak mendapat apa pun. —quiet dan —debug sama-sama mengesampingkan —progress
--quietfalseMembungkam tampilan progres build di stderr. Tidak memengaruhi stdout. Didahulukan atas —progress
--release—Path ke file YAML Release (wajib). Path relatif di-resolve terhadap direktori tempat Anda menjalankan perintah, bukan terhadap root workspace. Jika direktori tersebut tidak berada di workspace mana pun dan tidak ada root yang disebut, path absolut menemukan workspace dari folder milik Release itu sendiri
--tracefalsemenulis file perantara per node ke .trace/ di bawah root workspace, di samping dist/, untuk pemeriksaan pascakejadian
--trace-unredactedfalseMenulis nilai yang dideklarasikan sensitif ke dalam file .trace/ alih-alih teks yang menggantikannya, dan membubuhkan header yang menyatakan hal itu pada setiap file yang ditulis trace. Memerlukan —trace. Opsi ini menjangkau .trace/ dan tidak ada yang lain: artefak yang dirender, output aggrega inspect, dan teks diagnostik identik dengan maupun tanpa opsi ini. Hanya untuk pemanggilan — tidak ada pengaturan konfigurasi workspace untuknya, sehingga opsi ini tidak pernah dapat dibiarkan aktif untuk build berikutnya
--unredactedfalseMencetak nilai yang dideklarasikan sensitif oleh penulis alih-alih menyembunyikannya. Apa pun yang dijangkau output — terminal, pipe, file, rekaman layar — kemudian membawa nilai tersebut dalam teks biasa. Menjangkau graf yang ditulis —ir-graph dan tidak ada yang lain, sehingga memerlukan —ir-graph; file .trace/ menggunakan —trace-unredacted sebagai gantinya
--upgradefalseMenjadikan langkah auto-pull penyegaran penuh: membuang lockfile yang ada dan me-resolve ulang setiap dependensi dari status registry saat ini, menaikkan masing-masing ke versi tertinggi yang tersedia alih-alih menghormati pin yang ada. Menyiratkan —auto-pull — dengan sendirinya menjalankan pull penyegaran penuh sebelum build. Opsi ini tidak menerima target, sehingga tidak dapat dipersempit ke satu dependensi: untuk mengadopsi atau membuang satu pin, jalankan aggrega pull —upgrade —release sebagai gantinya, yang mempertahankan setiap pin lain tanpa perubahan. Karena membuang setiap pin yang tercatat, opsi ini meminta konfirmasi terlebih dahulu; —yes menjawab di muka, dan pada stdin non-interaktif opsi ini menolak alih-alih menunggu jawaban yang tidak dapat diberikan siapa pun
--verify-determinismfalseMerender setiap node dua kali dan membandingkan byte yang dikeluarkan, menghentikan build jika dua render dari node mana pun berbeda. Nonaktif secara default. Gunakan untuk memastikan bahwa provider merender secara deterministik — input yang identik menghasilkan output yang identik byte demi byte — yang menjadi sandaran jaminan diff GitOps dan output yang identik byte demi byte
--yesfalseMenjawab konfirmasi —upgrade di muka, untuk penggunaan non-interaktif. Opsi ini menjangkau satu prompt itu saja dan tidak ada yang lain: build yang tidak melakukan penyegaran tidak menanyakan apa pun, sehingga memberikannya di sana tidak mengubah perilaku apa pun