Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Phân giải phiên bản

Các artifact của catalog — Components, Features, Recipes, FeatureRecipes, Plugins và Aggregates — mang một metadata.version, và một catalog có thể chứa đồng thời nhiều phiên bản của cùng một artifact. Khi có thứ gì đó tham chiếu đến một artifact, tham chiếu sẽ chọn phiên bản cần dùng. Trang này mô tả cách việc lựa chọn đó hoạt động.

Tham chiếu đến một phiên bản

Một tham chiếu là URI kiểu của artifact, có thể được ghim vào một phiên bản. Ba dạng được chấp nhận:

DạngVí dụChọn
Chính xáccore/datastore/mariadb:1.2.0đúng phiên bản đó
Khoảng (caret)core/datastore/mariadb:^1.2.0phiên bản cao nhất >= 1.2.0 và < 2.0.0
Không có phiên bảncore/datastore/mariadbphiên bản cao nhất hiện có

Dạng caret tuân theo quy ước tương thích theo phiên bản chính quen thuộc từ npm, Cargo và Go modules. Ở mọi dạng, việc phân giải chọn phiên bản cao nhất thỏa mãn tham chiếu, ưu tiên các bản phát hành ổn định hơn các bản tiền phát hành. Một tham chiếu chính xác là cách để không dùng việc lựa chọn tự động và ghim một phiên bản.

Tính tất định

Việc lựa chọn chạy một lần, khi các phụ thuộc được khóa. Lockfile ghi lại phiên bản mà tham chiếu đã chọn — một tham chiếu khoảng được ghi lại ở phiên bản mà nó đã phân giải đến, không bao giờ dưới dạng khoảng — cùng với một dấu vân tay nội dung lấy trên chính tài liệu của phiên bản đó, và mọi lần build sau đều tái tạo đúng cùng một artifact từ bản ghi đó — vì vậy một catalog có thêm phiên bản mới hơn không bao giờ âm thầm thay đổi một bản build đã được khóa. Khóa lại là một hành động tường minh.

Cùng một quy tắc áp dụng bất kể catalog nằm ở đâu: một bản checkout catalog cục bộ và một registry phân giải một tham chiếu đến cùng một phiên bản. Đó cũng là cùng một quy tắc cho mọi lệnh đọc catalog. Lệnh pull ghi lockfile, lệnh build đọc nó, một lần validate, trình soạn thảo và các công cụ dành cho trợ lý đều chọn cùng một phiên bản từ một catalog, bất kể các thư mục của nó chứa bao nhiêu phiên bản của một tên, và bước kiểm tra lockfile của build so sánh phiên bản nó đã chọn với phiên bản mà pull đã ghi lại.

Phụ thuộc thư viện

Các thư viện schema và mapping có thể tái sử dụng (SchemaLibrary, MappingLibrary) phân giải khác: chúng dùng lựa chọn phiên bản tối thiểu — phiên bản thấp nhất thỏa mãn mọi ràng buộc trong toàn workspace — một lần nữa giống Go modules. Điều này giúp việc nâng cấp thư viện là có chủ đích thay vì tự động.

Khi không có gì thỏa mãn một tham chiếu

Nếu một tham chiếu ghim một phiên bản, hoặc một khoảng, mà không phiên bản hiện có nào thỏa mãn — ví dụ :^2.0.0 khi chỉ có các phiên bản 1.x — việc phân giải dừng lại với một lỗi nêu tên tham chiếu như đã viết, gồm cả artifact và ràng buộc, thay vì âm thầm chuyển sang một phiên bản khác. Một lần pull và một lần validate của cùng một Release từ chối nó bằng cùng một lời lẽ. Việc phân giải các phụ thuộc của một Release cũng báo cáo một artifact hoàn toàn không tồn tại bằng chính lời lẽ đó, vì tham chiếu đều không khớp với gì trong cả hai trường hợp — vì vậy hãy đọc cả hai nửa của tham chiếu mà lỗi nêu tên.