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

Aggrega Entity Lock şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/entity-lock-v1beta1.schema.json

Bir varlığın yanında duran ve o varlığın kendi belgesi dışında başvurduğu girdilerin içerik sabitlemelerini kaydeden entity.lock dosyası: yapıtlarının içe aktardığı dosyalar, yerel bir kaynağın dosyaları ve kimliğini varlığın eksiksiz yazdığı uzak kaynaklar; ayrıca dizin olan bir yerel kaynak için, dosyalarından hangilerinin varlığa ait olduğuna karar veren kurallar. Dosyayı tek bir adım yazar: varlığın yazarının çalıştırdığı ve hiçbir Release gerektirmeyen aggrega pin. aggrega pull ve aggrega push, istendiğinde, yani --pin-sources ile ya da çalışma alanının pin_sources_at_pull veya pin_sources_at_push ayarıyla, aynı adımı çalıştırır ve aynı baytları yazar. Sabitleme istenmeyen bir pull buraya hiçbir şey yazmaz: çalışma alanının kendi katalog dizinlerindeki bir varlık üzerinde, adımın kaydedeceği şeyi dosyanın içerdiğiyle karşılaştırır ve bir sabitleme eksik olduğunda ya da artık girdisiyle eşleşmediğinde aggrega pin adını vererek durur; yerel bir kaynakta sabitlemeden bu yana eklenen, değiştirilen veya kaldırılan bir dosya, diğer her eskimiş sabitleme gibi pull işlemini durdurur. aggrega build dosyayı geri okur ve diskteki içeriğin özeti artık kaydedilenle eşleşmediğinde durur. Dosyanın kapsamı bulunduğu dizinle belirlenir; o dizindeki varlığın girdilerini sabitler; böylece her tür kendi yazımını taşımak yerine tek bir dosya adı tüm türlere hizmet eder. Adım, böyle bir girdi okumayan bir varlığın kilidini, geride boş bir kilit bırakmak yerine kaldırır. Varlık belgesinin kendisi hiçbir zaman makine tarafından yazılmaz: yazarın yazdığı şey tam olarak yazıldığı gibi kalır, makinenin türettiği ise burada yer alır. Kilidi commit etmeyi güvenli ve bir diff olarak okunabilir kılan bu ayrımdır; çünkü her satır tek bir girdiyi adlandırır ve değişen bir özet, değişen girdiyi adlandırır. Dosya zaman damgası ve çözümleme meta verisi taşımaz; bu nedenle adımı değişmemiş girdiler üzerinde yeniden çalıştırmak dosyayı bayt bayt aynı bırakır. Sabitleme kaydedebilen tüm türlere tek bir satır biçimi hizmet eder; böylece bir sabitleme hangi türe ait olursa olsun aynı şekilde okunur. Aktarım biçimi kapalıdır (additionalProperties: false). Şema evrimi disiplini: yeni bir isteğe bağlı alan eklemek SemVer-MINOR (eklemeli) bir değişikliktir; bir alanı kaldırmak veya bir kısıtlamayı sıkılaştırmak SemVer-MAJOR bir değişikliktir.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
versionconst 1evetEntity-lock şema sürümü: 1. Şemadaki bir SemVer-MAJOR değişikliği bunu artırır. Sabit: 1
sourceDigestsobject[]hayırBu varlığın başvurduğu ve kimliğini varlığın eksiksiz yazdığı uzak kaynaklar için içerik sabitlemeleri; çözümleme sırasında getirilen baytlardan dondurulur ve önbellekteki kaynağın kaymadığını doğrulamak için derlemede geri okunur. Her girdi, çözümlenmiş kaynak kimliğini {kind, url, chart, moduleSubdir, version} ve içerik özetini (OCI ile dağıtılan bir kaynak için ayrıca manifest özetini) yansıtır. Kimliği bir şablondan doldurulan bir kaynağın (örneğin bir Release’in altyapı değerlerinden okunan bir sürüm) burada girdisi olmaz: hangi yapıtı adlandırdığına varlığı kullanan her Release karar verir, bu nedenle çözümlendiği her kimlik bunun yerine o Release’in kilit dosyasında sabitlenir. Yerel (dosya sistemine göreli) bir kaynağın da burada girdisi olmaz: getirilen bir şey yerine bir yol adlandırır, bu yüzden sabitlenecek edinilmiş bir arşiv yoktur ve dosyaları bunun yerine localSourceDigests içinde tek tek sabitlenir.
artifactDigestsobject[]hayırBu varlığın yapıtlarının $import ile içe aktardığı dosyalar (bir Recipe için, boundary.artifacts girdilerinin içe aktardıkları da) için içerik sabitlemeleri; çözümleme sırasında dondurulur ve içe aktarılan dosyanın kaymadığını doğrulamak için derlemede geri okunur. Değeri bir dosya içe aktarımı olan her yapıt için bir girdi bulunur; satır içi (literal) bir yapıt zaten varlığın parçasıdır ve ayrı bir sabitleme taşımaz, bir kütüphaneden alınan yapıt ise o kütüphanenin çözümlendiği sürümle sabitlenir. Derleme, her iki bloğun girdisini sabitlemesiyle aynı şekilde karşılaştırır ve artık onunla eşleşmeyen bir dosyayı aynı koşulda reddeder.
localSourceDigestsobject[]hayırBu varlığın yerel kaynağının (getirilmek yerine varlığın yanında bir yol olarak yazılan kaynak) dosyaları için içerik sabitlemeleri; varlık sabitlendiğinde dondurulur ve dosyaların kaymadığını doğrulamak için derlemede geri okunur. Kaynağın, varlığın bir yayımının taşıdıklarına kattığı her dosya için bir girdi bulunur: kaynağın adlandırdığı dizin altında, ignore altında kaydedilen kuralların tuttuğu her dosya ya da adlandırdığı tek dosya. Şablon olarak yazılan yerel bir kaynak dizinini ancak bir Release şablonu doldurduğunda adlandırır, bu nedenle varlığın kendi dizininde kaydedilen kuralların tuttuğu her dosyayı katar ve bunların her biri sabitlenir. Varlık belgesi, yanındaki yazarın .aggregaignore dosyası ve bu dosya asla girdi olmaz: belge varlığın kendisidir, ignore dosyasının kuralları ignore altında kaydedilir ve kilit kendi özetini kaydedemez. Kilit burada herhangi bir girdi kaydettiğinde, derleme girdisi olmayan bir dosya barındıran, içeriği artık girdisine özetlenmeyen bir dosya barındıran ya da bir girdinin adlandırdığı dosyayı eksik olan bir kaynağı reddeder.
ignoreobjecthayırBu varlığın yerel kaynak dizini altındaki hangi dosyaların ona ait olduğuna karar veren kurallar; varlık sabitlendiğinde kaydedilir. O dizinin sonraki her okuması bu kuralları uygular, başka hiçbir şeyi uygulamaz: varlığın bir yayımı, bir çekmenin ya da yayımın kilide tuttuğu karşılaştırma, yazarın varlık satırı, bir derlemenin karşılaştırması ve işlemesi ve doğrulayan bir çekme. Dolayısıyla yazarın .aggregaignore dosyasında, çalışma alanının provider bağlamasında ya da aggrega ikili dosyasında yapılan bir değişiklik, varlık yeniden sabitlenene kadar hiçbir özeti değiştirmez ve yeniden sabitlemek değişikliği burada bir fark olarak gösterir. Yalnızca varlık, dizin olan ya da şablon olarak yazılan bir yerel kaynak bildirdiğinde bulunur. Hiç kural kaydetmeyen bir kilit o dizin altındaki her dosyayı tutar. Altında herhangi bir yerdeki sembolik bağlantı izlenmek yerine reddedilir.

