Resolução de versões
Os artefactos do catálogo — Components, Features, Recipes, FeatureRecipes, Plugins e Aggregates — têm um metadata.version, e um catálogo pode conter em simultâneo mais do que uma versão do mesmo artefacto. Quando algo referencia um artefacto, a referência seleciona a versão a utilizar. Esta página descreve como funciona essa seleção.
Referenciar uma versão
Uma referência é o URI de tipo do artefacto, opcionalmente fixado numa versão. São aceites três formas:
| Forma | Exemplo | Seleciona |
|---|---|---|
| Exata | core/datastore/mariadb:1.2.0 | exatamente essa versão |
| Intervalo (caret) | core/datastore/mariadb:^1.2.0 | a versão mais alta >= 1.2.0 e < 2.0.0 |
| Sem versão | core/datastore/mariadb | a versão mais alta disponível |
A forma caret segue a convenção de compatibilidade por versão major conhecida do npm, do Cargo e dos módulos Go. Em todas as formas, a resolução seleciona a versão mais alta que satisfaz a referência, preferindo versões estáveis a pré-versões. Uma referência exata é a forma de prescindir da seleção automática e fixar uma versão.
Determinismo
A seleção é executada uma única vez, quando as dependências são bloqueadas. O lockfile regista a versão que a referência selecionou — uma referência de intervalo é registada na versão para a qual foi resolvida, nunca como o intervalo — juntamente com uma impressão digital do conteúdo calculada sobre o próprio documento dessa versão, e cada compilação posterior reproduz exatamente o mesmo artefacto a partir desse registo — assim, um catálogo que recebe uma versão mais recente nunca altera silenciosamente uma compilação já bloqueada. Voltar a bloquear é uma ação explícita.
A mesma regra aplica-se independentemente do local onde o catálogo se encontra: um checkout local do catálogo e um registry resolvem uma referência para a mesma versão. É também a mesma regra para todos os comandos que leem o catálogo. O pull que escreve o lockfile, a compilação que o lê, um validate, o editor e as ferramentas destinadas ao assistente selecionam todos a mesma versão a partir de um único catálogo, por mais versões de um nome que os seus diretórios contenham, e a verificação do lockfile feita pela compilação compara a versão que selecionou com a que o pull registou.
Dependências de bibliotecas
As bibliotecas reutilizáveis de esquemas e de mappings (SchemaLibrary, MappingLibrary) são resolvidas de outra forma: utilizam a seleção de versão mínima — a versão mais baixa que satisfaz todas as restrições em todo o workspace — novamente como os módulos Go. Isto mantém as atualizações das bibliotecas deliberadas em vez de automáticas.
Quando nada satisfaz uma referência
Se uma referência fixar uma versão, ou um intervalo, que nenhuma versão disponível satisfaz — por exemplo :^2.0.0 quando só existem versões 1.x —, a resolução para com um erro que nomeia a referência tal como foi escrita, artefacto e restrição em conjunto, em vez de recorrer silenciosamente a uma versão diferente. Um pull e um validate da mesma Release recusam-na com as mesmas palavras. A resolução das dependências de uma Release também comunica com essas mesmas palavras um artefacto que não existe de todo, uma vez que a referência não correspondeu a nada em nenhum dos casos — por isso, convém ler as duas metades da referência que o erro nomeia.