Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Versionamento semantico in Image Builder

Image Builder utilizza il controllo delle versioni semantiche per organizzare le risorse e garantire che siano uniche. IDs La versione semantica ha quattro nodi:

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

È possibile assegnare valori per i primi tre e filtrarli tutti.

Il controllo delle versioni semantiche è incluso nell'Amazon Resource Name (ARN) di ogni oggetto, al livello che si applica a quell'oggetto come segue:

Assegnazione: per i primi tre nodi è possibile assegnare qualsiasi valore intero positivo, o zero, con un limite superiore di 2^30-1 o 1073741823 per ogni nodo. Image Builder assegna automaticamente il numero di build al quarto nodo.

Modelli: è possibile utilizzare qualsiasi modello numerico che rispetti i requisiti di assegnazione per i nodi che è possibile assegnare. Ad esempio, è possibile scegliere un modello di versione del software, ad esempio 1.0.0, o una data, ad esempio 2021.01.01.

Selezione: con il controllo semantico delle versioni, hai la flessibilità di utilizzare i caratteri jolly (x) per specificare le versioni o i nodi più recenti quando selezioni l'immagine o i componenti di base per la tua ricetta. Quando utilizzi un carattere jolly in un nodo, anche tutti i nodi a destra del primo carattere jolly devono essere caratteri jolly.

Ad esempio, date le seguenti versioni recenti: 2.2.4, 1.7.8 e 1.6.8, la selezione della versione mediante caratteri jolly produce i seguenti risultati:

Utilizzo dei riferimenti alle versioni

I riferimenti alle versioni sono stringhe ready-to-use ARN che incorporano modelli di caratteri jolly basati sulla versione semantica della risorsa creata o recuperata. Invece di scrivere codice personalizzato per analizzare ARNs e inserire caratteri jolly, Image Builder fa questo lavoro per te.

Quando create o recuperate risorse di Image Builder, Image Builder fornisce automaticamente modelli di versione ARNs precostruiti con caratteri jolly nell'oggetto. latestVersionReferences Ciò elimina la necessità di analizzare e ricostruire manualmente ARNs quando si desidera fare riferimento a risorse utilizzando modelli di versione con caratteri jolly.

Ad esempio, quando si crea un componente con versione1.2.3, Image Builder restituisce:

{
    "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"
    }
}
		

Modelli di riferimento delle versioni disponibili

L'latestVersionReferencesoggetto contiene quattro pattern ARN:

Risorse che restituiscono riferimenti alle versioni

I riferimenti alle versioni vengono restituiti da Create e Get APIs per tutte le risorse Image Builder con versione:

Nota: per i flussi di lavoro gestiti da Image Builder, latestVersionArn (x.x.x) viene restituito solo, poiché Image Builder richiede di utilizzare sempre la versione più recente dei flussi di lavoro gestiti da Image Builder.