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

aggrega push

aggrega push memublikasikan entitas katalog ke registry OCI, tempat workspace lain dapat me-resolve-nya dengan aggrega pull.

Apa yang dilakukannya

aggrega push membaca satu YAML entitas, membundelnya untuk transportasi, dan mendorongnya ke <registry>/<kind>/<metadata.name>:<metadata.version>, dengan path repositori diubah ke huruf kecil; Recipe atau FeatureRecipe membawa spec.capability-nya, dan Plugin membawa metadata.pluginType-nya, sebagai segmen di antara jenis dan nama. Jalankan aggrega push --list-kinds untuk melihat jenis entitas yang dipublikasikan biner yang terpasang — satu jenis per baris, terurut, dan tidak ada yang lain, sehingga skrip dapat membacanya secara langsung. Himpunan ini mencakup jenis-jenis untuk penulisan katalog beserta Aggregate, sebuah modul yang dapat digunakan ulang, dan Plugin, sebuah referensi beralamat konten ke artefak WebAssembly yang dirutekan oleh kompiler dan dieksekusi oleh runtime. Plugin adalah artefak struktural yang dapat dipublikasikan, bukan jenis untuk penulisan katalog. Dapat dipublikasikan atau tidak adalah sifat entitas, bukan cara penggunaannya: Aggregate dapat dipublikasikan baik nantinya direferensikan sebagai spec.aggregate tingkat atas sebuah Release maupun disarangkan di blok aggregates: milik Aggregate lain. Release dan Manifest adalah input sisi deployment, bukan artefak katalog, dan ditolak.

Pembundelan

Push memublikasikan dokumen entitas dan file yang disebutkan entitas itu sendiri di sampingnya — dan tidak ada yang lain di direktorinya. File yang disebutkan entitas adalah:

  • untuk Recipe atau FeatureRecipe, source: lokalnya — sebuah direktori ikut terbawa bersama setiap file di bawahnya yang dipertahankan oleh aturan pengabaian yang dicatat di entity.lock-nya, seperti yang dijelaskan File mana yang dikirim bersama entitas; setiap file yang diimpor oleh entri valuesMapping:, workload:, dan artifacts:-nya dengan $import:; dan entity.lock di sampingnya;
  • untuk Component atau Feature, setiap file skema yang diimpor oleh spec.schema-nya, sebuah pilar, atau socket usesSchema dengan $import:, termasuk setiap file yang diimpor lagi oleh file yang diimpor.

Aggregate, Plugin, dan jenis-jenis pustaka tidak menyebutkan file apa pun di samping dokumennya. Catatan, README, file entitas lain, atau output build yang ada di direktori tidak dipublikasikan, apa pun namanya. Tautan simbolik di antara file yang disebutkan entitas ditolak alih-alih diikuti — A symbolic link sits among the files an entity carries (Ada tautan simbolik di antara file yang dibawa entitas) — begitu pula path yang disebutkan entitas melalui direktori yang merupakan tautan yang mengarah ke luar direktori entitas, sebelum apa pun dikemas — A path names content outside the entity’s own directory (Sebuah path menyebutkan konten di luar direktori milik entitas).

Bentuknya mengikuti dari hal itu. Entitas yang tidak menyebutkan apa pun dipublikasikan sebagai dokumennya, tanpa perubahan, di bawah media type +yaml jenisnya. Entitas yang menyebutkan file dipublikasikan sebagai .tar.gz yang berisi dokumen dan file-file tersebut di posisinya masing-masing dalam direktori, di bawah media type +tar+gz jenisnya. Jadi Recipe yang seluruh kontennya inline dipublikasikan sebagai dokumennya, dan Component yang skemanya diimpor dari file dipublikasikan sebagai arsip. Katalog dan Registry §6 mencantumkan kedua media type untuk setiap jenis.

Setiap file dalam arsip membawa mode 0644 dan tanpa timestamp, apa pun bit izinnya di disk. Checkout menulis file dengan bit izinnya sendiri, dan sistem yang tidak mencatat bit eksekusi melakukan checkout sebagai file biasa terhadap apa yang di-checkout sistem lain sebagai file yang dapat dieksekusi, sehingga arsip tidak membawa mode yang dibaca dari disk: dua checkout dari satu commit memublikasikan file yang sama apa pun umask-nya dan di sistem mana pun checkout itu dibuat, dan membalik bit eksekusi sebuah skrip tidak mengubah apa pun yang dipublikasikan.

Push memberikan peringatan untuk setiap entri arsip yang tidak dapat disimpan Windows sebagaimana tertulis — path dengan bagian yang dinamai seperti perangkat, misalnya CON, AUX, atau NUL, dalam huruf besar atau kecil apa pun dan dengan ekstensi apa pun yang mengikutinya, seperti aux/x.yaml, atau bagian yang diakhiri titik atau spasi, seperti report.. Di Windows, aggrega menolak mengekstrak entri seperti itu, sehingga workspace Windows tidak dapat menggunakan versi tersebut. Peringatan ditulis ke standard error di setiap platform, satu baris per entri, sebelum laporan publikasi itu sendiri; nama file dokumen entitas itu sendiri dinilai bersama file yang disebutkannya, dan entitas yang tidak menyebutkan apa pun dipublikasikan hanya sebagai dokumennya dan tidak pernah diberi peringatan. Peringatan ini tidak menolak apa pun: push berjalan atau ditolak persis seperti tanpa peringatan itu, dan --dry-run memberi peringatan dengan cara yang sama. A published archive carries an entry Windows cannot use (Arsip yang dipublikasikan berisi entri yang tidak dapat digunakan Windows) menunjukkan barisnya dan apa yang harus dilakukan.

source: lokal yang ditulis sebagai template membawa seluruh direktori. Template seperti ./charts/{{ .values.flavour }} baru menyebutkan sebuah direktori setelah Release mengisinya, sehingga tidak ada publikasi yang dapat mengetahui direktori mana yang akan dipakai. Entitas seperti itu membawa setiap file di direktorinya sendiri yang dipertahankan oleh aturan pengabaian tercatatnya — tidak pernah .aggregaignore-nya, yang aturannya ikut di dalam lock — dan push menyatakannya di bawah fakta-fakta lainnya:

carries: every file in the entity's directory, because its source "./charts/{{ .values.flavour }}" is a template and the directory it names is decided by each Release that uses it

Apa yang tidak disebutkan tidak ikut terbawa, dan konsumenlah yang mengetahuinya. File yang diandalkan entitas tanpa disebutkan melalui salah satu field di atas tidak ada dalam publikasi, dan build milik konsumen gagal dengan menyebutkan path yang hilang di dalam slot cache-nya — bukan push Anda. Sebutkan setiap file yang dibutuhkan entitas melalui salah satu field tersebut.

