aggrega push
aggrega push, bir katalog varlığını bir OCI kayıt defterine yayımlar; diğer çalışma alanları bu varlığı oradan aggrega pull ile çözümleyebilir.
Ne yapar
aggrega push tek bir varlık YAML’ını okur, onu taşıma için paketler ve depo yolu küçük harfe çevrilmiş olarak <registry>/<kind>/<metadata.name>:<metadata.version> adresine gönderir; bir Recipe veya FeatureRecipe kendi spec.capability değerini, bir Plugin ise kendi metadata.pluginType değerini tür ile ad arasında bir yol parçası olarak taşır. Kurulu ikili dosyanın yayımladığı varlık türlerini görmek için aggrega push --list-kinds komutunu çalıştırın: her satırda bir tür, sıralı ve başka hiçbir şey olmadan yazılır, böylece bir betik çıktıyı doğrudan okuyabilir. Bu küme, katalog yazım türlerini; yeniden kullanılabilir bir modül olan Aggregate’i ve derleyicinin yönlendirdiği, çalışma zamanının yürüttüğü bir WebAssembly yapıtına içerik adresli bir başvuru olan Plugin’i kapsar. Plugin, bir katalog yazım türü değil, yapısal ve yayımlanabilir bir yapıttır. Yayımlanabilirlik, varlığın nasıl kullanıldığının değil, varlığın kendisinin bir özelliğidir: bir Aggregate, daha sonra bir Release’in üst düzey spec.aggregate alanında başvurulsa da başka bir Aggregate’in aggregates: bloğuna yerleştirilse de yayımlanabilirdir. Release ve Manifest katalog yapıtları değil, dağıtım tarafı girdileridir ve reddedilir.
Paketleme
Bir push, varlık belgesini ve varlığın kendisinin yanında adlandırdığı dosyaları yayımlar; dizinindeki başka hiçbir şeyi yayımlamaz. Bir varlığın adlandırdığı dosyalar şunlardır:
- bir Recipe veya FeatureRecipe için yerel
source:değeri (bir dizin, Bir varlıkla hangi dosyalar gönderilir bölümünde açıklandığı gibi,entity.lockdosyasına kaydedilmiş yok sayma kurallarının tuttuğu, altındaki her dosyayla birlikte taşınır);valuesMapping:,workload:veartifacts:girdilerinin$import:ile içe aktardığı her dosya; ve yanındakientity.lock; - bir Component veya Feature için
spec.schemadeğerinin, bir sütunun veya birusesSchemasoketinin$import:ile içe aktardığı her şema dosyası; içe aktarılan bir dosyanın da sırayla içe aktardığı her dosya dahil.
Bir Aggregate, bir Plugin ve kütüphane türleri, belgelerinin yanında hiçbir dosya adlandırmaz. Dizinde duran bir not, bir README, başka bir varlığın dosyaları veya bir derlemenin çıktısı, adı ne olursa olsun yayımlanmaz. Bir varlığın adlandırdığı dosyalar arasındaki sembolik bağlantı izlenmez, reddedilir (A symbolic link sits among the files an entity carries (Bir varlığın taşıdığı dosyalar arasında sembolik bağlantı bulunuyor)); bir varlığın, varlık dizininin dışına çıkan bir bağlantı olan bir dizin üzerinden adlandırdığı yol da, herhangi bir şey paketlenmeden önce reddedilir (A path names content outside the entity’s own directory (Bir yol, varlığın kendi dizini dışındaki içeriği adlandırıyor)).
Biçim bundan çıkar. Hiçbir şey adlandırmayan bir varlık, türünün +yaml ortam türü altında, belgesi olarak ve değiştirilmeden yayımlanır. Bir dosya adlandıran varlık ise belgeyi ve bu dosyaları dizindeki yerlerinde tutan bir .tar.gz olarak, türünün +tar+gz ortam türü altında yayımlanır. Dolayısıyla içeriğinin tamamı satır içi olan bir Recipe belgesi olarak, şeması bir dosyadan içe aktarılan bir Component ise arşiv olarak yayımlanır. Katalog ve Registry §6, her tür için iki ortam türünü de listeler.
Bir arşivdeki her dosya, diskteki izin bitleri ne olursa olsun 0644 kipini taşır ve zaman damgası taşımaz. Bir checkout dosyaları kendi izin bitleriyle yazar ve çalıştırma biti kaydetmeyen bir sistem, başka bir sistemin çalıştırılabilir olarak çıkardığını sıradan bir dosya olarak çıkarır; bu nedenle arşiv diskten okunan hiçbir kip taşımaz: bir commit’in iki checkout’u, umask değerleri ne olursa olsun ve hangi sistemde yapılmış olurlarsa olsunlar aynı dosyaları yayımlar; bir betiğin çalıştırma bitini değiştirmek de yayımlanan hiçbir şeyi değiştirmez.
Bir push, bir arşivin taşıdığı ve Windows’un yazıldığı gibi tutamayacağı her girdi için uyarır: CON, AUX veya NUL gibi bir aygıtın adını taşıyan bir parçası olan yol (harf büyüklüğü ne olursa olsun ve ardından hangi uzantı gelirse gelsin, aux/x.yaml gibi) ya da nokta veya boşlukla biten bir parça (report. gibi). Windows’ta aggrega böyle bir girdiyi açmayı reddeder, dolayısıyla bir Windows çalışma alanı o sürümü kullanamaz. Uyarı her platformda, girdi başına bir satır olarak, yayının kendi dökümünden önce standart hataya yazılır; varlık belgesinin kendi dosya adı, adlandırdığı dosyalarla birlikte değerlendirilir ve hiçbir şey adlandırmayan bir varlık yalnızca belgesi olarak yayımlanır ve hiçbir zaman uyarı almaz. Uyarı hiçbir şeyi reddetmez: push, uyarı olmasaydı nasıl ilerleyecek ya da reddedilecek idiyse tam öyle davranır ve --dry-run de aynı şekilde uyarır. A published archive carries an entry Windows cannot use (Yayımlanmış bir arşiv Windows’un kullanamayacağı bir girdi taşıyor) satırı ve bu konuda ne yapılacağını gösterir.
Şablon olarak yazılmış yerel bir source: tüm dizini taşır. ./charts/{{ .values.flavour }} gibi bir şablon, ancak bir Release onu doldurduğunda bir dizini adlandırır; bu yüzden hiçbir yayın bunun hangisi olacağını bilemez. Böyle bir varlık, kendi dizininde kayıtlı yok sayma kurallarının tuttuğu her dosyayı taşır (kuralları kilidin içinde taşınan .aggregaignore hariç) ve push bunu diğer bilgilerinin altında belirtir:
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 itAdlandırılmayan taşınmaz ve bunu fark eden tüketici olur. Varlığın, yukarıdaki alanlardan biriyle adlandırmadan dayandığı bir dosya yayında yer almaz; bir tüketicinin onu derlemesi, önbellek yuvasında eksik olan yolu adlandırarak başarısız olur, sizin push işleminiz değil. Varlığın ihtiyaç duyduğu her dosyayı bu alanlardan biriyle adlandırın.
Yayımlanan her dosya, yapıtın manifest’inde adlandırılır; böylece oras gibi genel bir OCI istemcisi onu bu adda bir dosyaya yazar: belgesi olarak yayımlanan bir varlık için entity.yaml, dosyalarıyla yayımlanan bir varlık için entity.tar.gz, bir Plugin için ise varlık için entity.yaml ve yanında çalıştırılabilir dosyası için entity.wasm. Ad, yayımladığınız dosyadan değil ortam türünden çıkar; dolayısıyla yeniden adlandırılmış bir dosyadan yayımlanan aynı içerik aynı yapıtı yayımlar. Katalog ve Registry §6, yayımlanan her biçimi ve her birinin hangi dosya olarak indiğini listeler.
Bir Recipe üzerindeki uzak bir source: URL’si (bir OCI chart başvurusu, bir HTTPS chart veya parça URL’si, bir Git modülü) yayımlanan YAML’da olduğu gibi korunur; çekilip yapıta dahil edilmez. Tüketiciler uzak kaynakları kendi çekme zamanlarında bağımsız olarak çözümler ve sabitler. Bu, katalog varlığı dağıtımını ve kaynak yapıt çözümlemesini ayrı konular olarak tutar.
Bir Aggregate kendi tek belgesi olarak yayımlanır: aggregates: içinde başvurduğu bir alt aggregate yapıta paketlenmez. Her alt aggregate, tüketicilerin çekme zamanında kimliğe göre bağımsız olarak çözümleyip sabitlediği, ayrı yayımlanmış bir Aggregate’tir; bu, uzak kaynaklara uygulanan dağıtımın ayrılması ilkesinin aynısıdır.
Dizin başına bir varlık
Bir arşiv, varlık dosyasını adlandırdığı dosyaların arasında tutar; bu yüzden varlığın, arşivden çıkarken yeniden bulunması gerekir. Bir tüketici onu taşıdığı giriş bölümünden bulur: paketin en üstünde, kind: değeri yayımlanabilir bir varlık türü olan belge varlığın kendisidir. Varlığın yazıldığı dosyanın adı herhangi bir şey olabilir — recipe.yaml bir zorunluluk değil, kataloğun uzlaşımıdır — ve varlığın yanında duran bir compose parçası, bir chart şablonu ya da bir Kubernetes manifest’i varlıkla karıştırılmaz, çünkü bunlar başka bir şey bildirir ya da hiç tür bildirmez. Daha aşağıda, bir source/ ağacının içindeki varlık belgeleri varlığın kendisi değil, varlığın taşıdığı içeriktir ve hiçbir zaman dikkate alınmaz.
Bir push, dizinini başka bir varlıkla paylaşan bir varlığı reddeder. Bir çalışma alanı kökünün yan yana tuttuğu Aggregate, Release ve Manifest dışında her türün kendine ait bir dizini vardır. Diğer her tür için push, varlıkla başka bir şey yapmadan önce — pin adımından, imzalama politikasından ve paketten önce — aynı dizinde başka bir varlık belgesi bulunmadığını denetler; aksi hâlde push’tan pin istenmiş olsun ya da olmasın, engel olan her varlığı adlandırarak reddeder. aggrega pin aynı dizini aynı sözcüklerle reddeder; durma An entity shares its directory with another entity (Bir varlık dizinini başka bir varlıkla paylaşıyor) hatasıdır. Varlığın yanındaki varlık türü olmayan bir belge — bir chart dosyası, bir compose parçası, bir README — engel değildir; bir alt dizindeki herhangi bir şey de engel değildir. Varlığın yanındaki her belge yalnızca çalışma alanının içinden ya da çalışma alanı dışında adlandırdığınız bir varlık için varlığın kendi dizininin içinden okunur; bu yüzden dışarıya çıkan bir bağlantı olan belge, çalışma alanı sınırı bölümünün açıkladığı gibi, bağlantıyı okunmadan adlandırarak push’u durdurur.
Bu kural, bir entity.lock dosyasının tek bir varlığa ait kalmasını sağlar: kilidin dosya adı her varlık için aynıdır; dolayısıyla tek bir dizinde yazılmış iki varlık, dizinin yer verebildiği tek kilidi paylaşırdı. Kural yalnızca dizinden bir şey üretildiğinde değerlendirilir; bu yüzden birkaç varlık tutan bir dizin yine de yüklenir, lint edilir ve derlenir.
Dizinin adı değerlendirilmez. Dizininde tek başına olan bir varlık, o dizin nerede olursa olsun metadata.version sürümünde yayımlanır; standart kütüphane kataloğunun izlediği <name>/<version>/ düzeni bir uzlaşımdır. Başka bir istemcinin iki varlık tutan bir dizinden yayımladığı bir yapıt yine de güvenle okunur: onun pull işlemi, ikisinden birini yanıt olarak vermek yerine her iki belgeyi de adlandırarak durur; bu durum errors/fatal-halts.md sayfasında kataloglanmıştır.
Varlığın paketlenmeden önce okunması
Bir push, bir Component’i, bir Feature’ı, bir Recipe’yi veya bir FeatureRecipe’yi bir derlemenin okuduğu şekilde okur ve bu okumanın reddettiğini reddeder: aynı nedenle, aynı kısa kodla, paket oluşturulmadan ve hedef kayıt defterine bağlanılmadan önce. Dolayısıyla türünün şemasını karşılamayan bir belge, varlığın kendi dizini dışındaki içeriği adlandıran bir yol ve bir Component’in veya Feature’ın $import: ile içe aktardığı, eksik olan ya da kullanılamayan bir şema yayımlanmak yerine yayımlama sırasında reddedilir. Bunların her biri, tüketicilerinin ilk derlemesinin reddedeceği bir varlıktır; dizinden çıkan bir yol ayrıca varlıkla birlikte taşınmayacak bir dosyayı adlandırır, çünkü bir yayının taşıdığı her dosya varlığın kendi dizininden alınır. Bkz. A path names content outside the entity’s own directory (Bir yol, varlığın kendi dizini dışındaki içeriği adlandırıyor).
Bir Recipe veya FeatureRecipe, bir sonraki bölümün açıkladığı gibi sabitlemeleri karşılaştırılırken bu şekilde okunur; bu nedenle okuma, push’tan sabitleme istenip istenmediğinden ve varlığın sabitlenecek bir şeyi olup olmadığından bağımsız olarak gerçekleşir. Dört türün her biri, paketi oluşturulmadan hemen önce de bu şekilde okunur, çünkü hangi dosyaları adlandırdığını söyleyen bu okumadır. Bir Aggregate ve bir kitaplık hiçbir dosya adlandırmaz ve bu şekilde okunmaz. Bir Plugin de hiçbir dosya adlandırmaz ve Bir Plugin’in yayımlanması bölümünün açıkladığı gibi, .wasm dosyasından önce türünün şemasına göre okunur.
Bir Plugin yayımlama
Bir Plugin, --plugin ile adı verilen .wasm dosyasıyla birlikte yayımlanır ve push, herhangi bir bayt yayımlanmadan veya kayıt defterine bağlanılmadan önce bu ikisini değerlendirir. --dry-run bunları tam olarak bir yayımlamanın yaptığı gibi değerlendirir.
Varlık önce türünün şemasına göre okunur; bir katalog yüklemesinin okuduğu gibi ve .wasm okunmadan önce. Bu nedenle anlamsal sürüm olmayan bir metadata.version (415148e gibi yalın bir commit) şemanın kendi koşulu altında, alan adı belirtilerek reddedilir; eksik bir spec.abiVersion gibi şemadan başka her sapma da öyle. Burada neyin anlamsal sürüm sayılacağını şemanın metadata.version için tanımladığı kendi deseni belirler; push kendine ait bir kural eklemez.
Ardından .wasm yüklenir ve varlıkla karşılaştırılır. Sunduğunu bildirdiği şey varlığın iddia ettiğiyle uyuşmalı, varlığın kaydettiği komut kümesi ve host fonksiyonları onunla eşleşmeli ve kendi derlemesi hakkında bildirdiği sürüm metadata.version ile aynı olmalıdır; bkz. A Plugin entity’s recorded version does not match the plugin (Bir Plugin varlığının kayıtlı sürümü plugin ile eşleşmiyor).
Commit edilmemiş değişiklikleri olan bir çalışma ağacından derlenmiş bir .wasm reddedilir. Böyle bir derleme, bildirdiği sürümün sonunda -dirty işaretini taşır: 1.0.0-dirty, 1.0.0-3-g1a2b3c4-dirty. Bu geçerli bir anlamsal sürümdür, ancak derlenen şeyi içermeyen bir commit’i adlandırır; dolayısıyla yayımlanan şeyi, yayımlandığı sürümden kimse yeniden derleyemez. Push bunu, sürümü ve çözümü belirterek reddeder: plugin’i, sürümün etiketinin adlandırdığı commit’in temiz bir checkout’undan derleyin, böylece doğrudan sürüm numarasını bildirsin (değişikliği yayımlamak için ise önce varlığın metadata.version değerini yeni sürüme ayarlayarak commit edin ve o commit’i etiketleyin); yeniden derlemenin bildirdiği sürümü varlığa kopyalamayın. 1.0.0-3-g1a2b3c4 gibi bir commit’ten derlenmiş geliştirme sürümü ve 1.0.0-rc.1 gibi bir ön sürüm her ikisi de yayımlanır. Ret şudur: A plugin was built from a working tree with uncommitted changes (Bir plugin, commit edilmemiş değişiklikleri olan bir çalışma ağacından derlendi).
Yayımlamadan önce sabitleme
Bir Recipe veya FeatureRecipe, okuduğu girdilerin sabitlemelerini — tam olarak yazılmış uzak bir source:, bir artifacts girdisinin içe aktardığı bir dosya, yanındaki bir source:’un dosyaları — yanındaki entity.lock dosyasında taşır ve bir push bu dosyayı varlıkla birlikte yayımlar. Sabitleme, yayımlamadan önce çalıştırdığınız bir adımdır: aggrega pin; ardından yazdığı kilidi commit edersiniz.
Bir push, kilidi bu sabitlemeleri kaydetmeyen bir varlığı reddeder. Push, paketi oluşturmadan önce sabitleme adımının varlık için ne kaydedeceğini hesaplar ve bunu yanındaki entity.lock ile karşılaştırır. Bir sabitleme eksikse veya kilit, bir girdinin artık eşleşmediği bir sabitleme tutuyorsa, push herhangi bir arşiv oluşturulmadan veya herhangi bir registry ile iletişime geçilmeden durur. Ret, varlığı ve bu tür her girdiyi — her biri bir remote source, bir imported file veya bir local source file — ve ne çalıştırılacağını belirtir: varlık üzerinde aggrega pin, az önce çalıştırdığınız push’ta --pin-sources ya da çalışma alanındaki her push için pin_sources_at_push. Bu, bir pull’un aynı kilit için verdiği retle aynıdır: An entity reads an input the lock beside it records no pin for (Bir varlık, yanındaki kilidin sabitleme kaydetmediği bir girdiyi okuyor); yalnızca çözümleri push’a özgüdür. Böylece bir push’un yayımladığı bir Recipe veya FeatureRecipe, paketinin içinde, yayımlandığı anda adımın kaydedeceği her sabitlemeyi kaydeden bir kilit taşır.
İki tür varlığın sabitlenecek bir şeyi yoktur ve bunlar dokunulmadan yayımlanır: uzak kaynak okumayan, dosya içe aktarmayan ve yerel kaynak belirtmeyen bir varlık ile uzak kaynak koordinatları bir şablondan doldurulan bir Recipe. Bu kaynak, ancak bir Release şablonu doldurduğunda bir artifact’ı belirtir; bu nedenle sabitlemesi her Release’in lockfile’ına aittir ve push varlığın yanında bir sabitleme istemez. Bir Component, bir Feature, bir kütüphane, bir Aggregate veya bir Plugin, kilidin kaydettiği hiçbir şeyi okumaz ve burada hiçbir zaman reddedilmez.
Uzak bir kaynağın sabitlemesini karşılaştırmak, aggrega pin’in yaptığı gibi kaynağı getirmek anlamına gelir; çünkü artık eşleşmeyen bir sabitleme yalnızca kaynağın şu anda sunduğu içerikle karşılaştırıldığında görülebilir. Bu nedenle böyle bir kaynağa sahip bir varlık üzerindeki push, registry’ye ulaşmadan önce kaynağın sunucusuna ulaşır. Karşılaştırma, bir Recipe veya FeatureRecipe’yi sabitleme adımının yaptığı gibi katalog üzerinden okur; bu yüzden kataloğun okumayı reddettiği bir varlık — örneğin türünün şemasını karşılamayan bir belge — burada kataloğun kendi gerekçesiyle reddedilir.
Hiçbir çalışma alanı bulunamadığında ve hiçbiri belirtilmediğinde, karşılaştırma için uzak bir kaynak getirecek bir push, aggrega pin gibi, kaynağı getirmeden önce reddedilir. Karşılaştırma, varlığın tam olarak yazdığı her uzak kaynağı, sabitleme adımının yaptığı gibi artifact önbelleğine getirir; hiçbir çalışma alanının bulunamadığı bir klasöre yazılan bir önbellek ise o klasörü bir çalışma alanına dönüştürürdü. Bu nedenle hiçbir şey bir kök belirtmediğinde ve hiçbir şey bir kök sabitlemediğinde — push’u çalıştırdığınız klasörden ya da mutlak bir yolla belirtilen bir varlık için varlığın kendi klasöründen — böyle bir kaynağa sahip bir Recipe veya FeatureRecipe push’u, bir dry run ve --pin-sources dahil, kaynak getirilmeden önce durur ve kaynağı, klasörü ve iki çıkış yolunu belirtir: çalışma alanınızı --workspace-root veya AGGREGA_WORKSPACE_ROOT ile belirtin ya da o klasöre workspace: bloğu taşıyan bir .aggrega-config.yaml verin. Karşılaştırma, yukarıdaki iki tür varlık için ve kaynağı yerel olan bir varlık için hiçbir şey getirmez; bu yüzden bunların her biri orada da başka her yerde olduğu gibi kilidiyle karşılaştırılır ve yayımlanır; diğer her tür ise bir kilide tabi tutulmaz ve bu nedenle reddedilmez. Yapılandırma, bunun geçerli olduğu diğer komutları listeler.
aggrega push --pin-sources aynı adımı sizin için önce çalıştırır. Adım paket oluşturulmadan önce çalışır; böylece yazdığı kilit yayımlanan artifact’ın içindedir ve yayımlanan digest onu kapsar; ayrıca varlığı değerlendiren diğer her retten önce çalışır, böylece değerlendirilen şey varlığın sabitlenmiş halidir. Yalnızca yukarıdaki dizin kuralı önce gelir, çünkü adım dizinin tuttuğu tek kilidi yazar. Adım, aggrega pin’in yazdığı baytların aynısını yazar; bu yüzden yukarıdaki ret o çalıştırmada hiçbir zaman tetiklenmez: adımın az önce yazdığı kilit, retin karşılaştıracağı şeyi tam olarak kaydeder. pin_sources_at_push çalışma alanı anahtarı bunu her push’un varsayılanı yapar; --pin-sources=false ise adımı tek bir çalıştırma için atlar ve bu da reddi geri getirir. Adım varlığın yanına yazar; bu, yazılabilir bir konum gerektirir — ve bir push’un her zaman böyle bir konumu vardır, çünkü belirttiğiniz belgeyi yayımlar.
--dry-run, yayımlamanın vereceği yanıtı verir. --pin-sources olmadan, sabitlenmemiş bir varlığı tam olarak yayımlamanın yaptığı gibi reddeder; böylece bir paket raporlayan bir dry run, bu retin geçirmeye izin vereceği bir çalıştırmadır. --pin-sources ile adım dry run olarak sabitler: yazacağı kilidi yazdırır ve hiçbir şey yazmaz; ardından gelen paket bilgileri dizini o kilit olmadan, mevcut haliyle tanımlar — bu yüzden digest, kilit olmadan yapılan bir yayımlamanın digest’idir ve kilidin yeni olacağı durumda boyut ve, başka hiçbir şey belirtmeyen bir varlık için, medya türü de öyledir. Ret tetiklenmez, çünkü yayımlama önce sabitlemiş olurdu.
En iyi uygulama: daha önce yayımladığınız bir sürümdeki değişiklik yeni bir sürüme gider, ardından sabitleme yapılır. Varlığı yeni bir sürüm dizinine kopyalayın, değişikliği orada yapın, sabitleyin ve onu yayımlayın. Ürünün bunun zorladığı yarısı bir sonraki bölümdedir: zaten yayımlanmış bir sürümde farklı içerik yayımlamak reddedilir. Diğer yarısı — zaten yayımlanmış bir sürümü kendi çalışma alanınızda düzenledikten sonra yeniden sabitlememek — sizin korumanıza kalmıştır; yerel olarak hiçbir şey bunu reddetmez, çünkü yeniden sabitleme, yayımlamadığınız bir varlık için meşrudur.
Kayıt defteri, etiket ve içerik adresleme
Hedef kayıt defteri, verildiğinde --registry <ref>, aksi halde çalışma alanının default_registry değeridir (varsayılan olarak hub.aggrega.ai). Etiket, varlığın metadata.version değeridir ve depo yolu varlığın türünden ve adından türetilir; bu nedenle yayımlanan bir sürümün nereye yerleşeceği, yayımlandığı dizine bağlı değildir.
Bir default_registry bir depo yolu taşıyabilir ve onun üzerinden yapılan bir yayın o yolun altına yerleşir. default_registry: ghcr.io/acme ile, 1.0.0 sürümündeki Component core/api-server, ghcr.io/acme/component/core/api-server:1.0.0 adresinde yayımlanır; bu, aynı varsayılan üzerinden yapılan bir çekme işleminin onu getirdiği yerdir, dolayısıyla burada eklenen imza o çekme işleminin bulduğu imzadır. --registry bir ana makine adlandırır ve onun yönlendirdiği bir yayın, yol olmadan o ana makineye yerleşir. Hedef hangi yolla adlandırılırsa adlandırılsın, uygulanan imzalama gereksinimi ve imzalama yapılandırması, hedefin ana makinesi için tutulanlardır: bir yol hiçbir zaman farklı bir ilke seçmez. Bir yolun yazımı bir kayıt defteri ana makinesinin nasıl yazıldığı bölümünde açıklanır.
Manifest, yayımlanan baytların özetini adlandırır; kilit dosyası ise bu baytların taşıdığı şeyin özetini kaydeder. Bir push işleminin yazdığı OCI manifest’i, yayımlanan belgenin veya arşivin özetini adlandırır ve aggrega pull bununla eşleşmeyen bir indirmeyi reddeder; böylece yayımlama ile çekme arasında değiştirilen baytlar yakalanır. Bir çekme işleminin yazdığı kilit dosyası varlığı farklı bir özetle kaydeder: içeriğinin özeti; yani her dosyanın yolu ve baytları; arşivin nasıl sıkıştırıldığı veya dosyalarının hangi izin bitlerine sahip olduğu hakkında hiçbir şey içermez. Bu, yazarın kendi çalışma alanındaki bir çekme işleminin aynı varlık için katalog dizininde kaydettiği özettir; dolayısıyla bir yazar ve tek bir yayının her tüketicisi aynı değeri kaydeder ve her iki taraftaki bir derleme artık onunla eşleşmeyen içeriği reddeder. İki özet farklı soruları yanıtlar: manifest’inki indirmeyi denetler, kilit dosyasınınki ise varlığın kimliğidir.
Mevcut bir sürümün üzerine yayımlama
Herhangi bir bayt yüklenmeden önce aggrega push, hedef kayıt defterinin yazmak üzere olduğu başvuruda halihazırda ne tuttuğunu çözümler ve bunu önündeki içerikle karşılaştırır. Üç sonuç vardır:
- Orada henüz hiçbir şey yayımlanmamıştır — push devam eder ve normal şekilde yayımlar.
- Aynı içerik — hiçbir şey yüklenmez ve komut sürümü zaten yayımlanmış olarak bildirir; böylece tekrarlanan veya yeniden denenen bir push hata sayılmaz. Daha önceki bir push’un eklemeden bıraktığı şey — imza veya yayım tarihi — Daha önceki bir push’un yarım bıraktığı bir yayımı tamamlama bölümünde açıklandığı gibi şimdi eklenir.
- Farklı içerik — push, zaten yayımlanmış olan özeti ve kendisinin yazacağı özeti belirterek durur. Bunu zorla geçirecek bir bayrak yoktur.
Bu nedenle zaten yayımlanmış bir sürüm, altında yayımlanan baytları göstermeye devam eder. Değişmiş içerik yeni bir metadata.version altında yayımlanır; aggrega lint --pre-publish bir sonraki soruyu — o sürümün ne kadar ilerlemesi gerektiğini — değişikliği önceden yayımlanmış sürüme göre sınıflandırarak yanıtlar.
--dry-run, bir push’un yazacağı özeti, onu yazacağı başvurunun yanında yazdırır:
aggrega push (dry-run): <reference>:<tag> (<digest>)Bu, push’un kendisinin zaten yayımlanmış olanla karşılaştırdığı, yalnızca içerikten aynı şekilde hesaplanan özettir ve yazdırılması hiçbir kayıt defteriyle iletişim kurmaz. Böylece önünüzdeki içerik, herhangi bir şey push edilmeden önce bir sürümün yayımlandığı özetle karşılaştırılabilir: yayımlanmış bir sürümde farklıysalar push reddedilir. --pin-sources ile bu, Yayımlamadan önce sabitleme bölümünde açıklandığı gibi dizinin mevcut halinin özetidir.
Daha önceki bir push’un yarım bıraktığı bir yayımı tamamlama
Bir push önce içeriği yazar, imzayı ve yayım tarihini sonra ekler; bu nedenle bu eklemelerden birinde — yeniden denemelerinden sonra — başarısız olan bir push, içeriği o ek olmadan yayımlanmış bırakır ve ekleyemediği şeyi belirterek sıfırdan farklı bir kodla çıkar. Aynı push’u yeniden çalıştırmak o yayımı tamamlar. Push içeriği zaten yayımlanmış bulur, Already published: satırını yazdırır, hiçbir şey yüklemez ve sürümde hâlâ eksik olanı, her birini ilk yayımın onun için yazdırdığı satırla ekler:
- İmza, bu push imzalıyorsa. Sürüm bu yayıma ait sayılan bir imza taşımıyorsa eklenir. Yapılandırmanız hedefin ana bilgisayarı için bir güven politikası sabitliyorsa — bir
public_keyveyatrusted_identitiesya dahub.aggrega.aiiçin yerleşik temel politika — bir imza o politika altında doğrulandığında sayılır; böylece politikanın kabul etmediği bir imza asla yayımın kendi imzası olarak alınmaz. Politika ikisini de sabitlemiyorsa hiçbir imza ona karşı doğrulanamaz; bu nedenle sürümün taşıdığı her imza sayılır ve push yalnızca hiç imza taşımayan bir sürümü imzalar; orada doğrulamaya göre karar vermek her çalıştırmada yeni bir imza eklerdi. - Yayım tarihi, tarih kuralı bir tarih gerektiriyorsa — az önce eklenen imzadan ya da zaten sayılmış olandan okunur — ve sürüm hiç published-at referrer’ı taşımıyorsa. İmzalamayan bir push, sürüme sonradan hangi imzalar eklenmiş olursa olsun, imzasız bir yayımın gerektirdiği gibi bir tarih gerektirir. Belirttiği tarih bu push’un kendi saatidir: yayımın tamamlandığı zaman; bu, içeriğin ilk ulaştığı zamandan sonradır, çünkü kayıt defterinin sunduğu hiçbir şey o anı kaydetmez.
Zaten tamamlanmış bir yayıma, push kaç kez tekrarlanırsa tekrarlansın hiçbir şey eklenmez. Push herhangi bir şey eklemeden önce sürümün hangi imzaları ve tarihleri taşıdığını okur ve borçlu olduğu imzayı oluşturur. Yanıtlayamadığı bir soru — okuyamadığı bir listeleme veya imza ya da güven kökü elde edilemediği için değerlendiremediği bir imza — ve oluşturamadığı bir imza, sürümün hiç imza taşımadığı anlamına alınmak yerine, her biri hiçbir şey eklenmeden sıfırdan farklı bir kodla çıkışa yol açar.
Kayıt defteri bir yazmayı başarısız kıldığında
Bir push, kayıt defterine adım adım yazar: içerik — bir Plugin için varlık ve onun .wasm dosyası —, ardından onu adlandıran manifest, ardından sürüm etiketi, ardından imza ve onun yanındaki yayın tarihi. Yazan her adım, sonraki bir denemenin başarılı olabileceği bir şekilde başarısız olduğunda yeniden denenir: kayıt defteri bir sunucu hatasıyla (Retry-After taşıyan bir 503 dışında herhangi bir 5xx durumu) ya da 408 Request Timeout ile yanıt verir veya bağlantı zaman aşımına uğrar, sıfırlanır ya da bir yanıtın ortasında sona erer. Bir adım en fazla üç kez denenir; ikinci denemeden önce yarım saniye, üçüncüden önce bir saniye beklenir.
Yavaşlamayı isteyen bir kayıt defteri beklenir ve bu, o denemelerin hiçbirini harcamaz. 429 Too Many Requests ya da Retry-After taşıyan bir 503 alındığında, o kayıt defterine yapılan her istek — yazma kadar okuma da — kayıt defterinin istediği kadar bekler ve sonra yeniden gönderilir; içeriği reddedilen bir adım yeni bir yükleme olarak baştan başlar. Sabit bir deneme sayısı yoktur; bu, kayıt defteri beş dakika boyunca “yavaşla” dışında hiçbir yanıt vermeyene kadar sürer. Beklemeyi ve onu sona erdiren reddi Yavaşlamayı isteyen bir kayıt defteri açıklar.
Her deneme, aynı baytların yeni bir yüklemesidir; başarısız olan isteğin yeniden gönderilmesi asla değildir. Bir yüklemenin gövdesini zaten almış olan bir kayıt defteri aynı isteği ikinci kez reddedebilir ve kabul ettiği şey yeni bir yüklemedir. Kayıt defterinin zaten tuttuğu içerik yüklenmiş sayılır ve yeniden denenen bir adım ilk denemenin yazacağı şeyi yazar; bu nedenle yerine ulaşmış ancak yanıtı kaybolmuş bir deneme hiçbir şeyi iki kez yazmaz: manifest özetini korur ve sürüm tek bir imza ile tek bir yayın tarihi taşır.
Diğer her hata adımı hemen sonlandırır: reddedilen bir kimlik bilgisi (401, 403 ya da kayıt defteri için saklanmış bir kimlik bilgisinin olmaması), kayıt defterinin verdiği diğer herhangi bir yanıt, hiç ulaşılamayan bir kayıt defteri veya sizin kestiğiniz bir push. Son denemesinden sonra hâlâ başarısız olan bir adım komutu başarısız kılar ve hata, adımı adlandırır — içerik, manifest, etiket, imza ya da yayın tarihi. Önceki adımların yayımladığı şey yayımlanmış olarak kalır; bunun sürüm için ne anlama geldiğini İmzalama ve Yayın tarihi açıklar.
Bu hatalar için yalnızca yazmalar yeniden denenir. Herhangi bir şey yüklenmeden önce kayıt defterinin sürümde zaten tuttuğu şeyin okunması yeniden denenmez; yine de her istek gibi, yavaşlamayı isteyen bir kayıt defterinin istediği kadar bekler.
İmzalama
aggrega push, yayımlarken yapıtı imzalayabilir ve imzayı bir OCI referrer’ı olarak ekleyebilir: yapıtın değişmez manifest özetine bağlı bir Sigstore (cosign uyumlu) paketi. İmza kardeş bir manifesttir, bu nedenle imzalama yayımlanmış baytları hiçbir zaman yeniden göndermez veya değiştirmez. Referrer paketini signature.json olarak adlandırır, bu nedenle referrer’ı özetiyle çeken genel bir OCI istemcisi paketi bu dosyaya yazar.
İmzalama göndermeden önce imzalama biçimindedir: manifest özeti yayımlamadan önce bilinir, bu nedenle aggrega push imzalayıcıyı oluşturur ve özeti herhangi bir bayt kayıt defterine ulaşmadan önce imzalar. İmzalayıcı oluşturulamazsa veya imzalama başarısız olursa, gönderme herhangi bir şey yüklenmeden önce reddedilir; hiçbir şey yayımlanmaz, bu nedenle başarısız bir imzalama kayıt defterinde hiçbir zaman imzasız içerik bırakmaz. Reddetmeden önce, geçici olarak başarısız olan bir imzalama çağrısı (bir kayıt defteri yazmasının yeniden denendiği herhangi bir hata ya da anahtarsız sertifika yetkilisinin kimlik belirtecini işleyemediğini bildirmesi) aynı bekleme süreleriyle en fazla üç deneme olacak şekilde yeniden denenir. Anahtarsız bir imzalama çağrısının içinde, sertifika yetkilisinin, şeffaflık günlüğünün veya zaman damgası yetkilisinin 429 Too Many Requests ya da bir sunucu hatasıyla yanıtladığı bir istek, aggrega sign belgesinde açıklandığı gibi önce o hizmete yeniden gönderilir.
İmza içerik yerleştikten sonra eklenir, bu nedenle başarısız bir ekleme içeriği imzasız olarak yayımlanmış bırakır. Ekleme bir yazmadır ve Kayıt defteri bir yazmayı başarısız kıldığında bölümünün anlattığı gibi yeniden denenir. Yine de başarısız olursa komut, ekleyemediği imzayı belirterek sıfırdan farklı bir kodla çıkar ve kayıt defteri imza gerektiren bir tüketici, bir imza eklenene kadar sürümü reddeder. Aynı gönderimi yeniden çalıştırmak, Önceki bir gönderimin yarım bıraktığı yayını tamamlama bölümünün anlattığı gibi imzayı ekler; aggrega sign ise yayımlanmış sürüme referansla bir imza ekler.
Hedef kayıt defterinin kendi signing bloğu required: true ayarladığında ya da üst düzey signing bloğu bunu her kayıt defteri için yaptığında bir yayın imza gerektirir — her biri, kinds alanı tür listeliyorsa listelediği türlerle sınırlıdır. Böyle bir yayın varsayılan olarak imzalanır ve --sign imzalamayı açıkça ister. İmza gerektiğinde imzasız içerik göndermek için bir bayrak yoktur; bu gönderim her zaman durur.
İki imzalama kipi:
- Anahtarsız (varsayılan): kısa ömürlü bir Fulcio sertifikasıyla bir OIDC kimliğine bağlanan ve Rekor şeffaflık günlüğüne kaydedilen geçici bir anahtar. Fulcio ve Rekor varsayılan olarak kamu yararına sunulan Sigstore örneklerini kullanır (
https://fulcio.sigstore.dev,https://rekor.sigstore.dev). Anahtarsız güvenilir zaman damgası Rekor’un şeffaflık günlüğüne dahil edilmesinden gelir; ayrı bir RFC3161 zaman damgası yetkilisi isteğe bağlıdır; birini etkinleştirmek için--timestamp-urlile tam bir uç nokta verin. Etkileşimli bir terminalde anahtarsız imzalama hiçbir bayrak gerektirmez: CLI, kısa ömürlü bir OIDC kimlik belirteci almak için bir tarayıcı açar. GitHub Actions üzerinde de hiçbir bayrak gerekmez: CLI, iş akışı OIDC belirtecini çalıştırıcının ortam uç noktasından otomatik olarak üretir. Diğer etkileşimsiz / CI kullanımlarındaAGGREGA_IDENTITY_TOKEN(veyaSIGSTORE_ID_TOKEN) dışa aktarın ya da--identity-tokenverin; sağlanan belirteç, ortam uç noktası ve terminal olmadığında gönderim reddedilir. CI belirteç modeli için environment-variables.md sayfasına bakın. - Anahtarlı (
--key): çevrimdışı tutulan bir ECDSA P-256 anahtarı (cosign uyumlu PEM); OIDC kimlik sağlayıcısı olmayan ortamlar için kaçış yolu. Hiçbir kimlik sağlayıcısına, sertifika yetkilisine veya şeffaflık günlüğüne bağlanılmaz.
Anahtarsız hizmet URL’leri ve anahtarlı kipin anahtar yolu, .aggrega-config.yaml içinde bir signing: bloğu altında da (genel ve kayıt defterine özgü) ayarlanabilir; bayrak yapılandırmayı, yapılandırma da kamu yararına sunulan varsayılanı geçersiz kılar. OIDC kimlik belirteci hiçbir zaman bir yapılandırma alanı değildir (kısa ömürlü bir gizli bilgidir) ve özel anahtar hiçbir zaman yapılandırmada satır içi yer almaz; yalnızca ona giden bir yol yer alır.
Yayın tarihi
Manifest’in oluşturulma zamanı sabitlenir; böylece bir manifest özeti yalnızca neyin yayımlandığına bağlıdır, hiçbir zaman ne zaman yayımlandığına bağlı değildir. Bir sürümün yayımlandığı tarih bunun yerine sürümün yanında taşınır ve nereden geldiği imzaya bağlıdır:
- Anahtarsız bir imza bu tarihi zaten taşır. İmzanın şeffaflık günlüğü kaydı, günlüğün imzayı ne zaman bütünleştirdiğini kaydeder ve günlüğün imzalı taahhüdü bu zamanı doğrular.
aggrega pushbaşka bir şey yazmaz. - Anahtarlı bir imza ya da imzasızlık hiçbir zaman bilgisi taşımaz. Bu nedenle varlık ve varsa imza yerine ulaştıktan sonra
aggrega push, manifest’e küçük bir published-at referrer’ı ekler — genel bir OCI istemcisi içinpublished-at.jsonolarak adlandırılır — ve bu referrer, yayımlayan makinenin kendi saatinden okunan, UTC’de saniye hassasiyetinde tek bir RFC 3339 zaman damgası içerir. İmzalı değildir: yayımlayanın beyanıdır ve okuyucu onu bu şekilde kaydeder.Publication date attached:satırı bunu bildirir.
Bir imza gibi published-at referrer’ı da yayımlanmış manifest’e geri işaret eden kardeş bir manifest’tir; bu nedenle hiçbir özeti değiştirmez, hiçbir etiketi değiştirmez ve mevcut bir sürümün üzerine yayımlama denetimi bundan etkilenmez. Aynı içeriğin tekrarlanan bir push’u, yalnızca tarih taşımayan bir sürüme kendi saatini belirterek bir tarih ekler — bkz. Daha önceki bir push’un yarım bıraktığı bir yayını tamamlama. Tarih, ekleme ilk denenmeden önce saatten bir kez okunur; böylece yeniden denenen bir ekleme — bkz. Kayıt defteri bir yazmayı başarısız kıldığında — aynı tarihi belirtir. İçeriğini yayımlayan ancak bu denemelerden sonra tarihi ekleyemeyen bir push sıfırdan farklı bir kodla çıkar ve neyin eklenmediğini belirtir. aggrega registry update, her sürümün tarihini, iki kaynaktan hangisinden geldiğiyle birlikte kaydeder.
Çevrimdışı
Yayımlama bir ağ gidiş-dönüşüdür ve böyle olmayan bir biçimi yoktur; bu nedenle çevrimdışı duruşta — bir yapılandırma dosyasındaki üst düzey offline anahtarı, AGGREGA_OFFLINE veya --offline — aggrega push, varlığınızı okumadan önce reddeder. Ret, duruşu bu üçünden hangisinin ayarladığını belirtir; bu da, duruşu okuyucunun yazdığı herhangi bir şey yerine bir projenin commit edilmiş yapılandırması açtığında okuyucunun ihtiyaç duyduğu bilgidir.
--dry-run istisnadır ve yaptığı iş nedeniyle istisnadır: paketi hesaplar, yayımlayacağı referansı ve o yayımlamanın ortaya çıkaracağı digest’i yazdırır ve registry ile hiçbir zaman iletişim kurmaz. Bu, onu duruşla bir çatışma değil, yayımlamanın çevrimdışı için güvenli biçimi yapar ve bu duruş altında da çalışmaya devam eder — tek bir çekinceyle. Uzak source: değeri tam olarak yazılmış bir Recipe veya FeatureRecipe’te, sabitlemesini karşılaştırmak için o kaynak getirilir; çevrimdışı duruş altında bu getirme kendi ifadesiyle reddedilir, bu nedenle böyle bir varlık üzerindeki bir deneme çalıştırması, kefil olamayacağı bir paketi raporlamak yerine orada durur.
Yapılandırması çevrimdışı olan bir çalışma alanından tek bir çalıştırma için yayımlamak üzere --offline=false geçirin.
Ortam değişkenleri
İmzalama girdileri ve hedef kayıt defteri ortam üzerinden sağlanabilir; bu değerler .aggrega-config.yaml dosyasını geçersiz kılar, ancak bir bayrak yine de önceliklidir:
AGGREGA_IDENTITY_TOKEN— anahtarsız OIDC kimlik belirteci (--identity-tokenbayrağının ortam değişkeni karşılığı).SIGSTORE_ID_TOKEN, sigstore ekosistemiyle birlikte çalışabilirlik için bir takma ad olarak kabul edilir ve önceliğiAGGREGA_IDENTITY_TOKENile ortamdaki GitHub Actions uç noktasının altındadır. Belirteç hiçbir zaman bir yapılandırma alanı değildir.AGGREGA_SIGNING_FULCIO_URL,AGGREGA_SIGNING_REKOR_URL,AGGREGA_SIGNING_TIMESTAMP_URL— anahtarsız hizmet URL’leri.AGGREGA_SIGNING_KEY_PATH— anahtarlı imzalama için bir PEM anahtarını gösteren yol işaretçisi (hiçbir zaman anahtar materyalinin kendisi değildir).AGGREGA_DEFAULT_REGISTRY—--registrybelirtilmediğinde kullanılan hedef kayıt defteri.
Öncelik sırası bayrak > ortam > yapılandırma > varsayılan şeklindedir. Tam liste ve öncelik modeli için environment-variables.md sayfasına bakın.
Kimlik doğrulama
aggrega push, kayıt defteri kimlik bilgilerini aggrega pull gibi okur — Docker kimlik bilgisi yapılandırmasından ve onun adlandırdığı kimlik bilgisi yardımcılarından. Özel bir kayıt defterine göndermeden önce başka hiçbir araç gerektirmeyen aggrega login <registry> komutunu ya da docker login <registry> komutunu çalıştırın. Bu yapılandırmanın nereden okunduğu için aggrega-pull.md sayfasına bakın.
Ayrıca bakınız
- ./aggrega-sign.md — önceden yayımlanmış bir yapıtı sonradan imzalar (
--signseçeneğinin yayımlama sonrası karşılığı). - ./aggrega-lint.md — bir push işleminden önce gelmesi gereken yayımlama denetimi (
--pre-publish). - ./aggrega-pull.md —
pushkomutunun yayımladığını çözümleyen ve sabitleyen tüketen taraf. - ./aggrega-serve.md — arka plan hizmeti bu aynı yayımlamayı
aggrega/publishEntityüzerinden sunar; böylece bir düzenleyici oturumdan ayrılmadan çalıştırabilir. Yalnızca bir istek onu adlandırdığında çalışır ve referansı, yayımlanan özeti — deneme çalıştırmasında--dry-runseçeneğinin yazdırdığı özeti —, çağrının ne kadar ilerlediğini ve bu komutun uyardığı girdileriwindowsUnusableEntriesolarak döndürür. - ./aggrega-mcp.md — bir asistanın çağırabileceği
publish-entityaracı olarak aynı yetenek; bu girdileriwindows_unusable_entriesolarak döndürür. Buna izin vermeden önce o sayfanın bu konuda söylediklerini okuyun. - ../../architecture/13-catalog-and-registry.md — katalog, kayıt defteri ve OCI ortam türü modeli.
Kullanım
aggrega push <entity-path> [flags]Açıklama
Publish a single catalog entity to an OCI registry, where other workspacesresolve 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 pathlowercased; a Recipe or FeatureRecipe carries its spec.capability, and a Pluginits metadata.pluginType, as a segment between <kind> and <metadata.name>. Thetag is the entity's own metadata.version. Run "aggrega push --list-kinds" forthe kinds this binary publishes, one per line and nothing else, so a script canread it directly. Release and Manifest are deployment-side inputs rather thancatalog artifacts and are refused.
Every kind has a directory of its own except Aggregate, Release and Manifest: anentity 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 itbefore it is bundled, and one that read refuses is refused here for the samereason: a document that fails its kind's schema, a path naming content outsidethe entity's own directory, which would not travel with the entity, or a schemaa 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 ametadata.version that is not a semantic version is refused. Its .wasm must thenagree with the entity on what the plugin offers and on its version, and a .wasmwhose 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 buildfrom uncommitted changes are both cleared by building the plugin from a cleancheckout of the commit its release tag names, never by copying the version itreports into the entity. A development version such as 1.0.0-3-g1a2b3c4, builtfrom 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 namesbeside 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 Featureimports — and nothing else in its directory. An entity that names nothingpublishes as its document, unchanged; one that names a file publishes as agzipped archive of the document and those files. A directory it names travelswith 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 linkamong those files is refused rather than followed. A local source written as atemplate names no one directory until a Release fills it in, so an entity withone 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 Windowscannot 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 apart ending in a full stop or a space. On Windows, aggrega refuses to unpacksuch a file, so a Windows workspace cannot use the version. The warning iswritten to standard error on every platform, one line per file, the entitydocument'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 entitythat names nothing publishes as its document alone and is never warned about.
Each file travels with mode 0644, whatever its permission bits — the executebit included — in the checkout it is published from. The OCI manifest names thedigest of the published bytes, so "aggrega pull" refuses a download that doesnot match it. The lockfile a pull writes records the entity by the digest of itscontent — each file's path and its bytes — which is the digest a pull in theauthor's own workspace records for the same entity in its catalog directory, soa build on either side refuses content that no longer matches.
Push signs before it publishes: where signing applies, the signature is madeover the manifest digest before any bytes reach the registry, so a failedsigning refuses the push rather than leaving unsigned content published.
The manifest's creation time is pinned, so the digest depends only on what ispublished and never on when. Push states when it published beside the manifestinstead, as a small published-at attachment carrying this machine's clock, inUTC to the second — unless the signature it attached already carries a time atransparency log attests, as a keyless signature does. So a keyed or unsignedpublication writes one, and a keyless one does not. The attachment moves nodigest and changes no tag. "aggrega registry update" records the date, withwhich 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.lockbeside 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 ismissing 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, tohave push run that same step first, so the lock it writes is part of what ispublished; --pin-sources=false skips it for one run.Bayraklar
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--dry-run | false | Paketi hesaplar ve kayıt defteriyle iletişim kurmadan, önerilen |
--entity | — | Yayımlanacak varlık YAML dosyasının yolu (alternatif olarak konumsal argüman olarak verilebilir) |
--fulcio-url | — | Anahtarsız imzalama için Fulcio sertifika yetkilisi URL’si. Belirtilmediğinde kamuya açık Fulcio örneği kullanılır. |
--identity-token | — | Anahtarsız imzalama için OIDC kimlik belirteci. Etkileşimli bir terminalde (bir tarayıcı akışı belirteci edinir) ve GitHub Actions üzerinde (iş akışının OIDC belirteci otomatik olarak üretilir) isteğe bağlıdır; diğer etkileşimsiz/CI kullanımlarında zorunludur ve bu durumlarda bunun yerine AGGREGA_IDENTITY_TOKEN veya SIGSTORE_ID_TOKEN olarak dışa aktarılabilir. |
--key | — | Çevrimdışı anahtarlı imzalama için elde tutulan ECDSA P-256 özel anahtar PEM dosyasının yolu. Belirtilmediğinde anahtarsız imzalama kullanılır. |
--list-kinds | false | Yayımlanabilecek her varlık türünü listeler, ardından hiçbir şey yayımlamadan çıkar. Çıktı makine tarafından okunabilir ve biçimi kararlıdır: satır başına bir tür, sıralı biçimde ve başka hiçbir şey olmadan. |
--pin-sources | false | Varlığı paketlemeden önce varlık yazarının sabitleme adımını varlık üzerinde çalıştırır; böylece kilidi sabitlemelerini kaydetmeyen bir varlığı reddetmek yerine, adımın varlığın yanına yazdığı entity.lock yayımlanan içeriğin parçası olur. aggrega pin ile aynı adımdır ve aynı baytları yazar. Varlığın yanına yazdığı için yalnızca varlığın yazılabilir bir konumu olduğunda çalışır: okunduğu bir dizindeki bir belge — bir push işleminde bu her zaman vardır, çünkü adlandırdığınız varlık belgesini yayımlar. Çalışma alanının pin_sources_at_push ayarını her iki yönde de geçersiz kılar: ayar ne derse desin, —pin-sources bu çalıştırma için sabitler, —pin-sources=false ise sabitlemez |
--plugin | — | Bir Plugin varlığı için yerel .wasm yapıtının yolu. Bir Plugin yayımlanırken zorunludur: publish, .wasm yapıtını gönderir, içerik özetini hesaplar ve varlığı gönderir. |
--registry | — | Hedef kayıt defteri ana bilgisayarı (çalışma alanının default_registry değerini geçersiz kılar) |
--rekor-url | — | Anahtarsız imzalama için Rekor şeffaflık günlüğü URL’si. Belirtilmediğinde kamuya açık Rekor örneği kullanılır. |
--sign | false | Yayımlanan yapıtı imzalar ve imzayı bir OCI referrer olarak ekler. Belirtilmediğinde imzalama, hedef kayıt defterinin ilkesini izler. |
--timestamp-url | — | Anahtarsız imzalama için isteğe bağlı RFC3161 zaman damgası yetkilisi URL’si. |