İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

aggrega pull

aggrega pull, bir Release’in tüm bağımlılıklarını çözümler ve her bağımlılığı tam bir sürüme ve içerik özetine sabitleyen bir kilit dosyası yazar. Ardından çalıştırılan bir aggrega build, kilit dosyasının sabitlediklerini kullanır, bunları doğrular ve ihtiyaç duyduğu ancak orada sabitlenmemiş olan her şeyi adlandırarak durur; böylece derlemeler yeniden üretilebilir olur ve çevrimdışı çalışabilir.

Bir derlemenin tükettiği her şey bu tek anda sabitlenir. Katalog varlıkları, bir Recipe’in bir sağlayıcıyı yönlendirdiği kaynak yapıtlar ve bir sağlayıcının işleme sırasında istediği uzak belgeler aynı komutla çözümlenir ve aynı kilit dosyası yazımında kaydedilir. Ağa erişen adım aggrega pull’dur; build ağa erişmez. Kuralın tamamı budur ve bu sayfanın geri kalanı bundan çıkan sonuçlardır.

Ne yapar

aggrega pull, üç tür bağımlılığı tek geçişte çözümler:

  • Katalog varlıkları — Release’in başvurduğu Components, Features, Recipes, FeatureRecipes, şema ve eşleme kütüphaneleri ile Wasm eklentileri; geçişli olarak (extends:, implements:, aggregate:, Feature ekleri ve kütüphane $import: / $ref: noktaları üzerinden) çözümlenir ve yerelde yoksa kayıt defterinden getirilir.
  • Kaynak yapıtlar — tek bir Recipe’in veya FeatureRecipe’in bir sağlayıcıyı yönlendirdiği uzak source:: bir Helm chart’ı (OCI veya klasik HTTPS) ya da HTTPS üzerinden bir Compose parçası. Her biri getirilir, önbelleğe alınır ve sabitlenir.
  • Harici girdiler — bir sağlayıcının işleme sırasında ana sistemden istediği uzak belgeler; örneğin bir chart’ın values.schema.json dosyasında bir URL’yi gösteren bir $ref. Her biri getirilir, içerik özeti altında saklanır ve sabitlenir.

Üçünden ikisi sizin yazdığınız belgelerden okunur. Üçüncüsü öyle değildir: harici girdiler Release işlenerek bulunur; bu komutun bir Release işlemesinin nedeni budur. Komutu çalıştırmak için bunların hiçbiri gerekmez — Çözümlemenin harici girdileri nasıl bulduğu bölümü bunu, işlemenin maliyeti, tamamlanamadığında ne olduğu ve kendi kilit dosyasını dolduran bir derlemenin bununla ilişkisiyle birlikte eksiksiz anlatır.

Kayıt defteri belirtilmeden adlandırılan bir katalog varlığı, çalışma alanının default_registry değeri üzerinden getirilir ve bu varsayılanın taşıdığı depo yolu, varlığın getirildiği yerdir. default_registry: ghcr.io/acme ile core/api-server, ghcr.io/acme/component/core/api-server adresinden getirilir — aggrega push onu aynı varsayılan üzerinden oraya yayımlar — ve imzası da orada aranır. Yol yalnızca konumdur: bir çekmenin gerektirdiği imza, güvendiği anahtarlar ve kimlikler ile sunduğu kimlik bilgisi ana makine için tutulanlardır; dolayısıyla ghcr.io için olan registries girdisi o ana makinedeki her yolu yönetir. Kilit dosyası böyle bir varlığı, yalnızca bir ana makineden getirilen bir varlığı kaydettiği gibi kimliği, sürümü ve özetleriyle kaydeder. Bir yolun yazımı bir kayıt defteri ana makinesinin nasıl yazıldığı bölümünde açıklanır.

Sonucu, Release’in yanına <release-stem>.lock olarak yazar. Kabul-veya-ret kararı döndüren bir eklenti ekleyen bir çalışma alanı, o dizinde ikinci bir dosya da alır — eklenti güven kaydı.

Sabitlemesi istenen bir çekme, bir tür dosya daha yazar. Katalog dizinlerinizde bir yapıt dosyasını içe aktaran, tam olarak yazdığınız uzak bir source: değerini gösteren veya yanındaki bir source: değerini okuyan her Recipe ve FeatureRecipe’in yanında, o içeriğin hangi özete karşılık geldiğini kaydeden bir entity.lock bulunur. Bunu kaydetmek varlık yazarının adımıdır, aggrega pin, ve varsayılan olarak bir çekme bunu yapmaz: bu tür her varlığın kilidini adımın kaydedeceği değerle karşılaştırır ve bir sabitleme eksik olduğunda durur. aggrega pull --pin-sources veya pin_sources_at_pull: true ayarlayan bir çalışma alanı bunun yerine adımı çalıştırır — bu durumda bir çekmenin etkisi Release’in bulunduğu dizinin ötesine uzanır, ancak yazdığınız varlık dosyalarına asla yazılmaz. Varlık kilidi bu dosyayı açıklar; Bir çekmenin ne yazacağını önizleme ise hiçbir şey değişmeden önce çalışma alanınız için tüm kümeyi gösterir.

Bir başvuru hiçbir şeye çözümlenmediği için reddedilen bir çekme, nerede çalışırsa çalışsın yerel varlıkların nereden okunduğunu söyler. Ret, çalışma alanının yerel varlıkları okuduğu dizinlere ve varlığın okunması için neyin değiştirilmesi gerektiğine dair kendi açıklamasını taşır — Yerel varlıkların okunduğu yer notunun gösterdiği gibi — ve bunu bu komuttan, bağımlılıklarını önce çözümleyen bir derlemeden, aggrega mcp aracının çekme aracından ve bir düzenleyicinin bağımlılık çözümlemesinden aynı şekilde taşır; çünkü hepsinin çalıştırdığı çözümleme bu açıklamayı oluşturur. Çekme aracının reddi, bir terminalin reddin başında kısa kodu yazdırdığı gibi, durumun kısa kodunu ve açıklayıcı kodunu da adlandırır. Bu dizinlerde bir Aggrega apiVersion’ı bildiren — girintisiz olarak apiVersion: ile ve aggrega.ai/ ile başlayan bir değerle başlayan bir satır — ve yüklenemeyen bir dosya, örneğin YAML olarak ayrıştırılamayan bir dosya, aynı ret mesajında, yükleme sırasında atlanan katalog dosyaları arasında, ayrıştırıcının kendi gerekçesiyle adlandırılır: böyle bir dosya, başvurunun adlandırdığı varlığı bildiren dosya olabilir ve hangi varlığı bildirdiğini söyleyecek hiçbir şey ondan okunamaz. Başka bir apiVersion bildiren ya da hiç bildirmeyen bir YAML dosyası bir Aggrega belgesi değildir ve orada asla adlandırılmaz.

Kilit dosyası

Kilit dosyası her bağımlılığı URI’sine, çözümlenen sürümüne ve içerik özetine sabitler. Katalog varlıkları, şema ve eşleme kütüphaneleri (her biri kendisini tüketen Components ve Features’a geri işaretçiler taşır), Wasm eklentileri, kaynak yapıtlar, harici girdiler (her biri URL ile anahtarlanır ve kendisini isteyen eklentileri taşır) ve Release dosyalarının kendileri için bölümleri vardır. Dosya kanonik, deterministik bir biçimde yazılır.

Bir varlık, onun bir yayınının taşıdığı şeyle kaydedilir. Bir varlığın satırındaki özet, belgesini ve yanında adlandırdığı her dosyayı kapsar — bir Recipe’in veya FeatureRecipe’in yerel source: değeri, bir $import: ifadesinin adlandırdığı her dosya, yanındaki entity.lock, bir Component’in veya Feature’ın içe aktardığı her şema dosyası — yani aggrega push komutunun yayımladığı kümenin aynısı. Her dosya yolunu ve baytlarını katar, başka hiçbir şey katmaz: bir arşivin nasıl sıkıştırıldığı, bir zaman damgası, bir izin biti — çalıştırma biti de dahil — katılmaz. Hiçbir dosya adlandırmayan bir varlık o tek belge olarak kaydedilir. Böylece aynı varlık, katalog dizininizden okunmuş da olsa bir kayıt defterinden getirilmiş de olsa aynı özeti kaydeder ve bir checkout’tan commit edilen kilit dosyası, aynı commit’in başka bir checkout’unda umask’ı ne olursa olsun ve o checkout’un sistemi hangi dosyaların çalıştırılabilir olduğunu kaydetsin ya da etmesin doğrulanır. Bir Recipe altında düzenlenen bir chart, bildirdiği bir kaynağa eklenen bir dosya ve değişen bir entity.lock özeti değiştirir; çalıştırma biti değişen bir betik ve varlığın yanında hiçbir şeyin adlandırmadığı bir not değiştirmez. Release’in adlandırdığı Aggregate ve Manifest de aynı şekilde, her biri tek belgesi olarak kaydedilir. Bir kütüphane, nereden okunursa okunsun belgesi olan baytlarının özetiyle kaydedilir.

Manifest’in bağladığı her Recipe ve FeatureRecipe, hangi katman bağlarsa bağlasın bir satırdır. Manifest’in name katmanının tek bir örnek veya tek bir ek için seçtiği bir gerçekleştirme, type katmanının bir türün her örneği için seçtiği bir gerçekleştirmeyle tam olarak aynı şekilde edinilir ve kaydedilir; satırının referenced_from alanı onu bağlayan girdiyi adlandırır — manifest.spec.mappings.components.name.<instance> veya manifest.spec.mappings.features.name.<attachment>. Bir derleme onu bu satıra bağlı tutar; dolayısıyla onu kaydetmeyen bir kilit dosyası, gerçekleştirmeyi ve o girdiyi adlandırarak derlemeyi durdurur. İki katman için Düz URI eşlemesi bölümüne bakın.

Bir bağlantının ekleri, bir bileşenin kendi ekleri gibi tam olarak bağımlılıktır. Bir bağlantıdaki ekin adlandırdığı Feature — Aggregate’te bir bileşenin uses: girdisine ya da Release’te bir bağlantı girdisine yazılmış olsun — doğrudan bileşenin üzerine yazılmış bir ekin Feature’ı gibi edinilir ve kaydedilir; satırının referenced_from alanı, yazarın yazdığı ve .uses.<socket>.<alias>.features.<slot>.type ile biten bağlantı girdisini adlandırır. Manifest’in ona bağladığı gerçekleştirme de, onu ister features.type bağlasın ister ekin adıyla (<alias>.<slot>) anahtarlanmış features.name, bir satırdır. Bir derleme ikisini de satırlarına bağlı tutar: bunlardan birini içermeyen bir kilit dosyası, başvuruyu ve onu isteyen girdiyi adlandırarak derlemeyi durdurur; içeriği pull’dan bu yana değişmiş bir Feature da iki özeti adlandırarak derlemeyi durdurur. Ekin kendisi için Aggregate’in bağlantı girdisi bölümüne bakın.

Bir Component’in veya Feature’ın genişlettiği bir taban, başka bir şey onu adlandırsın ya da adlandırmasın bir satırdır. Çekme işlemi her extends: öğesini zincirinin sonuna kadar izler ve her tabanı kendi türü altında kaydeder; satırının referenced_from alanı, genişleten varlığın spec.extends alanını adlandırır: component(<name>:<version>).spec.extends. Bir derleme tabanı o satırdan okur, bu yüzden bir Manifest bir sarmalayıcının kendi tipini eşler ve tabanı için bir satıra ihtiyaç duymaz. Hiçbir katalog dizininin, önbelleğin veya kayıt defterinin tutmadığı bir taban, zincirin birleştirildiği yerde bildirilir; bkz. An extends: chain cannot be assembled (Bir zincir birleştirilemiyor).

Release yalnızca adıyla değil, içeriğiyle kaydedilir. Release’in istediği her şey — bir kaynağın hangi chart sürümüne çözümlendiği, hangi bileşenlerin hangi sınıra düştüğü — dosyanın içerdiklerinden çözümlenir; bu yüzden release_documents, onu adlandıran release ile birlikte Release’in ve genişlettiği her Release’in özetini kaydeder. Pull’dan sonra Release’i düzenlerseniz sonraki derleme, düzenlediğiniz dosyayı adlandırıp yeniden pull yapmanızı söyleyerek hiçbir şey işlenmeden durur; düz bir aggrega pull --release <release>, diğer tüm sabitlemelere uyarak düzenlemeyi kaydeder. Özet dosyanın baytlarını olduğu gibi kapsar; dolayısıyla bir yorum veya boşluk değişikliği de, Aggregate ve Manifest için olduğu gibi, sayılır. Release’in parameters aracılığıyla içe aktardığı bir dosya bu şekilde kaydedilmez.

Bir çekme, imzasını denetlediği her yapıtta bir kullanımdan kaldırma işareti arar ve ne bulduğunu söyler. Kendi imzası, çekmenin kabul ettiği bir imzalayana — yapıtın kendi imzalayanına ya da kayıt defterinin trusted_deprecation_identities listesindeki bir kimliğe — karşı doğrulanan bir işaret kaydedilir ve önem derecesiyle ve işaretin imzalayanıyla birlikte duyurulur. Çekmenin bulduğu ancak kabul edemediği bir işaret — okunamayan, imzasız, ilkenin güvenmediği biri tarafından imzalanmış ya da denetlenemeyen bir imza taşıyan — gerekçesiyle birlikte marker present but not honored olarak raporlanır ve kaydedilmez. Tamamlanamayan bir arama — çekme yapıtın kayıt defterini açamadı ya da ona eklenenlerin listesi yanıt vermedi — gerekçesiyle birlikte marker lookup did not complete olarak raporlanır ve hiçbir şey kaydetmez, çünkü çekme bir işaretin var olup olmadığı hakkında hiçbir şey öğrenmemiştir. Kendi güven ilkesi yapıtın türü için imza gerektiren ve advisory olmayan bir kayıt defteri altında, bu ikisinden herhangi biri raporlanmak yerine çekmeyi durdurur. İşaret taşımayan bir yapıt hiçbir satır üretmez ve imza doğrulamasının çalışma alanı ya da yapıtın kayıt defteri için kapatıldığı yerde hiçbir işaret aranmaz.

<release-stem>.lock dosyasını, sabitlenmiş bağımlılıklar içeren herhangi bir manifest’i commit ettiğiniz gibi, Release ile birlikte commit edin. Bir kilit dosyası farkı, gözden geçirenlere hangi bağımlılık sürümlerinin ve özetlerinin değiştiğini tam olarak gösterir; bir kütüphane özeti değişikliği, etkilediği tüketicileri adlandırır.

Belirli bir pull’un ne yaptığı — her varlığın bir kayıt defterinden yeni getirilip getirilmediği (fetched-fresh), bir önbellek yuvasını yeniden kullanıp kullanmadığı (cache-reuse), yerel bir katalogda bulunup bulunmadığı (local), derleyici ikili dosyasının içindeki kopyadan sunulup sunulmadığı (in-binary) ya da harici olup olmadığı (external: Release’in kendi Aggregate’i veya Manifest’i; bağımlılıklarından biri olarak çözümlenmek yerine Release’in adlandırdığı dosyadan veya girdiden okunur; pull’un bir kayıt defterinden getirdiği bir Aggregate ise bunun yerine fetched-fresh olur) — --detail tarafından stdout’a yazdırılan geçici bir pull olayı tanılamasıdır ve kilit dosyasına asla yazılmaz. Bir varlığı hangi kaynağın sunduğu, pull yapan makinenin yerel durumuna bağlıdır; dolayısıyla bunu kalıcı kılmak, kilit dosyasının makineler arasındaki bayt özdeşliğini bozar. Bu pull’un ne yaptığını bildirir ve bu sonradan geri kazanılamaz (yeni çekilmiş bir varlık sonraki çalıştırmada önbellektedir); bir Release’in bağımlılıklarının pull sonrası çözümleme durumu için aggrega inspect kullanın.

