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

aggrega pin

aggrega pin <entity-path> mencatat, dalam entity.lock di samping sebuah Recipe atau FeatureRecipe, pin konten untuk setiap input yang dibaca entitas dari luar dokumennya sendiri. Ini adalah langkah penulis entitas: jalankan sebelum entitas dikonsumsi atau dipublikasikan, dan commit lock yang ditulisnya.

aggrega pin catalog/recipe/helm/server/1.0.0/recipe.yaml

Apa yang dicatatnya

Sebuah entitas dapat bergantung pada byte di luar dokumennya sendiri, dan lock menyimpan satu pin untuk masing-masing:

  • source: jarak jauh yang koordinatnya Anda tulis lengkap — tanpa template di kind, url, chart, module_subdir, version, atau ref. Langkah ini mengambilnya dan mencatat versi hasil resolve-nya — untuk sumber git, commit yang disebutkan oleh ref-nya — serta digest konten dari apa yang diambil.
  • File yang diimpor oleh entri artifacts dengan $import. Langkah ini menghitung digest file sebagaimana adanya di workspace Anda.
  • Setiap file dari source: yang menyebutkan direktori atau file di samping entitas. Tidak ada yang diambil: langkah ini menghitung digest setiap file yang dikontribusikan sumber ke apa yang dibawa publikasi entitas — setiap file di bawah direktori yang disebutkannya yang dipertahankan oleh aturan pengabaian entitas, atau file tunggal tersebut — dan mencatatnya berdasarkan jalurnya di samping entitas. File di samping Recipe yang tidak dikontribusikan sumber, seperti README, tidak di-pin. Sumber yang ditulis sebagai template, seperti ./charts/{{ .values.flavour }}, baru menyebutkan direktorinya setelah sebuah Release mengisinya, sehingga sumber tersebut mengontribusikan setiap file di direktori entitas yang dipertahankan aturan, dan masing-masing di-pin. Sebuah build membandingkan sumber dengan pin-pin ini sebelum provider-nya membacanya, sehingga file yang ditambahkan, diubah, atau dihapus sejak pin akan menghentikan build — 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).
  • Aturan pengabaian itu sendiri, untuk source: yang berupa direktori. Langkah ini mencatat plugin mana yang melayani capability entitas dan aturan persis yang disusunnya, sebagaimana dijelaskan di bagian berikutnya.

Apa yang tidak dicatatnya: sumber jarak jauh yang koordinatnya diisi dari template, yang baru menyebutkan artefak setelah sebuah Release mengisinya dan di-pin dalam lockfile setiap Release oleh aggrega pull; serta entri artifacts inline atau entri yang diambil dari sebuah ArtifactLibrary. File itu sendiri dijelaskan per bidang dalam skema lock entitas.

Tidak diperlukan Release. Sumber yang ditulis lengkap menyebutkan artefak yang sama untuk setiap Release yang kelak menggunakan entitas, sehingga me-resolve-nya tidak memerlukan apa pun yang disediakan Release. Itulah yang memungkinkan penulis melakukan pin pada entitas di workspace yang sama sekali tidak memiliki Release.

File entitas tidak pernah ditulis. Apa yang diturunkan langkah ini diletakkan di samping entitas; apa yang Anda ketik dibiarkan persis seperti yang Anda ketik. Menjalankan ulang atas input yang tidak berubah membiarkan lock identik byte demi byte, dan entitas yang berhenti membaca apa pun yang dicatat lock akan dihapus lock-nya. Component, Feature, atau jenis lain apa pun yang tidak membaca input seperti itu dilaporkan tidak memiliki apa pun untuk di-pin, dan tidak ada apa pun di sampingnya yang disentuh.

File mana yang dikirim bersama entitas

