Resolusi versi
Artefak katalog — Components, Features, Recipes, FeatureRecipes, Plugins,
dan Aggregates — membawa metadata.version, dan sebuah katalog dapat menyimpan lebih dari satu
versi artefak yang sama sekaligus. Ketika sesuatu mereferensikan sebuah artefak,
referensi tersebut memilih versi mana yang digunakan. Halaman ini menjelaskan cara kerja
pemilihan tersebut.
Mereferensikan sebuah versi
Referensi adalah URI tipe artefak, yang secara opsional dipatok ke sebuah versi. Tiga bentuk diterima:
| Bentuk | Contoh | Memilih |
|---|---|---|
| Tepat | core/datastore/mariadb:1.2.0 | tepat versi tersebut |
| Rentang (caret) | core/datastore/mariadb:^1.2.0 | versi tertinggi >= 1.2.0 dan < 2.0.0 |
| Tanpa versi | core/datastore/mariadb | versi tertinggi yang tersedia |
Bentuk caret mengikuti konvensi kompatibel-mayor yang dikenal dari npm, Cargo, dan modul Go. Dalam setiap bentuk, resolusi memilih versi tertinggi yang memenuhi referensi, dengan mengutamakan rilis stabil daripada pra-rilis. Referensi tepat adalah cara untuk tidak menggunakan pemilihan otomatis dan mematok satu versi.
Determinisme
Pemilihan dijalankan sekali, ketika dependensi dikunci. Lockfile mencatat versi yang dipilih oleh referensi — referensi rentang dicatat pada versi hasil resolusinya, tidak pernah sebagai rentang — bersama sidik jari konten yang diambil dari dokumen milik versi tersebut, dan setiap build berikutnya mereproduksi artefak yang persis sama dari catatan tersebut — sehingga katalog yang mendapatkan versi lebih baru tidak pernah diam-diam mengubah build yang telah dikunci. Penguncian ulang merupakan tindakan eksplisit.
Aturan yang sama berlaku di mana pun katalog berada: checkout katalog lokal dan registry meresolusi referensi ke versi yang sama. Aturan ini juga sama untuk setiap perintah yang membaca katalog. Pull yang menulis lockfile, build yang membacanya, validate, editor, dan alat yang ditujukan bagi asisten semuanya memilih versi yang sama dari satu katalog, berapa pun banyaknya versi sebuah nama yang disimpan direktorinya, dan pemeriksaan lockfile oleh build membandingkan versi yang dipilihnya dengan versi yang dicatat oleh pull.
Dependensi pustaka
Pustaka skema dan pemetaan yang dapat digunakan ulang (SchemaLibrary, MappingLibrary) diresolusi secara berbeda: keduanya menggunakan pemilihan versi minimal — versi terendah yang memenuhi semua batasan di seluruh workspace — sekali lagi sesuai dengan modul Go. Hal ini membuat peningkatan pustaka tetap disengaja, bukan otomatis.
Ketika tidak ada yang memenuhi referensi
Jika sebuah referensi mematok versi, atau rentang, yang tidak dipenuhi oleh versi mana pun yang tersedia —
misalnya :^2.0.0 ketika hanya ada versi 1.x — resolusi berhenti dengan
galat yang menyebutkan referensi sebagaimana ditulis, artefak dan batasannya sekaligus, alih-alih
diam-diam beralih ke versi lain. Pull dan validate atas
Release yang sama menolaknya dengan kata-kata yang sama. Resolusi dependensi sebuah Release juga melaporkan
artefak yang sama sekali tidak ada dengan kata-kata yang sama, karena referensi tersebut
tidak cocok dengan apa pun dalam kedua kasus — jadi bacalah kedua bagian referensi yang disebutkan galat tersebut.