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 :

Gestion des versions génériques dans les politiques de cycle de vie

Vous pouvez utiliser des modèles génériques pour les versions sémantiques lors de la sélection de recettes de politique de cycle de vie afin de cibler plusieurs versions d'une recette avec une seule politique. Cela simplifie la gestion du cycle de vie en éliminant le besoin de créer des politiques distinctes pour chaque version de recette.

Les modèles génériques suivants sont pris en charge pour les versions de recettes de politique de cycle de vie :

Lorsqu'une politique de cycle de vie comportant des modèles génériques est exécutée, Image Builder résout les caractères génériques en fonction de toutes les versions de recette correspondantes au moment de l'exécution. Cela crée une liste immuable de versions pour cette exécution. Les nouvelles versions de recettes créées après le début de l'exécution de la politique sont automatiquement incluses dans la prochaine exécution planifiée.

Pour plus d'informations sur la création de politiques de cycle de vie avec des versions génériques, consultez. Créez des politiques de cycle de vie

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.