Setiap file yang dipublikasikan disebutkan dalam manifest artefak, sehingga klien OCI generik seperti oras menulisnya ke file dengan nama tersebut: entity.yaml untuk entitas yang dipublikasikan sebagai dokumennya, entity.tar.gz untuk entitas yang dipublikasikan bersama file-file-nya, dan untuk Plugin entity.yaml untuk entitasnya di samping entity.wasm untuk file yang dapat dieksekusi. Nama itu ditentukan oleh media type, bukan oleh file asal publikasi Anda, sehingga konten yang sama yang dipublikasikan dari file yang diganti namanya menghasilkan artefak yang sama. Katalog dan Registry §6 mencantumkan setiap bentuk yang dipublikasikan dan file tempat masing-masing tiba.

URL source: jarak jauh pada Recipe (referensi chart OCI, URL chart atau fragmen HTTPS, modul Git) dipertahankan apa adanya dalam YAML yang dipublikasikan; URL itu tidak diambil dan dimasukkan ke dalam artefak. Konsumen me-resolve dan mem-pin sumber jarak jauh secara independen saat pull mereka sendiri. Hal ini menjaga distribusi entitas katalog dan resolusi artefak sumber sebagai urusan yang terpisah.

Aggregate dipublikasikan sebagai satu dokumennya sendiri: sub-aggregate yang direferensikannya di aggregates: tidak dibundel ke dalam artefak. Setiap sub-aggregate adalah Aggregate yang dipublikasikan terpisah, yang di-resolve dan di-pin konsumen secara independen saat pull, berdasarkan identitas — prinsip pemisahan distribusi yang sama yang berlaku untuk sumber jarak jauh.

Satu entitas per direktori

Arsip menyimpan file entitas di antara file yang disebutkannya, sehingga entitas harus ditemukan kembali saat diekstrak. Konsumen menemukannya dari preambul yang dibawanya: dokumen di bagian atas bundel yang kind:-nya adalah jenis entitas yang dapat dipublikasikan adalah entitasnya. File tempat entitas itu ditulis boleh bernama apa saja — recipe.yaml adalah konvensi katalog, bukan persyaratan — dan fragmen compose, template chart, atau manifest Kubernetes di samping entitas tidak dikira sebagai entitas, karena semua itu mendeklarasikan hal lain atau tidak mendeklarasikan jenis sama sekali. Dokumen entitas yang lebih dalam, di dalam pohon source/, adalah konten yang dikirim entitas, bukan entitas itu sendiri, dan tidak pernah dipertimbangkan.

Push menolak entitas yang berbagi direktori dengan entitas lain. Setiap jenis memiliki direktorinya sendiri kecuali Aggregate, Release, dan Manifest, yang ditempatkan berdampingan oleh root workspace. Untuk jenis lainnya, push memeriksa sebelum melakukan hal lain apa pun dengan entitas — sebelum langkah pin, kebijakan penandatanganan, dan bundel — bahwa tidak ada dokumen entitas lain di direktori yang sama, dan menolak jika ada, dengan menyebutkan setiap entitas yang menghalangi, baik push diminta untuk mem-pin maupun tidak. aggrega pin menolak direktori yang sama dengan kata-kata yang sama; penghentiannya adalah An entity shares its directory with another entity (Sebuah entitas berbagi direktori dengan entitas lain). Dokumen yang bukan jenis entitas mana pun di samping entitas — file chart, fragmen compose, README — tidak menghalangi, begitu pula apa pun di subdirektori. Setiap dokumen di samping entitas hanya dibaca dari dalam workspace, atau, untuk entitas yang Anda sebutkan di luarnya, dari dalam direktori milik entitas itu sendiri, sehingga dokumen yang merupakan tautan yang mengarah ke luar menghentikan push dengan menyebutkan tautan tersebut, tanpa membacanya, seperti yang diuraikan batas workspace.

Aturan inilah yang menjaga satu entity.lock tetap menjadi milik satu entitas: nama file lock sama untuk setiap entitas, sehingga dua entitas yang ditulis dalam satu direktori akan berbagi satu-satunya lock yang dapat ditampungnya. Aturan ini hanya dinilai ketika sesuatu dihasilkan dari direktori tersebut, sehingga direktori yang berisi beberapa entitas tetap dapat dimuat, di-lint, dan di-build.

Nama direktori tidak dinilai. Entitas yang sendirian di direktorinya dipublikasikan pada metadata.version-nya di mana pun direktori itu berada; <name>/<version>/, tata letak yang diikuti katalog pustaka standar, adalah sebuah konvensi. Artefak yang dipublikasikan klien lain dari direktori yang berisi dua entitas tetap dibaca dengan aman: pull atasnya berhenti dengan menyebutkan kedua dokumen alih-alih menjawab dengan salah satunya, sebagaimana dikatalogkan di errors/fatal-halts.md.

Membaca entitas sebelum dibundel

Push membaca Component, Feature, Recipe, atau FeatureRecipe dengan cara yang sama seperti build membacanya, dan menolak apa yang ditolak oleh pembacaan itu — dengan alasan yang sama, di bawah kode singkat yang sama, sebelum bundel dibuat dan sebelum registry tujuan dihubungi. Jadi dokumen yang tidak memenuhi skema jenisnya, path yang menyebutkan konten di luar direktori milik entitas, dan skema yang diimpor Component atau Feature dengan $import: yang hilang atau tidak dapat digunakan ditolak saat publikasi alih-alih dipublikasikan. Masing-masing adalah entitas yang akan ditolak oleh build pertama konsumennya; path yang keluar dari direktori juga menyebutkan file yang tidak akan ikut terbawa bersama entitas, karena setiap file yang dibawa publikasi diambil dari direktori milik entitas itu sendiri — lihat A path names content outside the entity’s own directory (Sebuah path menyebutkan konten di luar direktori milik entitas).

Recipe atau FeatureRecipe dibaca dengan cara ini saat pin-nya dibandingkan, seperti yang dijelaskan bagian berikutnya, sehingga pembacaan terjadi baik push diminta untuk mem-pin maupun tidak, dan baik entitas memiliki sesuatu untuk di-pin maupun tidak. Keempat jenis tersebut juga dibaca dengan cara ini tepat sebelum bundelnya dibuat, karena pembacaan itulah yang menyatakan file mana yang disebutkannya. Aggregate dan pustaka tidak menyebutkan file apa pun dan tidak dibaca dengan cara ini. Plugin juga tidak menyebutkan file apa pun, dan dibaca terhadap skema jenisnya sebelum .wasm-nya dibaca, seperti yang dijelaskan Memublikasikan Plugin.

