Versionamento semântico no Image Builder

O Image Builder usa versionamento semântico para organizar recursos e garantir que eles sejam exclusivos. IDs Essa versão semântica tem quatro nós:

<major>. <minor>. <patch>/<build>

É possível atribuir valores para os três primeiros e filtrar todos eles.

O controle de versionamento semântico está incluído no nome do recurso da Amazon (ARN) de cada objeto, no nível que se aplica a esse objeto da seguinte forma:

1. Versionless ARNs e Name ARNs não incluem valores específicos em nenhum dos nós. Os nós são totalmente excluídos ou são especificados como curingas, por exemplo: x.x.x.

2. A versão ARNs tem apenas os três primeiros nós:<major>. <minor>. <patch>

3. A versão de compilação ARNs tem todos os quatro nós e aponta para uma construção específica de uma versão específica de um objeto.

Atribuição: Para os primeiros três nós, você pode atribuir qualquer valor inteiro positivo, ou zero, com um limite superior de 2^30-1, ou 1073741823 para cada nó. O Image Builder atribui o número da compilação automaticamente ao quarto nó.

Padrão: é possível utilizar qualquer padrão numérico que atenda aos requisitos de atribuição para os nós que você pode atribuir. Por exemplo, você pode escolher um padrão de versão de software, como 1.0.0, ou uma data, como 2021.01.01.

Seleção: com o versionamento semântico, você tem a flexibilidade de utilizar curingas (x) para especificar as versões ou os nós mais recentes ao selecionar a imagem base ou os componentes para sua fórmula. Quando um curinga é usado em qualquer nó, todos os nós à direita do primeiro curinga também devem ser curingas.

Por exemplo, dadas as seguintes versões recentes: 2.2.4, 1.7.8 e 1.6.8, a seleção de versão usando curingas produz os seguintes resultados:

• x.x.x = 2.2.4

• 1.x.x = 1.7.8

• 1.6.x = 1.6.8

• x.2.x não é válido e produz um erro

• 1.x.8 não é válido e produz um erro

Usando referências de versão

As referências de versão são cadeias de caracteres ready-to-use ARN que incorporam padrões curinga com base na versão semântica do recurso que você criou ou recuperou. Em vez de escrever código personalizado para analisar ARNs e inserir curingas, o Image Builder faz esse trabalho para você.

Quando você cria ou recupera recursos do Image Builder, o Image Builder fornece automaticamente padrões de versão pré-construídos ARNs com caracteres curinga no objeto. latestVersionReferences Isso elimina a necessidade de analisar e reconstruir manualmente ARNs quando você deseja referenciar recursos usando padrões de versão curinga.

Por exemplo, quando você cria um componente com versão1.2.3, o Image Builder retorna:

{
    "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3/1",
    "latestVersionReferences": {
        "latestVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/x.x.x",
        "latestMajorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.x.x",
        "latestMinorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.x",
        "latestPatchVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3"
    }
}
		

Padrões de referência de versão disponíveis

O latestVersionReferences objeto contém quatro padrões de ARN:

• latestVersionArn (x.x.x) - Sempre resolve para a versão mais recente absoluta.

• atestMajorVersionArn (1.x.x) - Resolve para as versões secundárias e de patch mais recentes dentro de uma versão principal.

• latestMinorVersionArn (1.2.x) - Vai para a versão mais recente do patch em uma versão secundária específica.

• latestPatchVersionArn (1.2.3) - Faz referência a uma versão semântica específica e resolve para a versão de compilação mais recente para recursos que oferecem suporte a várias versões de compilação.

Recursos que retornam referências de versão

As referências de versão são retornadas por Create e Get APIs para todos os recursos do Image Builder versionados:

• Componentes -CreateComponent, GetComponent

• Receitas de imagens -CreateImageRecipe, GetImageRecipe

• Receitas de contêineres -CreateContainerRecipe, GetContainerRecipe

• Imagens -CreateImage, GetImage

• Fluxos de trabalho -CreateWorkflow, GetWorkflow

Nota: Para fluxos de trabalho gerenciados pelo Image Builder, somente latestVersionArn (x.x.x) é retornado, pois o Image Builder exige que você sempre use a versão mais recente dos fluxos de trabalho gerenciados pelo Image Builder.