Recipe atau FeatureRecipe yang source:-nya menyebutkan direktori di sampingnya — chart yang ditempatkan bersama, sebuah modul — membawa file-file direktori tersebut saat dipublikasikan. Tidak setiap file di dalamnya termasuk di sana: direktori kontrol versi, cache dependensi, sisa-sisa editor. File mana yang termasuk ditentukan oleh aturan pengabaian, dalam sintaks yang digunakan .gitignore, dan Anda yang mengendalikannya. Aturan tersebut berasal dari dua tempat:

  • Plugin yang merender capability entitas mendeklarasikan apa yang tidak pernah dikirim oleh ekosistemnya sendiri. Plugin chart mengecualikan direktori kontrol versi (.git/, .hg/, .svn/, .bzr/) dan file tersembunyi di bawah templates/ sebuah chart, serta mematuhi .helmignore milik chart itu sendiri: di mana pun penelusuran sumber menemukan file tersebut, baris-barisnya dibaca sebagai aturan tambahan untuk direktori yang memuatnya. Plugin Terraform mengecualikan direktori kontrol versi dan direktori kerja .terraform/ — bukan file lock dependensi, yang memang dimaksudkan untuk ikut bersama modul — dan mematuhi .terraformignore dengan cara yang sama. Plugin yang tidak mendeklarasikan apa pun membiarkan semuanya masuk.
  • .aggregaignore milik Anda sendiri, satu file di samping dokumen entitas, dalam sintaks yang sama. Baris-barisnya berlaku setelah aturan plugin dan setelah setiap file pengabaian yang disebutkan plugin, sehingga Anda memiliki keputusan akhir atas jalur apa pun yang Anda sebutkan: baris seperti .venv/ mengecualikan direktori yang tidak diketahui plugin, dan baris seperti !.git/ mengembalikan direktori yang dikecualikan plugin. File itu sendiri tidak pernah ikut; aturannya yang ikut, di dalam lock.
catalog/recipe/helm/server/1.0.0/.aggregaignore
.venv/
*.bak
!notes.bak

Setiap aturan dibaca relatif terhadap direktori tempat aturan itu berada. Aturan yang dideklarasikan plugin dibaca dari root direktori sumber; baris dari .helmignore dari direktori yang memuat file tersebut; baris dari .aggregaignore Anda dari direktori entitas itu sendiri. Aturan tanpa garis miring, atau hanya dengan garis miring di akhir, cocok dengan nama pada kedalaman apa pun; garis miring di akhir hanya cocok dengan direktori; ! di awal mengembalikan apa yang dikecualikan aturan sebelumnya. Direktori yang dikecualikan aturan tidak dimasuki, sehingga file di dalamnya baru kembali setelah direktori itu sendiri kembali — !.git/HEAD saja tidak mengembalikan file tersebut selama .git/ dikecualikan, sedangkan !.git/ mengembalikannya.

Plugin yang aturannya dibaca adalah plugin yang melayani capability di workspace Anda saat Anda melakukan pin: binding provider workspace Anda untuk capability tersebut, atau jika tidak ada, plugin bawaan aggrega. Langkah ini mencatat plugin tersebut berdasarkan namanya, seperti provider/terraform, tanpa versi, serta aturan persis yang disusunnya dalam entity.lock; melakukan pin lagi dengan aggrega yang lebih baru yang plugin-nya mendeklarasikan aturan yang sama membuat lock tidak berubah. Sejak saat itu, setiap pembacaan direktori menerapkan aturan yang tercatat dan bukan aturan lain: publikasi entitas, perbandingan yang digunakan pull atau push untuk menguji lock, baris entitas dalam lockfile, perbandingan sebuah build, render yang menyerahkan direktori ke provider, dan aggrega pull --verify. Dengan demikian, apa yang Anda publikasikan persis sama dengan apa yang dirender build Anda sendiri, dan binding yang berubah, .aggregaignore yang diedit, atau aggrega yang lebih baru tidak mengubah apa pun sampai Anda melakukan pin lagi — saat itulah diff lock menunjukkan apa yang berubah. File yang disebutkan plugin sebagai file pengabaian, seperti .helmignore, juga merupakan salah satu file sumber dan di-pin seperti file lain kecuali ada aturan yang mengecualikannya, sehingga mengeditnya tanpa melakukan pin lagi akan terdeteksi oleh pull atau build berikutnya. Lock yang tidak mencatat aturan apa pun mempertahankan setiap file di bawah direktori.