Memublikasikan Plugin

Plugin dipublikasikan bersama .wasm-nya, yang disebutkan oleh --plugin, dan push menilai keduanya sebelum byte apa pun dipublikasikan atau registry dihubungi. --dry-run menilainya persis seperti publikasi.

Entitas dibaca terlebih dahulu terhadap skema jenisnya, seperti pemuatan katalog membacanya, sebelum .wasm dibaca. Jadi metadata.version yang bukan versi semantik — commit polos seperti 415148e — ditolak berdasarkan kondisi skema itu sendiri, dengan menyebutkan field-nya, begitu pula setiap penyimpangan lain dari skema, seperti spec.abiVersion yang hilang. Apa yang dianggap sebagai versi semantik di sini adalah pola skema itu sendiri untuk metadata.version; push tidak menambahkan aturannya sendiri.

Kemudian .wasm dimuat dan dicocokkan dengan entitas. Apa yang dilaporkannya ia tawarkan harus sesuai dengan apa yang diklaim entitas, set perintah dan fungsi host yang dicatat entitas harus cocok dengannya, dan versi yang dilaporkannya tentang build-nya sendiri harus sama dengan metadata.version — lihat A Plugin entity’s recorded version does not match the plugin (Versi yang dicatat entitas Plugin tidak cocok dengan plugin).

.wasm yang di-build dari working tree dengan perubahan yang belum di-commit ditolak. Build seperti itu membawa tanda -dirty di akhir versi yang dilaporkannya — 1.0.0-dirty, 1.0.0-3-g1a2b3c4-dirty. Itu adalah versi semantik yang valid, tetapi menyebutkan commit yang tidak berisi apa yang di-build, sehingga tidak ada yang dapat mem-build ulang apa yang dipublikasikan dari versi yang digunakan untuk memublikasikannya. Push menolaknya, dengan menyebutkan versi dan perbaikannya: build plugin dari checkout bersih atas commit yang disebutkan oleh tag rilis, sehingga plugin melaporkan versi rilis itu sendiri — dan untuk merilis perubahan, commit perubahan tersebut dengan metadata.version entitas diatur ke rilis baru lalu beri tag pada commit itu terlebih dahulu — alih-alih menyalin versi yang dilaporkan build ulang ke dalam entitas. Versi pengembangan yang di-build dari sebuah commit, seperti 1.0.0-3-g1a2b3c4, dan prarilis seperti 1.0.0-rc.1 sama-sama dapat dipublikasikan. Penolakannya adalah A plugin was built from a working tree with uncommitted changes (Plugin di-build dari working tree dengan perubahan yang belum di-commit).

Menyematkan pin sebelum menerbitkan

Sebuah Recipe atau FeatureRecipe membawa pin untuk input yang dibacanya — source: jarak jauh yang ditulis lengkap, file yang diimpor oleh entri artifacts, file dari source: di sampingnya — dalam entity.lock di sampingnya, dan push menerbitkan file itu bersama entitasnya. Penyematan pin adalah langkah yang Anda jalankan sebelum menerbitkan, aggrega pin, lalu Anda meng-commit lock yang ditulisnya.

Push menolak entitas yang lock-nya tidak mencatat pin tersebut. Sebelum membangun bundle, push menentukan apa yang akan dicatat oleh langkah penyematan pin untuk entitas itu dan membandingkannya dengan entity.lock di sampingnya. Jika sebuah pin tidak ada, atau lock memuat pin yang tidak lagi cocok dengan suatu input, push berhenti sebelum arsip apa pun dibangun atau registry apa pun dihubungi. Penolakan itu menyebutkan entitas dan setiap input tersebut — masing-masing berupa remote source, imported file, atau local source file — serta apa yang harus dijalankan: aggrega pin pada entitas, --pin-sources pada push yang baru saja Anda jalankan, atau pin_sources_at_push untuk setiap push di workspace. Ini adalah penolakan yang sama yang dimunculkan pull atas lock yang sama, An entity reads an input the lock beside it records no pin for (Entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya), dengan solusi khusus push. Jadi, Recipe atau FeatureRecipe yang diterbitkan oleh push membawa, di dalam bundle-nya, lock yang mencatat setiap pin yang akan dicatat langkah itu pada saat diterbitkan.

Dua jenis entitas tidak memiliki apa pun untuk disematkan pin-nya dan diterbitkan tanpa perubahan: entitas yang tidak membaca sumber jarak jauh, tidak mengimpor file, dan tidak menyebut sumber lokal, serta Recipe yang koordinat sumber jarak jauhnya diisi dari template. Sumber itu baru menyebut sebuah artefak setelah sebuah Release mengisi template tersebut, sehingga pin-nya berada di lockfile setiap Release, dan push tidak meminta pin di samping entitas. Sebuah Component, Feature, pustaka, Aggregate, atau Plugin tidak membaca apa pun yang dicatat lock dan tidak pernah ditolak di sini.

Membandingkan pin sumber jarak jauh berarti mengambil sumber tersebut, seperti yang dilakukan aggrega pin, karena pin yang tidak lagi cocok hanya terlihat jika dibandingkan dengan apa yang disajikan sumber saat ini. Karena itu, push atas entitas dengan sumber seperti itu menjangkau host sumber sebelum menjangkau registry. Perbandingan membaca Recipe atau FeatureRecipe dengan cara yang sama seperti langkah penyematan pin, melalui katalog, sehingga entitas yang ditolak untuk dibaca oleh katalog — misalnya dokumen yang gagal memenuhi skema jenisnya — ditolak di sini dengan alasan dari katalog itu sendiri.

Jika tidak ada workspace yang ditemukan dan tidak ada yang disebutkan, push yang akan mengambil sumber jarak jauh untuk perbandingan ditolak sebelum mengambilnya, sama seperti aggrega pin. Perbandingan mengambil setiap sumber jarak jauh yang ditulis lengkap oleh entitas ke dalam cache artefak, persis seperti langkah penyematan pin, dan cache yang ditulis di folder yang darinya tidak ditemukan workspace akan menjadikan folder itu sebuah workspace. Jadi, ketika tidak ada yang menyebut root dan tidak ada yang menambatkannya — dari folder tempat Anda menjalankan push, atau, untuk entitas yang disebut dengan path absolut, dari folder entitas itu sendiri — push sebuah Recipe atau FeatureRecipe dengan sumber seperti itu berhenti sebelum sumber diambil, termasuk dry run dan --pin-sources, serta menyebutkan sumber, folder, dan dua solusinya: sebutkan workspace Anda dengan --workspace-root atau AGGREGA_WORKSPACE_ROOT, atau berikan folder itu sebuah .aggrega-config.yaml yang memuat blok workspace:. Perbandingan tidak mengambil apa pun untuk dua jenis entitas di atas, maupun untuk entitas yang sumbernya lokal, sehingga masing-masing dibandingkan dengan lock-nya dan diterbitkan di sana seperti di tempat lain; dan setiap jenis lain tidak terikat pada lock dan tidak ditolak karena hal ini. Konfigurasi mencantumkan perintah lain yang juga berlaku.

