aggrega pull
aggrega pull me-resolve semua dependensi sebuah Release dan menulis lockfile yang mengunci setiap dependensi ke versi dan digest konten yang persis. aggrega build berikutnya menggunakan apa yang dikunci lockfile, memverifikasinya, dan berhenti dengan menyebutkan apa pun yang dibutuhkannya yang tidak dikunci di sana — sehingga build dapat direproduksi dan dapat berjalan offline.
Segala sesuatu yang dikonsumsi build dikunci pada satu momen ini. Entitas katalog, artefak sumber yang ditunjuk sebuah Recipe untuk provider, dan dokumen jarak jauh yang diminta provider saat merender di-resolve oleh perintah yang sama dan dicatat dalam penulisan lockfile yang sama. aggrega pull adalah langkah yang menyentuh jaringan; build tidak. Itulah keseluruhan aturannya, dan sisa halaman ini adalah apa yang mengikutinya.
Apa yang dilakukannya
aggrega pull me-resolve tiga jenis dependensi dalam satu kali lintasan:
- Entitas katalog — Components, Features, Recipes, FeatureRecipes, pustaka skema dan pemetaan, serta plugin Wasm yang dirujuk oleh Release, di-resolve secara transitif (melalui
extends:,implements:,aggregate:, lampiran Feature, dan titik$import:/$ref:pada pustaka) dan diambil dari registry jika belum tersedia secara lokal. - Artefak sumber —
source:jarak jauh yang ditunjuk oleh suatu Recipe atau FeatureRecipe untuk sebuah provider: chart Helm (OCI atau HTTPS klasik) atau fragmen Compose melalui HTTPS. Masing-masing diambil, di-cache, dan di-pin. - Input eksternal — dokumen jarak jauh yang diminta provider dari host saat merender, misalnya
$refdalamvalues.schema.jsonsebuah chart yang menunjuk ke sebuah URL. Masing-masing diambil, disimpan di bawah digest kontennya, dan di-pin.
Dua dari ketiganya dibaca dari dokumen yang Anda tulis. Yang ketiga tidak: input eksternal ditemukan dengan merender Release, itulah sebabnya perintah ini melakukan render. Menjalankan perintah ini tidak memerlukan semua itu — Cara resolusi menemukan input eksternal menjelaskannya secara lengkap, beserta biaya render, apa yang terjadi bila render tidak dapat selesai, dan bagaimana build yang mengisi lockfile-nya sendiri berkaitan dengannya.
Entitas katalog yang disebut tanpa registry diambil melalui default_registry milik workspace, dan jalur repositori yang dimuat oleh default tersebut adalah tempat entitas itu diambil. Dengan default_registry: ghcr.io/acme, core/api-server diambil dari ghcr.io/acme/component/core/api-server — tempat aggrega push menerbitkannya melalui default yang sama — dan tanda tangannya dicari di sana. Jalur hanya menunjukkan lokasi: tanda tangan yang diwajibkan oleh pull, kunci dan identitas yang dipercayainya, serta kredensial yang diajukannya adalah yang disimpan untuk host, sehingga entri registries untuk ghcr.io mengatur setiap jalur pada host tersebut. Lockfile mencatat entitas semacam itu berdasarkan identitas, versi, dan digest-nya, sama seperti mencatat entitas yang diambil dari host saja. Cara penulisan jalur dijelaskan dalam cara menulis host registry.
Perintah ini menulis hasilnya ke <release-stem>.lock di samping Release. Workspace yang melampirkan plugin yang mengembalikan putusan terima-atau-tolak juga mendapatkan file kedua di direktori tersebut — catatan kepercayaan plugin.
Pull yang diminta untuk melakukan pin menulis satu jenis file lagi. Di samping setiap Recipe dan FeatureRecipe dalam direktori katalog Anda yang mengimpor file artefak, menunjuk ke source: jarak jauh yang Anda tulis lengkap, atau membaca source: di sampingnya, terdapat entity.lock yang mencatat digest konten tersebut. Mencatatnya adalah langkah penulis entitas, aggrega pin, dan secara default pull tidak melakukannya: pull mencocokkan lock setiap entitas semacam itu dengan apa yang akan dicatat oleh langkah tersebut, dan berhenti di tempat pin tidak ada. aggrega pull --pin-sources, atau workspace yang menetapkan pin_sources_at_pull: true, menjalankan langkah tersebut sebagai gantinya — dan dengan begitu efek pull menjangkau lebih jauh dari direktori tempat Release berada, meskipun file entitas yang Anda tulis tidak pernah ditulisi. Lock entitas menjelaskan file tersebut, dan Pratinjau apa yang akan ditulis pull menampilkan seluruh himpunannya untuk workspace Anda sebelum ada yang berubah.
Pull yang ditolak karena sebuah referensi tidak ter-resolve ke apa pun menyebutkan dari mana entitas lokal dibaca, di mana pun pull dijalankan. Penolakan tersebut memuat penjelasan workspace sendiri tentang direktori tempat ia membaca entitas lokal dan apa yang perlu diubah agar entitas tersebut terbaca — catatan yang ditunjukkan oleh Dari mana entitas lokal dibaca — dan memuatnya dari perintah ini, dari build yang me-resolve dependensinya terlebih dahulu, dari alat pull aggrega mcp, dan juga dari resolusi dependensi sebuah editor, karena resolusi yang dijalankan oleh semuanya itulah yang menyusunnya. Penolakan dari alat pull juga menyebutkan kode singkat dan kode deskriptif kondisi tersebut, sebagaimana terminal mencetak kode singkat di awal penolakan. File di direktori tersebut yang mendeklarasikan apiVersion Aggrega — 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, disebutkan dalam penolakan yang sama, di antara file katalog yang dilewati saat pemuatan, beserta alasan dari parser itu sendiri: file semacam itu mungkin adalah file yang mendeklarasikan entitas yang disebut referensi, dan tidak ada yang dapat dibaca darinya untuk menyatakan entitas mana yang dideklarasikannya. File YAML yang mendeklarasikan apiVersion lain, atau tidak mendeklarasikannya sama sekali, bukan dokumen Aggrega dan tidak pernah disebutkan di sana.
Lockfile
Lockfile mem-pin setiap dependensi ke URI-nya, versi hasil resolusinya, dan digest kontennya. Lockfile memiliki bagian untuk entitas katalog, pustaka skema dan pemetaan (masing-masing membawa penunjuk balik ke Components dan Features yang menggunakannya), plugin Wasm, artefak sumber, input eksternal (masing-masing dikunci berdasarkan URL dan membawa plugin yang memintanya), serta file Release itu sendiri. File ditulis dalam bentuk kanonis dan deterministik.
Sebuah entitas dicatat berdasarkan apa yang dibawa oleh publikasinya. Digest pada baris sebuah entitas mencakup dokumennya dan setiap file yang disebutkannya di sampingnya — source: lokal milik Recipe atau FeatureRecipe, setiap file yang disebut oleh $import:, entity.lock di sampingnya, setiap file skema yang diimpor oleh Component atau Feature — himpunan yang sama yang diterbitkan oleh aggrega push. Setiap file menyumbangkan jalur dan byte-nya, dan tidak ada hal lain yang menyumbang: bukan cara sebuah arsip dikompresi, bukan stempel waktu, bukan bit izin, termasuk bit eksekusi. Entitas yang tidak menyebut file apa pun dicatat sebagai satu dokumen itu. Jadi entitas yang sama mencatat digest yang sama baik dibaca dari direktori katalog Anda maupun diambil dari registry, dan lockfile yang di-commit dari satu checkout dapat diverifikasi pada checkout lain dari commit yang sama apa pun umask-nya, dan terlepas dari apakah sistem checkout tersebut mencatat file mana yang dapat dieksekusi. Chart yang diedit di bawah sebuah Recipe, file yang ditambahkan ke sumber yang dideklarasikannya, dan entity.lock yang berubah masing-masing mengubah digest; skrip yang bit eksekusinya berubah, dan catatan di samping entitas yang tidak disebut oleh apa pun, tidak. Aggregate dan Manifest yang disebut oleh Release dicatat dengan cara yang sama, masing-masing sebagai satu dokumennya. Pustaka dicatat berdasarkan digest byte-nya, yang merupakan dokumennya di mana pun pustaka itu dibaca.
Setiap Recipe dan FeatureRecipe yang diikat oleh Manifest adalah sebuah baris, tingkat mana pun yang mengikatnya. Realisasi yang dipilih tingkat name Manifest untuk satu instans atau satu lampiran diperoleh dan dicatat persis seperti realisasi yang dipilih tingkat type-nya untuk setiap instans suatu tipe, dan referenced_from pada barisnya menyebutkan entri yang mengikatnya — manifest.spec.mappings.components.name.<instance> atau manifest.spec.mappings.features.name.<attachment>. Build mencocokkannya dengan baris tersebut, sehingga lockfile yang tidak mencatatnya menghentikan build, dengan menyebutkan realisasi dan entri tersebut. Lihat Pemetaan URI datar untuk kedua tingkat tersebut.
Lampiran sebuah koneksi adalah dependensi persis seperti lampiran milik komponen itu sendiri. Feature yang disebut oleh lampiran pada sebuah koneksi — ditulis pada entri uses: sebuah komponen di Aggregate, atau pada entri koneksi di Release — diperoleh dan dicatat seperti Feature dari lampiran yang ditulis pada komponen itu sendiri, dan referenced_from pada barisnya menyebutkan entri koneksi yang ditulis oleh penulis, yang berakhir dengan .uses.<socket>.<alias>.features.<slot>.type. Realisasi yang diikatkan Manifest padanya juga merupakan sebuah baris, baik diikat oleh features.type maupun oleh features.name yang dikunci dengan nama lampiran, <alias>.<slot>. Build mencocokkan keduanya dengan barisnya: lockfile tanpa salah satunya menghentikan build dengan menyebutkan referensi dan entri yang memintanya, dan Feature yang kontennya berubah sejak pull menghentikannya dengan menyebutkan kedua digest. Lihat entri koneksi Aggregate untuk lampiran itu sendiri.
Basis yang diperluas oleh sebuah Component atau Feature adalah sebuah baris, entah ada hal lain yang menyebutnya atau tidak. Pull mengikuti setiap extends: hingga akhir rantainya dan mencatat setiap basis di bawah jenisnya sendiri, dengan referenced_from pada barisnya menyebutkan spec.extends milik entitas yang memperluasnya — component(<name>:<version>).spec.extends. Build membaca basis dari baris tersebut, sehingga Manifest memetakan tipe milik pembungkus itu sendiri dan tidak memerlukan baris untuk basisnya. Basis yang tidak dimuat oleh direktori katalog, cache, maupun registry mana pun dilaporkan di tempat rantai digabungkan — lihat An extends: chain cannot be assembled (Rantai tidak dapat disusun).
Release dicatat berdasarkan kontennya, bukan hanya namanya. Segala hal yang diminta Release — ke versi chart mana sebuah sumber di-resolve, komponen mana yang masuk ke batas mana — di-resolve dari isi file, sehingga release_documents mencatat digest Release dan setiap Release yang diperluasnya, di samping release, yang menyebutkan namanya. Edit Release setelah pull dan build berikutnya berhenti sebelum apa pun dirender, menyebutkan file yang Anda edit dan meminta Anda melakukan pull lagi; aggrega pull --release <release> biasa mencatat suntingan tersebut sambil tetap mematuhi setiap pin lainnya. Digest mencakup byte file apa adanya, sehingga perubahan komentar atau spasi juga dihitung, persis seperti untuk Aggregate dan Manifest. File yang diimpor Release melalui parameters tidak dicatat dengan cara ini.
Pull mencari penanda deprecation pada setiap artefak yang tanda tangannya diperiksanya, dan menyatakan apa yang ditemukannya. Penanda yang tanda tangannya sendiri terverifikasi terhadap penanda tangan yang diakui pull — penanda tangan artefak itu sendiri, atau identitas di trusted_deprecation_identities milik registry — dicatat, dan diumumkan beserta tingkat keparahannya dan penanda tangan penanda tersebut. Penanda yang ditemukan pull tetapi tidak dapat diakuinya — tidak dapat dibaca, tidak ditandatangani, ditandatangani oleh pihak yang tidak dipercaya kebijakan, atau membawa tanda tangan yang tidak dapat diperiksa — dilaporkan sebagai marker present but not honored, beserta alasannya, dan tidak dicatat. Pencarian yang tidak dapat diselesaikan — pull tidak dapat membuka registry artefak tersebut, atau daftar apa yang dilampirkan padanya tidak memberikan jawaban — dilaporkan sebagai marker lookup did not complete, beserta alasannya, dan tidak mencatat apa pun, karena pull tidak mengetahui apa pun tentang ada atau tidaknya penanda. Di bawah registry yang kebijakan kepercayaannya sendiri mewajibkan tanda tangan untuk jenis artefak tersebut dan bukan advisory, salah satu dari kedua hal itu menghentikan pull alih-alih dilaporkan. Artefak yang tidak membawa penanda tidak menghasilkan baris apa pun, dan jika verifikasi tanda tangan dinonaktifkan, untuk workspace atau untuk registry artefak tersebut, tidak ada penanda yang dicari.
Commit <release-stem>.lock bersama Release, seperti Anda meng-commit manifes dependensi ter-pin apa pun. Diff lockfile menunjukkan kepada peninjau secara persis versi dan digest dependensi mana yang berubah; perubahan digest pustaka menyebutkan konsumen yang terdampak.
Apa yang dilakukan oleh suatu pull — apakah setiap entitas diambil baru dari registry (fetched-fresh), memakai ulang slot cache (cache-reuse), ditemukan di katalog lokal (local), disajikan dari salinan di dalam biner compiler (in-binary), atau bersifat eksternal (external: Aggregate atau Manifest milik Release sendiri, dibaca dari file atau entri yang disebut Release alih-alih di-resolve sebagai salah satu dependensinya; Aggregate yang diambil pull dari registry justru berstatus fetched-fresh) — adalah diagnostik peristiwa pull sementara yang dicetak ke stdout oleh --detail, dan tidak pernah ditulis ke lockfile. Sumber mana yang menyajikan sebuah entitas bergantung pada keadaan lokal mesin yang melakukan pull, sehingga menyimpannya akan merusak identitas byte lockfile antarmesin. Diagnostik ini melaporkan apa yang dilakukan pull ini, yang tidak dapat dipulihkan sesudahnya (entitas yang baru di-pull akan di-cache oleh run berikutnya); untuk keadaan resolusi pasca-pull dari dependensi sebuah Release, gunakan aggrega inspect.
Lock entitas
Sebuah Recipe atau FeatureRecipe dapat bergantung pada byte di luar dokumennya sendiri: chart atau fragmen yang diambil dari source: jarak jauh, file yang dibawa oleh entri artifacts — atau entri boundary.artifacts milik sebuah Recipe — dengan $import, atau file dari source: yang menyebut direktori atau file di sampingnya. Digest masing-masing dicatat dalam file bernama entity.lock, di direktori yang sama dengan file entitas. File entitas yang Anda tulis tidak pernah ditulisi; apa yang diturunkan berada di sampingnya. Skema lock entitas menjelaskan file tersebut per kolom.
Siapa yang menulisnya. Satu langkah yang menulisnya: aggrega pin, yang dijalankan oleh penulis entitas, tidak memerlukan Release, dan mencatat setiap kelas pin yang dimuat lock. aggrega pull --pin-sources dan aggrega push --pin-sources menjalankan langkah yang sama atas nama penulis dan menulis byte yang sama. Pull yang tidak diminta melakukan pin tidak menulis lock sama sekali: untuk setiap Recipe dan FeatureRecipe yang dibangun Release dari direktori katalog Anda, pull membandingkan apa yang akan dicatat langkah tersebut dengan apa yang dimuat lock, dan berhenti di tempat pin tidak ada atau tidak lagi cocok dengan inputnya, dengan menyebutkan entitas, setiap input beserta kelasnya, dan aggrega pin. File sumber lokal dicocokkan dengan pin-nya sebagai satu himpunan: lock yang tidak mencatat satu pun di antaranya menghentikan pull, demikian pula file yang ditambahkan, diubah, atau dihapus sejak pin. Kunci workspace pin_sources_at_pull menjadikan pin sebagai default setiap pull, dan --pin-sources=false memulihkan penghentian untuk satu run. Pin adalah kewajiban penulis, sehingga penghentian pada pull pertama seorang konsumen berarti penerbit entitas tidak pernah mem-pin-nya; solusi bagi konsumen adalah kunci tersebut, bukan suntingan manual pada direktori milik orang lain. aggrega pin menjelaskannya secara lengkap.
Apa isinya. Tiga daftar, setiap barisnya menyebutkan satu input:
sourceDigests— satu baris untuk setiapsource:jarak jauh yang koordinatnya Anda tulis lengkap, tanpa template dikind,url,chart,module_subdir,version, atauref. Baris tersebut memuatkinddanurlsumber,chartataumodule_subdir-nya jika ada, versi hasil resolusinya — untuk sumber git, commit yang disebut olehref-nya — dan digest konten arsip yang diambil, ditambah digest manifes untuk chart yang diambil melalui OCI.artifactDigests— satu baris untuk setiap entriartifactsatauboundary.artifactsyang disediakan oleh file yang diimpor dengan$import, yang menyebutkan entri tersebut dan digest byte file itu. Entriartifactsdisebut dengan kuncinya, dan entriboundary.artifactssebagaiboundary/<key>, sehingga entri dari masing-masing blok yang ditulis di bawah satu kunci di-pin secara terpisah.localSourceDigests— satu baris untuk setiap file yang disumbangkan olehsource:yang menyebut direktori atau file di samping entitas ke apa yang dibawa oleh publikasi entitas, yang menyebutkan jalur file di samping entitas dan digest byte-nya. Tidak ada yang diambil untuk sumber semacam itu; digest file-filenya dihitung apa adanya. Sumber yang ditulis sebagai template menyumbangkan setiap file di direktori entitas, sehingga masing-masing memiliki baris.
Apa yang tidak dimuatnya:
- Sumber jarak jauh yang koordinatnya diisi dari template — misalnya
versionyang dibaca dari.infra. Artefak mana yang disebutnya ditentukan oleh setiap Release yang menggunakan entitas tersebut, sehingga setiap versi hasil resolusinya di-pin di lockfile Release tersebut, dan tidak ada apa pun tentangnya yang ditulis di samping entitas. - Entri
artifactsatauboundary.artifactsinline, yang merupakan bagian dari file entitas, dan entri yang diambil dari ArtifactLibrary, yang kontennya di-pin oleh versi pustaka yang dicatat lockfile.
Entitas yang tidak memiliki apa pun untuk di-pin tidak mendapatkan entity.lock, dan langkah tersebut, bila dijalankan pada entitas yang tidak lagi memerlukannya, menghapusnya.
Commit file ini di samping entitas. Setiap Recipe dan FeatureRecipe menggunakan nama file yang sama, dan direktori tempatnya berada menunjukkan entitas pemiliknya, sehingga lock ikut berpindah bersama direktori tersebut. Lock tidak memuat stempel waktu dan barisnya disimpan dalam urutan tetap, sehingga langkah tersebut pada input yang tidak berubah membiarkannya identik byte demi byte, dan diff atasnya menyebutkan sumber, file yang diimpor, atau file sumber lokal yang berubah. Satu direktori memuat satu lock, sehingga langkah tersebut menolak Recipe atau FeatureRecipe yang berdampingan dengan entitas lain mana pun — setiap jenis memiliki direktorinya sendiri kecuali Aggregate, Release, dan Manifest — dan pull yang diminta melakukan pin menolak entitas semacam itu sebelum apa pun di-resolve; Satu entitas per direktori menjelaskan aturannya. Pull yang tidak melakukan pin tidak menulis apa pun di samping entitas dan tidak menilai direktorinya.
aggrega build mencocokkan file Anda dengannya. Build membaca lock dan melakukan tiga perbandingan:
- Digest setiap file yang diimpor dihitung ulang dan dibandingkan dengan barisnya, file
boundary.artifactspersis seperti fileartifacts. File yang diedit setelah di-pin menghentikan build dengan[CATALOG_ERROR E0026], menyebutkan artefak sebagaimana barisnya menyebutnya, file yang diimpor, dan kedua digest. - Digest file-file sumber lokal dihitung ulang dan dibandingkan dengan barisnya, sebagai satu himpunan, sebelum provider membaca sumber tersebut. File yang diedit, ditambahkan, atau dihapus sejak pin menghentikan build dengan
E0305di bawah instans komponen yang sumbernya adalah file tersebut, menyebutkan setiap file tersebut dan kedua digest; file di samping entitas yang tidak disumbangkan oleh sumber tidak dibandingkan. Lock yang tidak mencatat baris apa pun untuk sumber lokal tidak menyisakan apa pun untuk dibandingkan, sebagaimana dijelaskan dalam A local source no longer matches the pins recorded beside its Recipe (Sumber lokal tidak lagi cocok dengan pin yang dicatat di samping Recipe-nya). - Setiap baris sumber dibandingkan dengan digest yang dicatat lockfile Release untuk sumber yang sama. Ketidaksesuaian menghentikan build dengan
[FETCH_ERROR E0135], menyebutkan lock dan kedua digest. Kedua file ditulis oleh dua resolusi atas sumber yang sama — resolusi langkah pin dan resolusi pull — sehingga keduanya tidak sesuai bila resolusi tersebut mendapatkan byte yang berbeda, atau bila salah satu dari kedua file diedit. Byte yang berbeda di bawah satu versi adalah tanda upstream yang menerbitkan ulang sebuah versi.
Lockfile yang ditulis sebelum perubahan menyebabkan penghentian lebih dulu, dan pull menyebutkan file-nya. Lockfile mencatat entitas berdasarkan apa yang dibawanya, dan lock serta setiap file yang dibaca perbandingan ini adalah bagian darinya, sehingga build — atau aggrega pull --verify — yang memegang lockfile yang ditulis sebelum file yang diimpor, file sumber lokal, atau lock itu sendiri berubah akan berhenti sebelum satu pun dari ketiga perbandingan berjalan: The lockfile no longer matches what the release resolves to (Lockfile tidak lagi cocok dengan hasil resolusi release), dengan menyebutkan entitas dan kedua digest. aggrega pull biasa kemudian menyebutkan file-nya, karena pull mencocokkan lock dengan apa yang akan dicatat langkah pin dan menolak input yang pin-nya tidak lagi cocok: An entity reads an input the lock beside it records no pin for (Sebuah entitas membaca input yang tidak memiliki pin di lock di sampingnya).
Ketika lockfile tidak memiliki catatan atas konten entitas itu sendiri, ketiga perbandingan inilah yang dihadapi build. Recipe atau FeatureRecipe yang disebut Manifest dengan referensi yang juga merupakan nama Component atau Feature yang dijangkau Release tidak memiliki entri sendiri: entri lockfile untuk referensi tersebut mencatat Component atau Feature itu, sehingga tidak ada yang berubah di lockfile ketika file Recipe berubah, dan build maupun pull verifikasi melaporkan file yang berubah dengan kode di atas. Perbandingan baris sumber juga yang dihadapi build ketika entri source_artifacts di lockfile adalah catatan yang berubah sementara lock di samping entitas tidak berubah.
Menanggapi penghentian. Jika Anda sengaja mengubah file yang diimpor, jalankan aggrega pin pada entitas: langkah tersebut mencatat digest baru file itu, dan build berikutnya menerimanya. Jika tidak, pulihkan file tersebut. Sumber lokal yang berubah memiliki dua tanggapan yang sama: pin ulang entitas, atau pulihkan file yang disebut oleh penghentian. Untuk baris sumber yang tidak sesuai dengan lockfile, pulihkan entity.lock dari kontrol versi, atau jalankan aggrega pin pada entitas untuk menulisnya ulang.
aggrega pull --verify juga memeriksanya. Pull verifikasi melakukan tiga perbandingan yang sama atas lock di samping Recipes dan FeatureRecipes yang dijangkau Release di direktori katalog Anda, melaporkan setiap pin yang akan ditolak build dengan kode yang sama dan kata-kata yang sama, keluar dengan kode bukan nol jika ada, dan tidak menulis lock.
Ketika tidak ada lock yang dibandingkan. Recipe atau FeatureRecipe yang di-resolve dari registry, bukan dari salah satu direktori katalog Anda, tidak memiliki lock yang dibaca build; sumbernya hanya dicocokkan dengan lockfile Release. Dan sumber yang ditulis pada ref: git dicatat di lock pada commit hasil resolusi ref tersebut, sedangkan build mencari pin sumber pada versi yang disebut entitas, sehingga baris itu tidak pernah dibandingkan — baik oleh build maupun oleh pull verifikasi. Lockfile tetap mem-pin commit tersebut, dan setiap build memverifikasi arsip yang di-cache terhadapnya.
Catatan kepercayaan plugin
Beberapa plugin yang dilampirkan workspace tidak pernah membentuk output yang dirender. Lampiran plugins.governance dalam peran ir-verdict atau render-verdict, dan setiap lampiran plugins.linter, mengembalikan putusan terima-atau-tolak dan tidak ada yang lain — tidak satu byte pun dari mereka yang mencapai artefak. Jadi plugin tersebut bukan bagian dari apa yang direproduksi build byte demi byte, dan lockfile, yang mem-pin tepat hal itu, adalah tempat yang salah untuk mereka.
Identitas mereka justru dimasukkan ke file kedua yang di-commit: plugins-trust.yaml, di samping lockfile. File ini memuat satu entri per plugin semacam itu, yang mencatat koordinat identitas plugin, versi yang dipilih untuknya, dan digest konten artefak hasil resolusi — ditambah tanda tangan yang diverifikasi pull untuk artefak tersebut, jika pull memverifikasinya, dan, bila penerbit telah menandai artefak tersebut sebagai usang sejak menerbitkannya, penanda yang ditemukan dan diverifikasi pull. Skema catatan kepercayaan plugin menjelaskan file tersebut per kolom.
Commit plugins-trust.yaml bersama lockfile, dengan alasan yang sama Anda meng-commit lockfile: catatan yang disimpan di luar kontrol versi adalah catatan yang tidak dapat ditinjau siapa pun dan tidak dapat dijadikan pembanding apa pun. Setelah di-commit, file ini menjadi satu pernyataan bersama tentang plugin mana yang menjadi hasil resolusi setiap lampiran tersebut, dan diff atasnya menyebutkan identitas yang berubah.
File ini hanya muncul bila ada sesuatu untuk dicatat. Workspace yang tidak melampirkan plugin pengembali putusan tidak me-resolve identitas semacam itu, sehingga pull tidak menulis file dan tidak mengatakan apa pun tentangnya — sebuah ketiadaan, bukan file yang hilang. Saat pull membuatnya, pull menyebutkan file yang dibuatnya dan meminta Anda meng-commit-nya. Pull berikutnya menambahkan identitas yang belum dimuat catatan dan membiarkan setiap identitas yang sudah tercatat persis seperti adanya.
Setiap perubahan pada file ini diumumkan, dan tidak ada hal lain yang diumumkan. Pull yang mengubah catatan mencetak satu baris per entri yang berubah, menyebutkan plugin dan jenis perubahannya: identitas yang dicatat untuk pertama kali, identitas yang diadopsi menggantikan yang dipegang (dengan menyebutkan keduanya, sehingga Anda dapat melihat apa yang ditukar), status usang yang dicatat terhadap artefak yang sudah disebut sebuah entri, status usang yang dihapus dari sebuah entri, tanda tangan yang dicatat pada atau dihapus dari sebuah entri, atau entri yang dibuang. Baris pembuatan di atas terpisah dan menyangkut file, bukan entri, sehingga resolusi pertama menyampaikan keduanya: file ini baru dan harus di-commit, dan inilah identitas yang kini dimuatnya.
Pull yang membiarkan catatan persis seperti semula tidak mengatakan apa pun tentangnya. Jadi baris tentang file ini berarti file yang di-commit telah berubah dan diff-nya layak dibaca — yang di sini lebih penting daripada untuk lockfile. Segala hal yang di-pin lockfile juga merupakan bagian dari apa yang direproduksi build byte demi byte, sehingga perubahan di sana memiliki tempat kedua untuk terlihat; identitas plugin putusan tidak memilikinya. File ini adalah satu-satunya tempat gerbang yang ditukar dicatat.
aggrega pull --dry-run tidak mengumumkan semua ini, karena tidak mengubah apa pun. Sebagai gantinya, perintah ini mencantumkan catatan tersebut di antara file yang akan ditulisnya, sebagaimana dijelaskan dalam Pratinjau apa yang akan ditulis pull.
Status usang ditambahkan ke entri yang sudah dimuat catatan, dan itu tidak sama dengan menulis ulang entri tersebut. Jika penerbit menandai usang plugin yang sudah Anda percayai, aggrega pull berikutnya mencatat penanda pada entri plugin tersebut yang sudah ada — koordinat, versi, dan digest tidak disentuh, karena artefak tidak berubah dan tidak ada hal baru yang diadopsi. Jadi pull biasa dapat menambahkan blok deprecation, dan hanya upgrade eksplisit yang pernah mengubah identitas. Penanda hanya dicatat terhadap artefak yang sudah disebut entri, dan tidak ada pull yang mengejar penanda yang tidak lagi diterbitkan: penanda yang tercatat hanya hilang bersama entri yang memuatnya, yaitu ketika entri itu dibuang, atau ketika upgrade eksplisit me-resolve ulang plugin dan tidak menemukan penanda pada byte yang sudah dicatat entri.
Tanda tangan yang terverifikasi dicatat pada entri dengan cara yang sama, dan setiap pull menjawabnya dari awal. Pull memverifikasi tanda tangan setiap plugin tersebut terhadap kebijakan kepercayaan registry-nya pada setiap run — plugin yang disajikan registry diambil berdasarkan versinya setiap kali, karena tidak ada yang mem-pin-nya — dan mencatat apa yang diverifikasinya pada entri plugin, sekali lagi tanpa menyentuh identitas: mode, penandatangan yang cocok, dan digest bundle tanda tangan yang di-cache-nya, signature yang sama yang dimuat entri lockfile. Tidak seperti penanda, jawaban ini menggantikan apa yang dimuat entri, dan ketika pull tidak memverifikasi tanda tangan apa pun — plugin tidak membawa tanda tangan dan tidak ada yang diwajibkan, atau skip_signature_verification atau registry advisory menerimanya — entri tidak mencatat tanda tangan. Bundle tanda tangan yang diverifikasinya juga di-cache ulang, dan salinan cache yang tidak lagi cocok dengan digest-nya ditulis ulang. Jadi entri yang kehilangan tanda tangannya, entri yang membawa tanda tangan yang disalin dari entri plugin lain, entri yang bundle tanda tangan cache-nya dihapus atau diubah, atau catatan yang dihapus atau ditulis sebelum tanda tangan dicatat, diperbaiki oleh aggrega pull biasa berikutnya. Build mencocokkan setiap plugin tersebut dengan fakta itu: lihat Catatan kepercayaan plugin di halaman build.
Identitas hasil resolusi yang tidak sesuai dengan yang tercatat menghentikan pull. Entri yang tercatat menyebutkan versi sekaligus digest, sehingga berubahnya salah satu dari keduanya adalah peristiwa yang sama: plugin yang akan dijalankan bukanlah plugin yang ditinjau untuk catatan tersebut. Diagnostik menyebutkan plugin, apa yang dimuat catatan, dan apa yang dilaporkan resolusi ini, pada kedua sumbu sekaligus — dan pull berhenti tanpa menyentuh catatan, sehingga identitas yang telah ditinjau tetap ada untuk dibandingkan. Pull berhenti karena versi saja (penerbitan ulang yang byte-nya tidak berubah) persis seperti berhenti karena digest saja (push ulang pada versi yang sama).
aggrega pull --verify melakukan perbandingan yang sama. Perintah ini tidak menulis satu pun file yang di-commit oleh pull, sehingga tidak mengadopsi apa pun; perintah ini melaporkan apakah file-file tersebut masih menggambarkan apa yang akan di-resolve pull hari ini, dan catatan adalah salah satunya. Perintah ini juga mencocokkan tanda tangan setiap entri dengan tanda tangan yang dihasilkan verifikasi plugin oleh pull itu sendiri, dan melaporkan entri yang tanda tangannya akan dicatat, diganti, atau dihapus oleh pull — serta plugin yang tidak memiliki entri dalam catatan ketika build menolaknya karena tidak mencatat tanda tangan — sebagaimana dijelaskan dalam Perintah ini membandingkan tanda tangan yang tercatat, di kedua file.
Untuk mengadopsi identitas baru, mintalah berdasarkan namanya: aggrega pull --upgrade --release <release> <plugin>, dengan menyebut plugin sebagaimana lampiran di .aggrega-config.yaml Anda menyebutnya, tanpa akhiran versi. Perintah itu me-resolve ulang satu plugin itu saja dan menulis ulang entrinya, tanpa menyentuh dependensi ter-pin lainnya dan identitas tercatat lainnya — dan tetap berfungsi meskipun plugin tidak memiliki pin lockfile, karena target yang disebut juga boleh menyebut salah satu lampiran tersebut. aggrega pull --upgrade tanpa target, yang me-resolve ulang setiap dependensi, juga me-resolve ulang dan menulis ulang setiap identitas yang tercatat. Demikian pula aggrega build --upgrade, yang menjalankan pull penyegaran penuh tanpa target dan tidak memiliki cara untuk menyebut satu target.
Untuk menghapus identitas, mintalah hal itu berdasarkan nama juga. Melepas plugin dari .aggrega-config.yaml tidak menghapus entrinya, dan itu disengaja: aggrega pull biasa tidak pernah menghapus entri. Jalankan aggrega pull --upgrade --release <release> <plugin>, dengan menyebut plugin sebagaimana catatan menyebutnya — koordinat identitasnya, yaitu string yang dicetak oleh penghentian di bawah — dan entri tersebut dibuang, tanpa menyentuh dependensi ter-pin lainnya dan identitas tercatat lainnya. aggrega pull --upgrade tanpa target membuang setiap entri yang tidak lagi disebut oleh lampiran putusan mana pun, dalam lintasan yang sama yang me-resolve ulang semua hal lainnya.
Membuang entri terakhir membiarkan file tetap ada dan kosong alih-alih menghapusnya. Catatan kosong tidak memuat apa pun, sehingga tidak mem-pin apa pun dan tidak menghentikan apa pun — sama seperti tidak ada catatan sama sekali — dan mempertahankan file berarti penghapusan tersebut muncul di diff-nya sebagai penghapusan.
Catatan yang tidak memenuhi skemanya menghentikan setiap perintah yang membacanya — build, lint dengan cakupan release, dan pull, termasuk pull yang tidak memiliki apa pun untuk dicatat sendiri. Catatan yang dikosongkan dan catatan yang rusak sengaja dibedakan: pengosongan adalah cara menghapus entri terakhir, dan catatan yang dikosongkan tetap diam, sedangkan file yang isinya tidak lagi dapat di-parse adalah kesalahan, bukan catatan kosong — membacanya sebagai kosong akan menjadikan pemotongan file sebagai cara untuk mematikan perbandingan. Pulihkan dari kontrol versi untuk mendapatkan kembali identitas yang telah ditinjau.
Plugin yang disajikan dari salinan di dalam biner compiler tidak dicatat. Pull mencatat apa yang diperolehnya — diambil dari registry, atau dibaca dari cache — dan tidak ada yang diperoleh dari biner: byte tersebut diidentifikasi oleh versi compiler yang membawanya, sehingga tidak ada resolusi tersendiri untuk dicatat. Karena itu, melampirkan plugin yang sudah dibawa biner tidak menghasilkan entri untuknya. Itu adalah catatan yang tetap terbatas pada artefak yang diperoleh, bukan resolusi yang gagal.
Build, lint dengan cakupan release, dan validasi dengan cakupan release mencocokkan konfigurasi workspace dengan catatan. Sebelum lampiran mana pun dijalankan, aggrega build, aggrega lint --release, dan aggrega validate --release — serta operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp — membandingkan lampiran putusan yang disebut konfigurasi dengan entri yang dimuat catatan. Plugin yang digest artefak hasil resolusinya bukan yang tercatat akan ditolak alih-alih dijalankan. Entri catatan yang tidak dipertanggungjawabkan oleh lampiran putusan terkonfigurasi mana pun menghentikan run: gerbang yang telah ditinjau dan kini tidak ada meninggalkan output yang tidak dapat dibedakan dari output yang disetujui gerbang itu, dan justru itulah yang tidak dapat dilihat oleh orang yang membaca output. Penghentian tersebut menyebutkan plugin dan menawarkan dua solusi yang berbeda menurut maksud Anda — lampirkan plugin lagi jika penghapusan itu keliru, atau jalankan upgrade eksplisit di atas jika memang disengaja — dan mencetak upgrade tersebut dalam bentuk siap dijalankan. Arah sebaliknya — lampiran yang belum dimuat catatan — adalah penemuan pertama yang dijelaskan di atas, dan tidak satu pun dari kedua perbandingan berhenti karenanya; persyaratan tanda tangan adalah satu-satunya ketentuan yang tidak dapat dihindari oleh lampiran tanpa entri. Ketiga permukaan yang sama mencocokkan setiap plugin yang dibacanya dari cache dengan tanda tangan yang dicatat entrinya, saat memuatnya, sebagaimana dijelaskan halaman build untuk build. Cakupan lint untuk seluruh katalog dan untuk satu entitas tidak merujuk catatan apa pun.
Validasi dicocokkan dengan catatan karena menjalankan pemeriksaan yang sama dengan build. aggrega validate --release menjangkau setiap pemeriksaan yang dijangkau aggrega build kecuali penulisan artefak, termasuk plugin gerbang — itulah yang membuat “ini lolos validasi” bermakna sama dengan “ini berhasil di-build” — sehingga identitas plugin yang dijalankannya dibandingkan dengan catatan persis seperti identitas plugin pada build. Cakupan lain dari aggrega validate tidak dicocokkan dengannya: memvalidasi seluruh katalog, satu entitas, atau biner plugin sama sekali tidak membaca lampiran plugin workspace, sehingga tidak ada plugin putusan yang dijalankan di dalamnya dan tidak ada yang perlu dipegang oleh catatan.
Mencocokkan konfigurasi dengan catatan memastikan keberadaan dan identitas, dan tidak lebih dari itu. Hal ini memastikan bahwa setiap gerbang yang disebut catatan masih terlampir, dan bahwa masing-masing berjalan dari artefak yang dicatat untuknya. Hal ini tidak memastikan bahwa gerbang yang berjalan benar-benar mengembalikan putusan, dan satu kasus semacam itu tidak terdeteksi di mana pun: lampiran yang function-nya menyebut ekspor yang memang dideklarasikan plugin, yang bukan ekspor putusan yang dibaca socket-nya, dan yang output-nya tidak membawa field tingkat atas di luar bentuk yang diharapkan socket tersebut — objek kosong adalah contoh paling sederhana — akan berjalan, tidak mengembalikan apa pun untuk dijadikan dasar penolakan, dan meloloskan build. Output-nya tidak dapat dibedakan dari output gerbang yang menyetujui, dan tidak ada perbandingan dengan catatan yang dapat menyadarinya, karena tidak ada yang salah pada catatan: plugin yang berjalan persis plugin yang tercatat, dan plugin itu sekadar tidak menjalankan apa pun. Dua kasus yang berdekatan memang berhenti, sehingga batasnya tidak lebih luas dari kelihatannya — function yang menyebut ekspor yang tidak dideklarasikan plugin ditolak saat plugin dimuat, dan output yang membawa field tingkat atas yang tidak dideklarasikan bentuk socket ditolak alih-alih dibaca sebagai daftar putusan yang kebetulan kosong. Jadi identitas yang tercatat saja tidak cukup untuk memastikan bahwa sebuah gerbang telah menilai sesuatu.
Digest yang tercatat mengatur plugin yang di-resolve workspace dari cache yang diisi oleh aggrega pull, dan bukan apa pun yang di-resolve dengan cara lain. Itulah resolusi yang biasanya ditempuh lampiran putusan — tidak ada yang mem-pin-nya di lockfile, sehingga byte-nya berasal dari cache, dan pada pembacaan itulah digest hasil resolusi dibandingkan dengan yang tercatat. Plugin putusan yang di-resolve workspace dengan cara lain tidak pernah mencapai pembacaan itu, dan diatur oleh apa pun yang mengatur cara resolusinya, bukan oleh catatan: byte yang disajikan dari salinan di dalam biner compiler diidentifikasi oleh versi compiler yang membawanya, .wasm yang berada di samping entitas katalognya adalah file di direktori katalog Anda sendiri, jalur sistem file eksplisit adalah jalur yang Anda sebutkan, dan plugin yang membawa pin lockfile diatur oleh pin tersebut. Separuh lainnya dari pencocokan konfigurasi dengan catatan tidak dibatasi dengan cara itu: setiap entri yang dimuat catatan harus tetap dipertanggungjawabkan oleh lampiran terkonfigurasi, bagaimanapun plugin itu di-resolve. Jadi catatan memastikan bahwa gerbang yang disebutnya masih terlampir, apa pun yang menyajikannya, dan memastikan identitas artefak dari gerbang yang disajikan dari cache.
Mematuhi vs. memperbarui
Secara default, aggrega pull mematuhi lockfile yang sudah ada: dependensi yang sudah di-pin diresolusi tepat ke versi yang di-pin (diverifikasi terhadap digest yang di-pin), hanya referensi yang belum di-pin yang diresolusi dan ditambahkan, dan pin untuk referensi yang tidak lagi dijangkau oleh Release dipangkas. Jadi pull ulang atas Release yang tidak berubah tidak melakukan apa pun — pull tersebut mereproduksi lockfile yang sama byte demi byte (termasuk generated_at). Menambahkan dependensi baru, atau melakukan pull setelah suntingan manual menghapus sebuah pin, hanya meresolusi celah tersebut dan membiarkan setiap pin lain tidak tersentuh.
Dependensi yang dibaca oleh pull ulang dari cache dicatat persis seperti pull yang mengambilnya mencatatnya. Barisnya mempertahankan versi, digest konten, dan manifest_digest — yang terakhir diambil dari manifest yang disimpan di samping konten di dalam cache — beserta signature dan deprecation yang diverifikasi pull tersebut di registry. Tidak satu pun dari itu dicari lagi selama build akan menerima baris tersebut, dan --detail melaporkan dependensi semacam itu sebagai cache-reuse, sehingga pull ulang yang semua dependensinya ada di cache, atas lockfile yang mencatat setiap tanda tangan yang diwajibkan konfigurasi kepercayaan dan hanya tanda tangan yang diterima build, menulis lockfile yang sama baik registry dapat dijangkau maupun tidak.
Pull ulang mencari tanda tangan lagi tepat di tempat build akan menolak baris tersebut, dan ada dua baris semacam itu.
- Tanda tangan wajib yang tidak dicatat oleh lockfile. Jika konfigurasi kepercayaan mewajibkan tanda tangan untuk dependensi yang disajikan cache dan baris lockfile tidak mencatat satu pun — baris tersebut disunting, lockfile ditulis ulang dari awal di atas cache yang diisi oleh pull sebelumnya, atau persyaratan ditambahkan setelah pull yang menulis baris tersebut — pull ulang menanyakan tanda tangannya kepada registry dependensi tersebut, berdasarkan digest manifest yang disimpan di sampingnya di dalam cache, persis seperti yang dilakukannya untuk dependensi yang diambilnya, lalu mencatat tanda tangan yang terverifikasi pada baris tersebut. Baris itulah yang ditolak build (No verified signature is recorded for an artifact that requires one (Tidak ada tanda tangan terverifikasi yang tercatat untuk artefak yang memerlukannya)), sehingga melakukan pull lagi adalah cara menghilangkan penolakan itu. Registry yang tidak melampirkan tanda tangan, atau tanda tangan yang tidak diterima konfigurasi kepercayaan, menghentikan pull ulang sebagaimana ia menghentikan pull yang mengambil dependensi tersebut. Pengaturan yang memungkinkan pull menerima dependensi tanpa tanda tangan membiarkan baris semacam itu apa adanya dan tidak menanyakan apa pun tentangnya:
skip_signature_verificationdi tingkat teratas, sakelar yang sama pada entri registry itu sendiri kecuali untuk jenis yang diwajibkan kebijakan penandatanganan seluruh workspace, dan registry yang ditandaiadvisory. - Tanda tangan tercatat yang tidak diterima build. Jika baris mencatat tanda tangan yang bundel tanda tangannya di cache telah dihapus atau diubah setelah pull yang menyimpannya ke cache — atau
signatureyang disalin dari baris lain, yang bundelnya utuh tetapi dibuat untuk artefak lain — build menolak baris tersebut apa pun bunyi persyaratan tanda tangannya (A cached signature bundle does not match the digest recorded for it (Bundel tanda tangan dalam cache tidak cocok dengan digest yang tercatat untuknya), A recorded signature was made for a different artifact (Tanda tangan yang tercatat dibuat untuk artefak yang berbeda)). Jadi pull ulang menanyakan lagi tanda tangan dependensi tersebut kepada registry-nya, apa pun bunyi persyaratannya, melalui verifikasi yang sama dengan yang dijalani dependensi yang diambilnya: apa yang diverifikasi menggantikan tanda tangan baris tersebut, dan bundel yang disebutnya disimpan lagi ke cache, dengan salinan di cache yang tidak lagi cocok dengan digest-nya ditulis ulang — sehingga baris dan cache berisi apa yang ditinggalkan pull yang mengambil dependensi tersebut. Tanda tangan yang tidak diterima konfigurasi kepercayaan menghentikan pull ulang sebagaimana ia menghentikan pull yang mengambil dependensi tersebut, begitu pula registry yang tidak melampirkan tanda tangan di tempat tanda tangan diwajibkan. Jika verifikasi tidak mencatat apa pun —skip_signature_verificationdi tempat ia berlaku, yang tidak menanyakan apa pun, registry yang tidak melampirkan tanda tangan di tempat tidak ada yang diwajibkan, atau registryadvisorydi tempat tidak ada yang terverifikasi — tanda tangan baris tersebut dihapus, yang diterima build dengan pengaturan yang sama.
Baris yang tanda tangan tercatatnya diterima build tidak ditanyakan lagi, begitu pula baris yang tidak mencatat tanda tangan dan tidak ada yang mewajibkan tanda tangan untuknya.
Dependensi yang disebut tanpa registry, di workspace yang kini tidak menyebut default_registry apa pun, tidak dapat ditanyakan. Barisnya diikat ke sebuah registry oleh pull yang mencatat tanda tangannya, dan tanpa default tidak ada registry yang dapat ditanyai. Jika baris semacam itu mencatat tanda tangan yang tidak diterima build, pull ulang berhenti dengan penolakan milik build itu sendiri, yang menyatakan bahwa tidak ada registry yang dikonfigurasi untuk menanyakan baris tersebut lagi, dan membiarkan lockfile seperti semula. Mengonfigurasi registry asal dependensi tersebut sebagai default_registry lalu melakukan pull lagi akan memperbaikinya.
Yang diatur oleh kepatuhan itu adalah apa yang disajikan registry atau cache. Entitas yang disediakan direktori katalog lokal diresolusi dari direktori tersebut, pada versi yang dideklarasikan berkasnya, dan entri yang dicatat lockfile untuknya tidak dirujuk dalam prosesnya. Lockfile tetap mencatat entitas semacam itu, jadi Anda akan melihatnya di sana — tetapi menyunting entri tersebut secara manual tidak menahan entitas pada versi yang Anda tulis, dan rekonsiliasi berikutnya menulis ulang entri tersebut agar sesuai dengan berkasnya. Untuk mengubah versi entitas yang disediakan secara lokal yang diresolusi sebuah Release, sunting berkas katalog, bukan lockfile.
Pin menyebut byte, bukan tempat, sehingga entri cache yang tidak lagi memuat pin-nya dilewati alih-alih dipercaya. Entitas yang disunting di tempat — isi baru di bawah version yang sama — meninggalkan isi sebelumnya di cache konten di bawah nama dan versi tersebut. Direktori katalog dibaca terlebih dahulu, sehingga entitas yang masih disediakan salah satunya di-pin dari berkasnya dan entri usang tidak pernah dibaca. Render yang dijalankan pull untuk menemukan input eksternal Release membaca setiap pin seperti yang dilakukan build, dari direktori katalog yang memuat byte yang di-pin, dan melaporkan entri yang dilewatinya dengan pemberitahuan yang dicetak aggrega build. Jika tidak ada direktori katalog yang menyediakan entitas tersebut dan sebuah registry dapat dijangkau, pull mengambil lagi versi yang di-pin, menulis ulang entrinya, dan menyatakannya di standard error, dengan menyebut entri tersebut dan kedua digest:
reuse: cache entry for <name>:<version> held <digest the entry held>, not the pinned <pinned digest>; refreshed from the registry (pin unchanged)Byte yang diambil dicocokkan dengan pin seperti pengambilan apa pun di bawah pin, sehingga registry yang menyajikan byte lain di bawah versi tersebut menghentikan pull, seperti dijelaskan di bawah. Jika tidak ada sumber yang memuat byte yang di-pin — tidak ada direktori katalog yang menyediakan entitas tersebut, entri cache memuat byte lain, dan tidak ada registry yang menyajikan versi yang di-pin atau eksekusi tidak menjangkau satu pun — pull dan aggrega pull --verify berhenti dengan E0135 — atau E0133 jika manifest entri cache bukan yang di-pin lockfile — dengan menyebut setiap sumber yang dibacanya dan apa isinya; jika eksekusi tidak menjangkau registry mana pun, penghentian juga menyebut langkah yang mengambil lagi versi yang di-pin.
Untuk memperbarui versi yang di-pin, jalankan aggrega pull --upgrade --release <release> — perintah ini membuang pin yang ada dan meresolusi ulang semua dependensi ke versi terbaru yang memenuhi syarat. Memperbarui adalah tindakan eksplisit; perilaku default tidak pernah menggeser dependensi yang di-pin. Ini mencerminkan konvensi npm ci / cargo / go build (default mewujudkan lock; memperbarui bersifat opt-in), dan inilah yang membuat pull otomatis aggrega build aman — build meresolusi tepat apa yang di-pin lockfile, tanpa pernah memindahkan versi secara diam-diam.
Bentuk tanpa target itu membuang setiap pin yang tercatat, sehingga ia meminta konfirmasi sebelum melakukan apa pun. Jawab konfirmasi itu terlebih dahulu dengan --yes untuk penggunaan non-interaktif; jika standard input bukan terminal dan tidak ada --yes, ia menolak alih-alih menunggu jawaban yang tidak dapat diberikan siapa pun. Menyebut target (aggrega pull --upgrade --release <release> <uri>) mempertahankan setiap pin yang tidak disebutnya, sehingga bentuk itu tidak menanyakan apa pun. aggrega build --upgrade menjalankan bentuk tanpa target dan tunduk pada syarat yang sama.
Jika byte versi yang di-pin di registry tidak lagi cocok dengan digest yang dicatat lockfile (pelanggaran imutabilitas di hulu), pull berhenti dengan galat integritas alih-alih mengadopsi byte yang berubah secara diam-diam — jalankan --upgrade untuk melakukan pin ulang secara sengaja.
Memeriksa lockfile tanpa menulisnya
aggrega pull --verify --release <release> menjawab satu pertanyaan: apakah menjalankan aggrega pull sekarang akan mengubah lockfile, atau catatan kepercayaan plugin di sampingnya? Perintah ini melakukan resolusi yang akan dilakukan pull, membandingkan lockfile dan catatan tersebut dengannya, dan berhenti sebelum apa pun yang dikomit pull ditulis — lockfile, catatan kepercayaan plugin, dan setiap entity.lock dibiarkan apa adanya. Perintah ini keluar dengan kode bukan nol bila lockfile tidak ada dan pada setiap perbedaan, dengan menyebut masing-masing. Penanda deprekasi tidak dibandingkan, seperti dijelaskan di bawah. Perintah ini ditolak bersama --upgrade, bersama --dry-run, dan bersama --pin-sources apa pun nilai yang diberikan pada flag tersebut: verifikasi tidak mencatat pin yang hilang dari entity.lock dan juga tidak berhenti karenanya, sehingga flag itu tidak akan mengubah apa pun.
Perintah ini mematuhi pin yang tercatat persis seperti pull. Dependensi yang di-pin lockfile diresolusi pada versi yang di-pin dan diperiksa terhadap digest yang di-pin, dan entitas yang disediakan direktori katalog lokal diresolusi dari direktori tersebut, seperti dijelaskan dalam Mematuhi vs. memperbarui. Jadi:
- Referensi yang registry-nya telah menerbitkan versi lebih baru sejak pull bukanlah penyimpangan. Pull akan mempertahankan pin-nya, sehingga lockfile tersebut tetap yang akan ditulis pull;
aggrega pull --upgradeadalah cara mengadopsi versi yang lebih baru. - Registry yang kini menyajikan byte berbeda di bawah versi yang di-pin menghentikan verifikasi dengan galat integritas yang menghentikan pull, alih-alih melaporkan perubahan itu sebagai penyimpangan.
- Baris lockfile yang disunting manual, Release yang disunting, dan entitas yang disunting di direktori katalog lokal masing-masing dilaporkan, karena masing-masing merupakan perbedaan antara lockfile dan apa yang diresolusi pull sekarang.
Perintah ini membaca dan mengisi cache seperti pull. Entri yang dimuat cache di bawah pin-nya — entitas katalog, atau .wasm sebuah plugin — dibaca dari sana tanpa bertanya ke registry, yang memungkinkan verifikasi berjalan dalam mode luring atas workspace yang telah diisi pull yang terhubung. Entri yang tidak dimuat cache diambil, seperti pull mengambilnya, dan entri yang tidak lagi cocok dengan pin-nya diperlakukan persis seperti pull memperlakukannya. Jadi verifikasi dapat menambah isi cache, dan tidak pernah memindahkan pin.
Membandingkan tanda tangan yang tercatat, di kedua berkas
Tanda tangan yang diverifikasi pull untuk sebuah artefak adalah bagian dari apa yang ditulisnya: signature pada entri lockfile, dan pada entri plugins-trust.yaml untuk plugin yang dipasang pada peran verdict. Setelah pin-pin cocok, verifikasi mencocokkan setiap tanda tangan yang tercatat dengan tanda tangan yang akan dicatat pull sekarang, dan melaporkan setiap tanda tangan yang akan dicatat pull di tempat belum ada yang tercatat, diganti, atau dihapus, di bawah A recorded signature is not the one a pull would record (Tanda tangan yang tercatat bukan yang akan dicatat oleh pull). Setiap entri semacam itu, di kedua berkas, disebut dalam eksekusi yang sama.
Entri lockfile mana yang dicarinya adalah pilihan pull itu sendiri. Pull ulang menanyakan tanda tangan sebuah entri kepada registry tepat di tempat yang dijelaskan Mematuhi vs. memperbarui, dan verifikasi membaca pilihan yang sama itu:
- Dua dilaporkan tanpa bertanya ke registry, karena pull menulis ulang keduanya apa pun jawaban registry: entri yang disajikan cache yang tidak mencatat tanda tangan di tempat konfigurasi kepercayaan mewajibkannya — pull mencatat tanda tangan artefak, atau berhenti di tempat tidak ada yang dapat ditetapkan — dan entri yang tanda tangan tercatatnya dibuat untuk artefak lain, yang diganti pull dengan tanda tangan milik artefak itu sendiri.
- Setiap entri lain yang akan dicari lagi oleh pull ditanyakan, karena hanya jawaban registry yang menyatakan apakah pull akan mengubahnya: entri yang byte-nya diambil oleh verifikasi ini, dan entri yang bundel tanda tangannya di cache telah dihapus, tidak dapat dibaca, atau telah diubah. Verifikasi bertanya ke registry, seperti yang akan dilakukan pull, dan melaporkan entri tersebut di tempat jawabannya mencatat, mengganti, atau menghapus tanda tangannya. Bundel tanda tangan yang diverifikasinya disimpan ke cache seperti pull menyimpannya, sehingga entri yang bundel di cache-nya telah dihapus, sementara registry-nya masih menyajikan tanda tangan yang tercatat, lolos dan meninggalkan cache dalam keadaan diperbaiki.
Entri yang tanda tangan tercatatnya diterima build, dan entri yang tidak mencatat tanda tangan dan tidak ada yang mewajibkan tanda tangan untuknya, tidak ditanyakan, baik oleh pull maupun oleh verifikasi.
Catatan kepercayaan plugin dicocokkan dengan pull yang sama. Setiap pull memverifikasi tanda tangan setiap plugin yang dipasang pada peran verdict di registry-nya, begitu pula verifikasi, yang melaporkan entri yang tanda tangannya akan dicatat, diganti, atau dihapus oleh verifikasi tersebut. Plugin yang tidak memiliki entri dalam catatan dilaporkan di tempat build menolaknya karena tidak mencatat tanda tangan, karena pull menulis entri yang membawa tanda tangannya dan build menolak plugin tersebut sampai saat itu. Plugin lainnya merupakan penampakan pertama, yang tidak dilaporkan verifikasi, sebagaimana verifikasi tidak melaporkan identitas apa pun yang belum dimuat catatan tersebut. Dalam mode luring, verifikasi tidak bertanya ke registry mana pun tentang plugin-plugin ini, dan Luring menjelaskan apa yang dilaporkannya sebagai gantinya.
Penanda deprekasi tidak dibandingkan. Penanda yang dilampirkan ke artefak setelah pull adalah keadaan registry, dan ia berubah tanpa ada yang berubah di workspace; verifikasi yang gagal karenanya akan menggagalkan pemeriksaan atas berkas yang tidak Anda sentuh. Dengan alasan yang sama, penanda yang tercatat memberi peringatan kepada build alih-alih menghentikannya. Jadi pull dapat mencatat penanda pada entri yang telah lolos verifikasi.
Pratinjau apa yang akan ditulis pull
aggrega pull --dry-run --release <release> meresolusi dependensi persis seperti pull biasa lalu, alih-alih menulis, mencetak apa yang akan ditulisnya: satu header yang menyebut jalur setiap berkas, diikuti konten yang akan dimuat berkas tersebut.
aggrega pull --dry-run --release release.yamlPerintah ini menyebut setiap berkas, bukan hanya lockfile. Lockfile, entity.lock di samping setiap Recipe dan FeatureRecipe yang pin tercatatnya akan bergeser di bawah --pin-sources, dan catatan kepercayaan plugin semuanya muncul dalam laporan yang sama, karena pratinjau yang hanya menampilkan lockfile akan mengajarkan kepada Anda bahwa lockfile adalah satu-satunya yang bergeser. Pull yang akan berhenti pada entitas yang belum di-pin juga berhenti di bawah --dry-run, dengan alasan yang sama: apa yang ditampilkan pratinjau adalah apa yang akan dilakukan pull. Berkas yang akan dibiarkan pull tetap sama byte demi byte tidak muncul sama sekali — sebuah nama dalam laporan berarti berkas tersebut akan berubah. Baris terakhir menghitungnya, dan workspace yang tidak akan diubah pull melaporkan hitungan nol.
Tidak ada yang berubah di disk. Tidak ada lockfile yang ditulis atau dibuat, tidak ada lock entitas yang ditulis atau dihapus, dan tidak ada catatan kepercayaan yang dibuat atau diubah. Jika sebuah kapabilitas disajikan oleh lebih dari satu plugin provider dan belum ada yang memilih di antaranya, eksekusi berhenti dengan menyebut apa yang perlu diberikan alih-alih menawarkan untuk menulis pilihan itu ke konfigurasi Anda — pratinjau tidak menyunting berkas konfigurasi sambil lalu.
Resolusi itu sendiri tetap berjalan, sehingga cache tetap terisi. Input eksternal mana yang dikonsumsi sebuah Release merupakan hasil dari merendernya, dan eksekusi yang menolak meresolusi tidak akan memiliki apa pun untuk dilaporkan, sehingga --dry-run mengambil dan menyimpan persis seperti pull. Konten di bawah .aggrega/cache hanya dibaca melalui pin yang dicatat lockfile, sehingga mengisinya tidak mengubah apa pun yang diresolusi build; apa yang ditampilkan dry run adalah apa yang akan ditulis pull.
--upgrade tanpa target tidak menanyakan apa pun di bawah flag ini. Konfirmasi ada karena penyegaran penuh membuang setiap pin yang tercatat, sedangkan pratinjau tidak membuang satu pun — jadi aggrega pull --dry-run --upgrade --release <release> adalah bentuk yang tepat digunakan ketika yang ingin Anda ketahui adalah berapa biaya sebuah penyegaran bagi Anda, dan bentuk ini berjalan tanpa jawaban.
Flag ini tidak diterima bersama --verify, yang memang tidak menulis satu pun dari berkas-berkas itu. Pasangan tersebut akan membuat flag tidak melakukan apa pun sementara tampak seolah telah melakukan sesuatu, sehingga pasangan itu ditolak alih-alih diabaikan.
Ada satu hal yang tidak selalu dapat ditampilkan sepenuhnya oleh pratinjau dengan pinning, dan ia menyatakannya ketika itu terjadi. Pull yang diminta melakukan pin menulis ulang entity.lock di samping setiap Recipe dan FeatureRecipe lalu merender Release untuk menemukan input eksternalnya; pratinjau membiarkan lock tersebut, sehingga di tempat pin yang tercatat di sana telah usang — misalnya, Anda menyunting berkas yang diimpor sejak berkas itu di-pin — render tersebut dicocokkan dengan digest usang yang masih dicatat oleh lock yang tidak ditulis, lalu berhenti. Segala hal lain dalam laporan persis seperti yang akan ditulis pull; hanya pin input eksternal dari lockfile yang dilaporkan yang kurang. Eksekusi menyatakannya baik di output maupun di diagnostiknya alih-alih menyerahkan kepada Anda lockfile yang tampak lengkap. Resolusi pertama sebuah workspace tidak terpengaruh, karena belum ada digest tercatat yang dapat membuat sesuatu menjadi usang.
Komposisi yang dijelaskan pin-pin ini
Lockfile mem-pin apa yang akan dikonsumsi build Release ini, sehingga resolusi menyusun komposisi yang disusun build tersebut: ia meresolusi dokumen, menerapkan transformasi yang dideklarasikan pemasangan workspace, dan menjalankan hasilnya melalui pemeriksaan yang dilakukan build atas graf yang sudah jadi. Dua hal mengikuti dari situ, dan keduanya muncul pada tahap yang menulis lockfile, bukan pada build pertama yang membacanya.
Komposisi yang ditolak pemeriksaan tersebut menghentikan pull. Sisi uses: yang targetnya tidak memenuhi selector: soket-nya, Feature yang dipasang pada komponen yang tidak diizinkan oleh appliesTo:-nya, dan setiap pelanggaran lain yang dilaporkan pemeriksaan tersebut menghentikan perintah ini, dengan diagnostik yang dicetak build atas dokumen yang sama — dan penghentian itu menyebut setiap temuan dalam satu eksekusi alih-alih hanya yang pertama, sehingga satu tahap memberi Anda seluruh daftar yang perlu diperbaiki. Hal ini terjadi sebelum penulisan, sehingga <release-stem>.lock dan plugins-trust.yaml dibiarkan persis seperti semula dan Release yang tidak dapat di-build tidak pernah dicatat sebagai Release yang teresolusi dengan bersih. Yang tidak tercakup adalah pemasangan yang mengembalikan verdict: tidak ada pemasangan ir-verdict atau render-verdict yang berjalan di sini, sehingga verdict yang menolak menghentikan build, lint lingkup release, atau validasi lingkup release yang memanggilnya, bukan perintah ini.
Pemasangan pada peran yang membentuk graf berjalan selama tahap tersebut, sehingga plugin yang tidak dapat diresolusi menghentikan pull. Pemasangan label-transform menentukan label node sebelum apa pun dicocokkan dengannya, dan pemasangan annotation-transform menyisipkan anotasi yang mengembang menjadi pemasangan Feature — keduanya mengubah isi graf, sehingga menyusun graf berarti memanggil keduanya, dan memanggilnya berarti memegang byte milik setiap plugin. Plugin yang byte-nya tidak dapat diperoleh tahap ini menghentikan eksekusi, dengan menyebut plugin tersebut dan apa yang tidak dapat ditemukan untuknya — penolakan yang sama dengan yang dilakukan build atas workspace yang sama ketika tidak dapat memperolehnya. Yang dipanggilnya adalah daftar pemasangan yang baru saja diresolusi tahap ini, membawa pengaturan dan berkas definisi yang dicatat lockfile agar build berikutnya dapat merekonstruksinya, sehingga kedua tahap menjalankan pemasangan yang sama atas input yang sama.
Plugin yang disebut sebuah langkah pipeline dan tidak dimuat oleh sumber mana pun juga menghentikan pull. Setiap Plugin yang disebut pipeline sebuah Recipe atau FeatureRecipe diresolusi bersama dependensi lain milik Release — dari direktori katalog, salinan di dalam biner compiler, cache konten, atau registry — dan Plugin yang tidak dimuat oleh satu pun dari sumber tersebut juga tidak akan dapat dimuat oleh build. Jadi pull berhenti sebelum menulis apa pun, dengan menyebut Plugin tersebut dan Recipe atau FeatureRecipe yang pipeline-nya menyebutnya, dengan kondisi yang dimunculkan build ketika mencapai langkah itu (A plugin reference is not a Plugin entity (Referensi plugin bukan entitas Plugin)). Hal itu berlaku untuk setiap Recipe dan FeatureRecipe yang diikat Manifest, termasuk yang tidak dipasang oleh apa pun dalam Release ini, karena masing-masing diresolusi dan di-pin baik dirender maupun tidak. Terbitkan Plugin tersebut, atau letakkan di direktori katalog dengan .wasm hasil build-nya di sampingnya, lalu lakukan pull lagi.
Penghentian itu dan eksekusi yang terdegradasi sengaja merupakan hasil yang berbeda. Render yang tidak dapat selesai — yang dijelaskan baik oleh Bagaimana resolusi menemukan input eksternal maupun Luring — membiarkan setiap pin dependensi tetap benar, sehingga pin-pin ditulis dan kekurangannya dilaporkan. Komposisi yang ditolak pemeriksaan bukanlah kekurangan dalam apa yang telah diresolusi: ia adalah Release yang tidak dapat di-build, sehingga tidak ada yang di-pin untuknya dan eksekusi berhenti.
Cache
Konten yang diambil disimpan di bawah .aggrega/cache, dibagi menjadi subpohon entities/ untuk entitas katalog, subpohon source-artifacts/ untuk artefak sumber, dan subpohon inputs/ untuk input eksternal yang dikonsumsi render. Slot entitas katalog dinamai berdasarkan jenis, koordinat, dan versinya — sehingga Component dan Recipe yang berbagi koordinat dan versi tetap memiliki dua slot —, slot artefak sumber berdasarkan asal pengambilannya, versinya, dan awalan digest kontennya, dan slot input eksternal berdasarkan digest kontennya; apa yang dibaca build dari salah satunya diperiksa terhadap apa yang dicatat lockfile. Karena itu, pin versi yang identik berbagi satu slot lintas Releases. Setiap slot artefak sumber memuat arsip otoritatif, ekstraksi yang dibuat ulang, dan sebuah berkas metadata kecil; ekstraksi dibuat ulang pada setiap pembacaan, sehingga output build bergantung pada arsip dan lockfile, bukan pada keadaan berkas yang diekstrak.
Setiap nama yang diturunkan cache dari sebuah nilai diterima oleh Windows, Linux, dan macOS. Koordinat, versi, host registry, atau digest memuat karakter yang tidak dapat dimuat nama berkas: / di antara bagian-bagian koordinat, : sebelum versi, di dalam sha256:, dan sebelum port registry. Jadi setiap nilai — jenis, koordinat, versi, host registry, atau digest — ditranskripsikan sebelum menjadi nama direktori atau berkas — huruf kecil, angka, ., _, dan - ditulis apa adanya, dan setiap karakter lain ditulis sebagai escape yang diawali +. Component core/devtool/adminer:1.0.0 pada versi 1.0.0 adalah slot entities/+zx000043omponent/core+zsdevtool+zsadminer+zx00003a1.0.0/1.0.0/, dan slot yang dinamai berdasarkan digest konten adalah sha256+zx00003a<hex>. Huruf besar juga di-escape, sehingga dua koordinat yang hanya berbeda dalam huruf besar-kecil tetap memiliki dua slot pada sistem berkas yang mengabaikan huruf besar-kecil; nama yang dicadangkan Windows untuk perangkat, seperti con, huruf pertamanya di-escape; dan tidak ada nama yang diakhiri titik. Dua nilai berbeda tidak pernah berbagi nama, dan satu nilai memiliki nama yang sama di setiap mesin. aggrega cache status mencantumkan setiap entri berdasarkan nilai yang menjadi asal transkripsi namanya — entitas katalog berdasarkan koordinat, versi, dan jenisnya — bukan berdasarkan nama hasil transkripsi.
Entri sebuah arsip mempertahankan nama yang diberikan penerbitnya, sehingga di Windows entri yang tidak dapat dimuat Windows ditolak. Berkas-berkas yang dibawa arsip artefak sumber atau entitas katalog ditata dengan nama yang diberikan arsip tersebut, bukan ditranskripsikan oleh cache. Jika ekstraksi berjalan di Windows, entri yang memuat bagian yang tidak dapat dimuat Windows sebagaimana tertulis — nama yang dicadangkannya untuk perangkat, seperti NUL atau aux, dalam huruf besar-kecil apa pun dan dengan atau tanpa ekstensi, atau bagian yang diakhiri titik atau spasi — ditolak dengan E0340, dengan menyebut entri tersebut, dan tidak ada isi arsip itu yang ditata. Di Linux dan macOS, entri semacam itu ditata sesuai namanya. Entri yang naik keluar dari direktori ekstraksi ditolak di setiap mesin.
Slot entitas katalog hanya merupakan entri jika disertai manifest-nya. Slot memuat konten yang disajikan registry dan, di sampingnya, manifest yang menjelaskan konten tersebut. Slot yang hanya memuat konten — pengambilan yang berhenti di antara dua penulisan, atau berkas yang diletakkan di sana secara manual — bukanlah entri: pull, dan pull yang memverifikasi, memintanya lagi dari registry entitas tersebut jika ada yang dapat dijangkau, sedangkan build, yang tidak pernah mengambil apa pun, memperlakukan entitas tersebut sebagai tidak ada, seperti yang dilakukan pull ketika tidak ada registry yang dapat dijangkau.
Apa yang masuk ke cache diuji terhadap dua hal: bentuk yang dijelaskan skema entitas itu sendiri, dan tempat yang ditetapkan cache untuknya. Isi yang diambil dari registry dijalankan melalui skema jenisnya — pemeriksaan yang sama dengan yang membacanya kembali — sebelum disimpan ke cache, sehingga entitas atau pustaka terbitan yang disajikan registry dan ditolak skemanya sendiri menghentikan pull, dengan menyebut apa yang diambil, alih-alih disimpan ke cache dan baru ditemui sebagai kesalahan di kemudian hari. Dan nilai yang menjadi dasar pembentukan lokasi cache yang akan menempatkan berkas cache di tempat selain yang disebut nilai tersebut — versi yang berupa jalur dan bukan versi, jalur url sumber, atau module_subdir yang naik melewati tempatnya — ditolak di tempat lokasi itu dibentuk, dengan menyebut nilai yang bermasalah. Nilai yang ditulis dalam Recipe atau FeatureRecipe yang Anda tulis diuji dengan cara yang sama pada saat lokasi cache dibentuk darinya — dan module_subdir sumber git lebih awal lagi, sebelum repositori diambil, seperti dijelaskan di bawah.
Repositori git diarsipkan dari checkout-nya sendiri. Untuk sumber git-repository, pull melakukan checkout repositori pada commit yang di-pin-nya dan mengarsipkan direktori yang disebut module_subdir, atau seluruh repositori. module_subdir yang naik melewati repositori sebagaimana tertulis — ../shared, atau ..\shared — ditolak sebelum repositori diambil, dengan E0307 mengutip nilainya, sehingga tidak ada apa pun di samping checkout yang dibaca. Tautan simbolik yang dikomit repositori diarsipkan sebagai berkas atau direktori yang ditunjuknya bila target itu berada di dalam repositori — module_subdir itu sendiri dapat berupa tautan semacam itu. Tautan yang mengarah keluar dari repositori menghentikan pull dengan E0321, dengan menyebut tautan tersebut dan ke mana ia mengarah, dan tidak ada yang disimpan ke cache, sehingga repositori yang Anda pull tidak dapat membuat pull menyalin berkas dari mesin Anda ke dalam artefak. Checkout dihapus begitu pull berhenti, sehingga pesan menyebut tautan berdasarkan tempatnya di repositori, serta repositori dan revisi yang disebut sumber, alih-alih direktori yang sudah tidak ada. Mengubah tautan itu adalah urusan repositori. Batas workspace menyatakan aturan yang diterapkan di sini.
Cache ditambatkan ke workspace, bukan ke direktori tempat Anda menjalankan perintah, sehingga satu workspace memiliki satu cache dan pull yang dijalankan dari subdirektori mengisi penyimpanan yang sama dengan yang dibaca build yang dijalankan dari root.
Pull yang tidak menemukan workspace dan tidak diberi nama workspace ditolak sebelum apa pun diambil. Jika tidak ada yang menyebut root dan penemuan tidak menambatkan apa pun — dari folder tempat Anda menjalankannya, atau, untuk Release yang disebut dengan jalur absolut, dari folder milik Release itu sendiri — folder tersebut akan menjadi root, dan cache yang ditulis di bawahnya akan menjadikannya workspace. Jadi pull berhenti, tidak menulis lockfile maupun cache, dan menyebut folder tersebut serta dua cara untuk mengatasinya: sebut workspace Anda dengan --workspace-root atau AGGREGA_WORKSPACE_ROOT, atau berikan folder tersebut sebuah .aggrega-config.yaml yang memuat blok workspace:. Alat pull dari aggrega mcp, yang dipanggil tanpa workspace_root pada server yang dijalankan tanpa root, ditolak dengan cara yang sama; Konfigurasi mencantumkan perintah lain yang juga berlaku demikian.
Membangun di tempat jaringan tidak dapat dijangkau
Karena perintah ini adalah satu-satunya langkah yang menjangkau ke luar, satu eksekusi yang terhubung sudah cukup untuk membuat setiap build berikutnya bersifat lokal. Eksekusi itu menulis lockfile dan mengisi cache workspace dengan byte yang disebut pin-pin tersebut, dan build kemudian tidak memerlukan apa pun di luar itu.
Tiga hal dibawa ke mesin yang terputus:
- Release dan lockfile-nya. Komit
<release-stem>.lockdi samping Release; berkas itulah yang memberi tahu build ke versi dan digest mana setiap dependensi diresolusi. plugins-trust.yaml, jika workspace memasang plugin yang mengembalikan verdict. Build membandingkan pemasangan verdict yang disebut konfigurasinya dengan catatan tersebut sebelum salah satunya berjalan, sehingga membawa catatan itulah yang mengikat build yang terputus pada identitas yang telah ditinjau dan pada tanda tangan yang diverifikasi pull untuknya. Komit catatan itu di samping lockfile, seperti dijelaskan dalam Catatan kepercayaan plugin.- Direktori cache. Entitas, artefak sumber, dan input yang di-pin semuanya berada di bawahnya, dan apa pun yang tidak disediakan direktori
catalog_dirslokal dibaca dari sana.
Lakukan build di mesin yang terputus seperti biasa. Mengatur mode luring di sana layak dilakukan meskipun build atas lockfile yang terisi membaca closure-nya dari cache: hal itu mengubah upaya akses jaringan yang mungkin terjadi menjadi penolakan langsung yang menyebut mode tersebut, alih-alih upaya koneksi yang harus menunggu timeout terlebih dahulu. Apa pun yang tidak dimuat cache, dan setiap input eksternal yang tidak di-pin lockfile, menghentikan build dengan menyebut apa yang hilang dan resolusi yang akan mem-pin-nya — tidak ada yang diambil secara diam-diam untuk mengisi celah tersebut.
Mesin yang terisolasi dari jaringan dan workspace luring adalah klaim yang berbeda, dan perbedaannya layak dipertahankan. Mesin di balik isolasi jaringan dapat memuat salinan lokal sebuah registry, atau katalog catalog_dirs yang membawa semua yang dibutuhkannya, dan dalam hal itu pull biasa di mesin tersebut dapat dipenuhi tanpa menjangkau ke luar sama sekali. Mode luring menjelaskan apa yang boleh dijangkau sebuah perintah, bukan apa yang dimuat mesin; Luring menguraikan apa yang ditolaknya dan apa yang dibiarkannya.
Luring
Dalam mode luring — kunci tingkat teratas offline dalam berkas konfigurasi, AGGREGA_OFFLINE di lingkungan, atau --offline di baris perintah — aggrega pull menolak akses jaringan. Penolakan terjadi sebelum koneksi apa pun dicoba, bukan sebagai timeout di tengah pengambilan, sehingga pull luring tidak menjangkau registry mana pun maupun sumber jarak jauh mana pun. Jika berkas yang dikomit atau variabel yang diekspor menetapkan mode tersebut dan Anda ingin melewatinya untuk satu perintah, --offline=false mengizinkan jaringan hanya untuk eksekusi itu.
--upgrade ditolak mentah-mentah dalam mode ini, dan hanya opsi inilah yang demikian di sini. Penyegaran penuh menggeser setiap dependensi ke versi tertinggi yang saat ini ditawarkan registry, sehingga ia perlu bertanya kepada registry apa yang saat ini disajikannya. Pull biasa tidak perlu: ia mematuhi pin yang sudah dicatatnya, hanya meresolusi apa yang belum memiliki pin, dan karena itu dapat dipenuhi dari apa yang dimuat mesin. Penolakan tersebut menyebut tempat mana dari ketiganya yang menetapkan mode itu dan cara mengizinkan jaringan untuk satu eksekusi.
Resolusi kemudian hanya mengandalkan apa yang sudah dimuat mesin: tumpukan pencarian catalog_dirs dan cache di bawah .aggrega/cache. Dengan katalog dan cache yang memenuhi setiap referensi, pull luring selesai secara normal dan menulis lockfile biasa. Lockfile mencatat URI, versi yang diresolusi, dan digest setiap dependensi, dan tidak pernah mencatat tempat mana yang menyajikan byte-nya — sehingga pull luring dan pull daring yang meresolusi versi yang sama menulis lockfile yang sama.
Dependensi yang tidak dapat dipenuhi pull luring secara lokal menghentikannya. Entri tersebut tidak pernah dilewati:
- Entitas katalog yang tidak dapat diresolusi di mana pun menghentikan pull, dengan menyebut referensinya dan dari mana ia dirujuk, sehingga baik dependensi yang hilang maupun hal yang memintanya sama-sama disebut.
source:jarak jauh menghentikan pull, dengan menyebut sumbernya dan meminta Anda untuk mengizinkan akses jaringan atau mengisi cache dari lingkungan yang terhubung.- Dependensi yang dimuat cache yang tanda tangan wajibnya tidak dicatat lockfile, atau yang tanda tangan tercatatnya tidak diterima build, menghentikan pull dengan penolakan luring, dengan menyebut dependensi tersebut: mencatat tanda tangan berarti bertanya kepada registry-nya, seperti dijelaskan dalam Mematuhi vs. memperbarui. Mengizinkan jaringan untuk satu eksekusi itu akan mencatatnya. Tanda tangan tercatat yang diterima build tidak dicari lagi, sehingga tidak menghentikan pull luring.
Input eksternal adalah satu-satunya yang tidak menghentikan, dan sebagai gantinya ia menyatakannya. Render yang menemukannya tidak dapat mengambil apa yang belum tersimpan, sehingga pull luring atas Release dengan input eksternal yang belum di-pin tetap selesai, menulis setiap pin dependensi yang telah diresolusinya, dan melaporkan tiga hal: bahwa render tidak selesai, apa yang telah di-pin-nya, dan bahwa build Release ini akan berhenti dengan menyebut URL-nya. Pin dependensi yang ditulisnya benar — tidak ada yang bergantung pada render — sehingga pin-pin itu dipertahankan alih-alih dibuang untuk direproduksi pembaca.
Hal itu disengaja dan bukan celah, dan tidak ada sakelar untuknya. Pull yang membuang pekerjaan yang benar akan merugikan Anda bagian yang berhasil; pull yang diam akan menyerahkan kepada Anda lockfile yang tampak lengkap padahal tidak. Menyatakannya adalah satu-satunya hasil yang membuat Anda tetap dapat bertindak: jalankan pull lagi dari lingkungan yang terhubung, atau dari lingkungan yang cache-nya sudah memuat konten tersebut, dan perintah yang sama akan mem-pin-nya.
Jadi pull luring adalah penolakan untuk menyentuh jaringan, bukan hasil yang dikurangi untuk semua yang disebut sebuah dokumen, dan untuk input eksternal ia adalah resolusi yang selesai yang memberi tahu Anda apa yang tidak dapat dijangkaunya. Lockfile yang ada adalah lockfile yang resolusi dependensinya telah selesai; apakah input eksternalnya lengkap adalah hal yang diberitahukan output pull itu sendiri kepada Anda, dan hal yang kemudian diuji oleh build terhadapnya.
--verify dalam mode luring mencakup lebih sedikit, dan melaporkan hal itu. Menanyakan ke mana ref sumber yang tercatat menunjuk hari ini berarti menjangkau remote-nya, yang ditolak oleh mode luring. Jadi --verify luring memeriksa dependensi yang di-pin dan melewati sumbu tersebut, serta mencetak baris yang menyatakannya alih-alih melaporkan kecocokan yang tidak pernah ditetapkannya. Tanda tangan tercatat yang hanya dapat dikonfirmasi registry-nya — pada entri lockfile yang bundel tanda tangannya di cache telah dihapus atau diubah — dilewati dengan cara yang sama, pada baris yang menyebut setiap entri semacam itu:
verify: offline, so the signature the lockfile records for "<reference>" was not checked at its registry, which alone can say whether a pull would record it again; this verify does not cover itTanda tangan tercatat yang akan ditulis ulang pull apa pun jawaban registry tetap dilaporkan secara luring, karena tidak diperlukan jawaban untuk mengetahuinya, seperti dijelaskan dalam Membandingkan tanda tangan yang tercatat, di kedua berkas.
Plugin yang dipasang pada peran verdict dan disajikan registry adalah titik di mana verifikasi luring dan pull luring berpisah. Plugin semacam itu tidak pernah di-pin di lockfile, sehingga setiap pull meresolusi .wasm-nya dari registry-nya, dan pull luring atas workspace yang memasang plugin seperti itu berhenti di sana, dengan menyebut plugin tersebut sebagai plugin yang .wasm-nya tidak dapat diresolusi — bahkan ketika cache konten memuatnya, dan terlepas dari apakah registry itu ditandai advisory atau melewati verifikasi tanda tangan. Sebaliknya, verifikasi luring tidak menanyakan apa pun kepada registry tentang plugin tersebut: ia membaca plugin dari cache konten, seperti build membacanya, dan berhenti di tempat cache tidak memuat .wasm-nya atau memuat berkas yang tidak lagi cocok dengan digest yang disebut manifest terbitannya. Ia tetap mencocokkan identitas plugin dengan catatan kepercayaan plugin dan memeriksa ulang fungsi host-nya terhadap .wasm tersebut, dan berhenti di tempat salah satunya tidak sesuai, persis seperti verifikasi yang terhubung. Ia melaporkan plugin tersebut di tempat pull menulis ulang entrinya apa pun jawaban registry, yaitu di tempat build menolak plugin karena entrinya: karena tidak mencatat tanda tangan, sebab entrinya tidak mencatat tanda tangan atau catatan tidak memiliki entri untuknya, atau karena tanda tangan yang dicatat entrinya dibuat untuk artefak lain, yang diganti pull dengan tanda tangan milik plugin itu sendiri. Setiap entri lain — entri yang tanda tangannya diterima build, dan entri yang bundel tanda tangannya di cache telah dihapus atau diubah — disebutnya pada baris yang menyatakan bahwa tanda tangannya tidak diperiksa, dan ia tidak melaporkan apa pun tentang tanda tangan itu:
verify: offline, so the signature of "<plugin>" was not checked at its registry, which alone can say whether a pull would record the same signature on its entry in the plugin trust record; this verify does not cover itJadi verifikasi luring melewati entri yang tanda tangannya akan diganti atau dihapus pull yang terhubung — misalnya entri yang penandatangannya disunting secara manual, atau entri yang tidak lagi dilampiri tanda tangan oleh registry-nya — dengan baris tersebut sebagai satu-satunya hal yang menyatakannya. Verifikasi di mesin yang terisolasi dari jaringan tetap tersedia; yang tidak diberitahukannya kepada Anda adalah apakah sebuah ref telah berpindah sejak itu, atau apakah tanda tangan yang dilewati akan dicatat lagi. Pemeriksaan yang hanya membaca kode keluar mencakup hal-hal itu hanya ketika verifikasi berjalan dalam keadaan terhubung.
Integrasi dengan aggrega build
- Verifikasi.
aggrega buildmemverifikasi setiap dependensi yang telah di-resolve terhadap lockfile dan berhenti jika terjadi drift: entitas, pustaka, atau plugin yang kontennya tidak lagi cocok dengan pin-nya, referensi yang kini dijangkau oleh Release tetapi tidak di-pin oleh lockfile atau yang di-pin tetapi tidak lagi dijangkau oleh Release, serta file Release yang diedit sejak pull. Jalankanaggrega pull --release <release>, perintah yang dicetak oleh penghentian tersebut, untuk mengatasinya: pull me-resolve Release sebagaimana kondisinya sekarang, menulis ulang pin yang berpindah, dan mempertahankan semua pin lainnya, sehingga tidak ada yang bergeser tanpa Anda ubah. Jika yang berpindah adalah file di bawah sumber lokal sebuah Recipe, pull terlebih dahulu menyebutkanaggrega pinuntuk entitas tersebut, seperti yang dijelaskan dalam Lock entitas. Lockfile yang baru saja ditulis oleh perintah ini lolos pemeriksaan tersebut, karena perintah menjalankan pemeriksaan yang sama sebelum menulisnya; build yang berhenti karena drift tepat setelah pull telah diberi input yang berbeda dari pull — direktori--catalogyang diberikan ke salah satunya saja, atau konfigurasi workspace yang diedit di antara keduanya — jadi jalankan keduanya atas input yang sama.aggrega validate --releasedan setiap pilihanaggrega inspectyang me-resolve Release menerapkan pemeriksaan yang sama pada lockfile dan menolak dengan penghentian yang sama, sehingga keduanya tidak meloloskan lockfile yang ditolak oleh build. - Pull otomatis. Jika lockfile tidak ada dan
auto_pullbernilai true,aggrega buildmenjalankan pull terlebih dahulu secara otomatis. Jikaauto_pullbernilai false, yang merupakan nilai default-nya, build berhenti dan meminta Anda melakukan pull. Pull yang dijalankan oleh build mengikutipin_sources_at_pull, sehingga pada entitas yang belum di-pin ia berhenti persis seperti pull. Langkah pull yang dijalankan oleh build sama dengan yang dijelaskan halaman ini, sehingga build yang mengisi lockfile yang sudah ada berhenti pada ref sumber yang berpindah persis sepertiaggrega pull— lihat Determinisme dan integritas. - Offline. Dalam mode offline,
aggrega buildhanya menggunakan apa yang sudah ada di mesin, dan menolak akses jaringan sebelum koneksi apa pun dicoba. Referensi yang kontennya tidak ada di cache menghentikan build alih-alih gagal di tengah pengambilan, dan build tanpa lockfile yang tidak diminta untuk mengisinya berhenti dengan menyebutkan pull yang akan mengisinya, persis seperti saat online.--auto-pulltidak ditolak: pengisian yang dimintanya adalah pull yang dijelaskan halaman ini, sehingga atas entitas katalog yang sudah ada di cache atau ada di katalog lokal, ia menulis lockfile tanpa menghubungi registry — Recipe yang chart-nya diambil dari sumber jarak jauh di-resolve ulang, sehingga dalam mode offline ia berhenti bahkan ketika cache menyimpan chart tersebut — dan referensi yang tidak disimpan oleh keduanya — atau yang ada di cache tetapi tanda tangan wajibnya tidak dicatat oleh lockfile, atau tanda tangan tercatatnya tidak diterima oleh build — menghentikannya dengan penolakan milik pull itu sendiri yang menyebutkan referensi tersebut.--upgradeditolak, dengan alasan yang diberikan Offline. - Pencarian katalog. Pull mematuhi
catalog_dirsdari.aggrega-config.yamlbahkan ketika tidak ada--catalogyang diberikan — beserta direktori milik Release sendiri jika konfigurasi memberinya direktori di bawahworkspace.releases— dan me-resolve tumpukan pencarian yang sama dengan aturan kecocokan pertama menang sepertiaggrega build, sehingga dependensi yang di-pin-nya cocok dengan apa yang dicari build. Direktori terdaftar yang ternyata bukan direktori — misalnya tidak ada apa pun di sana — ditolak oleh kedua perintah sebelum apa pun di-resolve atau ditulis, dengan menyebutkan entri tersebut serta file konfigurasi dan baris yang mencantumkannya, seperti yang ditunjukkan Dari mana entitas lokal dibaca.
Cara resolusi menemukan input eksternal
Tidak ada dalam bagian ini yang mengubah aturan di atas — tetap ada satu momen saat sesuatu di-pin, yaitu perintah ini. Yang dijelaskannya adalah bagaimana perintah mencapai jenis ketiga dari tiga jenis tersebut, yang penting ketika Anda memasang resolusi ke dalam pipeline, membaca eksekusi yang menurun, atau menalar mengapa perintah ini melakukan render sama sekali.
Entitas katalog dan artefak sumber masing-masing disebutkan dalam sebuah dokumen; input eksternal tidak. Me-resolve dua yang pertama adalah soal membaca apa yang Anda tulis. Input eksternal disebutkan oleh provider, di tengah proses render, dan URL mana yang disebutkannya bergantung pada nilai yang sedang di-render — entri nilai yang tidak ada membuat seluruh subpohon skema sebuah chart tidak dikompilasi dan setiap referensi jarak jauh di subpohon itu tidak diminta. Tidak ada pembacaan Release yang dapat menghitung himpunan tersebut.
Jadi perintah melakukan dua hal dalam satu lintasan: ia me-resolve dan mem-pin penutupan yang disebutkan dokumen, lalu me-render penutupan itu untuk melihat dokumen jarak jauh mana yang diminta oleh provider. Artefak hasil render dibuang dan pin dipertahankan. Keduanya bersifat internal pada satu perintah itu, dan tidak satu pun merupakan momen kedua saat sesuatu dapat di-pin — hanya ada satu penulisan lockfile, dan penulisan itu membawa setiap pin.
Dua konsekuensi perlu diketahui sebelum memasang resolusi ke dalam pipeline otomatis sebagai langkah yang murah. Biayanya lebih besar daripada resolusi yang hanya membaca dokumen, karena ia melakukan render. Dan ia dapat gagal karena alasan yang tidak mungkin menggagalkan resolusi yang hanya membaca dokumen: provider yang tidak dapat me-render Release ini. Ketika itu terjadi, pin dependensi tetap ditulis, karena tidak ada bagian darinya yang bergantung pada render, dan diagnostik menyebutkan tahap yang berhenti, apa yang telah di-pin, dan bahwa build akan berhenti dengan menyebutkan URL yang belum di-pin. Eksekusi tersebut tidak hilang, dan Offline menunjukkan hasil yang sama yang dicapai dengan cara lain.
Render juga menguji lockfile dengan perbandingan yang diterapkan build, sebelum apa pun ditulis. Ia menjalankan urutan milik build itu sendiri, sehingga membandingkan lockfile yang akan ditulis perintah ini dengan hasil resolusi build atas Release yang sama, persis seperti build membandingkan lockfile yang ditemukannya di disk. Lockfile yang ditolak oleh perbandingan itu tidak ditulis — begitu pula apa pun yang akan ditulis perintah setelahnya — dan perintah berhenti dengan menyatakan bahwa resolusi dan build tidak sepakat tentang apa yang menjadi dependensi Release, diikuti setiap entri yang disebutkan oleh perbandingan. Tidak ada apa pun dalam file Anda yang dapat menyebabkannya, dan me-resolve ulang akan menghasilkan ketidaksepakatan yang sama, jadi laporkan bersama Release-nya alih-alih mencoba ulang. Ini satu-satunya kegagalan render yang menghentikan penulisan, dan inilah alasan build atas Release yang sama, dengan input yang sama, tidak melaporkan drift pada lockfile yang ditulis perintah ini.
Tidak ada sakelar untuk melewati render. Sakelar seperti itu akan mempertahankan, sebagai pilihan, justru kejutan yang dihilangkan oleh satu momen tunggal: Release yang ter-resolve dengan bersih sementara input yang dibutuhkan render-nya dibiarkan tanpa pin, dan baru ditemukan saat build.
--auto-pull memasukkan resolusi yang sama ini ke dalam build, dan build hanya melakukan render sekali. Render dari pengisian itulah yang menemukan dan mem-pin input eksternal, dan build menyajikan render tersebut alih-alih melakukan render kedua, sehingga build dengan satu perintah memerlukan render yang sama dengan build biasa atas lockfile yang sudah terisi. aggrega build menguraikan flag render build mana yang sampai kepadanya.
Himpunan tersebut bergantung pada parameter Release, yang memang sudah menjadi perilaku pin komponen. Mengedit parameter Release di antara resolusi dan build adalah pengeditan terhadap Release, sehingga build berhenti pada perbandingan drift dengan menyebutkan file-nya, sebelum render apa pun dapat meminta URL yang belum di-pin; solusinya adalah perintah ini. Parameter yang diimpor dari file terpisah tidak dicatat berdasarkan konten, sehingga mengedit file itu justru sampai ke render, yang berhenti dengan menyebutkan URL yang belum di-pin — dengan solusi yang juga menyebutkan perintah ini.
Determinisme dan integritas
source: sebuah Recipe dapat membuat template versinya berdasarkan values dan infra Release yang telah di-resolve (serta atas locals yang didefinisikan pada keduanya); nilai-nilai ini di-resolve saat pull dan hasilnya di-pin. Pull hanya mengevaluasi entri locals: yang dibaca oleh field source:, serta entri yang dibaca oleh entri-entri itu, hanya dengan helper template milik Aggrega sendiri: entri yang dibaca sumber dan memanggil fungsi Sprig menghentikan pull dengan menyebutkan entri, field, dan fungsinya, sedangkan entri yang tidak dibaca oleh field source: mana pun diserahkan kepada build, yang mengevaluasi dan memeriksanya saat me-render Recipe — lihat Resolving a source: coordinate registers a narrower function set (Me-resolve koordinat source: mendaftarkan kumpulan fungsi yang lebih sempit). Tag atau branch Git yang dapat berubah di-pin ke commit konkret yang ditunjuknya, dan ref yang Anda tulis dicatat di sampingnya. Saat build, digest arsip yang di-cache diverifikasi ulang terhadap lockfile, sehingga cache yang dirusak akan terdeteksi.
Ref yang dicatat diikat ke commit yang di-pin-nya. Ref dicatat karena eksekusi berikutnya menanyakannya lagi, bukan demi keterbacaan — build menanyakan artefak mana yang disebutkannya, dan pull menanyakan apakah ref itu masih menunjuk ke tempat semula. pull yang bukan upgrade menanyakan ulang setiap ref yang dicatat ke mana ia menunjuk, dan ref yang telah berpindah di remote-nya menghentikan eksekusi — dengan menyebutkan artefak, ref, commit yang di-pin lockfile, dan commit yang kini menjadi hasil resolusinya — alih-alih mengadopsi perpindahan tersebut. Jalankan aggrega pull --upgrade --release <release> untuk mengadopsinya. Upgrade yang ditargetkan, yang menyebutkan URI entitas, tidak melakukannya: referensi sumber bukan entitas yang dapat Anda sebutkan, sehingga eksekusi yang ditargetkan mempertahankannya persis seperti pull biasa.
Pemeriksaan itu adalah satu-satunya hal yang tidak dapat dilakukan verifikasi ulang digest saat build untuk Anda. Pull yang mengadopsi ref yang berpindah akan menulis ulang byte yang diambil dan digest yang dicatat dalam tindakan yang sama, sehingga dua nilai yang dibandingkan build akan berpindah bersama dan saling cocok — dan Anda akan mem-build konten sumber yang berbeda dari yang menjadi dasar peninjauan lockfile, tanpa ada yang melaporkannya.
Hanya ref yang dicatat lockfile yang diikat dengan cara ini, dan ref dicatat setiap kali Anda menulisnya. Recipe yang menyebutkan sumbernya hanya dengan version: tidak memiliki ref, sehingga tidak ada yang perlu ditanyakan ulang oleh eksekusi berikutnya — dan itulah jawaban yang benar, karena versi yang Anda tulis sendiri tidak dapat berpindah tanpa sepengetahuan Anda. Referensi lockfile menyatakan apa yang dicatat.
Tulis ref-nya, bukan commit-nya. build menemukan artefak bersumber git berdasarkan ref yang Anda tulis, dicocokkan dengan ref yang dicatat lockfile, sehingga ref: v1.2.3 di-build terhadap commit tempat tag tersebut di-pin dan commit itu tidak pernah perlu muncul di Recipe Anda. Menyebutkan tag yang dapat berubah di version: sebagai gantinya tidak berfungsi dan memang tidak dimaksudkan untuk itu: version: dicocokkan sebagaimana tertulis, dan untuk sumber git lockfile mem-pin sebuah commit.
Lockfile mem-pin konten yang diambil dari registry dan sumber jarak jauh, serta mencatat digest setiap entitas yang di-resolve-nya dari direktori katalog Anda — atas file entitas dan setiap file yang disebutkannya di sampingnya, seperti yang dijelaskan Lockfile — dan setiap file Release yang dibaca oleh resolusi. File dari sumber yang diawali ./ atau ../, dan file artefak yang diimpor entitas, juga di-pin satu per satu dalam lock di samping entitas tersebut, seperti yang dijelaskan Lock entitas, dan itulah yang menyebutkan file yang berpindah; integritas sisa workspace Anda di antara build menjadi tanggung jawab sistem kontrol versi. Lihat output yang identik byte demi byte untuk cakupan jaminan determinisme.
Autentikasi
Kredensial registry hanya dibaca dari konfigurasi kredensial Docker: config.json di direktori yang disebut DOCKER_CONFIG, atau ~/.docker/config.json bila variabel itu tidak diatur, beserta credential helper atau keychain OS apa pun yang didelegasikan file itu melalui credsStore atau credHelpers. aggrega login <registry> menulis kredensial di sana, demikian pula docker login <registry>; jalankan salah satunya sebelum aggrega pull untuk katalog OCI atau registry chart privat. File yang ditulis podman login dan helm registry login tidak dibaca.
Konfigurasi kredensial yang tidak dapat dibaca dilaporkan tanpa menyebut isinya. Jika config.json bukan JSON yang valid, nilai auth sebuah entri bukan pengguna dan kata sandi yang digabung dengan titik dua dan dienkode base64, atau credential helper yang disebut file tidak dapat menjawab, upaya menjangkau registry gagal dengan pesan yang menyebut registry dan file kredensial, tetapi tidak pernah isi file atau entri tersebut. aggrega login dan aggrega logout melaporkan config.json yang bukan JSON valid dengan cara yang sama, dan tidak mengubah apa pun di dalamnya. Perbaiki file tersebut; entri yang tidak dapat dibaca juga dapat diganti dengan aggrega login <registry>.
Repositori chart Helm klasik atau arsip chart (helm-https-chart), fragmen compose (compose-https-fragment), dan repositori Git yang dijangkau melalui HTTP atau HTTPS (git-repository) melakukan autentikasi dengan file netrc, file kredensial per pengguna yang juga dibaca curl dan Git. Inilah satu-satunya penyimpanan kredensial yang dibaca ketiga jenis ini: ~/.config/helm/repositories.yaml dan credential helper Git tidak dibaca. Repositori Git yang dijangkau melalui SSH melakukan autentikasi melalui SSH agent dan tidak membaca file netrc.
machine charts.example.com login deploy-bot password <token>File mana yang dibaca. File yang disebut variabel lingkungan NETRC, bila diatur. Jika tidak, .netrc di direktori home Anda; di Windows, _netrc di %USERPROFILE% bila file itu ada, dan .netrc di sana bila tidak ada. File yang tidak ada tidak memuat kredensial dan bukan galat. File yang ada tetapi tidak dapat dibaca, atau tidak mengikuti format netrc, menghentikan perintah dengan E0360, menyebut file tersebut — dan, untuk kesalahan format, barisnya — tetapi tidak pernah isinya: The netrc file cannot be read (File netrc tidak dapat dibaca). Di Linux dan macOS, file netrc yang dapat dibaca pengguna lain di mesin itu memicu satu peringatan yang menyebutnya; buat agar hanya dapat dibaca oleh Anda (chmod 600).
Entri mana yang menjawab permintaan. Setiap permintaan dicari berdasarkan host-nya — nama host tanpa port, tanpa membedakan huruf besar dan kecil — dan dijawab oleh entri machine pertama yang menyebut host tersebut, atau oleh entri default bila tidak ada. login dan password entri dikirim sebagai kredensial HTTP basic, baik melalui http maupun https; entri yang tidak memiliki salah satunya tidak mengirim apa pun. Repositori yang index-nya menempatkan chart di host lain dijawab per permintaan: permintaan index memakai entri host repositori, dan permintaan chart memakai entri host chart. Permintaan yang dikirim tanpa kredensial harus dapat dibaca secara anonim, dan server yang menjawab 401 atau 403 menghentikan pull sebagai pengambilan tanpa otorisasi, yang langkah perbaikannya menyebut entri yang harus ditambahkan dan file tempat entri itu dicari.
Kredensial tidak ditulis di mana pun. Kredensial dibaca saat pengambilan berjalan dan dikirim bersama permintaan: lockfile, entity.lock di samping Recipe, cache sumber, dan setiap pesan membawa URL sumber sebagaimana Anda menuliskannya.
URL sumber tidak membawa kredensial. Recipe atau FeatureRecipe yang url sumbernya menuliskan pengguna sebelum host-nya — https://user:token@charts.example.com/…, atau token yang ditulis sendiri seperti https://token@charts.example.com/… — ditolak dengan E0361 saat dokumen dibaca, sebelum apa pun diambil: validasi Recipe menolaknya, demikian pula setiap pull, pin, dan build yang menjangkaunya. Pesannya menyebut host dan tidak pernah kredensialnya: A source URL carries a credential (URL sumber membawa kredensial). Letakkan kredensial dalam entri machine file netrc sebagai gantinya. Melalui SSH, pengguna yang ditulis sendiri — ssh://git@github.com/… — menyebut akun, bukan rahasia, dan diterima, sedangkan kata sandi yang ditulis di sana juga ditolak.
Pemeriksaan hanya membaca bagian URL sebelum host. Token yang dibawa dalam query string atau path — …/index.yaml?access_token=… — tidak terdeteksi, jadi jangan menulisnya di sana: URL dicatat sebagaimana ditulis dalam lockfile, dalam entity.lock, dan dalam cache sumber, termasuk nama direktori cache.
Variabel lingkungan
Pengaturan workspace yang dibaca pull dapat ditimpa melalui lingkungan, di atas konfigurasi yang di-commit dan di bawah flag apa pun: AGGREGA_OFFLINE (lihat Offline, dan --offline untuk flag di atasnya), AGGREGA_CATALOG_DIRS (dipisahkan seperti daftar path sistem operasi; berikan path absolut), AGGREGA_ARTIFACT_CACHE_DIR, AGGREGA_DEFAULT_REGISTRY, dan AGGREGA_SKIP_SIGNATURE_VERIFICATION (berisik — di mana pun pull seharusnya memeriksa tanda tangan, pull mencatat peringatan bahwa verifikasi dinonaktifkan secara global). Lihat environment-variables.md untuk daftar lengkap dan model prioritasnya.
Lihat juga
- ./aggrega-build.md — memverifikasi lockfile dan melakukan pull otomatis bila dikonfigurasi.
- ./aggrega-serve.md — daemon menyediakan resolusi yang sama ini di
aggrega/resolveDependencies, dan di dalamaggrega/builduntuk permintaan yang fieldautoPull-nya memintanya, sehingga editor dapat menjalankannya tanpa meninggalkan sesi; dalam kedua cara, resolusi hanya berjalan ketika sebuah permintaan menyebutkannya, dan menulis lockfile yang sama dengan perintah ini. - ./aggrega-push.md — memublikasikan entitas katalog ke registry.
- ./aggrega-lint.md — gerbang publikasi yang mendahului
aggrega push. - ../../architecture/13-catalog-and-registry.md — model katalog, lockfile, dan cache secara lengkap.
Sinopsis
aggrega pull [<uri>...] [flags]Deskripsi
Resolve the Release's catalog and source dependencies into the cache and write the per-Release lockfile.
By default, pull reconciles the lockfile against the current dependency resolution while honoringthe pins it already records. That pin discipline governs what a registry or the content cacheserves: such an entity is fetched at its pinned version and verified against its pinned digest,and if the registry no longer serves the pinned bytes, pull halts rather than silently re-pinning.An entity a local catalog directory supplies is resolved from that directory instead, at theversion its file declares, and its recorded pin is not consulted — so editing a pin by hand doesnot hold a locally-supplied entity at that version, and the reconcile rewrites the entry to matchthe file. A reference with no pin — newly added, or removed from the lockfile by hand — isresolved fresh and added. Entities no longer among the resolved dependencies are pruned.Re-running pull on an unchanged dependency set is a no-op.
Use --upgrade with no positional arguments to discard the existing lockfile and re-resolveevery entity from current registry state, floating each dependency to the highest availableversion. That form drops every recorded pin, so it asks for confirmation first; --yes answers inadvance, and on a non-interactive stdin it refuses rather than waiting for an answer nobody cangive. Pass one or more entity URIs after --upgrade to upgrade only those: each named pinis dropped and re-resolved fresh while every other pin — and the recorded external inputs —is held unchanged. A named target may also be a plugin that returns an accept-or-reject verdict;such a plugin carries no lockfile pin, and its identity is recorded beside the lockfile instead.Naming one the workspace still attaches adopts the identity it resolves to. Naming one theworkspace no longer attaches drops its recorded identity — the one way to clear an entry thatoutlived the attachment it was recorded for. A bare --upgrade does both for every plugin at once.A URI given without --upgrade is a usage error.
Each Recipe and FeatureRecipe this Release builds from one of your catalog directories carriesthe pins for its own inputs in the entity.lock beside it: a remote source: written out in full,a file an artifacts entry imports, and each file of a local source:. Recording them is theentity author's step, aggrega pin.By default pull records none of them, and halts on an entity whose lock is missing any, namingthe entity, each input and its class, and the command that records them. A local source's filesare held to their pins as one set: a file added, changed or removed since the pin halts the pullthe same way.Pass --pin-sources, or set pin_sources_at_pull in the workspace configuration, to have pull runthat same step instead; --pin-sources=false restores the halt for one run.
Which files of a local source directory belong to its entity was decided when the entity waspinned, by the ignore rules of the plugin that served its capability for the author, and itsentity.lock records that decision. Where the plugin this workspace binds for that capabilitydeclares different rules, pull prints a warning naming both plugins and the difference, andcarries on: the entity's files are the ones its recorded rules kept.Flag
| Flag | Default | Deskripsi |
|---|---|---|
--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. |
--detail | false | Mencetak, untuk setiap entitas yang di-resolve, apa yang dilakukan pull ini — diambil baru dari registry, menggunakan ulang slot cache, ditemukan di katalog lokal, disajikan dari dalam biner kompiler, atau eksternal (Aggregate atau Manifest milik Release sendiri, dibaca dari file atau entri yang disebutkan Release). Hanya stdout; tidak ditulis ke lockfile |
--dry-run | false | Me-resolve dependensi dan mencetak apa yang akan ditulis pull ini alih-alih menulisnya: path setiap file dan konten yang akan dimuatnya dikirim ke stdout, dan lockfile, entity.lock di samping setiap Recipe dan FeatureRecipe yang pin tercatatnya akan berpindah dengan —pin-sources, serta catatan kepercayaan plugin semuanya dibiarkan tidak tersentuh. Hanya file yang benar-benar akan berubah yang disebutkan. Resolusi itu sendiri berjalan persis seperti biasanya, sehingga cache konten tetap terisi, pull yang akan berhenti pada entitas yang belum di-pin juga berhenti di sini, dan —upgrade tanpa argumen tidak menanyakan apa pun karena tidak membuang pin apa pun — apa yang ditunjukkan dry run adalah apa yang akan ditulis pull. Tidak diterima bersama —verify, yang memang tidak menulis satu pun dari file tersebut |
--include-prerelease | false | Belum diimplementasikan: diterima dan diabaikan, sehingga skrip yang memberikannya tetap berfungsi ketika flag ini mulai berpengaruh |
--pin-sources | false | Menjalankan langkah pin milik penulis entitas atas Recipes dan FeatureRecipes yang di-build oleh Release ini, dengan mencatat di entity.lock di samping masing-masing pin untuk setiap input yang dibacanya — source: jarak jauh yang ditulis lengkap, file yang diimpor oleh entri artifacts, dan setiap file sumber lokal — alih-alih berhenti pada entitas yang lock-nya tidak mencatatnya. Langkah yang sama dengan aggrega pin, yang menulis byte yang sama. Langkah ini menulis di samping entitas, sehingga hanya berjalan ketika entitas memiliki lokasi yang dapat ditulisi: dokumen di salah satu direktori katalog Anda. Entitas yang di-resolve dari cache tidak memilikinya dan tidak pernah di-pin. Menimpa pin_sources_at_pull milik workspace ke dua arah: —pin-sources mem-pin untuk eksekusi ini dan —pin-sources=false berhenti untuk eksekusi ini, apa pun isi pengaturannya |
--progress | false | Memaksa tampilan progres pull aktif bahkan ketika stderr bukan terminal, dengan mencetak satu baris sederhana per langkah saat langkah tersebut 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 | false | Membungkam tampilan progres pull di stderr. Tidak memengaruhi stdout. Lebih diutamakan daripada —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 |
--upgrade | false | Me-resolve ulang dependensi dari status registry saat ini, menaikkan masing-masing ke versi tertinggi yang tersedia. Tanpa argumen (tanpa URI posisional), membuang lockfile dan me-resolve ulang setiap entitas, serta meminta konfirmasi terlebih dahulu karena membuang setiap pin yang tercatat; dengan satu atau beberapa URI entitas, hanya me-resolve ulang entitas tersebut, mempertahankan semua pin lain dan input eksternal yang tercatat tanpa perubahan, dan tidak menanyakan apa pun (saling eksklusif dengan —verify) |
--verify | false | Memverifikasi lockfile yang ada terhadap resolusi dependensi yang akan dilakukan pull saat ini, tanpa menulis lockfile, catatan kepercayaan plugin, atau entity.lock apa pun; keluar dengan kode bukan nol jika terjadi drift atau lockfile tidak ada. Resolusi mematuhi pin yang dicatat lockfile persis seperti pull: referensi yang registry-nya telah memublikasikan versi lebih baru sejak pull bukan drift, karena pull akan mempertahankan pin-nya, dan registry yang kini menyajikan byte berbeda di bawah versi yang di-pin menghentikan verifikasi seperti halnya menghentikan pull. Cache konten dibaca dan diisi seperti pull membaca dan mengisinya: entri yang disimpan cache di bawah pin-nya dibaca dari sana tanpa menanyakan registry, entri yang tidak disimpannya diambil, dan entri yang tidak lagi cocok dengan pin-nya diperlakukan persis seperti pull memperlakukannya. Juga mengikat entity.lock di samping setiap Recipe dan FeatureRecipe di direktori katalog Anda yang dijangkau Release pada apa yang dibandingkan build dengannya, dan keluar dengan kode bukan nol pada pin yang akan ditolak build: file impor yang tidak lagi cocok dengan digest tercatatnya, sumber lokal yang file-nya tidak lagi cocok dengan digest tercatatnya, atau pin sumber yang tidak sesuai dengan lockfile. Juga membandingkan tanda tangan yang dicatat lockfile untuk setiap artefak, dan catatan kepercayaan plugin untuk setiap plugin, dengan yang akan dicatat pull saat ini, dan keluar dengan kode bukan nol ketika pull akan mencatat, mengganti, atau menghapus salah satunya: tanda tangan yang diminta suatu persyaratan tetapi tidak dicatat, dan tanda tangan yang dibuat untuk artefak lain, dilaporkan tanpa menanyakan registry, karena pull menulis ulang keduanya apa pun jawabannya; tanda tangan yang dicari ulang oleh pull dan mungkin dicatat tanpa perubahan — artefaknya diambil, atau bundel tanda tangan di cache-nya dihapus atau diubah — ditanyakan ke registry-nya, atau dalam mode offline dibiarkan tidak diperiksa dengan baris yang menyatakannya; dan setiap plugin yang dicakup catatan kepercayaan plugin diverifikasi di registry-nya, sebagaimana setiap pull memverifikasinya, kecuali dalam mode offline, ketika plugin dibaca dari cache konten seperti build membacanya, identitas dan fungsi host-nya tetap diperiksa, dan tanda tangannya dibiarkan tidak diperiksa dengan baris yang menyatakannya, kecuali build menolaknya karena tidak mencatat tanda tangan apa pun atau mencatat tanda tangan yang dibuat untuk artefak lain, yang dilaporkan. Penanda deprecation tidak dibandingkan. Juga melaporkan versi kompiler dan plugin inti yang dicatat lockfile — dilaporkan untuk audit dan tidak pernah dibandingkan dengan biner ini, sehingga perbedaan toolchain tidak pernah dianggap drift. Tidak diterima bersama —pin-sources, berapa pun nilai yang diberikan: verifikasi tidak mencatat pin yang hilang dari entity.lock dan tidak berhenti karenanya, sehingga flag itu tidak akan mengubah apa pun (saling eksklusif dengan —upgrade) |
--yes | false | Menjawab konfirmasi —upgrade tanpa argumen sebelumnya, untuk penggunaan non-interaktif. Flag ini hanya menjangkau prompt itu dan tidak yang lain: setiap bentuk pull lainnya tidak menanyakan apa pun, sehingga memberikannya tidak mengubah perilaku apa pun di sana |