Konsumen merender file-file yang dipertahankan oleh aturan Anda. Sebuah plugin dapat merender Recipe yang dipublikasikan untuk capability-nya ketika plugin tersebut menggunakan versi ABI yang sama, kontraknya cocok dengan klaim entitasnya, dan tidak memerlukan file di luar himpunan yang dipublikasikan. Plugin yang memerlukan file yang dikecualikan dari himpunan harus menggagalkan build-nya secara eksplisit dan menyebutkan file tersebut; bagian host adalah menolak setiap pengemasan atau pembacaan file yang tidak dibawa himpunan, dengan menyebutkannya. Ketika plugin yang di-bind workspace konsumen untuk capability tersebut mendeklarasikan aturan yang berbeda dari yang dicatat lock Anda, aggrega pull milik konsumen menyatakannya dalam peringatan yang menyebutkan kedua plugin dan perbedaannya, lalu melanjutkan.

Tautan simbolik di antara file-file entitas akan ditolak, ke mana pun tautan itu menunjuk dan apakah ter-resolve atau tidak — lihat A symbolic link sits among the files an entity carries (Ada tautan simbolik di antara file yang dibawa entitas). Tautan yang dikecualikan aturan Anda dilewati seperti file lain yang dikecualikannya. Jalur yang disebutkan entitas yang melewati direktori berupa tautan yang mengarah keluar dari direktori entitas juga ditolak, sebelum apa pun di-pin — lihat A path names content outside the entity’s own directory (Sebuah jalur menyebutkan konten di luar direktori entitas itu sendiri).

Di mana lock diletakkan

Lock ditulis di samping dokumen yang Anda sebutkan, di direktori yang sama, sehingga entitas memerlukan tempat yang dapat ditulisi: dokumen di direktori milik Anda. Entitas yang di-resolve oleh pull dari cache konten tidak memiliki tempat seperti itu dan tidak pernah di-pin oleh apa pun.

Satu direktori, satu entitas. Satu direktori menyimpan satu entity.lock, sehingga langkah ini menolak Recipe atau FeatureRecipe yang berbagi direktori dengan entitas lain mana pun, baik salah satunya memiliki sesuatu untuk di-pin maupun tidak, dengan menyebutkan setiap entitas yang menghalangi — penolakannya adalah An entity shares its directory with another entity (Sebuah entitas berbagi direktorinya dengan entitas lain). Setiap jenis memiliki direktorinya sendiri kecuali Aggregate, Release, dan Manifest, yang boleh berdampingan; push memberlakukan aturan yang sama pada entitas yang dipublikasikannya, sebagaimana dijelaskan dalam Satu entitas per direktori. Langkah ini hanya menilai hal yang lock-nya ia tulis, sehingga Component atau jenis lain apa pun yang tidak memiliki apa pun untuk di-pin dilaporkan tidak memiliki apa pun untuk di-pin, dan penolakan menjangkau entitas tersebut saat dipublikasikan. File di samping entitas yang bukan dokumen entitas — file chart, file yang diimpor itu sendiri — tidak menghalangi. Setiap dokumen di samping entitas hanya dibaca dari dalam workspace, atau, untuk dokumen yang Anda sebutkan di luarnya, dari dalam direktorinya sendiri — tempat lock juga disimpan — sehingga dokumen yang berupa tautan yang mengarah keluar akan menghentikan langkah ini dengan menyebutkan tautan tersebut, tanpa dibaca, sebagaimana dijelaskan dalam batas workspace.

Siapa yang melakukan pin, dan kapan