aggrega push --pin-sources menjalankan langkah yang sama itu untuk Anda, lebih dahulu. Langkah ini berjalan sebelum bundle dibangun, sehingga lock yang ditulisnya berada di artefak yang diterbitkan dan digest yang diterbitkan mencakupnya; dan langkah ini berjalan sebelum setiap penolakan lain yang menilai entitas, sehingga yang dinilai adalah entitas yang sudah disematkan pin-nya. Hanya aturan direktori di atas yang didahulukan, karena langkah ini menulis satu-satunya lock yang dimuat direktori tersebut. Langkah ini menulis byte yang sama dengan yang ditulis aggrega pin, sehingga penolakan di atas tidak pernah terpicu pada eksekusi itu: lock yang baru saja ditulis langkah ini mencatat persis apa yang akan dibandingkan oleh penolakan. Kunci workspace pin_sources_at_push menjadikan ini bawaan setiap push, dan --pin-sources=false melewati langkah ini untuk satu eksekusi, yang mengembalikan penolakan. Langkah ini menulis di samping entitas, yang memerlukan lokasi yang dapat ditulisi — dan push selalu memilikinya, karena push menerbitkan dokumen yang Anda sebutkan.

--dry-run menjawab sebagaimana penerbitan akan menjawab. Tanpa --pin-sources, ia menolak entitas yang belum disematkan pin-nya persis seperti penerbitan, sehingga dry run yang melaporkan bundle adalah dry run yang akan diloloskan oleh penolakan ini. Dengan --pin-sources, langkah ini menyematkan pin sebagai dry run: ia mencetak lock yang akan ditulisnya dan tidak menulis apa pun, dan fakta bundle yang mengikutinya menggambarkan direktori apa adanya, tanpa lock itu — sehingga digest-nya adalah digest penerbitan tanpa lock tersebut, dan jika lock itu baru, demikian pula ukurannya dan, untuk entitas yang tidak menyebut hal lain, media type-nya. Penolakan tidak terpicu, karena penerbitan akan menyematkan pin terlebih dahulu.

Praktik terbaik: perubahan pada versi yang sudah Anda terbitkan masuk ke versi baru, lalu ke sebuah pin. Salin entitas ke direktori versi baru, lakukan perubahan di sana, sematkan pin-nya, dan terbitkan yang itu. Separuh yang ditegakkan produk adalah bagian berikutnya: menerbitkan konten yang berbeda pada versi yang sudah diterbitkan akan ditolak. Separuh lainnya — tidak menyematkan ulang pin versi yang sudah diterbitkan setelah mengeditnya di workspace Anda sendiri — menjadi tanggung jawab Anda; tidak ada yang menolaknya secara lokal, karena menyematkan ulang pin sah untuk entitas yang belum Anda terbitkan.

Registry, tag, dan pengalamatan berbasis konten

Registry tujuan adalah --registry <ref> jika diberikan, jika tidak default_registry milik workspace (hub.aggrega.ai secara bawaan). Tag-nya adalah metadata.version entitas, dan path repositori diturunkan dari jenis dan namanya, sehingga tempat sebuah versi yang diterbitkan mendarat tidak bergantung pada direktori asal penerbitannya.

Sebuah default_registry dapat memuat path repositori, dan penerbitan melaluinya mendarat di bawah path tersebut. Dengan default_registry: ghcr.io/acme, Component core/api-server pada versi 1.0.0 diterbitkan di ghcr.io/acme/component/core/api-server:1.0.0 — tempat pull melalui bawaan yang sama mengambilnya, sehingga tanda tangan yang dilampirkan di sini adalah yang ditemukan pull tersebut. --registry menyebut sebuah host, dan penerbitan yang diarahkannya mendarat di host itu tanpa path. Bagaimanapun tujuan disebutkan, persyaratan penandatanganan dan konfigurasi penandatanganan yang berlaku adalah yang disimpan untuk host-nya: path tidak pernah memilih kebijakan yang berbeda. Cara menulis path dijelaskan di cara menulis host registry.

Manifest menyebut digest dari byte yang diterbitkan, dan lockfile mencatat digest dari isinya. Manifest OCI yang ditulis push menyebut digest dokumen atau arsip yang diterbitkan, dan aggrega pull menolak unduhan yang tidak cocok dengannya, sehingga byte yang diubah antara penerbitan dan pull terdeteksi. Lockfile yang ditulis pull mencatat entitas dengan digest yang berbeda: digest kontennya — path dan byte setiap file, dan tidak ada apa pun tentang cara arsip dikompresi atau bit izin apa yang dimiliki file-filenya. Itulah digest yang dicatat pull di workspace milik penulis sendiri untuk entitas yang sama di direktori katalognya, sehingga penulis dan setiap konsumen sebuah penerbitan mencatat nilai yang sama, dan build di kedua sisi menolak konten yang tidak lagi cocok dengannya. Kedua digest menjawab pertanyaan yang berbeda: digest manifest memeriksa unduhan, dan digest lockfile adalah identitas entitas.

Menerbitkan di atas versi yang sudah ada

Sebelum byte apa pun diunggah, aggrega push menentukan apa yang sudah dimuat registry tujuan pada referensi yang akan ditulisnya dan membandingkannya dengan konten yang ada di hadapannya. Tiga hasil:

  • Belum ada yang diterbitkan di sana — push berlanjut dan menerbitkan seperti biasa.
  • Konten yang sama — tidak ada yang diunggah, dan perintah melaporkan versi tersebut sebagai sudah diterbitkan, sehingga push yang diulang atau dicoba ulang bukan kesalahan. Apa yang dibiarkan tidak terlampir oleh push sebelumnya — tanda tangan, atau tanggal penerbitan — dilampirkan sekarang, seperti yang dijelaskan di Menyelesaikan penerbitan yang dibiarkan parsial oleh push sebelumnya.
  • Konten yang berbeda — push berhenti, dengan menyebut digest yang sudah diterbitkan dan digest yang akan ditulisnya. Tidak ada flag yang dapat memaksanya lolos.

