Resolução de versões
Os artefatos do catálogo — Components, Features, Recipes, FeatureRecipes, Plugins e Aggregates — têm um metadata.version, e um catálogo pode conter ao mesmo tempo mais de uma versão do mesmo artefato. Quando algo faz referência a um artefato, a referência seleciona qual versão usar. Esta página descreve como essa seleção funciona.
Referenciar uma versão
Uma referência é o URI de tipo do artefato, opcionalmente fixado em uma versão. Três formas são aceitas:
| 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é-lançamentos. Uma referência exata é a maneira de abrir mão da seleção automática e fixar uma versão.
Determinismo
A seleção é executada uma única vez, quando as dependências são travadas. O lockfile registra a versão que a referência selecionou — uma referência de intervalo é registrada na versão para a qual foi resolvida, nunca como o intervalo — junto com uma impressão digital do conteúdo tirada sobre o próprio documento dessa versão, e cada build posterior reproduz exatamente o mesmo artefato a partir desse registro — assim, um catálogo que ganha uma versão mais nova nunca altera silenciosamente um build que já foi travado. Travar novamente é uma ação explícita.
A mesma regra se aplica independentemente de onde o catálogo está: um checkout local do catálogo e um registry resolvem uma referência para a mesma versão. Também é a mesma regra para todo comando que lê o catálogo. O pull que escreve o lockfile, o build que o lê, um validate, o editor e as ferramentas voltadas ao assistente selecionam todos a mesma versão a partir de um único catálogo, por mais versões de um nome que seus diretórios contenham, e a verificação do lockfile feita pelo build compara a versão que ele selecionou com a que o pull registrou.
Dependências de bibliotecas
Bibliotecas reutilizáveis de esquemas e de mappings (SchemaLibrary, MappingLibrary) são resolvidas de outra forma: elas usam 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. Isso mantém as atualizações de bibliotecas deliberadas em vez de automáticas.
Quando nada satisfaz uma referência
Se uma referência fixa 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 como foi escrita, artefato e restrição juntos, em vez de recorrer silenciosamente a uma versão diferente. Um pull e um validate da mesma Release a recusam com as mesmas palavras. A resolução das dependências de uma Release também informa com essas mesmas palavras um artefato que não existe de forma alguma, já que a referência não correspondeu a nada em nenhum dos casos — então leia as duas metades da referência que o erro nomeia.