Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Versionnage sémantique dans Image Builder

Image Builder utilise le versionnement sémantique pour organiser les ressources et s'assurer qu'elles sont uniques. IDs La version sémantique comporte quatre nœuds :

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

Vous pouvez attribuer des valeurs aux trois premiers et filtrer en les appliquant tous.

Le versionnement sémantique est inclus dans le nom de ressource Amazon (ARN) de chaque objet, au niveau qui s'applique à cet objet comme suit :

Affectation : Pour les trois premiers nœuds, vous pouvez attribuer n'importe quelle valeur entière positive, ou zéro, avec une limite supérieure de 2^30-1, ou 1073741823 pour chaque nœud. Image Builder attribue automatiquement le numéro de compilation au quatrième nœud.

Modèles : vous pouvez utiliser n'importe quel modèle numérique qui respecte les exigences d'attribution pour les nœuds que vous pouvez attribuer. Par exemple, vous pouvez choisir un modèle de version de logiciel, tel que 1.0.0, ou une date, telle que 2021.01.01.

Sélection : avec le versionnement sémantique, vous pouvez utiliser des caractères génériques (x) pour spécifier les versions ou les nœuds les plus récents lors de la sélection de l'image de base ou des composants de votre recette. Lorsque vous utilisez un caractère générique dans un nœud, tous les nœuds situés à droite du premier caractère générique doivent également être des caractères génériques.

Par exemple, étant donné les versions récentes suivantes : 2.2.4, 1.7.8 et 1.6.8, la sélection de version à l'aide de caractères génériques produit les résultats suivants :

Utilisation des références de version

Les références de version sont des chaînes ready-to-use ARN qui incorporent des modèles génériques basés sur la version sémantique de la ressource que vous avez créée ou récupérée. Au lieu d'écrire du code personnalisé pour analyser ARNs et insérer des caractères génériques, Image Builder s'en charge pour vous.

Lorsque vous créez ou récupérez des ressources Image Builder, Image Builder fournit automatiquement des modèles de version préconstruits ARNs avec des caractères génériques dans l'latestVersionReferencesobjet. Il n'est donc plus nécessaire d'analyser et de reconstruire manuellement ARNs lorsque vous souhaitez référencer des ressources à l'aide de modèles de version génériques.

Par exemple, lorsque vous créez un composant avec une version1.2.3, Image Builder renvoie :

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

Modèles de référence des versions disponibles

L'latestVersionReferencesobjet contient quatre modèles d'ARN :

Ressources qui renvoient des références de version

Les références de version sont renvoyées par Create et Get APIs pour toutes les ressources Image Builder versionnées :

Remarque : Pour les flux de travail gérés par Image Builder, seuls latestVersionArn (x.x.x) les flux de travail gérés par Image Builder sont renvoyés, car Image Builder exige que vous utilisiez toujours la dernière version des flux de travail gérés par Image Builder.