Karena itu, versi yang sudah diterbitkan tetap merujuk pada byte yang diterbitkan di bawahnya. Konten yang berubah diterbitkan di bawah metadata.version baru; aggrega lint --pre-publish menjawab pertanyaan berikutnya — seberapa jauh versi itu harus naik — dengan mengklasifikasikan perubahan terhadap versi yang diterbitkan sebelumnya.

--dry-run mencetak digest yang akan ditulis push, di samping referensi tempat ia akan menuliskannya:

aggrega push (dry-run): <reference>:<tag> (<digest>)

Ini adalah digest yang dibandingkan push sendiri dengan apa yang sudah diterbitkan, dihitung dengan cara yang sama hanya dari konten, dan mencetaknya tidak menghubungi registry apa pun. Jadi konten di hadapan Anda dapat dicocokkan dengan digest yang digunakan saat sebuah versi diterbitkan sebelum apa pun di-push: jika keduanya berbeda pada versi yang sudah diterbitkan, push akan ditolak. Dengan --pin-sources, ini adalah digest direktori apa adanya, seperti yang dijelaskan di Menyematkan pin sebelum menerbitkan.

Menyelesaikan penerbitan yang dibiarkan parsial oleh push sebelumnya

Push menulis konten terlebih dahulu dan melampirkan tanda tangan serta tanggal penerbitan sesudahnya, sehingga push yang gagal pada salah satu lampiran itu — setelah percobaan ulangnya — membiarkan konten diterbitkan tanpanya, dan keluar dengan kode bukan nol sambil menyebut apa yang tidak dapat dilampirkannya. Menjalankan push yang sama lagi menyelesaikan penerbitan itu. Push menemukan konten sudah diterbitkan, mencetak baris Already published:, tidak mengunggah apa pun, dan melampirkan apa yang masih kurang pada versi tersebut, masing-masing pada baris yang dicetak oleh penerbitan pertama untuknya:

  • Tanda tangan, jika push ini menandatangani. Tanda tangan dilampirkan ketika versi tidak membawa tanda tangan yang dihitung sebagai milik penerbitan ini. Jika konfigurasi Anda menyematkan kebijakan kepercayaan untuk host tujuan — sebuah public_key atau trusted_identities, atau untuk hub.aggrega.ai baseline bawaan — sebuah tanda tangan dihitung ketika terverifikasi di bawah kebijakan itu, sehingga tanda tangan yang tidak diterima kebijakan tidak pernah dianggap sebagai milik penerbitan itu sendiri. Jika kebijakan tidak menyematkan keduanya, tidak ada tanda tangan yang dapat diverifikasi terhadapnya, sehingga tanda tangan apa pun yang dibawa versi itu dihitung dan push hanya menandatangani versi yang tidak membawa tanda tangan sama sekali; menilai berdasarkan verifikasi dalam kasus itu akan melampirkan tanda tangan lain pada setiap eksekusi.
  • Tanggal penerbitan, jika aturan tanggal mengharuskannya — dibaca dari tanda tangan yang baru dilampirkan, atau dari tanda tangan yang sudah dihitung — dan versi itu sama sekali tidak membawa referrer published-at. Push yang tidak menandatangani berutang tanggal seperti penerbitan tanpa tanda tangan, terlepas dari tanda tangan apa pun yang dilampirkan ke versi itu sesudahnya. Tanggal yang dinyatakannya adalah jam milik push ini: waktu penerbitan diselesaikan, yang lebih lambat dari waktu konten pertama kali tiba, karena tidak ada yang disajikan registry yang mencatat momen itu.

Penerbitan yang sudah lengkap tidak mendapat lampiran apa pun, berapa kali pun push diulang. Sebelum melampirkan apa pun, push membaca tanda tangan dan tanggal apa yang dibawa versi itu dan membuat tanda tangan apa pun yang menjadi utangnya. Pertanyaan yang tidak dapat dijawabnya — daftar atau tanda tangan yang tidak dapat dibacanya, atau tanda tangan yang tidak dapat dinilainya karena root kepercayaan tidak dapat diperoleh — dan tanda tangan yang tidak dapat dibuatnya masing-masing keluar dengan kode bukan nol tanpa melampirkan apa pun, alih-alih dianggap berarti versi itu tidak membawa apa pun.

Ketika registry menggagalkan penulisan

Push menulis ke registry secara bertahap: konten — untuk Plugin, entitas dan .wasm-nya — lalu manifest yang menyebutnya, lalu tag versi, lalu tanda tangan dan tanggal penerbitan di sampingnya. Setiap langkah penulisan dicoba ulang ketika gagal dengan cara yang memungkinkan percobaan berikutnya berhasil: registry menjawab dengan kesalahan server (status 5xx apa pun, selain 503 yang membawa Retry-After) atau 408 Request Timeout, atau koneksi kehabisan waktu, direset, atau berakhir di tengah respons. Sebuah langkah dicoba paling banyak tiga kali, dengan menunggu setengah detik sebelum percobaan kedua dan satu detik sebelum percobaan ketiga.

Registry yang meminta untuk memperlambat akan ditunggu, dan penantian itu tidak menghabiskan satu pun dari percobaan tersebut. Pada 429 Too Many Requests, atau 503 yang membawa Retry-After, setiap permintaan ke registry itu — baik pembacaan maupun penulisan — menunggu selama yang diminta registry lalu dikirim lagi, dan langkah yang kontennya ditolak dimulai lagi sebagai unggahan baru, tanpa jumlah percobaan yang tetap, sampai registry tidak menjawab apa pun selain “perlambat” selama lima menit. Registry yang meminta untuk memperlambat menjelaskan penantian itu dan penolakan yang mengakhirinya.

Setiap percobaan adalah unggahan baru dari byte yang sama, tidak pernah pengiriman ulang permintaan yang gagal. Registry yang sudah menerima isi sebuah unggahan dapat menolak permintaan yang sama untuk kedua kalinya, dan yang diterimanya adalah unggahan baru. Konten yang sudah dimuat registry dihitung sebagai sudah diunggah, dan langkah yang dicoba ulang menulis apa yang akan ditulis percobaan pertama, sehingga percobaan yang berhasil sampai tetapi jawabannya hilang tidak menulis apa pun dua kali: manifest mempertahankan digest-nya, dan versi membawa satu tanda tangan dan satu tanggal penerbitan.

