Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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:

BentukContohMemilih
Tepatcore/datastore/mariadb:1.2.0tepat versi tersebut
Rentang (caret)core/datastore/mariadb:^1.2.0versi tertinggi >= 1.2.0 dan < 2.0.0
Tanpa versicore/datastore/mariadbversi 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.