Ek özelliklere izin verilmez.

entity-lock.sourceDigests[]

ÖzellikTürZorunluAçıklama
kindenumevetÇözümlenmiş kaynak türü. Kapalı bir kümeden biridir (kilit dosyasının kaynak yapıtı kind alanının ve önbellek meta verisinin kind alanının taşıdığı küme ile aynı), çünkü üçü de aynı çözümlenmiş kaynak kimliklerini kaydeder ve derleme yükleyiciyi seçmek için türü okur. terraform-module-oci kümeye dahildir ve hiçbir kaynak bağdaştırıcısı ona hizmet etmez: onu belirten bir Recipe veya FeatureRecipe okunurken reddedilir. İzin verilen değerler: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci"
urlstringevetÖzetin sabitlediği, yazılmış kaynak URL’si: spec.source.url içinde yazıldığı biçimiyle kimlik URL’si (bir depo kökü ya da helm-https-chart için doğrudan bir .tgz). Derleme bu URL’yi çevrimdışı olarak aynen yeniden oluşturur, bu yüzden çözümlenmiş bir yapıt konumu değil, sabitlemenin anahtarlandığı kararlı kimliktir.
chartstringhayırDepo köklü bir helm kaynağı için chart adı (spec.source.chart); çözümlenmiş kaynak kimliğinin parçasıdır, böylece aynı depo kökünden aynı sürümde sunulan iki chart ayrı sabitlenir. Doğrudan .tgz, OCI, compose ya da git kaynağında bulunmaz; bunların hiçbiri URL içinde bir chart seçmez.
moduleSubdirstringhayırGit kaynaklı bir depo içinde yapıt olan dizin (spec.source.module_subdir); çözümlenmiş kaynak kimliğinin parçasıdır, böylece bir deponun aynı commit’teki iki dizini ayrı sabitlenir. Deponun tamamı yapıt olduğunda ve yapıtına bir klona inerek değil URL ile ulaşan her türde bulunmaz.
versionstringevetKaynağın çözümlendiği somut sabitlenmiş sürüm: helm-* türü için bir chart sürümü, git-repository başvurusu için çözümlendiği commit. Tek bir yol kesimi olarak kaydedilir, çünkü derlemenin kaynağı geri okuduğu önbellek yuvasını oluşturur; bu nedenle /, \ ve .. içermez. Desen: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringevetGetirilen kaynak arşivinin içerik özeti; sha256: ve ardından 64 küçük harfli onaltılık karakter biçimindedir, derlemede önbellekteki baytlara karşı doğrulanır. Desen: ^sha256:[a-f0-9]{64}$.
manifestDigeststringhayırOCI ile dağıtılan bir kaynak için OCI manifest özeti (bağımsız güven kökü); sha256: ve ardından 64 küçük harfli onaltılık karakter biçimindedir. Yalnızca bir OCI kaynağı (helm-oci-chart) için bulunur; yapısı gereği manifest taşımayan https ya da git kaynağında bulunmaz. Desen: ^sha256:[a-f0-9]{64}$.

