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

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ÖrnekSeçtiği
Tamcore/datastore/mariadb:1.2.0tam 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üzcore/datastore/mariadbmevcut 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, edi​tö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.