Varlık kilidi

Bir Recipe veya FeatureRecipe kendi belgesinin dışındaki baytlara bağlı olabilir: uzak bir source: kaynağından getirilen bir chart veya parça, bir artifacts girdisinin — ya da bir Recipe’in boundary.artifacts girdisinin — $import ile getirdiği bir dosya veya bir dizini ya da yanındaki bir dosyayı adlandıran bir source: kaynağının dosyaları. Bunların her birinin özetinin ne çıktığı, varlık dosyasıyla aynı dizinde bulunan entity.lock adlı bir dosyaya kaydedilir. Sizin yazdığınız varlık dosyasına hiçbir zaman yazılmaz; türetilen her şey onun yanında durur. Varlık kilidi şeması dosyayı alan alan açıklar.

Kim yazar. Onu tek bir adım yazar: varlığın yazarının çalıştırdığı, Release gerektirmeyen ve kilidin tuttuğu her sabitleme sınıfını kaydeden aggrega pin. aggrega pull --pin-sources ve aggrega push --pin-sources aynı adımı yazar adına çalıştırır ve aynı baytları yazar. Sabitleme istenmemiş bir pull hiçbir kilit yazmaz: Release’in katalog dizinlerinizden derlediği her Recipe ve FeatureRecipe üzerinde adımın kaydedeceğini kilidin tuttuğuyla karşılaştırır ve bir sabitleme eksikse ya da artık girdisiyle eşleşmiyorsa varlığı, her girdiyi ve sınıfını ve aggrega pin komutunu adlandırarak durur. Yerel bir kaynağın dosyaları sabitlemelerine tek bir küme olarak tabi tutulur: hiçbirini kaydetmeyen bir kilit pull’u durdurur; sabitlemeden bu yana eklenen, değiştirilen veya kaldırılan bir dosya da öyle. pin_sources_at_pull çalışma alanı anahtarı sabitlemeyi her pull’un varsayılanı yapar ve --pin-sources=false tek bir çalıştırma için durmayı geri getirir. Sabitleme bir yazarlık görevidir; dolayısıyla bir tüketicinin ilk pull’unda yaşanan durma, varlığın yayımcısının onu hiç sabitlemediği anlamına gelir; tüketicinin çözümü başkasının dizinini elle düzenlemek değil, o anahtardır. aggrega pin bunu ayrıntılı olarak açıklar.

Ne tutar. Her satırı bir girdiyi adlandıran üç liste:

  • sourceDigests — koordinatlarını eksiksiz yazdığınız, kind, url, chart, module_subdir, version veya ref alanlarında şablon bulunmayan her uzak source: için bir satır. Satır, kaynağın kind ve url değerlerini, varsa chart veya module_subdir değerini, çözümlendiği sürümü — git kaynağı için ref değerinin adlandırdığı commit’i — ve getirilen arşivin içerik özetini, OCI üzerinden getirilen bir chart için de manifest özetini taşır.
  • artifactDigests — $import ile içe aktarılan bir dosyanın sağladığı her artifacts veya boundary.artifacts girdisi için, girdiyi ve dosya baytlarının özetini adlandıran bir satır. Bir artifacts girdisi anahtarıyla, bir boundary.artifacts girdisi ise boundary/<key> olarak adlandırılır; böylece her iki bloğun aynı anahtar altında yazılmış girdileri ayrı ayrı sabitlenir.
  • localSourceDigests — bir dizini veya varlığın yanındaki bir dosyayı adlandıran bir source: kaynağının, varlığın bir yayınının taşıdıklarına kattığı her dosya için, dosyanın varlığın yanındaki yolunu ve baytlarının özetini adlandıran bir satır. Böyle bir kaynak için hiçbir şey getirilmez; dosyalarının özeti oldukları haliyle alınır. Şablon olarak yazılmış bir kaynak, varlığın dizinindeki her dosyayı katar; bu yüzden her birinin bir satırı olur.

Neleri tutmaz:

  • Koordinatları bir şablondan doldurulan uzak bir kaynak — örneğin .infra içinden okunan bir version. Hangi yapıtı adlandırdığına, varlığı kullanan her Release karar verir; bu yüzden çözümlendiği her sürüm o Release’in kilit dosyasında sabitlenir ve onunla ilgili hiçbir şey varlığın yanına yazılmaz.
  • Satır içi bir artifacts veya boundary.artifacts girdisi; bu, varlık dosyasının bir parçasıdır; ve içeriği kilit dosyasının kaydettiği kütüphane sürümüyle sabitlenen bir ArtifactLibrary’den alınan girdi.

Sabitlenecek hiçbir şeyi olmayan bir varlığa entity.lock verilmez; artık kilide ihtiyacı olmayan bir varlık üzerinde çalıştırılan adım da onu kaldırır.

Onu varlığın yanında commit edin. Her Recipe ve FeatureRecipe aynı dosya adını kullanır ve dosyanın bulunduğu dizin hangi varlığa ait olduğunu söyler; böylece kilit o dizinle birlikte taşınır. Zaman damgası taşımaz ve satırları sabit bir sırada tutulur; bu yüzden değişmemiş girdiler üzerinde adım onu bayt bayt aynı bırakır ve üzerindeki bir diff, değişen kaynağı, içe aktarılan dosyayı veya yerel kaynağın dosyasını adlandırır. Bir dizin tek bir kilit tutar; bu yüzden adım, yanında başka bir varlık bulunan bir Recipe veya FeatureRecipe’i reddeder — Aggregate, Release ve Manifest dışında her türün kendine ait bir dizini vardır — ve sabitleme istenen bir pull böyle bir varlığı herhangi bir şey çözümlenmeden önce reddeder; Dizin başına bir varlık bu kuralı açıklar. Sabitleme yapmayan bir pull bir varlığın yanına hiçbir şey yazmaz ve dizini hakkında hüküm vermez.

aggrega build dosyalarınızı ona tabi tutar. Bir derleme kilidi okur ve üç karşılaştırma yapar:

  • İçe aktarılan her dosyanın özeti yeniden alınır ve satırıyla karşılaştırılır; bir boundary.artifacts dosyası da tıpkı bir artifacts dosyası gibi. Sabitlendikten sonra düzenlenen bir dosya derlemeyi [CATALOG_ERROR E0026] ile durdurur; yapıtı satırının adlandırdığı şekilde, içe aktarılan dosyayı ve her iki özeti adlandırır.
  • Yerel bir kaynağın dosyalarının özeti, sağlayıcı kaynağı okumadan önce yeniden alınır ve tek bir küme olarak satırlarıyla karşılaştırılır. Sabitlemeden bu yana düzenlenen, eklenen veya kaldırılan bir dosya, derlemeyi kaynağın ait olduğu bileşen örneği altında E0305 ile durdurur; bu tür her dosyayı ve her iki özeti adlandırır; varlığın yanında olup kaynağın katmadığı bir dosya karşılaştırılmaz. Yerel bir kaynak için hiç satır kaydetmeyen bir kilit karşılaştırılacak bir şey bırakmaz; bunu A local source no longer matches the pins recorded beside its Recipe (Yerel bir kaynak artık Recipe’inin yanında kaydedilen sabitlemelerle eşleşmiyor) açıklar.
  • Her kaynak satırı, Release’in kilit dosyasının aynı kaynak için kaydettiği özetle karşılaştırılır. Bir uyuşmazlık derlemeyi [FETCH_ERROR E0135] ile durdurur; kilidi ve her iki özeti adlandırır. İki dosya aynı kaynağın iki çözümlemesiyle — sabitleme adımınınki ve pull’unki — yazılır; bu yüzden bu çözümlemeler farklı baytlar elde ettiğinde veya iki dosyadan biri düzenlendiğinde uyuşmazlar. Tek bir sürüm altında farklı baytlar, bir sürümü yeniden yayımlamış bir upstream’in görünümüdür.

Değişiklikten önce yazılmış bir kilit dosyası önce durur ve bir pull dosyayı adlandırır. Kilit dosyası varlığı taşıdıklarıyla kaydeder; kilit ve bu karşılaştırmaların okuduğu her dosya bunun parçasıdır; bu yüzden içe aktarılan bir dosya, yerel bir kaynağın dosyası veya kilidin kendisi değişmeden önce yazılmış bir kilit dosyasını tutan bir derleme — ya da aggrega pull --verify — üç karşılaştırmadan herhangi biri çalışmadan durur: The lockfile no longer matches what the release resolves to (Kilit dosyası artık release’in çözümlendiği şeyle eşleşmiyor); varlığı ve her iki özeti adlandırır. Ardından düz bir aggrega pull dosyayı adlandırır; çünkü kilidi sabitleme adımının kaydedeceğine tabi tutar ve sabitlemesi artık eşleşmeyen girdiyi reddeder: 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).

Kilit dosyasında varlığın kendi içeriğine ait kayıt bulunmadığında, bir derlemenin karşılaştığı şey bu üç karşılaştırmadır. Manifest’in, Release’in ulaştığı bir Component veya Feature’ın da adı olan bir referansla adlandırdığı bir Recipe veya FeatureRecipe’in kendine ait girdisi yoktur: kilit dosyasının o referans için girdisi Component’i veya Feature’ı kaydeder; bu yüzden Recipe’in dosyaları değiştiğinde kilit dosyasında hiçbir şey değişmez ve bir derleme ile doğrulayan bir pull değişen dosyayı yukarıdaki kodla bildirir. Kaynak satırı karşılaştırması, kilit dosyasının source_artifacts girdisi değişen kayıt olduğu halde varlığın yanındaki kilit değişmediğinde de bir derlemenin karşılaştığı şeydir.

Duruşa yanıt verme. İçe aktarılan dosyayı bilerek değiştirdiyseniz, varlık üzerinde aggrega pin çalıştırın: adım dosyanın yeni özetini kaydeder ve sonraki derleme onu kabul eder. Bilerek değiştirmediyseniz dosyayı geri yükleyin. Değişen yerel bir kaynak da aynı iki yanıtı alır: varlığı yeniden sabitleyin ya da duruşun adını verdiği dosyaları geri yükleyin. Lockfile ile uyuşmayan bir kaynak satırı için entity.lock dosyasını sürüm denetiminden geri yükleyin ya da onu yeniden yazmak için varlık üzerinde aggrega pin çalıştırın.

aggrega pull --verify de bunu denetler. Doğrulayan bir pull, Release’in katalog dizinlerinizde ulaştığı Recipes ve FeatureRecipes’in yanındaki kilitler üzerinde aynı üç karşılaştırmayı yapar, bir derlemenin reddedeceği her sabitlemeyi aynı kodla ve aynı sözcüklerle bildirir, böyle bir sabitleme varsa sıfır dışı bir kodla çıkar ve hiçbir kilit yazmaz.

Hiçbir kilidin karşılaştırılmadığı yer. Katalog dizinlerinizden biri yerine bir kayıt defterinden çözümlenen bir Recipe veya FeatureRecipe’in, derlemenin okuduğu bir kilidi yoktur; kaynakları yalnızca Release’in lockfile’ına göre denetlenir. Ayrıca bir git ref: değerinde yazılan bir kaynak, kilide o ref’in çözümlendiği commit ile kaydedilirken derleme, kaynağın sabitlemesini varlığın adını verdiği sürümde arar; bu nedenle o satır hiçbir zaman karşılaştırılmaz — ne bir derleme ne de doğrulayan bir pull tarafından. Lockfile yine de commit’i sabitler ve her derleme önbellekteki arşivi buna göre doğrular.

Eklenti güven kaydı

Çalışma alanının bağladığı bazı eklentiler, oluşturulan çıktıyı hiçbir zaman şekillendirmez. ir-verdict veya render-verdict rolündeki bir plugins.governance bağlantısı ve her plugins.linter bağlantısı yalnızca bir kabul ya da ret kararı döndürür, başka hiçbir şey döndürmez; bunlara ait hiçbir bayt bir yapıta ulaşmaz. Bu nedenle bir derlemenin bayt bayt yeniden ürettiği şeyin parçası değildirler ve tam olarak bunu sabitleyen kilit dosyası onlar için yanlış yerdir.

Bunların kimlikleri bunun yerine kaydedilen ikinci bir dosyaya, kilit dosyasının yanındaki plugins-trust.yaml dosyasına yazılır. Bu dosya her böyle eklenti için bir girdi taşır; girdi eklentinin kimlik koordinatını, onun için seçilen sürümü ve çözümlenen yapıtın içerik özetini kaydeder; ayrıca pull’un o yapıt için doğruladığı imzayı (bir imza doğruladıysa) ve yayıncı o yapıtı yayımladıktan sonra kullanımdan kaldırdıysa pull’un bulup doğruladığı işareti de kaydeder. Eklenti güven kaydı şeması dosyayı alan alan açıklar.

plugins-trust.yaml dosyasını kilit dosyasıyla birlikte, kilit dosyasını kaydetmenizle aynı nedenle kaydedin: sürüm denetimi dışında tutulan bir kaydı kimse inceleyemez ve hiçbir şey onunla karşılaştırılamaz. Kaydedildiğinde, bu bağlantıların her birinin hangi eklentiye çözümlendiğine dair paylaşılan tek bir beyan olur ve üzerindeki bir fark, değişen kimliği adlandırır.

Dosya yalnızca kaydedilecek bir şey olduğunda ortaya çıkar. Karar döndüren hiçbir eklenti bağlamayan bir çalışma alanı böyle bir kimlik çözümlemez; bu yüzden pull hiçbir dosya yazmaz ve dosya hakkında hiçbir şey söylemez; bu eksik bir dosya değil, bir yokluktur. Pull dosyayı oluşturduğunda, oluşturduğu dosyayı adlandırır ve onu kaydetmenizi söyler. Sonraki bir pull, kaydın henüz tutmadığı bir kimliği ekler ve zaten kaydedilmiş her kimliği tam olarak olduğu gibi bırakır.

Bu dosyadaki her değişiklik duyurulur, başka hiçbir şey duyurulmaz. Kaydı değiştiren bir pull, değişen her girdi için eklentiyi ve değişikliğin türünü adlandıran bir satır yazdırır: ilk kez kaydedilen bir kimlik, tutulanın yerine benimsenen bir kimlik (neyin değiştirildiğini görebilmeniz için ikisini de adlandırarak), bir girdinin zaten adlandırdığı yapıta karşı kaydedilen bir kullanımdan kaldırma, bir girdiden temizlenen bir kullanımdan kaldırma, bir girdiye karşı kaydedilen ya da ondan temizlenen bir imza veya düşürülen girdi. Yukarıdaki oluşturma satırı ayrıdır ve bir girdiyle değil dosyayla ilgilidir; bu yüzden ilk çözümleme ikisini birden söyler: bu dosya yenidir ve kaydedilmelidir, ve şu an tuttuğu kimlikler bunlardır.

Kaydı tam olarak olduğu gibi bırakan bir pull, onun hakkında hiçbir şey söylemez. Dolayısıyla bu dosya hakkındaki bir satır, kaydedilmiş dosyanın değiştiği ve farkının okunmaya değer olduğu anlamına gelir; bu, burada kilit dosyasına göre daha önemlidir. Kilit dosyasının sabitlediği her şey aynı zamanda bir derlemenin bayt bayt yeniden ürettiği şeyin parçasıdır, bu yüzden oradaki bir değişikliğin görüneceği ikinci bir yer vardır; bir karar eklentisinin kimliğinin ise yoktur. Değiştirilmiş bir geçidin yazıya geçirildiği tek yer bu dosyadır.

aggrega pull --dry-run bunların hiçbirini duyurmaz, çünkü hiçbir şeyi değiştirmez. Bunun yerine kaydı, Bir pull’un ne yazacağını önizleme bölümünde açıklandığı gibi yazacağı dosyalar arasında listeler.

