버전 해석
카탈로그 아티팩트(Components, Features, Recipes, FeatureRecipes, Plugins,
Aggregates)는 metadata.version을 가지며, 카탈로그는 같은 아티팩트의 여러
버전을 동시에 보유할 수 있습니다. 무언가가 아티팩트를 참조하면, 그 참조가 사용할
버전을 선택합니다. 이 페이지에서는 그 선택이 어떻게 동작하는지 설명합니다.
버전 참조하기
참조는 아티팩트의 타입 URI이며, 선택적으로 버전을 고정할 수 있습니다. 다음 세 가지 형식을 사용할 수 있습니다.
| 형식 | 예 | 선택 대상 |
|---|---|---|
| 정확한 버전 | core/datastore/mariadb:1.2.0 | 정확히 그 버전 |
| 범위(캐럿) | core/datastore/mariadb:^1.2.0 | >= 1.2.0이고 < 2.0.0인 가장 높은 버전 |
| 버전 미지정 | core/datastore/mariadb | 사용 가능한 가장 높은 버전 |
캐럿 형식은 npm, Cargo, Go 모듈에서 익숙한 메이저 호환 관례를 따릅니다. 모든 형식에서 해석은 참조를 만족하는 가장 높은 버전을 선택하며, 프리릴리스보다 안정 릴리스를 우선합니다. 정확한 버전 참조는 자동 선택을 사용하지 않고 하나의 버전을 고정하는 방법입니다.
결정성
선택은 의존성을 잠글 때 한 번만 실행됩니다. lockfile은 참조가 선택한 버전을 기록하며(범위 참조는 범위가 아니라 해석된 버전으로 기록됩니다), 그 버전 자체의 문서에 대해 계산한 콘텐츠 지문도 함께 기록합니다. 이후의 모든 빌드는 그 기록에서 정확히 같은 아티팩트를 재현하므로, 카탈로그에 더 새로운 버전이 추가되어도 이미 잠긴 빌드가 조용히 바뀌는 일은 없습니다. 다시 잠그는 것은 명시적인 작업입니다.
카탈로그가 어디에 있든 같은 규칙이 적용됩니다. 로컬 카탈로그 체크아웃과 레지스트리는 참조를 같은 버전으로 해석합니다. 또한 카탈로그를 읽는 모든 명령에도 같은 규칙이 적용됩니다. lockfile을 작성하는 pull, 그것을 읽는 build, validate, 에디터, 어시스턴트용 도구는 모두 카탈로그의 디렉터리에 한 이름의 버전이 몇 개 있든 하나의 카탈로그에서 같은 버전을 선택하며, build의 lockfile 검사는 자신이 선택한 버전과 pull이 기록한 버전을 비교합니다.
라이브러리 의존성
재사용 가능한 스키마 및 매핑 라이브러리(SchemaLibrary, MappingLibrary)는 다르게 해석됩니다. 이들은 최소 버전 선택, 즉 워크스페이스 전체의 모든 제약 조건을 만족하는 가장 낮은 버전을 사용하며, 이 역시 Go 모듈과 같습니다. 이를 통해 라이브러리 업그레이드가 자동이 아니라 의도적으로 이루어집니다.
참조를 만족하는 버전이 없을 때
참조가 고정한 버전이나 범위를 만족하는 사용 가능한 버전이 없으면(예: 1.x 버전만
있는데 :^2.0.0을 지정한 경우), 해석은 다른 버전으로 조용히 대체하지 않고
작성된 그대로의 참조, 즉 아티팩트와 제약 조건을 함께 명시하는 오류와 함께 중단됩니다.
같은 Release에 대한 pull과 validate는 같은 문구로 이를 거부합니다. Release의
의존성을 해석할 때 아예 존재하지 않는 아티팩트도 같은 문구로 보고됩니다. 어느 경우든
참조가 아무것과도 일치하지 않았기 때문입니다. 따라서 오류가 명시하는 참조의 두 부분을 모두 확인하십시오.