Comprendre le versionnement des modules - AWS CloudFormation

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.

Comprendre le versionnement des modules

Le CloudFormation registre agit comme un référentiel dans lequel vous pouvez enregistrer et gérer des modules à utiliser au sein de votre région Compte AWS et de votre région. Vous pouvez enregistrer des modules provenant de différentes sources AWS, y compris des éditeurs tiers, et vos propres extensions personnalisées, dans votre compte et dans votre région. Pour de plus amples informations, veuillez consulter Gestion des extensions avec le CloudFormation registre.

Les modules peuvent avoir différentes versions. Vous pouvez donc spécifier la version d'un module que vous souhaitez utiliser. Cette fonctionnalité de gestion des versions est particulièrement utile lorsque vous devez mettre à jour ou modifier un module sans casser les piles existantes qui en dépendent.

Tenez compte des considérations suivantes lorsque vous utilisez plusieurs versions d'un module :

  • Pendant les opérations de pile, CloudFormation utilise la version du module actuellement enregistrée comme version par défaut dans la région Compte AWS et dans laquelle l'opération de pile est effectuée. Cela inclut les modules imbriqués dans d'autres modules.

    Par conséquent, sachez que si différentes versions du même module sont enregistrées comme version par défaut dans différents comptes ou régions, l'utilisation du même modèle peut entraîner des résultats différents.

  • Pendant les opérations de pile, CloudFormation utilise la version de la ressource actuellement enregistrée comme version par défaut dans la région Compte AWS et dans laquelle l'opération de pile est effectuée. Cela inclut les ressources générées par l'inclusion de modules.

  • La modification de la version par défaut d'un module ne lance aucune opération de mise à jour de la pile. Toutefois, la prochaine fois que vous effectuerez une opération de pile avec un modèle contenant ce module, comme une mise à jour de pile, CloudFormation vous utiliserez la nouvelle version par défaut dans l'opération.

    La seule exception est d'effectuer une mise à jour de pile avec l'option spécifiée Utiliser le modèle précédent, comme décrit ci-dessous.

  • Pour les opérations de mise à jour de pile, si vous spécifiez l'option Utiliser le CloudFormation modèle précédent, utilisez le modèle traité précédent pour la mise à jour de pile et ne retraitez pas le module pour les modifications que vous pourriez y avoir apportées.

  • Pour garantir des résultats uniformes, si vous incluez des modules dans un modèle de pile destiné à être utilisé avec des ensembles de piles, vous devez vous assurer que la même version du module est définie comme version par défaut dans tous les comptes et régions dans lesquels vous prévoyez de déployer vos instances de pile. Cela inclut les modules imbriqués dans d'autres modules. Pour de plus amples informations, veuillez consulter Gérer les stocks entre les comptes et les régions avec StackSets.

Exigences relatives à l'activation de modules publics tiers

Pour activer correctement un module public tiers dans votre compte et votre région, les conditions suivantes doivent être remplies pour chaque extension publique tierce (ressource ou module) incluse dans le module :

  • Activation de l'extension — L'extension doit être activée dans le compte et dans la région dans lesquels vous souhaitez l'utiliser. Pour de plus amples informations, veuillez consulter Utiliser des extensions publiques tierces depuis le CloudFormation registre.

  • Enregistrement d'alias — Si l'extension du module utilise un alias de nom de type, l'extension doit être enregistrée dans votre compte et dans votre région en utilisant le même alias de nom de type. Pour de plus amples informations, veuillez consulter Utiliser des alias pour faire référence aux extensions.

  • Compatibilité des versions — La version de l'extension actuellement activée doit être l'une des versions majeures prises en charge de cette extension spécifiée dans le module.

Si les extensions et versions d'extension publiques tierces ne sont pas activées correctement, l'opération CloudFormation échouera et une erreur indiquera les extensions et les versions qui doivent être activées pour que le module puisse être activé avec succès.