Kullanımdan kaldırma, kaydın zaten tuttuğu bir girdiye eklenir ve bu, girdiyi yeniden yazmakla aynı şey değildir. Bir yayıncı zaten güvendiğiniz bir eklentiyi kullanımdan kaldırırsa, sonraki aggrega pull işareti o eklentinin mevcut girdisine kaydeder; koordinat, sürüm ve özet dokunulmadan kalır, çünkü yapıt değişmemiştir ve yeni hiçbir şey benimsenmemektedir. Böylece sade bir pull bir deprecation bloğu ekleyebilir ve bir kimliği yalnızca açık bir yükseltme değiştirir. Bir işaret yalnızca girdinin zaten adlandırdığı yapıta karşı kaydedilir ve hiçbir pull yayımlanması durmuş bir işaretin peşine düşmez: kaydedilmiş bir işaret yalnızca onu taşıyan girdiyle birlikte gider; bu da ya o girdi düşürüldüğünde ya da açık bir yükseltme eklentiyi yeniden çözümleyip girdinin zaten kaydettiği baytlarda hiçbir işaret bulmadığında olur.

Doğrulanan imza bir girdiye aynı şekilde kaydedilir ve her pull onu yeniden yanıtlar. Pull, her çalıştırmada bu eklentilerin her birinin imzasını kayıt defterinin güven ilkesine karşı doğrular (bir kayıt defterinin sunduğu eklenti, hiçbir şey onu sabitlemediği için her seferinde sürümüyle getirilir) ve doğruladığını, yine kimliğe dokunmadan, eklentinin girdisine kaydeder: kip, eşleşen imzalayıcı ve önbelleğe aldığı imza paketinin özeti; yani bir kilit dosyası girdisinin taşıdığı aynı signature. Bir işaretin aksine, yanıt girdinin tuttuğunun yerine geçer ve pull hiçbir imza doğrulamadığında (eklenti imza taşımıyor ve imza gerekmiyorsa ya da onu skip_signature_verification veya advisory bir kayıt defteri kabul ettiyse) girdi hiçbir imza kaydetmez. Doğruladığı imza paketi de yeniden önbelleğe alınır ve artık özetiyle eşleşmeyen önbellekteki bir kopya yeniden yazılır. Böylece imzasını kaybetmiş bir girdi, başka bir eklentinin imzasından kopyalanmış bir imza taşıyan bir girdi, önbellekteki imza paketi kaldırılmış veya değiştirilmiş bir girdi ya da silinmiş veya bir imza kaydedilmeden önce yazılmış bir kayıt, sonraki sade aggrega pull ile onarılır. Bir derleme bu tür her eklentiyi bu olguya bağlı tutar: derleme sayfasındaki Eklenti güven kaydı bölümüne bakın.

Kaydedilenle uyuşmayan çözümlenmiş bir kimlik pull’u durdurur. Kaydedilmiş bir girdi hem bir sürümü hem bir özeti adlandırır, bu yüzden ikisinden birinin değişmesi aynı olaydır: çalışacak eklenti, kaydın incelendiği eklenti değildir. Tanılama eklentiyi, kaydın tuttuğunu ve bu çözümlemenin bildirdiğini her iki eksende birden adlandırır; pull da kayda dokunmadan durur, böylece incelenmiş kimlik karşılaştırma için orada kalır. Yalnızca sürümde (baytları değişmemiş bir yeniden yayımlama) tam olarak yalnızca özette (aynı sürümde yeniden gönderim) durduğu gibi durur.

aggrega pull --verify aynı karşılaştırmayı yapar. Bir pull’un kaydettiği dosyaların hiçbirini yazmaz, dolayısıyla hiçbir şey benimsemez; bu dosyaların bugün bir pull’un çözümleyeceği şeyi hâlâ tanımlayıp tanımlamadığını bildirir ve kayıt da bunlardan biridir. Ayrıca her girdinin imzasını, pull’un eklentiyi kendi doğrulamasının verdiği imzaya bağlı tutar ve bir pull’un imzasını kaydedeceği, değiştireceği veya temizleyeceği bir girdiyi (ve kaydın girdi tutmadığı, bir derlemenin imza kaydetmediği için reddettiği bir eklentiyi) Kaydedilen imzaları her iki dosyada karşılaştırır bölümünde açıklandığı gibi bildirir.

Yeni bir kimlik benimsemek için onu adıyla isteyin: aggrega pull --upgrade --release <release> <plugin>; eklentiyi .aggrega-config.yaml bağlantınızın adlandırdığı gibi, herhangi bir sürüm soneki olmadan adlandırın. Bu, yalnızca o eklentiyi yeniden çözümler ve girdisini yeniden yazar; diğer her sabitlenmiş bağımlılığı ve diğer her kaydedilmiş kimliği dokunulmadan bırakır. Eklentinin kilit dosyasında sabitlemesi olmasa bile çalışır, çünkü adlandırılmış bir hedef bu bağlantılardan birini de adlandırabilir. Her bağımlılığı yeniden çözümleyen yalın bir aggrega pull --upgrade, kaydedilmiş her kimliği de yeniden çözümler ve yeniden yazar. Yalın bir tam yenileme pull’u çalıştıran ve tek bir hedefi adlandırmanın hiçbir yolu olmayan aggrega build --upgrade da öyle.

Bir kimliği kaldırmak için de onu adıyla isteyin. Bir eklentiyi .aggrega-config.yaml dosyasından ayırmak girdisini temizlemez ve bu kasıtlıdır: sade bir aggrega pull hiçbir zaman girdi kaldırmaz. aggrega pull --upgrade --release <release> <plugin> komutunu, eklentiyi kaydın adlandırdığı gibi (aşağıdaki durdurmanın yazdırdığı dize olan kimlik koordinatıyla) adlandırarak çalıştırın; girdi düşürülür ve diğer her sabitlenmiş bağımlılık ve diğer her kaydedilmiş kimlik dokunulmadan kalır. Yalın bir aggrega pull --upgrade, hiçbir karar bağlantısının artık adlandırmadığı her girdiyi, diğer her şeyi yeniden çözümlediği aynı geçişte düşürür.

Son girdinin kaldırılması dosyayı silmez; dosyayı yerinde ve boş bırakır. Boş bir kayıt hiçbir şey tutmaz, dolayısıyla hiçbir şeyi sabitlemez ve hiçbir şeyi durdurmaz — hiç kayıt olmamasıyla aynıdır — ve dosyanın korunması, kaldırma işleminin dosyanın diff’inde bir kaldırma olarak görünmesini sağlar.

Şemasını karşılamayan bir kayıt, onu okuyan her komutu durdurur — bir derlemeyi, release kapsamlı bir lint’i ve bir pull’u; kendisinin kaydedecek hiçbir şeyi olmayan bir pull da buna dahildir. Boşaltılmış bir kayıt ile bozulmuş bir kayıt bilinçli olarak farklıdır: boşaltma son girdinin kaldırılma yoludur ve boşaltılmış bir kayıt sessiz kalır; içeriği artık ayrıştırılamayan bir dosya ise boş bir kayıt değil bir hatadır — onu boş olarak okumak, dosyayı kırpmayı karşılaştırmayı kapatmanın bir yolu hâline getirirdi. İncelenmiş kimlikleri geri almak için dosyayı sürüm denetiminden geri yükleyin.

Derleyici ikili dosyasının içindeki kopyadan sunulan bir eklenti kaydedilmez. Pull, edindiği şeyi kaydeder — bir kayıt deposundan getirilen ya da önbellekten okunan — ve ikili dosyadan hiçbir şey edinilmez: bu baytlar, onları taşıyan derleyici sürümüyle tanımlanır, dolayısıyla kaydedilecek kendilerine ait bir çözümleme yoktur. Bu nedenle ikili dosyanın zaten taşıdığı bir eklentiyi eklemek onun için bir girdi üretmez. Bu, kaydın edinilmiş yapıtlarla sınırlı kalmasıdır; başarısız olmuş bir çözümleme değildir.

Bir derleme, release kapsamlı bir lint ve release kapsamlı bir doğrulama, çalışma alanı yapılandırmasını kayda göre denetler. Bu eklemelerden herhangi biri çalışmadan önce aggrega build, aggrega lint --release ve aggrega validate --release — ve aggrega serve ile aggrega mcp üzerinden erişilen aynı işlemler — yapılandırmanın adlandırdığı karar eklemelerini kaydın tuttuğu girdilerle karşılaştırır. Çözümlenmiş yapıt özeti kaydedilenle aynı olmayan bir eklenti çalıştırılmaz, reddedilir. Yapılandırılmış hiçbir karar eklemesinin karşılamadığı bir kayıt girdisi çalıştırmayı durdurur: incelenmiş ve artık bulunmayan bir kapı, o kapının onayladığı çıktıdan ayırt edilemeyen bir çıktı bırakır; çıktıyı okuyan birinin göremediği şey de tam olarak budur. Durdurma eklentiyi adlandırır ve ne kastettiğinize göre değişen iki çözüm sunar — kaldırma bir hataysa eklentiyi yeniden ekleyin, kasıtlıysa yukarıdaki açık yükseltmeyi çalıştırın — ve o yükseltmeyi çalıştırılmaya hazır biçimde yazdırır. Ters yön — kaydın henüz tutmadığı bir ekleme — yukarıda açıklanan ilk görülmedir ve iki karşılaştırma da bunun üzerine durmaz; imza gereksinimi, girdisi olmayan bir eklemenin kaçamadığı tek denetimdir. Aynı üç yüzey, önbellekten okudukları her eklentiyi yüklerken girdisinin kaydettiği imzaya göre denetler; bir derleme için derleme sayfası bunu açıklar. Tüm katalog ve tek varlık lint kapsamları hiçbir kayda başvurmaz.

Bir doğrulama kayda göre denetlenir, çünkü bir derlemenin çalıştırdığı denetimlerin aynısını çalıştırır. aggrega validate --release, yapıtları yazmak dışında aggrega build’in ulaştığı her denetime, kapı eklentileri dahil, ulaşır — “bu doğrulanıyor” ifadesini “bu derleniyor” ile aynı anlama getiren budur — bu yüzden çalıştırdığı eklentinin kimliği, bir derlemeninki gibi tam olarak kayda göre karşılaştırılır. aggrega validate’in diğer kapsamları buna göre denetlenmez: tüm kataloğu, tek bir varlığı ya da bir eklenti ikili dosyasını doğrulamak çalışma alanının eklenti eklemelerini hiç okumaz, dolayısıyla bunlarda hiçbir karar eklentisi çalışmaz ve bir kaydın denetleyeceği bir şey yoktur.

Bir yapılandırmayı kayda göre denetlemek varlığı ve kimliği saptar, bunların ötesinde hiçbir şeyi saptamaz. Kaydın adlandırdığı her kapının hâlâ ekli olduğunu ve her birinin kendisi için kaydedilen yapıttan çalıştığını saptar. Çalışan bir kapının gerçekten bir karar döndürdüğünü saptamaz ve bunun bir durumu hiçbir yerde yakalanmaz: function alanı eklentinin bildirdiği, ancak soketinin okuduğu karar dışa aktarımı olmayan bir dışa aktarımı adlandıran ve çıktısı o soketin beklediği şeklin dışında üst düzey bir alan taşımayan — en basiti boş nesnedir — bir ekleme çalışır, reddedilecek hiçbir şey döndürmez ve derlemenin geçmesine izin verir. Çıktısı onaylayan bir kapınınkinden ayırt edilemez ve kayda karşı hiçbir karşılaştırma bunu fark edemez, çünkü kayıtta yanlış olan hiçbir şey yoktur: çalışan eklenti tam olarak kaydedilen eklentidir ve yalnızca hiçbir şey çalıştırmamıştır. Komşu iki durum ise durdurur, dolayısıyla sınır okunduğundan daha geniş değildir — eklentinin bildirmediği bir dışa aktarımı adlandıran bir function eklenti yüklenirken reddedilir ve soketin şeklinin bildirmediği üst düzey bir alan taşıyan bir çıktı, rastlantısal olarak boş bir karar listesi olarak okunmak yerine reddedilir. Bu yüzden kaydedilmiş bir kimlik, bir kapının bir şeyi yargılamış olması için tek başına yeterli değildir.

Kaydedilen özet, çalışma alanının aggrega pull’un doldurduğu önbellekten çözümlediği eklentileri yönetir; başka bir yolla çözümlediği hiçbir şeyi yönetmez. Bu, bir karar eklemesinin normalde izlediği çözümlemedir — lockfile’da onu hiçbir şey sabitlemez, dolayısıyla baytları önbellekten gelir ve çözümlenen özet bu okuma sırasında kaydedilenle karşılaştırılır. Çalışma alanının başka bir yolla çözümlediği bir karar eklentisi bu okumaya hiç ulaşmaz ve kayıt tarafından değil, gerçekte çözümlendiği yolu yöneten şey tarafından yönetilir: derleyici ikili dosyasının içindeki kopyadan sunulan baytlar onları taşıyan derleyici sürümüyle tanımlanır, katalog varlığının yanında duran bir .wasm sizin katalog dizininizdeki bir dosyadır, açık bir dosya sistemi yolu adlandırdığınız yoldur ve lockfile sabitlemesi taşıyan bir eklenti o sabitlemeyle yönetilir. Bir yapılandırmayı kayda göre denetlemenin diğer yarısı bu şekilde sınırlı değildir: kaydın tuttuğu her girdi, o eklenti nasıl çözümlenirse çözümlensin, yapılandırılmış bir ekleme tarafından hâlâ karşılanmalıdır. Böylece kayıt, adlandırdığı kapıların onları ne sunarsa sunsun hâlâ ekli olduğunu saptar ve önbellekten sunulanların yapıt kimliğini saptar.

Uyma ve güncelleme

Varsayılan olarak aggrega pull mevcut bir kilit dosyasına uyar: zaten sabitlenmiş bir bağımlılık tam olarak sabitlenmiş sürümüne çözümlenir (sabitlenmiş özetine karşı doğrulanarak), yalnızca henüz sabitlenmemiş başvurular çözümlenip eklenir ve Release’in artık ulaşmadığı başvuruların sabitlemeleri budanır. Dolayısıyla değişmemiş bir Release’in yeniden çekilmesi hiçbir şey yapmaz; aynı kilit dosyasını bayt bayt (generated_at dahil) yeniden üretir. Yeni bir bağımlılık eklemek ya da elle yapılan bir düzenleme bir sabitlemeyi kaldırdıktan sonra çekmek yalnızca o boşluğu çözümler ve diğer tüm sabitlemelere dokunmaz.

Yeniden çekmenin önbellekten okuduğu bir bağımlılık, onu getiren çekmenin kaydettiği şekliyle aynen kaydedilir. Satırı sürümü, içerik digest değerini ve manifest_digest değerini (sonuncusu önbellekte içeriğin yanında saklanan manifestten alınır), o çekmenin kayıt defterinde doğruladığı signature ve deprecation ile birlikte korur. Bir derleme satırı kabul ettiği sürece bunların hiçbiri yeniden sorgulanmaz ve --detail böyle bir bağımlılığı cache-reuse olarak bildirir; bu nedenle tüm bağımlılıkları önbellekte olan ve güven yapılandırmasının gerektirdiği her imzayı ve yalnızca bir derlemenin kabul ettiği imzaları kaydeden bir kilit dosyası üzerindeki yeniden çekme, kayıt defterine ulaşılabilsin ya da ulaşılamasın aynı kilit dosyasını yazar.

