Mettez à jour votre modèle de pile

Pour modifier les ressources ou les propriétés d'une CloudFormation pile, vous devez mettre à jour le modèle de la pile. Commencez par le modèle existant pour cette pile et apportez-y vos modifications. Si le modèle est stocké dans un système de contrôle de source, utilisez-en une copie comme point de départ. Sinon, vous pouvez obtenir une copie du modèle auprès de CloudFormation.

Si vous souhaitez uniquement modifier les paramètres ou les paramètres de la pile (comme le SNS sujet Amazon d'une pile), vous pouvez réutiliser le modèle existant sans en obtenir une copie.

Vous pouvez mettre à jour un modèle de CloudFormation pile à l'aide Application Composer d'un éditeur de texte.

Pour mettre à jour un modèle de pile existant à l'aide d'Application Composer

1. Sur la page Stacks de la CloudFormation console, choisissez le nom de la pile que vous souhaitez mettre à jour.

2. Dans le volet des détails de la pile sélectionnée, sélectionnez l'onglet Modèle, puis choisissez Afficher dans Application Composer.

3. CloudFormation ouvre le modèle dans Application Composer. Ici, vous pouvez glisser-déposer, configurer et connecter des ressources (cartes) à partir de la palette Ressources. Pour plus d'informations, consultez Comment composer Composeur d'applications AWS.

Pour mettre à jour un modèle de pile existant à l'aide du AWS CLI

1. Pour obtenir le modèle de la pile que vous souhaitez mettre à jour, utilisez la commande get-templateCLI.

2. Copiez le modèle, collez-le dans un fichier texte, modifiez-le et enregistrez-le. Copiez uniquement le modèle. La commande délimite le modèle par des guillemets. Ne copiez pas ces guillemets. Le modèle lui-même commence par une accolade d'ouverture et se termine par une accolade de fermeture. Spécifiez les modifications que vous souhaitez apporter aux ressources de la pile dans ce fichier.

Gardez à l'esprit les points suivants lorsque vous apportez des modifications à votre modèle :

• Vous ne pouvez pas ajouter, modifier ou supprimer un paramètre utilisé par une ressource qui ne prend pas en charge les mises à jour.

• Pour la plupart des ressources, la modification de leur nom logique revient à supprimer les ressources correspondantes et à les remplacer par une nouvelle. Toutes les autres ressources qui dépendent de la ressource renommée doivent également être mises à jour et peuvent entraîner leur remplacement. D'autres ressources nécessitent que vous mettiez à jour une propriété (non seulement le nom logique) pour lancer une mise à jour.

• Certaines ressources peuvent être soumises à des contraintes quant aux valeurs que vous pouvez définir pour certaines propriétés. Par exemple, les modifications apportées à la AllocatedStorage propriété d'une instance RDS de base de données doivent être supérieures à la valeur actuelle. Si votre mise à jour enfreint ces règles, cette partie échouera.

• La mise à jour d'une ressource peut également affecter les autres ressources qui y font référence. Si vous utilisez des fonctions telles que Ref ou GetAtt pour définir une propriété basée sur une autre ressource, la ressource de référence CloudFormation sera également mise à jour lorsque la ressource référencée changera.

• Pour plus d'informations sur les effets de la mise à jour de propriétés de ressources spécifiques, consultez la référence sur les types de AWS ressources. Pour chaque propriété, une mise à jour peut avoir l'un des impacts suivants :

  • Requis pour la mise à jour : aucune interruption

  • Requis pour la mise à jour : quelques interruptions

  • Requis pour la mise à jour : un remplacement

Note

Parfois, il CloudFormation n'autorise pas certaines modifications que vous essayez d'apporter et cela vous indique que le changement n'est pas autorisé. Ce message peut toutefois s'afficher de manière asynchrone, car les ressources sont créées et mises à jour par défaut CloudFormation dans un ordre non déterministe.