Ek özelliklere izin verilmez.

entity-lock.artifactDigests[]

ÖzellikTürZorunluAçıklama
namestringevetBu girdinin hangi yapıtın $import dosyasını sabitlediği: artifacts girdisi için artifacts: eşlem anahtarı, bir Recipe’in boundary.artifacts girdisi için boundary/ ve ardından anahtar; böylece her bloğun aynı anahtar altında yazılan girdisi ayrı sabitlenir.
digeststringevetİçe aktarılan dosyanın baytlarının içerik özeti; sha256: ve ardından 64 küçük harfli onaltılık karakter biçimindedir, derlemede doğrulanır. Desen: ^sha256:[a-f0-9]{64}$.

Ek özelliklere izin verilmez.

entity-lock.localSourceDigests[]

ÖzellikTürZorunluAçıklama
pathstringevetDosyanın, varlık belgesini barındıran dizine göreli yolu; eğik çizgilerle yazılır, örneğin charts/app/templates/deployment.yaml.
digeststringevetDosyanın baytlarının içerik özeti; sha256: ve ardından 64 küçük harfli onaltılık karakter biçimindedir, derlemede doğrulanır. Desen: ^sha256:[a-f0-9]{64}$.

Ek özelliklere izin verilmez.

entity-lock.ignore

Bu varlığın yerel kaynak dizini altındaki hangi dosyaların ona ait olduğuna karar veren kurallar; varlık sabitlendiğinde kaydedilir. O dizinin sonraki her okuması bu kuralları uygular, başka hiçbir şeyi uygulamaz: varlığın bir yayımı, bir çekmenin ya da yayımın kilide tuttuğu karşılaştırma, yazarın varlık satırı, bir derlemenin karşılaştırması ve işlemesi ve doğrulayan bir çekme. Dolayısıyla yazarın .aggregaignore dosyasında, çalışma alanının provider bağlamasında ya da aggrega ikili dosyasında yapılan bir değişiklik, varlık yeniden sabitlenene kadar hiçbir özeti değiştirmez ve yeniden sabitlemek değişikliği burada bir fark olarak gösterir. Yalnızca varlık, dizin olan ya da şablon olarak yazılan bir yerel kaynak bildirdiğinde bulunur. Hiç kural kaydetmeyen bir kilit o dizin altındaki her dosyayı tutar. Altında herhangi bir yerdeki sembolik bağlantı izlenmek yerine reddedilir.