Yeniden çekme, bir imzayı tam olarak bir derlemenin satırı reddedeceği yerde yeniden sorgular ve bu tür iki satır vardır.

  • Kilit dosyasının kaydetmediği gerekli bir imza. Güven yapılandırması önbelleğin sunduğu bir bağımlılık için imza gerektirdiğinde ve kilit dosyası satırı hiçbir imza kaydetmediğinde (satır düzenlenmişse, kilit dosyası daha önceki bir çekmenin doldurduğu bir önbellek üzerine sıfırdan yazılmışsa ya da gereksinim satırı yazan çekmeden sonra eklenmişse), yeniden çekme o bağımlılığın kayıt defterinden, önbellekte yanında saklanan manifestin özetiyle, tıpkı getirdiği bir bağımlılık için yaptığı gibi imzasını ister ve doğrulanan imzayı satıra kaydeder. Bu satır, bir derlemenin reddettiği satırdır (No verified signature is recorded for an artifact that requires one (Bir imza gerektiren bir yapıt için doğrulanmış imza kaydedilmemiş)); dolayısıyla bu reddi gideren, yeniden çekmektir. Hiçbir imza eklemeyen bir kayıt defteri ya da güven yapılandırmasının kabul etmediği bir imza, bağımlılığı getiren bir çekmeyi durdurduğu gibi yeniden çekmeyi de durdurur. Bir çekmenin imzasız bir bağımlılığı kabul etmesine izin veren ayarlar böyle bir satırı olduğu gibi bırakır ve onun hakkında hiçbir şey sormaz: üst düzeydeki skip_signature_verification, kayıt defterinin kendi girdisindeki aynı anahtar (çalışma alanı genelindeki imzalama ilkesinin gerektirdiği bir tür dışında) ve advisory olarak işaretlenmiş bir kayıt defteri.
  • Bir derlemenin kabul etmediği kayıtlı bir imza. Satır, önbelleğe alınmış imza paketi onu önbelleğe alan çekmeden sonra kaldırılmış ya da değiştirilmiş bir imzayı ya da başka bir satırdan kopyalanmış, paketi sağlam ama başka bir yapıt için oluşturulmuş bir signature değerini kaydettiğinde, bir derleme imzalama gereksinimi ne derse desin satırı reddeder (A cached signature bundle does not match the digest recorded for it (Önbelleğe alınmış bir imza paketi onun için kaydedilen özetle eşleşmiyor), A recorded signature was made for a different artifact (Kayıtlı bir imza farklı bir yapıt için oluşturulmuş)). Bu yüzden yeniden çekme, gereksinim ne derse desin, o bağımlılığın kayıt defterine imzasını yeniden sorar ve bunu getirdiği bir bağımlılığın geçtiği aynı doğrulamayla yapar: doğrulanan, satırın imzasının yerini alır ve adlandırdığı paket yeniden önbelleğe alınır, özetiyle artık eşleşmeyen önbellekteki kopya yeniden yazılır; böylece satır ve önbellek, bağımlılığı getiren çekmenin bıraktığını tutar. Güven yapılandırmasının kabul etmediği bir imza, bağımlılığı getiren bir çekmeyi durdurduğu gibi yeniden çekmeyi de durdurur; imza gerektiği yerde hiç imza eklemeyen bir kayıt defteri de öyle. Doğrulama hiçbir şey kaydetmediğinde (uygulandığı yerde hiçbir şey sormayan skip_signature_verification, imza gerekmediği yerde imza eklemeyen bir kayıt defteri ya da hiçbir şeyin doğrulanmadığı bir advisory kayıt defteri), satırın imzası temizlenir ve bir derleme bunu aynı ayarlar altında kabul eder.

Kayıtlı imzasını bir derlemenin kabul ettiği bir satır yeniden sorgulanmaz; hiçbir şeyin imza gerektirmediği, imza kaydetmeyen bir satır da sorgulanmaz.

Artık hiçbir default_registry belirtmeyen bir çalışma alanında kayıt defteri olmadan adlandırılmış bir bağımlılık sorgulanamaz. Satırı, imzasını kaydeden çekme tarafından bir kayıt defterine bağlanmıştır ve varsayılan olmadan sorulacak bir kayıt defteri yoktur. Böyle bir satır bir derlemenin kabul etmediği bir imza kaydettiğinde, yeniden çekme derlemenin kendi reddiyle durur, satırı yeniden sormak için yapılandırılmış bir kayıt defteri olmadığını söyler ve kilit dosyasını olduğu gibi bırakır. Bağımlılığın geldiği kayıt defterini default_registry olarak yapılandırıp yeniden çekmek bunu onarır.

Bu uymanın yönettiği, bir kayıt defterinin ya da önbelleğin sunduğudur. Yerel bir katalog dizininin sağladığı bir varlık, o dizinden, dosyasının bildirdiği sürümde çözümlenir ve kilit dosyasının onun için kaydettiği girdiye bu sırada başvurulmaz. Kilit dosyası böyle bir varlığı yine de kaydeder, bu yüzden onu orada görürsünüz; ancak o girdiyi elle düzenlemek varlığı yazdığınız sürümde tutmaz ve bir sonraki uzlaştırma girdiyi dosyayla eşleşecek şekilde yeniden yazar. Bir Release’in yerel olarak sağlanan bir varlığın hangi sürümünü çözümleyeceğini değiştirmek için kilit dosyasını değil, katalog dosyasını düzenleyin.

Bir sabitleme bir yeri değil baytları adlandırır; bu nedenle artık sabitlemesini tutmayan bir önbellek girdisine güvenilmez, atlanır. Yerinde düzenlenmiş bir varlık (aynı version altında yeni bir gövde), içerik önbelleğinin o ad ve sürüm altında önceki gövdeyi tutmasına yol açar. Önce katalog dizini okunur; bu yüzden bir dizinin hâlâ sağladığı bir varlık dosyasından sabitlenir ve eskimiş girdi hiç okunmaz. Çekmenin Release’in dış girdilerini keşfetmek için çalıştırdığı işleme, her sabitlemeyi bir derlemenin yaptığı gibi, sabitlenmiş baytları tutan katalog dizininden okur ve atladığı girdiyi aggrega build komutunun yazdırdığı bildirimle raporlar. Varlığı hiçbir katalog dizini sağlamadığında ve bir kayıt defterine ulaşılabildiğinde, çekme sabitlenmiş sürümü yeniden getirir, girdiyi yeniden yazar ve bunu girdiyi ve her iki özeti adlandırarak standart hataya bildirir:

reuse: cache entry for <name>:<version> held <digest the entry held>, not the pinned <pinned digest>; refreshed from the registry (pin unchanged)

Getirilen baytlar, bir sabitleme altındaki her getirme gibi sabitlemeye tabi tutulur; bu yüzden o sürüm altında başka baytlar sunan bir kayıt defteri, aşağıda açıklandığı gibi çekmeyi durdurur. Sabitlenmiş baytları hiçbir kaynak tutmadığında (varlığı hiçbir katalog dizini sağlamadığında, önbellek girdisi başka baytlar tuttuğunda ve hiçbir kayıt defteri sabitlenmiş sürümü sunmadığında ya da çalıştırma hiçbirine ulaşamadığında), çekme ve aggrega pull --verify, okudukları her kaynağı ve onun tuttuğunu adlandırarak E0135 ile (önbellek girdisinin manifesti kilit dosyasının sabitlediği değilse E0133 ile) durur; çalıştırma hiçbir kayıt defterine ulaşamadıysa, durma sabitlenmiş sürümü yeniden getiren adımı da adlandırır.

Sabitlenmiş sürümleri güncellemek için aggrega pull --upgrade --release <release> komutunu çalıştırın; bu komut mevcut sabitlemeleri atar ve tüm bağımlılıkları en son uygun sürümlere yeniden çözümler. Güncelleme açık bir eylemdir; varsayılan davranış sabitlenmiş bir bağımlılığı asla kaydırmaz. Bu, npm ci / cargo / go build uzlaşımını yansıtır (varsayılan kilidi gerçekleştirir; güncelleme isteğe bağlıdır) ve aggrega build komutunun otomatik çekmesini güvenli kılan da budur: derleme, bir sürümü sessizce değiştirmeden tam olarak kilit dosyasının sabitlediğini çözümler.

Bu yalın biçim kayıtlı her sabitlemeyi attığından, herhangi bir şey yapmadan önce onay ister. Etkileşimsiz kullanım için bunu önceden --yes ile yanıtlayın; standart girdi bir terminal değilse ve --yes yoksa, kimsenin veremeyeceği bir yanıtı beklemek yerine reddeder. Hedefleri adlandırmak (aggrega pull --upgrade --release <release> <uri>) adlandırmadığı her sabitlemeyi korur; bu yüzden o biçim hiçbir şey sormaz. aggrega build --upgrade yalın biçimi çalıştırır ve aynı koşullara tabidir.

Sabitlenmiş bir sürümün kayıt defterindeki baytları kilit dosyasının kaydettiği özetle artık eşleşmiyorsa (yukarı akışta bir değişmezlik ihlali), pull değişmiş baytları sessizce benimsemek yerine bir bütünlük hatasıyla durur; bilinçli olarak yeniden sabitlemek için --upgrade çalıştırın.

Bir lockfile’ı yazmadan denetlemek

aggrega pull --verify --release <release> tek bir soruyu yanıtlar: aggrega pull şimdi çalıştırılsa lockfile’ı ya da yanındaki eklenti güven kaydını değiştirir miydi? Bir pull’un yapacağı çözümlemeyi yapar, lockfile’ı ve kaydı bununla karşılaştırır ve bir pull’un kalıcı olarak yazdığı herhangi bir şey yazılmadan önce durur: lockfile, eklenti güven kaydı ve her entity.lock olduğu gibi bırakılır. Lockfile yoksa ve herhangi bir fark varsa, her birini adlandırarak sıfırdan farklı bir kodla çıkar. Kullanımdan kaldırma işaretleri, aşağıda açıklandığı gibi karşılaştırılmaz. --upgrade ile, --dry-run ile ve hangi değer verilirse verilsin --pin-sources ile birlikte kullanılması reddedilir: bir doğrulama, bir entity.lock dosyasında eksik olan bir sabitlemeyi ne kaydeder ne de onda durur; dolayısıyla bu bayrak hiçbir şeyi değiştirmezdi.

Kaydedilmiş sabitlemelere tam olarak bir pull gibi uyar. Lockfile’ın sabitlediği bir bağımlılık sabitlenmiş sürümünde çözümlenir ve sabitlenmiş özetine karşı denetlenir; yerel bir katalog dizininin sağladığı bir varlık ise, Uymak ve güncellemek bölümünde açıklandığı gibi o dizinden çözümlenir. Dolayısıyla:

  • Kayıt defteri pull’dan bu yana daha yeni bir sürüm yayımlamış olan bir başvuru, sapma değildir. Bir pull onun sabitlemesini korurdu; dolayısıyla lockfile hâlâ bir pull’un yazacağı lockfile’dır. Daha yeni sürüm aggrega pull --upgrade ile benimsenir.
  • Sabitlenmiş bir sürüm altında artık farklı baytlar sunan bir kayıt defteri, değişikliği sapma olarak raporlamak yerine, doğrulamayı bir pull’u durduran bütünlük hatasıyla durdurur.
  • Elle düzenlenmiş bir lockfile satırı, düzenlenmiş bir Release ve yerel bir katalog dizininde düzenlenmiş bir varlık ayrı ayrı raporlanır; çünkü her biri lockfile ile bir pull’un şimdi çözümlediği şey arasındaki bir farktır.

Önbelleği bir pull gibi okur ve doldurur. Önbelleğin sabitlemesi altında tuttuğu bir girdi (bir katalog varlığı ya da bir eklentinin .wasm dosyası) bir kayıt defterine sorulmadan oradan okunur; bu da bir doğrulamanın, bağlı bir pull’un doldurduğu bir çalışma alanı üzerinde çevrimdışı duruş altında çalışabilmesini sağlar. Önbelleğin tutmadığı bir girdi, bir pull’un getirdiği gibi getirilir; artık sabitlemesiyle eşleşmeyen bir girdiye ise tam olarak bir pull’un davrandığı gibi davranılır. Dolayısıyla bir doğrulama önbelleğe ekleme yapabilir, ancak hiçbir sabitlemeyi değiştirmez.

Kaydedilmiş imzaları her iki dosyada da karşılaştırır

Bir pull’un bir yapıt için doğruladığı imza, yazdıklarının bir parçasıdır: bir lockfile girdisindeki signature ve bir karar rolüne bağlı bir eklenti için plugins-trust.yaml girdisindeki imza. Sabitlemeler uyuştuğunda doğrulama, kaydedilmiş her imzayı bir pull’un şimdi kaydedeceği imzayla karşılaştırır ve bir pull’un hiçbir imzanın kaydedilmediği yerde kaydedeceği, değiştireceği ya da temizleyeceği her imzayı A recorded signature is not the one a pull would record (Kaydedilmiş bir imza, bir pull’un kaydedeceği imza değil) altında raporlar. Her iki dosyadaki bu tür her girdi aynı çalıştırmada adlandırılır.

Hangi lockfile girdilerine bakılacağı pull’un kendi seçimidir. Yeniden yapılan bir pull, bir girdinin imzasını kayıt defterine tam olarak Uymak ve güncellemek bölümünün açıkladığı yerde sorar; bir doğrulama da aynı seçimi okur:

  • İkisi bir kayıt defterine sorulmadan raporlanır, çünkü bir pull kayıt defteri ne yanıt verirse versin onları yeniden yazar: önbelleğin sunduğu ve güven yapılandırmasının imza gerektirdiği yerde hiçbir imza kaydetmeyen bir girdi (pull yapıtın imzasını kaydeder ya da hiçbir imza belirlenemiyorsa durur) ve kaydedilmiş imzası başka bir yapıt için oluşturulmuş bir girdi (pull bunu yapıtın kendi imzasıyla değiştirir).
  • Bir pull’un yeniden bakacağı diğer her girdi sorulur, çünkü pull’un onu değiştirip değiştirmeyeceğini yalnızca kayıt defterinin yanıtı söyler: baytlarını bu doğrulamanın getirdiği bir girdi ve önbelleğe alınmış imza paketi kaldırılmış, okunamayan ya da değiştirilmiş bir girdi. Doğrulama, pull’un yapacağı gibi kayıt defterine sorar ve yanıtın imzasını kaydettiği, değiştirdiği ya da temizlediği girdiyi raporlar. Doğruladığı imza paketi bir pull’un önbelleğe aldığı gibi önbelleğe alınır; dolayısıyla önbelleğe alınmış paketi kaldırılmış, ancak kayıt defteri hâlâ kaydedilmiş imzayı sunan bir girdi geçer ve önbelleği onarılmış olarak bırakır.

Kaydedilmiş imzasını bir derlemenin kabul ettiği bir girdi ve hiçbir şeyin imza gerektirmediği, imza kaydetmeyen bir girdi, ne bir pull ne de bir doğrulama tarafından sorulur.

Eklenti güven kaydı da aynı pull’a göre denetlenir. Her pull, bir karar rolüne bağlı her eklentinin imzasını kayıt defterinde doğrular; bir doğrulama da aynısını yapar ve imzasını bu doğrulamanın kaydedeceği, değiştireceği ya da temizleyeceği bir girdiyi raporlar. Kaydın girdi tutmadığı bir eklenti, bir derleme onu imza kaydetmediği için reddettiğinde raporlanır; çünkü bir pull onun imzasını taşıyan bir girdi yazar ve derleme o zamana kadar eklentiyi reddeder. Diğerleri ilk görülmedir; bir doğrulama, kaydın henüz tutmadığı hiçbir kimliği raporlamadığı gibi bunları da raporlamaz. Çevrimdışı duruş altında bir doğrulama bu eklentiler hakkında hiçbir kayıt defterine sormaz; bunun yerine neyi raporladığını Çevrimdışı açıklar.

Kullanımdan kaldırma işaretleri karşılaştırılmaz. Pull’dan sonra bir yapıta eklenen bir işaret kayıt defterinin durumudur ve çalışma alanında hiçbir şey değişmeden değişir; bir işaret yüzünden başarısız olan bir doğrulama, dokunmadığınız dosyalar üzerindeki bir denetimi başarısız kılardı. Aynı nedenle kaydedilmiş bir işaret, bir derlemeyi durdurmak yerine ona uyarı verir. Dolayısıyla bir pull, bir doğrulamanın geçirdiği bir girdiye işaret kaydedebilir.