Setiap kegagalan lain langsung mengakhiri langkah: kredensial yang ditolak (401, 403, atau tidak ada kredensial tersimpan untuk registry), jawaban lain apa pun dari registry, registry yang sama sekali tidak dapat dijangkau, atau push yang Anda hentikan. Langkah yang masih gagal setelah percobaan terakhirnya membuat perintah gagal, dan kesalahannya menyebut langkah tersebut — konten, manifest, tag, tanda tangan, atau tanggal penerbitan. Apa yang telah diterbitkan langkah-langkah sebelumnya tetap diterbitkan; Penandatanganan dan Tanggal penerbitan menjelaskan apa artinya bagi versi tersebut.

Untuk kegagalan tersebut, hanya penulisan yang dicoba ulang. Membaca apa yang sudah dimuat registry pada versi tersebut, sebelum apa pun diunggah, tidak, meskipun, seperti setiap permintaan, pembacaan itu menunggu selama yang diminta oleh registry yang meminta untuk memperlambat.

Penandatanganan

aggrega push dapat menandatangani artefak saat menerbitkannya dan melampirkan tanda tangan sebagai referrer OCI — bundle Sigstore (kompatibel dengan cosign) pada digest manifest artefak yang tidak dapat diubah. Tanda tangan adalah manifest saudara, sehingga penandatanganan tidak pernah melakukan push ulang atau mengubah byte yang diterbitkan. Referrer menamai bundle-nya signature.json, sehingga klien OCI generik yang mengambil referrer berdasarkan digest-nya menulis bundle ke file tersebut.

Penandatanganan bersifat sign-before-push: digest manifest diketahui sebelum penerbitan, sehingga aggrega push membangun penanda tangan dan menandatangani digest sebelum byte apa pun mencapai registry. Jika penanda tangan tidak dapat dibangun atau penandatanganan gagal, push ditolak sebelum apa pun diunggah — tidak ada yang diterbitkan, sehingga penandatanganan yang gagal tidak pernah meninggalkan konten tanpa tanda tangan di registry. Sebelum menolak, panggilan penandatanganan yang gagal secara sementara — kegagalan apa pun yang membuat penulisan registry dicoba ulang, atau otoritas sertifikat keyless yang melaporkan bahwa ia tidak dapat memproses token identitas — dicoba lagi, hingga tiga percobaan dengan waktu tunggu yang sama. Di dalam panggilan penandatanganan keyless, permintaan yang dijawab otoritas sertifikat, log transparansi, atau otoritas stempel waktu dengan 429 Too Many Requests atau galat server terlebih dahulu dikirim lagi ke layanan tersebut, sebagaimana dijelaskan aggrega sign.

Tanda tangan dilampirkan setelah konten tiba, sehingga lampiran yang gagal memang membiarkan konten diterbitkan tanpanya. Lampiran adalah penulisan, yang dicoba ulang seperti yang dijelaskan di Ketika registry menggagalkan penulisan. Jika masih gagal, perintah keluar dengan kode bukan nol sambil menyebut tanda tangan yang tidak dapat dilampirkannya, dan konsumen yang registry-nya mewajibkan tanda tangan menolak versi itu sampai tanda tangan dilampirkan. Menjalankan push yang sama lagi akan melampirkannya, seperti yang dijelaskan di Menyelesaikan penerbitan yang dibiarkan parsial oleh push sebelumnya; aggrega sign melampirkan tanda tangan ke versi yang diterbitkan berdasarkan referensi.

Publikasi memerlukan tanda tangan bila blok signing milik registry tujuan sendiri menetapkan required: true, atau bila blok signing tingkat atas melakukannya untuk setiap registry — masing-masing terbatas pada jenis yang dicantumkan kinds-nya, bila mencantumkan. Publikasi seperti itu menandatangani secara bawaan, dan --sign meminta penandatanganan secara eksplisit. Tidak ada flag untuk melakukan push konten tanpa tanda tangan bila tanda tangan diwajibkan — push tersebut selalu berhenti.