Melakukan pin adalah kewajiban penulisan. Entitas yang inputnya belum di-pin belum siap dikonsumsi, sehingga secara default pull tidak mencatat pin apa pun: atas Recipe atau FeatureRecipe di salah satu direktori katalog Anda yang di-build oleh Release, pull membandingkan apa yang akan dicatat langkah ini dengan isi lock, dan berhenti ketika sebuah pin hilang atau tidak lagi cocok dengan inputnya. Penghentian tersebut menyebutkan entitas, setiap input dan apakah input itu sumber jarak jauh, file yang diimpor, atau file dari sumber lokal, serta perintah ini. Itulah An entity reads an input the lock beside it records no pin for (Sebuah entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya). Push memberlakukan perbandingan yang sama pada entitas yang dipublikasikannya dan menolak dengan penghentian yang sama, sehingga sebuah entitas tidak dapat mencapai registry melalui aggrega push dengan pin yang tidak tercatat — Melakukan pin sebelum memublikasikan menjelaskannya. Sumber lokal diperlakukan sebagai satu himpunan file: lock yang tidak mencatat satu pun dari file tersebut menghentikan pull atau push, begitu pula file yang ditambahkan, diubah, atau dihapus sejak pin, seperti pin lain yang hilang atau usang.

Penghentian pada pull pertama adalah tanggung jawab penerbit untuk diperbaiki, bukan konsumen. Ketika Anda mengonsumsi katalog yang ditulis orang lain — misalnya checkout katalog tersebut di direktori milik Anda — dan sebuah entitas di sana belum di-pin, penulisnya tidak pernah menjalankan langkah ini. Solusinya bukan mengedit direktori mereka secara manual: atur kunci workspace di bawah ini, sehingga pull Anda mencatat pin-pin itu sendiri.

Dua perintah menjalankan langkah yang sama ini atas nama Anda, dan menulis byte yang sama:

  • aggrega pull --pin-sources menjalankannya atas entitas yang di-build oleh Release, alih-alih berhenti.
  • aggrega push --pin-sources menjalankannya pada entitas sebelum membundelnya, sehingga lock yang ditulisnya menjadi bagian dari apa yang dipublikasikan, alih-alih menolak.

Masing-masing memiliki kunci workspace yang menjadikan pin sebagai perilaku default-nya, pin_sources_at_pull dan pin_sources_at_push, keduanya nonaktif secara default dan masing-masing hanya mengatur perintahnya sendiri. Flag menimpa kuncinya ke dua arah: --pin-sources melakukan pin untuk satu kali jalan apa pun nilai kuncinya, dan --pin-sources=false tidak. Jadi workspace yang dikonfigurasi untuk melakukan pin tetap dapat mengembalikan penghentian untuk satu pull. Build yang mengisi lockfile-nya sendiri adalah pull, sehingga mengikuti pin_sources_at_pull. Kunci-kunci tersebut dijelaskan dalam referensi konfigurasi.

Mengubah entitas yang telah dipublikasikan

Praktik terbaik: suntingan pada entitas yang sudah Anda publikasikan dimasukkan ke versi baru, lalu di-pin — jangan pernah melakukan pin ulang pada versi yang sudah dirilis. Salin entitas ke direktori versi baru, lakukan perubahan di sana, dan jalankan aggrega pin pada versi baru. Versi yang telah dipublikasikan tetap menggambarkan persis byte yang digunakan saat dipublikasikan, dan konsumen yang beralih ke versi baru melakukannya dengan sengaja.

Produk menegakkan separuh dari hal ini: memublikasikan konten yang diubah pada versi yang sudah dipublikasikan akan ditolak, sehingga versi yang telah dipublikasikan tidak dapat diganti secara diam-diam. Produk tidak menegakkan separuh lainnya di workspace Anda sendiri. Melakukan pin ulang pada versi yang ada setelah suntingan terkadang memang tepat — misalnya entitas yang Anda konsumsi di dalam satu aplikasi dan belum Anda publikasikan — sehingga tidak ada yang menghalangi Anda, dan menjaga disiplin ini adalah tanggung jawab Anda.