Bir pull işleminin ne yazacağını önizleme

aggrega pull --dry-run --release <release> bağımlılıkları sıradan bir pull işleminin yaptığı gibi çözümler ve ardından yazmak yerine ne yazacağını yazdırır: her dosyanın yolunu adlandıran bir başlık ve ardından o dosyanın tutacağı içerik.

aggrega pull --dry-run --release release.yaml

Yalnızca kilit dosyasını değil, her dosyayı adlandırır. Kilit dosyası, kayıtlı sabitlemeleri --pin-sources altında değişecek her Recipe ve FeatureRecipe’in yanındaki entity.lock ve eklenti güven kaydı aynı raporda yer alır; çünkü yalnızca kilit dosyasını gösteren bir önizleme size değişenin yalnızca kilit dosyası olduğunu öğretirdi. Sabitlenmemiş bir varlıkta duracak bir pull, aynı nedenle --dry-run altında da durur: bir önizlemenin gösterdiği, pull işleminin yapacağı şeydir. Bir pull işleminin bayt bayt olduğu gibi bırakacağı dosyalar hiç görünmez; raporda bir adın bulunması, o dosyanın değişmek üzere olduğu anlamına gelir. Son satır bunları sayar ve bir pull işleminin değiştirmeyeceği bir çalışma alanı sıfır sayısını bildirir.

Diskte hiçbir şey değişmez. Hiçbir kilit dosyası yazılmaz veya oluşturulmaz, hiçbir varlık kilidi yazılmaz veya kaldırılmaz ve hiçbir güven kaydı oluşturulmaz veya değiştirilmez. Bir yetenek birden fazla sağlayıcı eklentisi tarafından sunuluyorsa ve aralarında hiçbir şey seçim yapmamışsa, çalıştırma seçimi yapılandırmanıza yazmayı önermek yerine neyin sağlanması gerektiğini adlandırarak durur; bir önizleme geçerken bir yapılandırma dosyasını düzenlemez.

Çözümlemenin kendisi yine de çalışır, bu nedenle önbellek yine de dolar. Bir Release’in hangi harici girdileri tükettiği, onun işlenmesinin bir sonucudur ve çözümlemeyi reddeden bir çalıştırmanın bildirecek hiçbir şeyi olmazdı; bu nedenle --dry-run, bir pull işleminin yaptığı gibi tam olarak getirir ve depolar. .aggrega/cache altındaki içerik yalnızca bir kilit dosyasının kaydettiği sabitlemeler aracılığıyla okunur, bu nedenle onu doldurmak bir derlemenin çözümlediği hiçbir şeyi değiştirmez; bir dry run’ın gösterdiği, bir pull işleminin yazacağı şeydir.

Tek başına bir --upgrade bu bayrak altında hiçbir şey sormaz. Onay, tam bir yenileme kayıtlı her sabitlemeyi bıraktığı için vardır ve bir önizleme hiçbirini bırakmaz; bu nedenle bir yenilemenin size neye mal olacağını öğrenmek istediğinizde başvurulacak biçim aggrega pull --dry-run --upgrade --release <release> biçimidir ve yanıt gerekmeden çalışır.

Zaten bu dosyaların hiçbirini yazmayan --verify ile birlikte kabul edilmez. Bu ikili, bayrağın bir şey yapmış gibi görünürken hiçbir şey yapmamasına yol açardı; bu nedenle yok sayılmak yerine reddedilir.

Sabitleme yapan bir önizlemenin her zaman tam olarak gösteremediği bir şey vardır ve bu olduğunda bunu belirtir. Sabitleme istenen bir pull, her Recipe ve FeatureRecipe’in yanındaki entity.lock dosyasını yeniden yazar ve ardından harici girdilerini keşfetmek için Release’i işler; bir önizleme bu kilitlere dokunmaz, bu nedenle orada kayıtlı bir sabitleme eskimişse (örneğin içe aktarılan bir dosyayı sabitlendikten sonra düzenlediyseniz) bu işleme, yazılmamış kilidin hâlâ kaydettiği eski özete tabi tutulur ve durur. Rapordaki diğer her şey tam olarak bir pull işleminin yazacağı şeydir; yalnızca bildirilen kilit dosyasının harici girdi sabitlemeleri eksiktir. Çalıştırma, size tamamlanmış gibi görünen bir kilit dosyası vermek yerine bunu hem çıktısında hem de tanılamalarında belirtir. Bir çalışma alanının ilk çözümlemesi bundan etkilenmez, çünkü henüz hiçbir şeyin karşısında eskiyebileceği kayıtlı bir özet yoktur.

Bu sabitlemelerin tanımladığı bileşim

Bir lockfile, bu Release’in bir derlemesinin tüketeceği şeyi sabitler; bu nedenle çözümleme, o derlemenin çizdiği bileşimi çizer: belgeleri çözümler, çalışma alanının eklerinin bildirdiği dönüşümleri uygular ve sonucu, bir derlemenin tamamlanmış bir graf üzerinde yaptığı denetimlerden geçirir. Bundan iki sonuç çıkar ve ikisi de lockfile’ı okuyan ilk derlemede değil, lockfile’ı yazan geçişte ortaya çıkar.

Bu denetimlerin reddettiği bir bileşim pull işlemini durdurur. Hedefi soketinin selector: koşulunu karşılamayan bir uses: kenarı, appliesTo: alanının kabul etmediği bir bileşene eklenmiş bir Feature ve bu denetimlerin bildirdiği diğer tüm ihlaller, aynı belgelerin bir derlemesinin yazdırdığı tanılamayla bu komutu durdurur; durdurma da yalnızca ilkini değil, tek çalıştırmada tüm bulguları adlandırır, böylece tek bir geçiş düzeltilecek listenin tamamını size verir. Bu, yazmadan önce gerçekleşir; bu nedenle <release-stem>.lock ve plugins-trust.yaml tam olarak oldukları gibi bırakılır ve derlenmeyecek bir Release hiçbir zaman temiz biçimde çözümlenmiş olarak kaydedilmez. Bunun kapsamadığı şey, bir karar döndüren eklerdir: burada hiçbir ir-verdict veya render-verdict eki çalışmaz; bu nedenle reddeden bir karar, bu komutu değil, onu çalıştıran derlemeyi, Release kapsamlı lint’i veya Release kapsamlı doğrulamayı durdurur.

Grafı biçimlendiren bir roldeki ek bu geçiş sırasında çalışır; bu nedenle çözümlenemeyen bir plugin pull işlemini durdurur. Bir label-transform eki, düğüm etiketlerine göre herhangi bir eşleştirme yapılmadan önce bu etiketleri belirler; bir annotation-transform eki ise Feature eklerine genişleyen açıklamalar ekler. İkisi de grafın içerdiğini değiştirir; bu nedenle grafı çizmek onları çalıştırmak, onları çalıştırmak da her plugin’in kendi baytlarına sahip olmak demektir. Bu geçişin baytlarını elde edemediği bir plugin, plugin’i ve onun için neyin bulunamadığını adlandırarak çalıştırmayı durdurur; bu, aynı çalışma alanının bir derlemesinin baytları elde edemediğinde yaptığı retle aynıdır. Çalıştırılan, bu geçişin az önce çözümlediği ek listesidir ve lockfile’ın sonraki bir derlemenin yeniden oluşturması için kaydettiği ayarları ve tanım dosyalarını taşır; böylece her iki geçiş de aynı eki aynı girdiye karşı çalıştırır.

Bir pipeline adımının adlandırdığı ve hiçbir yerde bulunmayan bir Plugin de pull işlemini durdurur. Bir Recipe’in veya FeatureRecipe’in pipeline alanının adlandırdığı her Plugin, Release’in diğer bağımlılıklarıyla birlikte çözümlenir: bir katalog dizininden, derleyici ikili dosyasının içindeki kopyadan, içerik önbelleğinden veya kayıt defterinden. Bunların hiçbirinde bulunmayan bir Plugin, bir derlemenin de yükleyemeyeceği bir Plugin’dir. Bu nedenle pull, herhangi bir şey yazmadan önce durur; Plugin’i ve pipeline’ı onu adlandıran Recipe’i veya FeatureRecipe’i, bir derlemenin o adıma ulaştığında oluşturduğu koşulla adlandırır (A plugin reference is not a Plugin entity (Bir plugin başvurusu bir Plugin varlığı değil)). Bu, Manifest’in bağladığı her Recipe ve FeatureRecipe için geçerlidir; bu Release’te hiçbir şeyin eklemediği bir tanesi de buna dahildir, çünkü her biri render edilsin ya da edilmesin çözümlenir ve sabitlenir. Plugin’i yayımlayın veya derlenmiş .wasm dosyası yanında olacak şekilde bir katalog dizinine yerleştirin ve yeniden pull edin.

Bu durdurma ile kısıtlı bir çalıştırma, bilinçli olarak farklı sonuçlardır. Tamamlanamayan bir render, yani Çözümlemenin harici girdileri nasıl bulduğu ve Çevrimdışı bölümlerinin ikisinin de anlattığı durum, her bağımlılık sabitlemesini doğru bırakır; bu nedenle sabitlemeler yazılır ve eksiklik bildirilir. Denetimlerin reddettiği bir bileşim ise çözümlenen şeydeki bir eksiklik değildir: derlenmeyecek bir Release’tir; bu nedenle onun için hiçbir şey sabitlenmez ve çalıştırma durur.

Önbellek

Çekilen içerik .aggrega/cache altında saklanır; katalog varlıkları için bir entities/ alt ağacına, kaynak yapıtlar için bir source-artifacts/ alt ağacına ve bir işlemenin tükettiği harici girdiler için bir inputs/ alt ağacına bölünür. Bir katalog varlığının yuvası türü, koordinatı ve sürümüyle adlandırılır (bu nedenle aynı koordinatı ve sürümü paylaşan bir Component ile bir Recipe iki ayrı yuvada kalır), bir kaynak yapıtınki getirildiği yer, sürümü ve içerik özetinin bir önekiyle, bir harici girdininki ise içerik özetiyle adlandırılır; bir derlemenin bunlardan herhangi birinden okuduğu şey, kilit dosyasının kaydettiğiyle karşılaştırılarak denetlenir. Bu nedenle özdeş sürüm sabitlemeleri Releases arasında tek bir yuvayı paylaşır. Her kaynak yapıt yuvası yetkili arşivi, yeniden oluşturulan bir çıkarımı ve küçük bir meta veri dosyasını tutar; çıkarım her okumada yeniden oluşturulur, dolayısıyla derleme çıktısı çıkarılan dosyaların durumuna değil, arşive ve kilit dosyasına bağlıdır.

Önbelleğin bir değerden türettiği her ad Windows, Linux ve macOS’in hepsinin kabul ettiği bir addır. Bir koordinat, bir sürüm, bir kayıt defteri ana bilgisayarı veya bir özet, bir dosya adının taşıyamayacağı karakterler içerir: bir koordinatın parçaları arasındaki /, bir sürümden önceki, sha256: içindeki ve bir kayıt defterinin bağlantı noktasından önceki :. Bu yüzden her değer (bir tür, bir koordinat, bir sürüm, bir kayıt defteri ana bilgisayarı veya bir özet) bir dizin ya da dosya adı olmadan önce dönüştürülür: küçük harf, rakam, ., _ ve - olduğu gibi yazılır, diğer her karakter ise + ile başlayan bir kaçış dizisi olarak yazılır. 1.0.0 sürümündeki Component core/devtool/adminer:1.0.0, entities/+zx000043omponent/core+zsdevtool+zsadminer+zx00003a1.0.0/1.0.0/ yuvasıdır ve bir içerik özetiyle adlandırılan yuva sha256+zx00003a<hex> olur. Büyük harf de kaçışlanır; böylece yalnızca harf büyüklüğünde farklılaşan iki koordinat, büyük/küçük harfi yok sayan bir dosya sisteminde iki ayrı yuvada kalır; Windows’un bir aygıt için ayırdığı con gibi bir adın ilk harfi kaçışlanır; ve hiçbir ad nokta ile bitmez. İki farklı değer hiçbir zaman aynı adı paylaşmaz ve bir değer her makinede aynı ada sahiptir. aggrega cache status, her girdiyi dönüştürülmüş adlarla değil, adlarının türetildiği değerlerle listeler; bir katalog varlığını koordinatı, sürümü ve türüyle.

Bir arşiv girdisi yayıncısının verdiği adı korur; bu yüzden Windows’ta Windows’un tutamayacağı bir girdi reddedilir. Bir kaynak yapıtın veya bir katalog varlığının arşivinin taşıdığı dosyalar, önbellek tarafından dönüştürülmeden arşivin verdiği adlarla yerleştirilir. Çıkarım Windows’ta çalıştığında, Windows’un yazıldığı haliyle tutamayacağı bir parça içeren girdi —herhangi bir harf büyüklüğünde, uzantılı veya uzantısız, NUL ya da aux gibi bir aygıt için ayrılmış ad veya nokta ya da boşlukla biten bir parça— girdiyi adlandıran E0340 ile reddedilir ve o arşivden hiçbir şey yerleştirilmez. Linux ve macOS’te böyle bir girdi adlandırıldığı gibi yerleştirilir. Çıkarım dizininin dışına tırmanan bir girdi her makinede reddedilir.

Bir katalog varlığının yuvası yalnızca manifest dosyasıyla birlikte bir girdidir. Yuva, bir kayıt defterinin sunduğu içeriği ve onun yanında bu içeriği tanımlayan manifest dosyasını tutar. Yalnızca içeriği tutan bir yuva —iki yazma arasında durmuş bir getirme veya oraya elle konmuş bir dosya— bir girdi değildir: bir çekme işlemi ve doğrulayan bir çekme işlemi, erişilebildiği durumda bunu varlığın kayıt defterinden yeniden ister; hiçbir zaman getirme yapmayan bir derleme ise, hiçbir kayıt defterine erişilemediğinde bir çekme işleminin yaptığı gibi, varlığı eksik sayar.

Önbelleğe ulaşan şey iki şeye tabi tutulur: varlığın kendi şemasının tanımladığı biçim ve önbelleğin onun için adlandırdığı yer. Bir kayıt defterinden getirilen gövde, önbelleğe alınmadan önce kendi türünün şemasından —onu geri okuyan denetimin aynısından— geçirilir; böylece kayıt defterinin sunduğu ve kendi şemasının reddettiği yayımlanmış bir varlık ya da kitaplık, önbelleğe alınıp sonradan bir hata olarak karşılanmak yerine, getirileni adlandırarak çekme işlemini durdurur. Ve bir önbellek konumunun oluşturulduğu, önbelleğe alınmış bir dosyayı değerin adlandırdığı yerden başka bir yere koyacak bir değer —sürüm yerine yol olan bir sürüm, yerinin üstüne tırmanan bir kaynak url yolu veya module_subdir— konumun oluşturulduğu yerde, sorunlu değeri adlandırarak reddedilir. Sizin yazdığınız bir Recipe veya FeatureRecipe içine yazılan bir değer de önbellek konumu ondan oluşturulduğu anda aynı şekilde denetlenir; bir git kaynağının module_subdir değeri ise aşağıda açıklandığı gibi daha önce, depo getirilmeden önce.

