Resolución de versiones
Los artefactos del catálogo — Components, Features, Recipes, FeatureRecipes, Plugins y Aggregates — llevan un metadata.version, y un catálogo puede contener a la vez más de una versión del mismo artefacto. Cuando algo hace referencia a un artefacto, la referencia selecciona qué versión usar. Esta página describe cómo funciona esa selección.
Hacer referencia a una versión
Una referencia es el URI de tipo del artefacto, opcionalmente fijado a una versión. Se aceptan tres formas:
| Forma | Ejemplo | Selecciona |
|---|---|---|
| Exacta | core/datastore/mariadb:1.2.0 | exactamente esa versión |
| Rango (caret) | core/datastore/mariadb:^1.2.0 | la versión más alta >= 1.2.0 y < 2.0.0 |
| Sin versión | core/datastore/mariadb | la versión más alta disponible |
La forma caret sigue la convención de compatibilidad por versión mayor conocida de npm, Cargo y los módulos de Go. En todas las formas, la resolución selecciona la versión más alta que satisface la referencia, prefiriendo las versiones estables a las preliminares. Una referencia exacta es la forma de renunciar a la selección automática y fijar una versión.
Determinismo
La selección se ejecuta una sola vez, cuando se bloquean las dependencias. El lockfile registra la versión que seleccionó la referencia — una referencia de rango se registra con la versión a la que se resolvió, nunca como rango — junto con una huella del contenido tomada sobre el propio documento de esa versión, y cada compilación posterior reproduce exactamente el mismo artefacto a partir de ese registro — así, un catálogo que incorpora una versión más reciente nunca cambia en silencio una compilación que ya se bloqueó. Volver a bloquear es una acción explícita.
La misma regla se aplica independientemente de dónde esté el catálogo: un checkout local del catálogo y un registro resuelven una referencia a la misma versión. También es la misma regla para cada comando que lee el catálogo. El pull que escribe el lockfile, la compilación que lo lee, un validate, el editor y las herramientas orientadas al asistente seleccionan todos la misma versión de un mismo catálogo, por muchas versiones de un nombre que contengan sus directorios, y la comprobación del lockfile que hace la compilación compara la versión que seleccionó con la que registró el pull.
Dependencias de bibliotecas
Las bibliotecas reutilizables de esquemas y de mappings (SchemaLibrary, MappingLibrary) se resuelven de otra manera: usan la selección de versión mínima — la versión más baja que satisface todas las restricciones de todo el espacio de trabajo — de nuevo como los módulos de Go. Esto mantiene las actualizaciones de bibliotecas deliberadas en lugar de automáticas.
Cuando nada satisface una referencia
Si una referencia fija una versión, o un rango, que ninguna versión disponible satisface — por ejemplo :^2.0.0 cuando solo existen versiones 1.x —, la resolución se detiene con un error que nombra la referencia tal como está escrita, artefacto y restricción juntos, en lugar de recurrir en silencio a una versión distinta. Un pull y un validate de la misma Release la rechazan con las mismas palabras. Al resolver las dependencias de una Release, también se informa con esas mismas palabras de un artefacto que no existe en absoluto, ya que la referencia no coincidió con nada en ninguno de los dos casos — así que lee ambas mitades de la referencia que nombra el error.