Dua mode penandatanganan:

  • Keyless (bawaan) — kunci sementara yang diikat ke identitas OIDC oleh sertifikat Fulcio berumur pendek, dicatat dalam log transparansi Rekor. Fulcio dan Rekor secara bawaan menggunakan instans Sigstore publik (https://fulcio.sigstore.dev, https://rekor.sigstore.dev). Stempel waktu tepercaya keyless berasal dari penyertaan dalam log transparansi Rekor; otoritas stempel waktu RFC3161 terpisah bersifat opsional — berikan --timestamp-url dengan endpoint lengkap untuk mengaktifkannya. Di terminal interaktif, penandatanganan keyless tidak memerlukan flag: CLI membuka browser untuk memperoleh token identitas OIDC berumur pendek. Di GitHub Actions juga tidak memerlukannya: CLI membuat token OIDC workflow secara otomatis dari endpoint lingkungan runner. Untuk penggunaan non-interaktif / CI lainnya, ekspor AGGREGA_IDENTITY_TOKEN (atau SIGSTORE_ID_TOKEN), atau berikan --identity-token; tanpa token yang diberikan, tanpa endpoint lingkungan, dan tanpa terminal, push ditolak. Lihat environment-variables.md untuk model token CI.
  • Keyed (--key) — kunci ECDSA P-256 yang disimpan offline (PEM yang kompatibel dengan cosign), jalan keluar untuk lingkungan tanpa penyedia identitas OIDC. Tidak ada penyedia identitas, otoritas sertifikat, atau log transparansi yang dihubungi.

URL layanan keyless dan path kunci keyed juga dapat diatur dalam .aggrega-config.yaml di bawah blok signing: (global dan per registry); flag menimpa konfigurasi, dan konfigurasi menimpa bawaan publik. Token identitas OIDC tidak pernah menjadi kolom konfigurasi (token itu adalah rahasia berumur pendek), dan kunci privat tidak pernah ditulis inline dalam konfigurasi — hanya path ke kunci tersebut.

Tanggal penerbitan

Waktu pembuatan manifest disematkan, sehingga digest manifest hanya bergantung pada apa yang diterbitkan dan tidak pernah pada kapan. Tanggal sebuah versi diterbitkan justru dibawa di sampingnya, dan asalnya bergantung pada tanda tangan:

  • Tanda tangan keyless sudah membawanya. Entri log transparansinya mencatat kapan log mengintegrasikan tanda tangan, dan janji bertanda tangan dari log membuktikan waktu tersebut. aggrega push tidak menulis apa pun lagi.
  • Tanda tangan keyed, atau tanpa tanda tangan, tidak membawa waktu. Jadi setelah entitas dan tanda tangan apa pun tiba, aggrega push melampirkan referrer published-at kecil ke manifest — dinamai published-at.json untuk klien OCI generik — yang memuat satu stempel waktu RFC 3339 dalam UTC hingga detik, dibaca dari jam milik mesin yang menerbitkan. Referrer ini tidak ditandatangani: ia adalah pernyataan penerbit, dan pembaca mencatatnya sebagai demikian. Baris Publication date attached: melaporkannya.

Seperti tanda tangan, referrer published-at adalah manifest saudara yang menunjuk kembali ke manifest yang diterbitkan, sehingga tidak menggeser digest apa pun dan tidak mengubah tag apa pun, dan pemeriksaan saat menerbitkan di atas versi yang sudah ada tidak terpengaruh olehnya. Push berulang atas konten yang sama hanya melampirkan tanggal ke versi yang belum membawanya, dengan menyatakan jamnya sendiri — lihat Menyelesaikan penerbitan yang dibiarkan parsial oleh push sebelumnya. Tanggal dibaca dari jam satu kali, sebelum lampiran pertama kali dicoba, sehingga lampiran yang dicoba ulang — lihat Ketika registry menggagalkan penulisan — menyatakan tanggal yang sama. Push yang telah menerbitkan kontennya tetapi tidak dapat melampirkan tanggal setelah percobaan-percobaan itu keluar dengan kode bukan nol dan menyebut apa yang tidak dilampirkan. aggrega registry update mencatat tanggal setiap versi beserta dari mana di antara kedua sumber itu tanggal tersebut berasal.

Luring

Penerbitan adalah perjalanan bolak-balik jaringan dan tidak memiliki bentuk yang bukan demikian, sehingga dalam mode offline — kunci tingkat atas offline dalam file konfigurasi, AGGREGA_OFFLINE, atau --offline — aggrega push menolak sebelum membaca entitas Anda. Penolakan itu menyebutkan mana dari ketiganya yang menetapkan mode tersebut, yang dibutuhkan pembaca ketika konfigurasi proyek yang di-commit-lah yang mengaktifkannya, bukan sesuatu yang mereka ketik.

--dry-run adalah pengecualiannya, dan ia menjadi pengecualian karena apa yang dilakukannya: ia menghitung bundle, mencetak referensi yang akan diterbitkannya dan digest yang akan dihasilkan penerbitan itu, dan tidak pernah menghubungi registry. Hal itu menjadikannya bentuk penerbitan yang aman untuk offline, bukan konflik dengan mode tersebut, dan ia tetap berfungsi di dalamnya — dengan satu catatan. Untuk Recipe atau FeatureRecipe yang source: jarak jauhnya ditulis lengkap, sumber itu diambil untuk membandingkan pin-nya, dan dalam mode offline pengambilan itu ditolak dengan pesannya sendiri, sehingga dry run atas entitas seperti itu berhenti di sana alih-alih melaporkan bundle yang tidak dapat dijaminnya.

Untuk menerbitkan dalam satu eksekusi dari workspace yang konfigurasinya offline, berikan --offline=false.

Variabel lingkungan

Input penandatanganan dan registry tujuan dapat diberikan melalui lingkungan, menimpa .aggrega-config.yaml, sementara flag tetap diutamakan:

  • AGGREGA_IDENTITY_TOKEN — token identitas OIDC keyless (padanan lingkungan untuk --identity-token). SIGSTORE_ID_TOKEN diterima sebagai alias interoperabilitas ekosistem sigstore, dengan prioritas di bawah AGGREGA_IDENTITY_TOKEN dan endpoint lingkungan GitHub Actions. Token tidak pernah menjadi kolom konfigurasi.
  • AGGREGA_SIGNING_FULCIO_URL, AGGREGA_SIGNING_REKOR_URL, AGGREGA_SIGNING_TIMESTAMP_URL — URL layanan keyless.
  • AGGREGA_SIGNING_KEY_PATH — penunjuk path ke PEM kunci keyed (tidak pernah materi kunci).
  • AGGREGA_DEFAULT_REGISTRY — registry tujuan ketika --registry dihilangkan.

Urutan prioritasnya adalah flag > lingkungan > konfigurasi > bawaan. Lihat environment-variables.md untuk daftar lengkap dan model prioritasnya.

Autentikasi

aggrega push membaca kredensial registry sebagaimana aggrega pull — dari konfigurasi kredensial Docker dan credential helper yang disebutkannya. Jalankan aggrega login <registry>, yang tidak memerlukan alat lain, atau docker login <registry> sebelum melakukan push ke registry privat. Lihat aggrega-pull.md untuk tempat konfigurasi tersebut dibaca.

Lihat juga

  • ./aggrega-sign.md — menandatangani artefak yang sudah diterbitkan setelahnya (padanan pasca-penerbitan dari --sign).
  • ./aggrega-lint.md — gerbang penerbitan (--pre-publish) yang sebaiknya mendahului push.
  • ./aggrega-pull.md — sisi konsumen, yang me-resolve dan menyematkan pin apa yang diterbitkan push.
  • ./aggrega-serve.md — daemon menyediakan penerbitan yang sama ini di aggrega/publishEntity, sehingga editor dapat menjalankannya tanpa meninggalkan sesi; penerbitan ini hanya berjalan ketika sebuah permintaan menyebutnya, dan menjawab dengan referensi, digest yang diterbitkan — pada dry run, digest yang dicetak --dry-run — seberapa jauh panggilan itu berjalan, dan entri yang diperingatkan perintah ini sebagai windowsUnusableEntries.
  • ./aggrega-mcp.md — kemampuan yang sama sebagai alat publish-entity, yang dapat dipanggil asisten, dan menjawab dengan entri-entri tersebut sebagai windows_unusable_entries. Baca apa yang dikatakan halaman itu tentang mengizinkannya sebelum Anda melakukannya.
  • ../../architecture/13-catalog-and-registry.md — model katalog, registry, dan mediatype OCI.

Sinopsis

aggrega push <entity-path> [flags]

Deskripsi

Publish a single catalog entity to an OCI registry, where other workspaces
resolve it with "aggrega pull".
The entity is read from the path given, bundled for transport, and pushed to
<registry>/<kind>/<metadata.name>:<metadata.version>, the repository path
lowercased; a Recipe or FeatureRecipe carries its spec.capability, and a Plugin
its metadata.pluginType, as a segment between <kind> and <metadata.name>. The
tag is the entity's own metadata.version. Run "aggrega push --list-kinds" for
the kinds this binary publishes, one per line and nothing else, so a script can
read it directly. Release and Manifest are deployment-side inputs rather than
catalog artifacts and are refused.
Every kind has a directory of its own except Aggregate, Release and Manifest: an
entity of any other kind is refused when another entity sits in its directory,
before anything is pinned or bundled, and the refusal names the entity in the way.
The directory's name is not judged.
A Component, Feature, Recipe or FeatureRecipe is read the way a build reads it
before it is bundled, and one that read refuses is refused here for the same
reason: a document that fails its kind's schema, a path naming content outside
the entity's own directory, which would not travel with the entity, or a schema
a Component or Feature imports that cannot be read or used.
A Plugin is read against its kind's schema too, before its .wasm is read, so a
metadata.version that is not a semantic version is refused. Its .wasm must then
agree with the entity on what the plugin offers and on its version, and a .wasm
whose version says it was built from a working tree with uncommitted changes —
the -dirty mark a build adds — is refused. A version disagreement and a build
from uncommitted changes are both cleared by building the plugin from a clean
checkout of the commit its release tag names, never by copying the version it
reports into the entity. A development version such as 1.0.0-3-g1a2b3c4, built
from a commit, and a prerelease such as 1.0.0-rc.1 publish.
What is published is the entity document and the files the entity itself names
beside it — a Recipe's or FeatureRecipe's local source, each file an $import:
names, the entity.lock beside it, and each schema file a Component or Feature
imports — and nothing else in its directory. An entity that names nothing
publishes as its document, unchanged; one that names a file publishes as a
gzipped archive of the document and those files. A directory it names travels
with every file under it that the ignore rules recorded in its entity.lock keep:
the rules the plugin serving its capability declared, and the author's own
.aggregaignore beside it, composed when the entity was pinned. A symbolic link
among those files is refused rather than followed. A local source written as a
template names no one directory until a Release fills it in, so an entity with
one carries every such file in its own directory, and push says so.
Push warns about each file an archive carries whose path holds a part Windows
cannot hold as written: a name Windows reserves for a device — CON, PRN, AUX,
NUL, COM1 or LPT1, say, in any letter case and whatever extension follows — or a
part ending in a full stop or a space. On Windows, aggrega refuses to unpack
such a file, so a Windows workspace cannot use the version. The warning is
written to standard error on every platform, one line per file, the entity
document's own file name judged with the rest, and it refuses nothing: the push,
or its dry run, goes ahead or stops exactly as it would without it. An entity
that names nothing publishes as its document alone and is never warned about.
Each file travels with mode 0644, whatever its permission bits — the execute
bit included — in the checkout it is published from. The OCI manifest names the
digest of the published bytes, so "aggrega pull" refuses a download that does
not match it. The lockfile a pull writes records the entity by the digest of its
content — each file's path and its bytes — which is the digest a pull in the
author's own workspace records for the same entity in its catalog directory, so
a build on either side refuses content that no longer matches.
Push signs before it publishes: where signing applies, the signature is made
over the manifest digest before any bytes reach the registry, so a failed
signing refuses the push rather than leaving unsigned content published.
The manifest's creation time is pinned, so the digest depends only on what is
published and never on when. Push states when it published beside the manifest
instead, as a small published-at attachment carrying this machine's clock, in
UTC to the second — unless the signature it attached already carries a time a
transparency log attests, as a keyless signature does. So a keyed or unsigned
publication writes one, and a keyless one does not. The attachment moves no
digest and changes no tag. "aggrega registry update" records the date, with
which of the two it came from.
Push refuses to replace content already published at the same version:
publish changed content under a new version instead.
A Recipe or FeatureRecipe carries the pins for its own inputs in the entity.lock
beside it, and pinning them is a step you run before publishing: aggrega pin.
A push that does not run that step refuses an entity whose entity.lock is
missing a pin, or holds one an input no longer matches, and names the step.
Pass --pin-sources, or set pin_sources_at_push in the workspace configuration, to
have push run that same step first, so the lock it writes is part of what is
published; --pin-sources=false skips it for one run.

Flag

FlagDefaultDeskripsi
--dry-runfalseMenghitung bundle dan mencetak : yang diusulkan beserta digest yang akan dihasilkan penerbitan, tanpa menghubungi registry. Entitas yang akan ditolak penerbitan karena pin yang hilang juga ditolak di sini
--entity—Path ke YAML entitas yang akan diterbitkan (atau berikan sebagai argumen posisional)
--fulcio-url—URL otoritas sertifikat Fulcio untuk penandatanganan tanpa kunci. Jika dihilangkan, instans Fulcio publik digunakan.
--identity-token—Token identitas OIDC untuk penandatanganan tanpa kunci. Opsional di terminal interaktif (alur browser memperolehnya) dan di GitHub Actions (token OIDC workflow diterbitkan secara otomatis); wajib untuk penggunaan non-interaktif/CI lainnya, yang memungkinkannya diekspor sebagai AGGREGA_IDENTITY_TOKEN atau SIGSTORE_ID_TOKEN sebagai gantinya.
--key—Path ke PEM kunci privat ECDSA P-256 yang Anda miliki untuk penandatanganan berkunci secara offline. Jika dihilangkan, penandatanganan tanpa kunci digunakan.
--list-kindsfalseMencantumkan setiap jenis entitas yang dapat diterbitkan, lalu keluar tanpa menerbitkan apa pun. Output-nya dapat dibaca mesin dan bentuknya stabil: satu jenis per baris, dalam urutan terurut, tanpa hal lain.
--pin-sourcesfalseMenjalankan langkah penyematan pin milik penulis entitas pada entitas sebelum membundelnya, sehingga entity.lock yang ditulis langkah itu di sampingnya menjadi bagian dari apa yang diterbitkan, alih-alih menolak entitas yang lock-nya tidak mencatat pin-nya. Langkah yang sama dengan aggrega pin, yang menulis byte yang sama. Langkah ini menulis di samping entitas, sehingga hanya berjalan di tempat entitas memiliki lokasi yang dapat ditulisi: dokumen di direktori tempat ia dibaca — yang selalu dimiliki push, karena push menerbitkan dokumen entitas yang Anda sebutkan. Menimpa pin_sources_at_push milik workspace ke dua arah: —pin-sources menyematkan pin untuk eksekusi ini dan —pin-sources=false tidak, apa pun isi pengaturannya
--plugin—Path ke artefak .wasm lokal untuk entitas Plugin. Wajib saat menerbitkan Plugin: penerbitan melakukan push artefak .wasm, menghitung digest kontennya, dan melakukan push entitas.
--registry—Host registry tujuan (menimpa default_registry milik workspace)
--rekor-url—URL log transparansi Rekor untuk penandatanganan tanpa kunci. Jika dihilangkan, instans Rekor publik digunakan.
--signfalseMenandatangani artefak yang diterbitkan dan melampirkan tanda tangan sebagai referrer OCI. Jika dihilangkan, penandatanganan mengikuti kebijakan registry tujuan.
--timestamp-url—URL otoritas stempel waktu RFC3161 opsional untuk penandatanganan tanpa kunci.