Bir git deposu kendi çalışma kopyasından arşivlenir. Bir git-repository kaynağı için çekme işlemi, depoyu sabitlediği commit’te çalışma kopyasına alır ve module_subdir değerinin adlandırdığı dizini ya da tüm depoyu arşivler. Yazıldığı haliyle deponun üstüne tırmanan bir module_subdir —../shared veya ..\shared— depo getirilmeden önce değeri alıntılayan E0307 ile reddedilir; böylece çalışma kopyasının yanındaki hiçbir şey okunmaz. Deponun commit ettiği bir sembolik bağlantı, gösterdiği yer depo içindeyse işaret ettiği dosya ya da dizin olarak arşivlenir; module_subdir’in kendisi de böyle bir bağlantı olabilir. Depo dışına çıkan bir bağlantı, bağlantıyı ve gittiği yeri adlandıran E0321 ile çekme işlemini durdurur ve hiçbir şey önbelleğe alınmaz; böylece çektiğiniz bir depo, çekme işlemine makinenizdeki bir dosyayı yapıta kopyalatamaz. Çalışma kopyası çekme işlemi durunca kaldırılır; bu yüzden ileti, artık var olmayan bir dizin yerine bağlantıyı depodaki yeriyle ve kaynağın adlandırdığı depo ile revizyonla adlandırır. Bağlantıyı değiştirmek deponun işidir. Çalışma alanı sınırı bunun uyguladığı kuralı açıklar.

Önbellek, komutu çalıştırdığınız dizine değil çalışma alanına bağlanır; böylece bir çalışma alanının tek bir önbelleği olur ve bir alt dizinden çalıştırılan çekme işlemi, kökten çalıştırılan bir derlemenin okuduğu aynı depoyu doldurur.

Hiçbir çalışma alanının bulunmadığı ve hiçbirinin adlandırılmadığı bir çekme işlemi, herhangi bir şey getirilmeden önce reddedilir. Hiçbir şey bir kök adlandırmadığında ve keşif hiçbir şeyi sabitlemediğinde —çalıştırdığınız klasörden veya mutlak bir yolla adlandırılan bir Release için o Release’in kendi klasöründen— kök o klasör olurdu ve altına yazılan bir önbellek onu bir çalışma alanına dönüştürürdü. Bu yüzden çekme işlemi durur, hiçbir kilit dosyası ve önbellek yazmaz; klasörü ve iki çıkış yolunu adlandırır: çalışma alanınızı --workspace-root veya AGGREGA_WORKSPACE_ROOT ile adlandırın ya da o klasöre workspace: bloğu taşıyan bir .aggrega-config.yaml verin. Kök olmadan başlatılmış bir sunucuda workspace_root olmadan çağrılan aggrega mcp çekme aracı da aynı şekilde reddedilir; Yapılandırma bunun geçerli olduğu diğer komutları listeler.

Ağa erişilemeyen yerde derleme

Dışarıya erişen tek adım bu komut olduğundan, sonraki her derlemeyi yerel hâle getirmek için bağlantılı tek bir çalıştırma yeterlidir. Bu çalıştırma kilit dosyasını yazar ve çalışma alanı önbelleğini bu sabitlemelerin adlandırdığı baytlarla doldurur; ardından bir derlemenin bunların ötesinde hiçbir şeye ihtiyacı olmaz.

Bağlantısız makineye üç şey taşınır:

  • Release ve kilit dosyası. <release-stem>.lock dosyasını Release’in yanına commit edin; derlemeye her bağımlılığın hangi sürüme ve özete çözümlendiğini söyleyen odur.
  • plugins-trust.yaml, çalışma alanının karar döndüren bir plugin eklediği durumda. Bir derleme, yapılandırmasının adlandırdığı karar eklerini herhangi biri çalışmadan önce bu kayıtla karşılaştırır; dolayısıyla kaydı taşımak, bağlantısız derlemeyi gözden geçirilmiş kimliklere ve pull’un bunlar için doğruladığı imzalara bağlı tutan şeydir. Plugin güven kaydı bölümünde anlatıldığı gibi, onu kilit dosyasının yanına commit edin.
  • Önbellek dizini. Varlıklar, kaynak yapıtlar ve sabitlenmiş girdilerin tümü bu dizin altında bulunur; yerel bir catalog_dirs dizininin sağlamadığı her şey oradan okunur.

Bağlantısız makinede her zamanki gibi derleyin. Dolu bir kilit dosyası üzerindeki derleme kapanışını önbellekten okusa da orada çevrimdışı duruşu ayarlamaya değer: olası bir ağ erişimini, önce zaman aşımına uğraması gereken bir bağlantı denemesi yerine duruşu adlandıran anında bir reddedişe dönüştürür. Önbelleğin tutmadığı her şey ve kilit dosyasının sabitlemediği her dış girdi, eksik olanı ve onu sabitleyecek çözümlemeyi adlandırarak derlemeyi durdurur — boşluğu doldurmak için sessizce hiçbir şey getirilmez.

Hava boşluklu bir makine ile çevrimdışı bir çalışma alanı farklı iddialardır ve bu farkı korumaya değer. Hava boşluğunun ardındaki bir makine, bir kayıt defterinin yerel bir kopyasını ya da ihtiyaç duyduğu her şeyi taşıyan bir catalog_dirs kataloğunu tutabilir; bu durumda o makinedeki sıradan bir pull, dışarıya hiç erişmeden karşılanabilir. Çevrimdışı duruş, makinenin ne tuttuğunu değil, bir komutun neye erişebileceğini tanımlar; Çevrimdışı bölümü neyi reddettiğini ve neye dokunmadığını açıklar.

Çevrimdışı

Çevrimdışı duruş altında — bir yapılandırma dosyasındaki üst düzey offline anahtarı, ortamdaki AGGREGA_OFFLINE ya da komut satırındaki --offline — aggrega pull ağ erişimini reddeder. Ret, bir getirme işleminin ortasında bir zaman aşımı olarak değil, herhangi bir bağlantı denenmeden önce gerçekleşir; böylece çevrimdışı bir pull hiçbir registry’ye ve hiçbir uzak kaynağa ulaşmaz. Duruşu commit edilmiş bir dosya ya da dışa aktarılmış bir değişken belirlediyse ve bunu tek bir komut için aşmak istiyorsanız, --offline=false yalnızca o çalıştırma için ağa izin verir.

--upgrade bu duruş altında doğrudan reddedilir ve buradaki seçenekler arasında reddedilen tek seçenek odur. Tam bir yenileme her bağımlılığı bir registry’nin o anda sunduğu en yüksek sürüme taşır; bu nedenle bir registry’ye o anda neyi sunduğunu sorması gerekir. Sıradan bir pull bunu gerektirmez: zaten kaydettiği sabitlemelere uyar, yalnızca sabitlemesi olmayanları çözümler ve bu nedenle makinenin elindekilerle karşılanabilir. Ret, duruşu üç yerden hangisinin belirlediğini ve tek bir çalıştırma için ağa nasıl izin verileceğini söyler.

Çözümleme bundan sonra yalnızca makinenin zaten elinde bulunanlardan yararlanır: catalog_dirs arama yığını ve .aggrega/cache altındaki önbellek. Her başvuruyu karşılayan bir katalog ve önbellek üzerinde çevrimdışı bir pull normal şekilde tamamlanır ve sıradan bir lockfile yazar. Lockfile her bağımlılığın URI’sini, çözümlenen sürümünü ve özetini kaydeder; baytları bu yerlerden hangisinin sunduğunu ise asla kaydetmez — bu nedenle aynı sürümleri çözümleyen çevrimdışı bir pull ile çevrimiçi bir pull aynı lockfile’ı yazar.

Çevrimdışı bir pull’un yerel olarak karşılayamadığı bir bağımlılık pull’u durdurur. Girdi asla atlanmaz:

  • Hiçbir yerde çözümlenemeyen bir katalog varlığı pull’u durdurur; başvuruyu ve nereden başvurulduğunu adlandırır, böylece hem eksik bağımlılık hem de onu isteyen şey adlandırılmış olur.
  • Uzak bir source: pull’u durdurur; kaynağı adlandırır ve size ya ağ erişimine izin vermenizi ya da önbelleği bağlı bir ortamdan doldurmanızı söyler.
  • Önbellekte bulunan ancak gerekli imzasını lockfile’ın kaydetmediği ya da kaydedilmiş imzasını bir build’in kabul etmediği bir bağımlılık, pull’u çevrimdışı ret ile durdurur ve bağımlılığı adlandırır: imzayı kaydetmek, Uymak ve güncellemek bölümünde açıklandığı gibi, onun registry’sine sormak anlamına gelir. Yalnızca o çalıştırma için ağa izin vermek imzayı kaydeder. Bir build’in kabul ettiği kaydedilmiş bir imza yeniden sorgulanmaz; bu nedenle çevrimdışı bir pull’u durdurmaz.

Durdurmayan tek şey harici bir girdidir ve bunun yerine durumu bildirir. Harici girdileri bulan render, henüz depolanmamış olanı getiremez; bu nedenle sabitlenmemiş harici girdisi olan bir Release üzerinde çevrimdışı bir pull tamamlanır, çözümlediği her bağımlılık sabitlemesini yazar ve üç şeyi bildirir: render’ın bitmediğini, neyi sabitlediğini ve bu Release’in bir build’inin URL’yi adlandırarak duracağını. Yazdığı bağımlılık sabitlemeleri doğrudur — hiçbiri render’a bağlı değildi — bu nedenle bir okuyucunun yeniden üretmesi için atılmak yerine korunur.

Bu bir eksiklik değil, bilinçli bir tercihtir ve bunun için bir anahtar yoktur. Doğru işi atan bir pull size başarılı olan kısmı kaybettirirdi; sessiz kalan bir pull ise size tamamlanmış gibi görünen ama tamamlanmamış bir lockfile verirdi. Durumu bildirmek, harekete geçebilmenizi sağlayan tek sonuçtur: pull’u bağlı bir ortamdan ya da önbelleği içeriği zaten barındıran bir ortamdan yeniden çalıştırın; aynı komut içeriği sabitler.

Dolayısıyla çevrimdışı bir pull, bir belgenin adlandırdığı her şey için azaltılmış bir sonuç değil, ağa dokunmayı reddetmedir; harici girdiler içinse neye ulaşamadığını size söyleyen tamamlanmış bir çözümlemedir. Var olan bir lockfile, bağımlılık çözümlemesi tamamlanmış bir lockfile’dır; harici girdilerinin tam olup olmadığını pull’un kendi çıktısı size söyler ve bir build de onu buna göre denetler.

Çevrimdışı duruş altında --verify daha az şeyi kapsar ve bunu bildirir. Kaydedilmiş bir kaynak ref’inin bugün nereyi gösterdiğini sormak, onun uzak deposuna ulaşmak anlamına gelir ve çevrimdışı duruş bunu reddeder. Bu nedenle çevrimdışı bir --verify sabitlenmiş bağımlılıkları denetler ve bu ekseni atlar; hiç doğrulamadığı bir eşleşmeyi bildirmek yerine bunu söyleyen bir satır yazdırır. Yalnızca registry’sinin doğrulayabileceği kaydedilmiş bir imza — önbellekteki imza paketi kaldırılmış ya da değiştirilmiş bir lockfile girdisinde — aynı şekilde, bu tür her girdiyi adlandıran bir satırla atlanır:

verify: offline, so the signature the lockfile records for "<reference>" was not checked at its registry, which alone can say whether a pull would record it again; this verify does not cover it

Registry ne yanıt verirse versin bir pull’un yeniden yazacağı kaydedilmiş bir imza, bunu bilmek için hiçbir yanıt gerekmediğinden, Her iki dosyadaki kaydedilmiş imzaları karşılaştırır bölümünde açıklandığı gibi, çevrimdışıyken de bildirilir.

Bir registry’nin sunduğu ve bir karar rolüne bağlanmış bir plugin, çevrimdışı verify ile çevrimdışı pull’un ayrıştığı yerdir. Böyle bir plugin lockfile’da asla sabitlenmez; bu nedenle her pull onun .wasm dosyasını registry’sinden çözümler ve böyle bir plugin bağlayan bir çalışma alanı üzerinde çevrimdışı bir pull orada durur, plugin’i .wasm dosyasını çözümleyemediği bir plugin olarak adlandırır — içerik önbelleği onu barındırsa bile ve o registry advisory olarak işaretlenmiş olsun ya da olmasın veya imza doğrulamasını atlasın ya da atlamasın. Çevrimdışı bir verify ise registry’ye plugin hakkında hiçbir şey sormaz: plugin’i, bir build’in okuduğu gibi, içerik önbelleğinden okur ve önbellek onun .wasm dosyasını barındırmıyorsa ya da yayımlanmış manifest’inin adlandırdığı özetle artık eşleşmeyen bir dosya barındırıyorsa durur. Yine de plugin’in kimliğini plugin güven kaydıyla karşılaştırır ve host işlevlerini o .wasm dosyasına karşı yeniden denetler; bunlardan biri uyuşmazsa, bağlı bir verify’ın yaptığı gibi durur. Plugin’i, registry ne yanıt verirse versin bir pull’un girdisini yeniden yazdığı durumda bildirir; bu da bir build’in plugin’i girdisi nedeniyle reddettiği durumdur: hiçbir imza kaydetmediği için, çünkü girdisi imza kaydetmiyordur ya da kayıtta ona ait bir girdi yoktur, veya girdisinin kaydettiği imza başka bir yapıt için oluşturulmuştur ve pull bunu plugin’in kendi imzasıyla değiştirir. Diğer her girdiyi — imzasını bir build’in kabul ettiği girdiyi ve önbellekteki imza paketi kaldırılmış ya da değiştirilmiş girdiyi — imzasının denetlenmediğini söyleyen bir satırda adlandırır ve o imza hakkında hiçbir şey bildirmez:

verify: offline, so the signature of "<plugin>" was not checked at its registry, which alone can say whether a pull would record the same signature on its entry in the plugin trust record; this verify does not cover it

Dolayısıyla çevrimdışı bir verify, imzasını bağlı bir pull’un değiştireceği ya da temizleyeceği bir girdiyi — örneğin imzalayanı elle düzenlenmiş ya da registry’sinin artık eklemediği bir girdiyi — geçer ve bunu söyleyen tek şey o satırdır. Hava boşluklu bir verify kullanılabilir olmaya devam eder; size söylemediği şey, bir ref’in o zamandan beri taşınıp taşınmadığı ya da atlanan bir imzanın yeniden kaydedilip kaydedilmeyeceğidir. Yalnızca çıkış kodunu okuyan bir denetim bunları ancak verify bağlı olarak çalıştığında kapsar.