Langkah yang sama di permukaan lain

Daemon menyediakan langkah ini sebagai aggrega/pin (aggrega serve), dan protokol alat sebagai alat pin (aggrega mcp); keduanya menulis byte yang sama dengan yang ditulis perintah ini. Melalui listener HTTP, alat ini menulis di dalam workspace dan menjangkau host yang disebutkan oleh sumber-sumber entitas, sehingga pemanggil memerlukan scope tulis workspace untuk memanggilnya — izin yang sama yang diperlukan pull.

Lihat juga

  • aggrega-pull.md — lock entitas, apa yang dibandingkan build dengannya, dan penghentiannya.
  • aggrega-push.md — memublikasikan entitas, dan memublikasikan sebuah versi satu kali.
  • configuration.md — pin_sources_at_pull dan pin_sources_at_push.

Sinopsis

aggrega pin <entity-path> [flags]

Deskripsi

Record, in the entity.lock beside a Recipe or FeatureRecipe, the content pin for every input
the entity reads from outside its own document: a remote source: whose coordinates you wrote out
in full, a file an artifacts entry imports with $import, and each file of a local source:.
Pinning is the entity author's step. Run it on an entity before it is consumed — before you
publish it, and after every change to one of its inputs — and commit the entity.lock it writes
beside the entity. A pull over an entity whose lock does not record these pins halts and names
this command, and so does a push of it; so does one whose local source has had a file added,
changed or removed since it was pinned.
No Release is needed. A source whose coordinates carry no template names one artifact for every
Release that uses the entity, so it is resolved and pinned here, with nothing supplied. A remote
source whose coordinates are filled in from a template is not pinned here: which artifact it names is
decided by each Release, and each identity it resolves to is pinned in that Release's lockfile.
A source that names a directory beside the entity is not fetched: each file it contributes to what
a publication of the entity carries is digested as it stands and pinned by its path, so a build
refuses a file added, changed or removed after the pin. A local source written as a template
contributes every file in the entity's directory, so each of those is pinned.
Which files a source directory contributes is decided here, once, and recorded. The step reads the
ignore rules the plugin serving the entity's capability declares — this workspace's provider binding
for that capability, or else the plugin built into aggrega — together with the ignore files that
plugin names inside the source, such as a chart's .helmignore, and the .aggregaignore beside the
entity, in gitignore syntax, whose lines come last and so have the final say. It records the plugin
and the composed rules in the entity.lock, and every publication, pull, build and render of the
entity applies the recorded rules and no others, so a changed binding or a newer binary moves
nothing until you pin again. A symbolic link among the files is refused rather than followed.
The step writes beside the entity, so the entity needs a writable home: the document you name is
read from its own directory and the lock lands next to it. The entity file itself is never
written to. Re-running over unchanged inputs leaves the lock byte-identical; an entity that reads
nothing a lock records has its lock removed. A Component, a Feature or any other kind that reads
no such input is reported as having nothing to pin, and nothing beside it is touched.
A directory holds one entity.lock, so the step refuses a Recipe or FeatureRecipe that shares its
directory with any other entity, naming the entity in the way, whether or not either has anything
to pin. Every kind has a directory of its own except Aggregate, Release and Manifest, which may sit
side by side; a push holds the entity it publishes to the same rule.
aggrega pull --pin-sources and aggrega push --pin-sources run this same step on your behalf, and
write the same bytes.

Flag

FlagDefaultDeskripsi
--dry-runfalseMe-resolve input entitas dan mencetak entity.lock yang akan ditulis langkah ini alih-alih menulisnya: jalurnya dan konten yang akan dimuatnya dikirim ke stdout, dan tidak ada apa pun di disk yang berubah. Lock yang akan dibiarkan identik byte demi byte oleh langkah ini tidak dicetak. Resolusi berjalan persis seperti biasanya, sehingga cache konten tetap terisi