Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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:

FormaExemploSeleciona
Exatacore/datastore/mariadb:1.2.0exatamente essa versão
Intervalo (caret)core/datastore/mariadb:^1.2.0a versão mais alta >= 1.2.0 e < 2.0.0
Sem versãocore/datastore/mariadba 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.