aggrega build ile entegrasyon

  • Doğrulama. aggrega build, çözümlenen her bağımlılığı lockfile’a karşı doğrular ve sapma durumunda durur: içeriği artık sabitlemesiyle eşleşmeyen bir varlık, kütüphane veya plugin; Release’in artık ulaştığı ancak lockfile’ın sabitlemediği ya da lockfile’ın sabitlediği ancak Release’in artık ulaşmadığı bir başvuru ve pull’dan sonra düzenlenmiş bir Release dosyası. Bunu gidermek için durmanın yazdırdığı komut olan aggrega pull --release <release> komutunu çalıştırın: pull, Release’i şu anki hâliyle çözümler, değişen sabitlemeleri yeniden yazar ve diğerlerinin hepsini korur; böylece sizin değiştirmediğiniz hiçbir şey kaymaz. Değişen şey bir Recipe’nin yerel kaynağı altındaki bir dosyaysa, pull önce Varlık kilidi bölümünün açıkladığı gibi o varlık için aggrega pin komutunu belirtir. Bu komutun az önce yazdığı bir lockfile bu denetimi geçer, çünkü komut onu yazmadan önce aynı denetimi çalıştırır; bir pull’un hemen ardından sapma nedeniyle duran bir build, pull’dan farklı girdiler almıştır — birine verilip diğerine verilmeyen bir --catalog dizini ya da ikisi arasında düzenlenmiş bir çalışma alanı yapılandırması gibi — bu nedenle ikisini aynı girdiler üzerinde çalıştırın. aggrega validate --release ve bir Release’i çözümleyen her aggrega inspect seçimi, lockfile’ı aynı denetime tabi tutar ve aynı durmayla reddeder; böylece ikisi de bir build’in reddettiği bir lockfile’ı geçerli saymaz.
  • Otomatik pull. Lockfile yoksa ve auto_pull true ise, aggrega build önce pull’u otomatik olarak çalıştırır. auto_pull varsayılanı olan false ise, build durur ve sizden pull yapmanızı ister. Bir build’in çalıştırdığı pull pin_sources_at_pull ayarını izler; bu nedenle sabitlenmemiş bir varlık üzerinde tam olarak bir pull’un durduğu gibi durur. Bir build’in çalıştırdığı pull adımı bu sayfanın açıkladığıyla aynıdır; bu nedenle mevcut bir lockfile’ı dolduran bir build, taşınmış bir kaynak ref’i üzerinde tam olarak aggrega pull gibi durur — bkz. Belirlenimcilik ve bütünlük.
  • Çevrimdışı. Çevrimdışı duruş altında aggrega build yalnızca makinede zaten bulunanı kullanır ve herhangi bir bağlantı denenmeden önce ağ erişimini reddeder. İçeriği önbellekte bulunmayan bir başvuru, bir getirme işleminin ortasında başarısız olmak yerine build’i durdurur; lockfile’ı olmayan ve onu doldurması istenmeyen bir build ise tıpkı çevrimiçiyken olduğu gibi, onu dolduracak pull’u belirterek durur. --auto-pull reddedilmez: istediği doldurma bu sayfanın açıkladığı pull’dur; bu nedenle zaten önbelleğe alınmış veya yerel bir katalogda bulunan katalog varlıkları üzerinde lockfile’ı bir registry’ye ulaşmadan yazar — chart’ı uzak bir kaynaktan getirilen bir Recipe yeniden çözümlenir, dolayısıyla önbellek o chart’ı tutsa bile çevrimdışıyken durur — ve ikisinin de tutmadığı bir başvuru — ya da gerekli imzasını lockfile’ın kaydetmediği veya kayıtlı imzasını bir build’in kabul etmediği önbellekteki bir başvuru — onu, pull’un kendi reddiyle o başvuruyu belirterek durdurur. --upgrade, Çevrimdışı bölümünün verdiği nedenle reddedilir.
  • Katalog araması. Pull, hiçbir --catalog verilmediğinde bile .aggrega-config.yaml içindeki catalog_dirs ayarına uyar — ve yapılandırma workspace.releases altında bir Release’e kendi dizinlerini veriyorsa onlara da — ve aggrega build ile aynı ilk-kazanır arama yığınını çözümler; böylece sabitlediği bağımlılıklar build’in aradığıyla eşleşir. Dizin olarak listelenen ama dizin olmayan bir yol (örneğin orada hiçbir şey bulunmuyorsa), herhangi bir şey çözümlenmeden veya yazılmadan önce her iki komut tarafından reddedilir; Yerel varlıkların okunduğu yer bölümünün gösterdiği gibi ret, girdiyi, onu listeleyen yapılandırma dosyasını ve satırı adlandırır.

Çözümlemenin dış girdileri nasıl bulduğu

Bu bölümdeki hiçbir şey yukarıdaki kuralı değiştirmez; herhangi bir şeyin sabitlendiği tek bir an vardır ve o an bu komuttur. Bölümün anlattığı, komutun üç türden üçüncüsüne nasıl ulaştığıdır; bu da çözümlemeyi bir işlem hattına bağlarken, kısmen başarısız olmuş bir çalıştırmayı okurken ya da bu komutun neden işleme yaptığını anlamaya çalışırken önem taşır.

Bir katalog varlığı ve bir kaynak yapıt her biri bir belgede adlandırılır; bir dış girdi adlandırılmaz. İlk ikisini çözümlemek, yazdıklarınızı okumaktan ibarettir. Bir dış girdi ise işleme sırasında bir provider tarafından adlandırılır ve hangi URL’leri adlandırdığı, işlenen değerlere bağlıdır: bulunmayan bir values girdisi, bir chart şemasının bütün bir alt ağacını derlenmemiş, o alt ağaçtaki her uzak başvuruyu da istenmemiş bırakır. Release’in hiçbir okunması bu kümeyi sayamaz.

Bu nedenle komut tek geçişte iki şey yapar: belgelerin adlandırdığı kapanışı çözümler ve sabitler, ardından provider’ların hangi uzak belgeleri istediğini görmek için bu kapanışı işler. İşlenen yapıtlar atılır, sabitlemeler tutulur. Her ikisi de tek komutun içindedir ve hiçbiri bir şeyin sabitlenebileceği ikinci bir an değildir; kilit dosyası bir kez yazılır ve her sabitlemeyi taşır.

Çözümlemeyi otomatik bir işlem hattına ucuz bir adım olarak bağlamadan önce bilinmesi gereken iki sonuç vardır. İşleme yaptığı için yalnızca belgeleri okuyan bir çözümlemeden daha maliyetlidir. Ayrıca yalnızca belgelere dayanan bir çözümlemenin başarısız olamayacağı bir nedenle başarısız olabilir: bu Release’i işleyemeyen bir provider. Bu durumda bağımlılık sabitlemeleri yine yazılır, çünkü bunların hiçbir yönü işlemeye bağlı değildi; tanılama da duran aşamayı, nelerin sabitlendiğini ve bir derlemenin sabitlenmemiş URL’yi adlandırarak duracağını belirtir. Çalıştırma boşa gitmez; Çevrimdışı aynı sonuca farklı bir yoldan ulaşılmasını gösterir.

İşleme, herhangi bir şey yazılmadan önce kilit dosyasını bir derlemenin uyguladığı karşılaştırmaya da tabi tutar. Derlemenin kendi sırasını çalıştırır; böylece bu komutun yazmak üzere olduğu kilit dosyasını, aynı Release’in bir derlemesinin çözümlendiği sonuçla karşılaştırır; tıpkı bir derlemenin diskte bulduğu kilit dosyasını karşılaştırması gibi. Bu karşılaştırmanın reddettiği bir kilit dosyası yazılmaz, komutun ondan sonra yazacağı başka hiçbir şey de yazılmaz; komut, çözümleme ile derlemenin Release’in neye bağlı olduğu konusunda anlaşamadığını belirterek ve ardından karşılaştırmanın adlandırdığı her girdiyi sıralayarak durur. Dosyalarınızdaki hiçbir şey buna neden olamaz ve yeniden çözümlemek aynı anlaşmazlığa ulaşır; bu yüzden yeniden denemek yerine durumu Release ile birlikte bildirin. Yazmayı durduran tek işleme hatası budur ve aynı girdiler üzerinde aynı Release’in bir derlemesinin bu komutun yazdığı bir kilit dosyası için sapma bildirmemesinin nedeni de budur.

İşlemeyi atlamak için bir anahtar yoktur. Böyle bir anahtar, tek bir anın ortadan kaldırdığı sürprizi bir seçenek olarak korurdu: işlemesinin ihtiyaç duyduğu bir girdi sabitlenmeden bırakılırken temiz biçimde çözümlenen ve bu durumu ancak derleme sırasında ortaya çıkan bir Release.

--auto-pull bu aynı çözümlemeyi bir derlemenin içine katar ve derleme bir kez işleme yapar. Doldurmanın işlemesi, dış girdileri bulan ve sabitleyen işlemedir; derleme ikinci bir işleme yapmak yerine bu işlemeyi sunar; böylece tek komutluk bir derleme, dolu bir kilit dosyası üzerindeki sıradan bir derlemenin maliyetiyle aynı işlemeye mal olur. Bir derlemenin hangi işleme bayraklarının buna ulaştığını aggrega build açıklar.

Küme, Release’in parametrelerinden çıkar; component sabitlemeleri de zaten böyle davranır. Çözümleme ile derleme arasında bir Release’in parametrelerini düzenlemek Release’te yapılan bir düzenlemedir; bu nedenle derleme, herhangi bir işleme sabitlenmemiş bir URL isteyemeden önce, sapma karşılaştırmasında dosyayı adlandırarak durur; çözüm bu komuttur. Ayrı bir dosyadan içe aktarılan parametreler içeriğe göre kaydedilmez; bu yüzden onun yerine o dosyayı düzenlemek işlemeye ulaşır ve işleme sabitlenmemiş URL’yi adlandırarak durur; çözüm olarak yine bu komut belirtilir.

Belirlenimcilik ve bütünlük

Bir Recipe’in source: alanı, sürümünü Release’in çözümlenmiş values ve infra değerlerine göre (ve aynı yerde tanımlanan locals üzerinden) şablonlayabilir; bunlar pull zamanında çözümlenir ve sonuç sabitlenir. Pull, yalnızca source: alanlarının okuduğu locals: girdilerini ve bu girdilerin de okuduğu girdileri, yalnızca Aggrega’nın kendi şablon yardımcılarıyla değerlendirir: kaynağın okuduğu ve bir Sprig işlevi çağıran bir girdi, girdiyi, alanı ve işlevi adlandırarak pull’u durdurur; hiçbir source: alanının okumadığı bir girdi ise derlemeye bırakılır, derleme de Recipe işlendiğinde onu değerlendirir ve denetler — bkz. Resolving a source: coordinate registers a narrower function set (Bir kaynak koordinatının çözümlenmesi daha dar bir işlev kümesi kaydeder). Değiştirilebilir bir Git etiketi veya dalı, işaret ettiği somut commit’e sabitlenir ve yazdığınız ref de yanına kaydedilir. Derleme zamanında önbellekteki arşivin özeti lockfile’a karşı yeniden doğrulanır, böylece kurcalanmış bir önbellek yakalanır.

Kaydedilmiş bir ref, sabitlediği commit’e bağlı tutulur. Ref okunabilirlik için değil, sonraki çalıştırmalar onu yeniden sorguladığı için kaydedilir: bir derleme onun hangi yapıtı adlandırdığını, bir pull ise hâlâ eskiden işaret ettiği yeri gösterip göstermediğini sorar. Yükseltme olmayan bir pull, kaydedilmiş her ref’e nereyi işaret ettiğini yeniden sorar ve uzak deposunda yer değiştirmiş bir ref, bu değişikliği benimsemek yerine yapıtı, ref’i, kilit dosyasının sabitlediği commit’i ve şimdi çözümlendiği commit’i adlandırarak çalıştırmayı durdurur. Değişikliği benimsemek için aggrega pull --upgrade --release <release> komutunu çalıştırın. Varlık URI’lerini adlandıran hedefli bir yükseltme bunu yapmaz: bir kaynak başvurusu adlandırabileceğiniz bir varlık değildir; bu yüzden hedefli bir çalıştırma onu tam olarak düz bir pull gibi tutar.

Bu denetim, derleme sırasındaki özet yeniden doğrulamasının sizin için yapamayacağı tek şeydir. Yer değiştirmiş bir ref’i benimseyen bir pull, getirilen baytları ve kaydedilen özeti aynı anda yeniden yazardı; böylece bir derlemenin karşılaştırdığı iki değer birlikte değişmiş ve uyuşmuş olurdu; siz de kilit dosyasının incelendiği kaynak içerikten farklı bir içeriği derliyor olurdunuz ve bunu bildiren hiçbir şey olmazdı.

Yalnızca kilit dosyasının kaydettiği bir ref bu şekilde tutulur ve siz bir ref yazdığınızda her zaman kaydedilir. Kaynağını yalnızca version: ile adlandıran bir Recipe’in ref’i yoktur; dolayısıyla sonraki bir çalıştırmanın yeniden sorabileceği bir şey yoktur. Doğru yanıt da budur, çünkü kendiniz yazdığınız bir sürüm siz farkında olmadan değişemez. Nelerin kaydedildiğini kilit dosyası başvurusu belirtir.

Commit’i değil, ref’i yazın. Bir build, git kaynaklı bir yapıtı yazdığınız ref ile, kilit dosyasının kaydettiği ref’e eşleştirerek bulur; böylece ref: v1.2.3, o etiketin sabitlendiği commit’e karşı derlenir ve commit’in Recipe’inizde hiç görünmesi gerekmez. Bunun yerine version: içinde değiştirilebilir bir etiket adlandırmak çalışmaz ve çalışması da amaçlanmaz: version: yazıldığı gibi eşleştirilir ve bir git kaynağı için kilit dosyası bir commit sabitler.

Kilit dosyası, kayıt defterlerinden ve uzak kaynaklardan getirilen içeriği sabitler ve kataloğunuzun dizinlerinden çözümlediği her varlığın özetini, Kilit dosyası bölümünün anlattığı gibi varlık dosyası ve yanında adlandırdığı her dosya üzerinden, ayrıca çözümlemenin okuduğu her Release dosyasının özetini kaydeder. ./ ya da ../ ile başlayan bir kaynağın dosyaları ve bir varlığın içe aktardığı bir yapıt dosyası da Varlık kilidi bölümünün anlattığı gibi o varlığın yanındaki kilitte tek tek sabitlenir; değişen dosyayı adlandıran da budur. Derlemeler arasında çalışma alanınızın geri kalanının bütünlüğü kaynak denetim sisteminin sorumluluğundadır. Belirlenimcilik güvencesinin kapsamı için bayt düzeyinde özdeş çıktı sayfasına bakın.

Kimlik doğrulama

Kayıt defteri kimlik bilgileri yalnızca Docker kimlik bilgisi yapılandırmasından okunur: DOCKER_CONFIG değişkeninin adlandırdığı dizindeki config.json ya da bu değişken ayarlanmamışsa ~/.docker/config.json ile birlikte, dosyanın credsStore veya credHelpers aracılığıyla devrettiği her kimlik bilgisi yardımcısı veya işletim sistemi anahtar zinciri. aggrega login <registry> oraya bir kimlik bilgisi yazar, docker login <registry> de öyle; özel bir OCI kataloğu veya chart kayıt defteri için aggrega pull öncesinde ikisinden birini çalıştırın. podman login ve helm registry login komutlarının yazdığı dosyalar okunmaz.

Okunamayan bir kimlik bilgisi yapılandırması, içeriği gösterilmeden bildirilir. config.json geçerli bir JSON değilse, bir girdinin auth değeri iki nokta üst üste ile birleştirilmiş base64 kodlu bir kullanıcı ve parola değilse ya da dosyanın adlandırdığı bir kimlik bilgisi yardımcısı yanıt veremiyorsa, kayıt defterine ulaşma, kayıt defterini ve kimlik bilgisi dosyasını adlandıran bir iletiyle başarısız olur; ileti dosyanın ya da girdinin içeriğini asla göstermez. aggrega login ve aggrega logout, geçerli JSON olmayan bir config.json dosyasını aynı şekilde bildirir ve içinde hiçbir şeyi değiştirmez. Dosyayı düzeltin; okunamayan bir girdi aggrega login <registry> ile de değiştirilebilir.

Klasik bir Helm chart deposu veya chart arşivi (helm-https-chart), bir compose parçası (compose-https-fragment) ve HTTP ya da HTTPS üzerinden erişilen bir Git deposu (git-repository), curl ve Git’in de okuduğu kullanıcı başına kimlik bilgisi dosyası olan netrc dosyası ile kimlik doğrular. Bu üç türün okuduğu tek kimlik bilgisi deposu budur: ~/.config/helm/repositories.yaml ve Git kimlik bilgisi yardımcıları okunmaz. SSH üzerinden erişilen bir Git deposu SSH aracısı üzerinden kimlik doğrular ve hiçbir netrc dosyası okumaz.

machine charts.example.com
login deploy-bot
password <token>

Hangi dosya okunur. Ayarlanmışsa NETRC ortam değişkeninin adlandırdığı dosya. Aksi hâlde ana dizininizdeki .netrc; Windows’ta, varsa %USERPROFILE% içindeki _netrc, yoksa oradaki .netrc. Eksik bir dosya hiçbir kimlik bilgisi içermez ve hata değildir. Var olan ama okunamayan ya da netrc biçimine uymayan bir dosya komutu E0360 ile durdurur; dosyayı — biçim hatasında satırı da — adlandırır, ancak dosyanın içeriğini asla göstermez: The netrc file cannot be read (netrc dosyası okunamıyor). Linux ve macOS’ta, makinenin diğer kullanıcılarının okuyabildiği bir netrc dosyası onu adlandıran bir uyarıya yol açar; dosyayı yalnızca sizin okuyabileceğiniz hâle getirin (chmod 600).

