Sürüm çözümleme
Katalog yapıtları — Components, Features, Recipes, FeatureRecipes, Plugins
ve Aggregates — bir metadata.version taşır ve bir katalog aynı yapıtın birden fazla
sürümünü aynı anda barındırabilir. Bir şey bir yapıta başvurduğunda, başvuru
hangi sürümün kullanılacağını seçer. Bu sayfa bu seçimin nasıl
işlediğini açıklar.
Bir sürüme başvurma
Bir başvuru, yapıtın tür URI’sidir ve isteğe bağlı olarak bir sürüme sabitlenir. Üç biçim kabul edilir:
| Biçim | Örnek | Seçtiği |
|---|---|---|
| Tam | core/datastore/mariadb:1.2.0 | tam olarak o sürüm |
| Aralık (şapka) | core/datastore/mariadb:^1.2.0 | >= 1.2.0 ve < 2.0.0 olan en yüksek sürüm |
| Sürümsüz | core/datastore/mariadb | mevcut en yüksek sürüm |
Şapka biçimi, npm, Cargo ve Go modüllerinden bilinen ana sürümle uyumlu uzlaşımı izler. Her biçimde çözümleme, kararlı sürümleri ön sürümlere tercih ederek başvuruyu karşılayan en yüksek sürümü seçer. Tam bir başvuru, otomatik seçimden çıkıp tek bir sürümü sabitlemenin yoludur.
Determinizm
Seçim, bağımlılıklar kilitlendiğinde bir kez çalışır. Kilit dosyası, başvurunun seçtiği sürümü — bir aralık başvurusu hiçbir zaman aralık olarak değil, çözümlendiği sürüm olarak kaydedilir — o sürümün kendi belgesi üzerinden alınan bir içerik parmak iziyle birlikte kaydeder ve sonraki her derleme bu kayıttan tam olarak aynı yapıtı yeniden üretir; böylece kataloğa daha yeni bir sürüm eklenmesi, önceden kilitlenmiş bir derlemeyi hiçbir zaman sessizce değiştirmez. Yeniden kilitleme açık bir eylemdir.
Aynı kural, kataloğun nerede bulunduğundan bağımsız olarak geçerlidir: yerel bir katalog kopyası ile bir kayıt defteri bir başvuruyu aynı sürüme çözümler. Kataloğu okuyan her komut için de kural aynıdır. Kilit dosyasını yazan pull, onu okuyan derleme, bir validate, editör ve asistana yönelik araçlar, dizinlerinde bir adın kaç sürümü bulunursa bulunsun, aynı katalogdan aynı sürümü seçer; derlemenin kilit dosyası denetimi de seçtiği sürümü pull’un kaydettiği sürümle karşılaştırır.
Kütüphane bağımlılıkları
Yeniden kullanılabilir şema ve eşleme kütüphaneleri (SchemaLibrary, MappingLibrary) farklı çözümlenir: en düşük sürüm seçimi kullanırlar — çalışma alanındaki tüm kısıtları karşılayan en düşük sürüm — bu da yine Go modülleriyle örtüşür. Bu, kütüphane yükseltmelerini otomatik değil bilinçli tutar.
Hiçbir şey bir başvuruyu karşılamadığında
Bir başvuru, mevcut hiçbir sürümün karşılamadığı bir sürümü veya aralığı sabitlerse —
örneğin yalnızca 1.x sürümleri varken :^2.0.0 — çözümleme, sessizce farklı bir
sürüme geri dönmek yerine, başvuruyu yazıldığı gibi, yapıt ve kısıtla birlikte adlandıran
bir hatayla durur. Aynı Release’in bir pull’u ve bir validate’i onu aynı sözcüklerle reddeder.
Bir Release’in bağımlılıklarını çözümlemek, hiç var olmayan bir yapıtı da aynı sözcüklerle
bildirir, çünkü başvuru her iki durumda da hiçbir şeyle eşleşmemiştir — bu yüzden hatanın
adlandırdığı başvurunun her iki yarısını da okuyun.