ÖzellikTürZorunluAçıklama
pluginobjecthayırVarlık sabitlendiğinde yazarın çalışma alanında varlığın yeteneğine hizmet eden plugin (çalışma alanının o yetenek için provider bağlaması ya da bu yoksa aggrega ikili dosyasına yerleşik plugin), sürüm olmadan adlandırılmış olarak, ve onun bildirdiği yok sayma kuralları. Plugin’in ne sürümü ne de özeti kaydedilir: her okumanın uyguladığı şey kurallardır, bu yüzden aynı plugin’in başka bir sürümü altında yeniden sabitlemek, kurallar değişmedikçe kilidi değiştirmez. Yetenek için kendi plugin’i farklı kurallar bildiren bir pull, bunu her iki plugin’i ve farkı adlandıran bir uyarıyla bildirir ve bu nedenle asla durmaz. Yeteneğe hiçbir plugin hizmet etmediğinde bulunmaz.
rulesobject[]hayırUygulandıkları sırayla, birleştirilmiş kuralların tam hali: önce plugin’in kalıpları, ardından plugin’in adlandırdığı ve taramanın bulduğu her yok sayma dosyasının satırları (bir dizinin kendi dosyası, altındakilerden önce gelir), ardından varlığın yanındaki yazarın .aggregaignore dosyasının satırları. Sonraki bir eşleşme öncekini geçersiz kılar; bu nedenle yazarın dosyası adlandırdığı her yol için son sözü söyler ve ! ile başlayan bir satır, önceki bir kuralın dışladığını geri getirir. Bir kuralın dışladığı dizine girilmez; bu nedenle altındaki bir dosya ancak dizin geri geldiğinde geri gelir.

Ek özelliklere izin verilmez.

entity-lock.ignore.plugin

Varlık sabitlendiğinde yazarın çalışma alanında varlığın yeteneğine hizmet eden plugin (çalışma alanının o yetenek için provider bağlaması ya da bu yoksa aggrega ikili dosyasına yerleşik plugin), sürüm olmadan adlandırılmış olarak, ve onun bildirdiği yok sayma kuralları. Plugin’in ne sürümü ne de özeti kaydedilir: her okumanın uyguladığı şey kurallardır, bu yüzden aynı plugin’in başka bir sürümü altında yeniden sabitlemek, kurallar değişmedikçe kilidi değiştirmez. Yetenek için kendi plugin’i farklı kurallar bildiren bir pull, bunu her iki plugin’i ve farkı adlandıran bir uyarıyla bildirir ve bu nedenle asla durmaz. Yeteneğe hiçbir plugin hizmet etmediğinde bulunmaz.

ÖzellikTürZorunluAçıklama
namestringevetVarlık sabitlendiğinde yeteneğine hizmet eden plugin; <pluginType>/<name> biçiminde, sürüm olmadan: bir okumanın uyguladığı şey aşağıdaki kurallardır ve ad, bunların kime ait olduğunu söyler. En az 1 karakter uzunluğundadır.
patternsstring[]hayırPlugin’in bildirdiği yok sayma kalıpları, bildirdiği haliyle.
filesstring[]hayırPlugin’in, ekosisteminin bir kaynak içinde dikkate aldığını bildirdiği yok sayma dosyalarının adları.

Ek özelliklere izin verilmez.

entity-lock.ignore.rules[]
ÖzellikTürZorunluAçıklama
patternstringevetgitignore söz diziminde tek bir yok sayma kalıbı.
withinstringevetKalıbın kapsamındaki dizin; varlık belgesini içeren dizine göreli ve eğik çizgilerle yazılır; . o dizinin kendisini adlandırır. Plugin’in bildirdiği bir kalıbın kapsamı yerel kaynak dizini, bir yok sayma dosyasının satırınınki o dosyayı içeren dizin, yazarın .aggregaignore dosyasının satırınınki ise varlığın dizinidir.
fromstringevetKalıbın bildirildiği yer: plugin’in bildirdiği bir kalıp için plugin, aksi halde okunduğu yok sayma dosyasının, varlık belgesini içeren dizine göreli yolu.

Ek özelliklere izin verilmez.