Bir isteği hangi girdi yanıtlar. Her istek ana makinesine göre — bağlantı noktası olmadan ana makine adı, büyük/küçük harf yok sayılarak — aranır ve o ana makineyi adlandıran ilk machine girdisi, hiçbiri yoksa default girdisi tarafından yanıtlanır. Girdinin login ve password değerleri, http’de de https’te de HTTP temel kimlik bilgileri olarak gönderilir; bunlardan biri eksik olan bir girdi hiçbir şey göndermez. Dizini chart’larını başka bir ana makineye yerleştiren bir depo istek başına yanıtlanır: dizin isteği deponun ana makinesinin girdisini, chart isteği ise chart’ın ana makinesinin girdisini alır. Kimlik bilgisi olmadan giden bir istek anonim olarak okunabilir olmalıdır; 401 veya 403 ile yanıt veren bir sunucu, pull işlemini yetkisiz bir getirme olarak durdurur ve çözüm önerisi eklenecek girdiyi ve onun arandığı dosyayı adlandırır.

Kimlik bilgisi hiçbir yere yazılmaz. Bir getirme çalıştığında okunur ve istekle birlikte gönderilir: kilit dosyası, Recipe’in yanındaki entity.lock, kaynak önbelleği ve her ileti, kaynağın URL’sini sizin yazdığınız gibi taşır.

Bir kaynak URL’si kimlik bilgisi taşımaz. Kaynak url değeri ana makineden önce bir kullanıcı yazan bir Recipe veya FeatureRecipe — https://user:token@charts.example.com/… ya da https://token@charts.example.com/… gibi tek başına yazılmış bir belirteç — belge okunurken, hiçbir şey getirilmeden önce E0361 ile reddedilir: Recipe’i doğrulamak onu reddeder; ona ulaşan her pull, pin ve derleme de öyle. İleti ana makineyi adlandırır, kimlik bilgisini asla göstermez: A source URL carries a credential (Bir kaynak URL’si kimlik bilgisi taşıyor). Bunun yerine kimlik bilgisini netrc dosyasının bir machine girdisine koyun. SSH üzerinden, tek başına yazılmış bir kullanıcı — ssh://git@github.com/… — bir sır değil bir hesap adlandırır ve kabul edilir; oraya yazılmış bir parola ise yine reddedilir.

Denetim URL’nin yalnızca ana makineden önceki kısmını okur. Bir sorgu dizesinde veya yolda taşınan bir belirteç — …/index.yaml?access_token=… — algılanmaz, bu nedenle oraya yazmayın: URL kilit dosyasına, entity.lock dosyasına ve kaynak önbelleğine, önbellek dizinlerinin adları da dahil olmak üzere yazıldığı gibi kaydedilir.

Ortam değişkenleri

pull komutunun okuduğu çalışma alanı ayarları, commit edilmiş yapılandırmanın üstünde ve her bayrağın altında olmak üzere ortam üzerinden geçersiz kılınabilir: AGGREGA_OFFLINE (bkz. Çevrimdışı ve onun üstündeki bayrak için --offline), AGGREGA_CATALOG_DIRS (işletim sisteminin yol listesi ayırıcısıyla ayrılır; mutlak yollar verin), AGGREGA_ARTIFACT_CACHE_DIR, AGGREGA_DEFAULT_REGISTRY ve AGGREGA_SKIP_SIGNATURE_VERIFICATION (göze batar — bir pull’un imzayı denetleyeceği her yerde, doğrulamanın genel olarak devre dışı bırakıldığına dair bir uyarı günlüğe yazar). Tam liste ve öncelik modeli için environment-variables.md sayfasına bakın.

Ayrıca bakınız

  • ./aggrega-build.md — lockfile’ı doğrular ve yapılandırıldığında otomatik olarak pull yapar.
  • ./aggrega-serve.md — arka plan süreci bu aynı çözümlemeyi aggrega/resolveDependencies altında ve autoPull alanı bunu isteyen bir istek için aggrega/build içinde taşır; böylece bir düzenleyici onu oturumdan ayrılmadan çalıştırabilir; her iki durumda da yalnızca bir istek onu adlandırdığında çalışır ve bu komutun yazdığı aynı lockfile’ı yazar.
  • ./aggrega-push.md — katalog varlıklarını bir kayıt defterine yayımlar.
  • ./aggrega-lint.md — aggrega push öncesindeki yayımlama kapısı.
  • ../../architecture/13-catalog-and-registry.md — katalog, lockfile ve önbellek modelinin tamamı.

Kullanım

aggrega pull [<uri>...] [flags]

Açıklama

Resolve the Release's catalog and source dependencies into the cache and write the per-Release lockfile.
By default, pull reconciles the lockfile against the current dependency resolution while honoring
the pins it already records. That pin discipline governs what a registry or the content cache
serves: such an entity is fetched at its pinned version and verified against its pinned digest,
and if the registry no longer serves the pinned bytes, pull halts rather than silently re-pinning.
An entity a local catalog directory supplies is resolved from that directory instead, at the
version its file declares, and its recorded pin is not consulted — so editing a pin by hand does
not hold a locally-supplied entity at that version, and the reconcile rewrites the entry to match
the file. A reference with no pin — newly added, or removed from the lockfile by hand — is
resolved fresh and added. Entities no longer among the resolved dependencies are pruned.
Re-running pull on an unchanged dependency set is a no-op.
Use --upgrade with no positional arguments to discard the existing lockfile and re-resolve
every entity from current registry state, floating each dependency to the highest available
version. That form drops every recorded pin, so it asks for confirmation first; --yes answers in
advance, and on a non-interactive stdin it refuses rather than waiting for an answer nobody can
give. Pass one or more entity URIs after --upgrade to upgrade only those: each named pin
is dropped and re-resolved fresh while every other pin — and the recorded external inputs —
is held unchanged. A named target may also be a plugin that returns an accept-or-reject verdict;
such a plugin carries no lockfile pin, and its identity is recorded beside the lockfile instead.
Naming one the workspace still attaches adopts the identity it resolves to. Naming one the
workspace no longer attaches drops its recorded identity — the one way to clear an entry that
outlived the attachment it was recorded for. A bare --upgrade does both for every plugin at once.
A URI given without --upgrade is a usage error.
Each Recipe and FeatureRecipe this Release builds from one of your catalog directories carries
the pins for its own inputs in the entity.lock beside it: a remote source: written out in full,
a file an artifacts entry imports, and each file of a local source:. Recording them is the
entity author's step, aggrega pin.
By default pull records none of them, and halts on an entity whose lock is missing any, naming
the entity, each input and its class, and the command that records them. A local source's files
are held to their pins as one set: a file added, changed or removed since the pin halts the pull
the same way.
Pass --pin-sources, or set pin_sources_at_pull in the workspace configuration, to have pull run
that same step instead; --pin-sources=false restores the halt for one run.
Which files of a local source directory belong to its entity was decided when the entity was
pinned, by the ignore rules of the plugin that served its capability for the author, and its
entity.lock records that decision. Where the plugin this workspace binds for that capability
declares different rules, pull prints a warning naming both plugins and the difference, and
carries on: the entity's files are the ones its recorded rules kept.

Bayraklar

BayrakVarsayılanAçıklama
--catalog[]Katalog dizini; tekrarlanabilir. Her —catalog <dir>, katalog arama yığınının başına eklenir (ilk eşleşme kazanır): çalışma alanının catalog_dirs değeri ya da çalışma alanı yapılandırmasının workspace.releases altında kendi dizinlerini verdiği bir Release için o Release’inkiler; yığın, varsa çalışma alanı kökündeki catalog adlı dizinle biter. Boş yazılmış bir catalog_dirs listesi hiçbir yerel kataloğu okumaz.
--detailfalseÇözümlenen her varlık için bu pull’un ne yaptığını yazdırır — bir kayıt defterinden yeni getirdi, bir önbellek yuvasını yeniden kullandı, yerel bir katalogda buldu, derleyici ikilisinin içinden sundu ya da harici (Release’in kendi Aggregate’i veya Manifest’i, Release’in adlandırdığı dosyadan ya da girdiden okunur). Yalnızca stdout; lockfile’a yazılmaz
--dry-runfalseBağımlılıkları çözümler ve bu pull’un yazacaklarını yazmak yerine yazdırır: her dosyanın yolu ve içereceği içerik stdout’a gider; lockfile, kaydedilmiş sabitlemeleri —pin-sources altında değişecek her Recipe ve FeatureRecipe’in yanındaki entity.lock ve plugin güven kaydı hiç değiştirilmez. Yalnızca gerçekten değişecek dosyalar adlandırılır. Çözümlemenin kendisi aksi durumda nasıl çalışacaksa tam öyle çalışır; bu nedenle içerik önbelleği yine dolar, sabitlenmemiş bir varlıkta duracak bir pull burada da durur ve çıplak bir —upgrade hiçbir sabitlemeyi düşürmediği için hiçbir şey sormaz — bir kuru çalıştırmanın gösterdiği, bir pull’un yazacağı şeydir. Bunların hiçbirini zaten yazmayan —verify ile birlikte kabul edilmez
--include-prereleasefalseHenüz uygulanmadı: kabul edilir ve yok sayılır; böylece onu geçiren bir betik, bayrak etki göstermeye başladığında da çalışmaya devam eder
--pin-sourcesfalseBu Release’in derlediği Recipes ve FeatureRecipes üzerinde varlık yazarının sabitleme adımını çalıştırır; kilidi bunları kaydetmeyen bir varlıkta durmak yerine, her birinin yanındaki entity.lock dosyasına okuduğu her girdinin sabitlemesini kaydeder — tam olarak yazılmış bir remote source:, bir artifacts girdisinin içe aktardığı bir dosya ve yerel bir kaynağın her dosyası. 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 yeri olduğunda çalışır: katalog dizinlerinizden birindeki bir belge. Önbellekten çözümlenen bir varlığın böyle bir yeri yoktur ve asla sabitlenmez. Çalışma alanının pin_sources_at_pull ayarını her iki yönde de geçersiz kılar: ayar ne derse desin, —pin-sources bu çalıştırma için sabitler ve —pin-sources=false bu çalıştırma için durur
--progressfalsestderr bir terminal olmadığında bile pull ilerleme yüzeyini açmaya zorlar ve her adım tamamlandıkça süresiyle birlikte adım başına bir düz satır yazdırır. Varsayılan auto’dur: etkileşimli aşama kontrol listesi yalnızca stderr kaçış dizilerini yorumlayan bir terminal olduğunda gösterilir, yorumlamayan bir terminal aynı düz satırları alır, yönlendirilmiş veya borulanmış çıktı ise hiçbirini almaz
--quietfalsestderr üzerindeki pull ilerleme yüzeyini susturur. stdout’u etkilemez. —progress’e göre önceliklidir
--release—Release YAML dosyasının yolu (zorunlu). Göreli bir yol, çalışma alanı köküne göre değil, komutu çalıştırdığınız dizine göre çözümlenir. Bu dizin hiçbir çalışma alanında değilse ve bir kök adlandırılmamışsa, mutlak bir yol çalışma alanını Release’in kendi klasöründen bulur
--upgradefalseBağımlılıkları mevcut kayıt defteri durumundan yeniden çözümler ve her birini mevcut en yüksek sürüme taşır. Çıplak kullanımda (konumsal URI olmadan) lockfile’ı atar ve her varlığı yeniden çözümler; kaydedilmiş her sabitlemeyi düşürdüğü için önce onay ister. Bir veya daha fazla varlık URI’si ile yalnızca bunları yeniden çözümler, diğer tüm sabitlemeleri ve kaydedilmiş harici girdileri değiştirmeden tutar ve hiçbir şey sormaz (—verify ile birlikte kullanılamaz)
--verifyfalseMevcut lockfile’ı, bir pull’un şimdi yapacağı bağımlılık çözümlemesine karşı doğrular; lockfile’ı, plugin güven kaydını ya da herhangi bir entity.lock dosyasını yazmaz; sapma veya eksik lockfile durumunda sıfırdan farklı bir kodla çıkar. Çözümleme, lockfile’ın kaydettiği sabitlemelere tam olarak bir pull’un uyduğu gibi uyar: kayıt defteri pull’dan bu yana daha yeni bir sürüm yayımlamış bir başvuru sapma değildir, çünkü bir pull onun sabitlemesini korur; sabitlenmiş bir sürüm altında artık farklı baytlar sunan bir kayıt defteri ise doğrulamayı, bir pull’u durdurduğu gibi durdurur. İçerik önbelleği bir pull’un okuyup doldurduğu gibi okunur ve doldurulur: önbelleğin sabitlemesi altında tuttuğu bir girdi bir kayıt defterine sorulmadan oradan okunur, tutmadığı bir girdi getirilir ve artık sabitlemesiyle eşleşmeyen bir girdi tam olarak bir pull’un davrandığı gibi ele alınır. Ayrıca, katalog dizinlerinizde Release’in ulaştığı her Recipe ve FeatureRecipe’in yanındaki entity.lock dosyasını bir derlemenin onu karşılaştırdığı şeye göre denetler ve bir derlemenin reddedeceği bir sabitlemede sıfırdan farklı bir kodla çıkar: artık kaydedilmiş özetiyle eşleşmeyen içe aktarılmış bir dosya, dosyaları artık kaydedilmiş özetleriyle eşleşmeyen yerel bir kaynak ya da lockfile ile uyuşmayan bir kaynak sabitlemesi. Ayrıca lockfile’ın her yapıt için kaydettiği imzayı ve her plugin için plugin güven kaydını, bir pull’un şimdi kaydedeceğiyle karşılaştırır ve bir pull’un birini kaydedeceği, değiştireceği veya temizleyeceği yerde sıfırdan farklı bir kodla çıkar: bir gereksinimin istediği ama kaydedilmemiş bir imza ve başka bir yapıt için yapılmış bir imza, bir kayıt defterine sorulmadan bildirilir, çünkü bir pull bunları yanıt ne olursa olsun yeniden yazar; bir pull’un yeniden aradığı ve değiştirmeden kaydedebileceği bir imza — yapıt getirilmiştir ya da önbelleğe alınmış imza paketi kaldırılmış veya değiştirilmiştir — kendi kayıt defterine sorulur ya da çevrimdışı duruşta bunu belirten bir satırla denetlenmeden bırakılır; plugin güven kaydının kapsadığı her plugin, her pull’un doğruladığı gibi kendi kayıt defterinde doğrulanır; çevrimdışı duruş bunun istisnasıdır: orada plugin, bir derlemenin okuduğu gibi içerik önbelleğinden okunur, kimliği ve ana makine işlevleri yine denetlenir ve imzası bunu belirten bir satırla denetlenmeden bırakılır; ancak bir derleme onu hiç imza kaydetmediği ya da başka bir yapıt için yapılmış bir imza kaydettiği için reddederse bu bildirilir. Kullanımdan kaldırma işaretleri karşılaştırılmaz. Ayrıca lockfile’ın kaydettiği derleyici ve çekirdek plugin sürümlerini bildirir — bunlar denetim için bildirilir ve asla bu ikiliye karşı karşılaştırılmaz; bu nedenle bir araç zinciri farkı asla sapma değildir. Hangi değer verilirse verilsin —pin-sources ile birlikte kabul edilmez: bir doğrulama, bir entity.lock dosyasında eksik olan bir sabitlemeyi ne kaydeder ne de onda durur; bu nedenle bayrak hiçbir şeyi değiştirmez (—upgrade ile birlikte kullanılamaz)
--yesfalseEtkileşimsiz kullanım için çıplak —upgrade onayını önceden yanıtlar. Yalnızca o tek isteme ulaşır, başka hiçbir şeye değil: pull’un diğer tüm biçimleri hiçbir şey sormaz; bu nedenle onu geçirmek oralarda hiçbir davranışı değiştirmez