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.
Mettre à jour votre modèle de pile
Pour modifier les ressources ou les propriétés d’une pile CloudFormation, 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 vous avez stocké le modèle dans un système de contrôle de source, utilisez une copie de celui-ci comme point de départ. Sinon, vous pouvez obtenir une copie du modèle à partir de CloudFormation.
Si vous voulez uniquement modifier les paramètres ou les réglages de la pile (comme la rubrique Amazon SNS d’une pile), vous pouvez réutiliser le modèle existant sans en obtenir de copie.
Vous pouvez mettre à jour un modèle de pile CloudFormation à l’aide d’un éditeur de texte ou de Infrastructure Composer.
Pour mettre à jour un modèle de pile existant à l’aide d’Infrastructure Composer
Connectez-vous à la AWS Management Console et ouvrez la console CloudFormation à l’adresse https://console.aws.amazon.com/cloudformation
. -
Sur la page Piles, sélectionnez le nom de la pile à mettre à jour.
-
Sélectionnez l’onglet Modèle, puis Afficher dans Infrastructure Composer.
CloudFormation ouvre le modèle dans Infrastructure Composer.
-
Mettez à jour votre modèle à l’aide de l’une des méthodes suivantes :
-
Interface Canevas : ici, vous pouvez glisser-déposer à partir de la palette Ressources. Configurez les ressources en double-cliquant sur une carte pour ouvrir le panneau Propriétés de la ressource. Connectez les ressources selon vos besoins. Pour obtenir des instructions détaillées sur l’utilisation de l’interface Canevas, consultez Comment composer dans AWS Infrastructure Composer.
-
Interface Modèle : passez de l’interface Canevas à l’interface Modèle. Effectuez des mises à jour en ligne du code du modèle. Basculez entre les formats JSON et YAML selon vos besoins.
-
-
Sélectionnez Valider pour vérifier qu’il n’y a pas d’erreurs de syntaxe dans le modèle.
-
Lorsque vous êtes prêt à exporter les modifications vers CloudFormation, sélectionnez Mettre à jour le modèle.
Pour mettre à jour un modèle de pile existant à l’aide de l’AWS CLI
-
Pour obtenir le modèle de la pile que vous voulez mettre à jour, utilisez la commande CLI get-template.
-
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.
Veuillez garder à 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 avoir des contraintes quant aux valeurs que vous pouvez définir pour certaines propriétés. Par exemple, les modifications apportées à la propriété
AllocatedStoraged’une instance de base de données RDS 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 d’autres ressources qui la référencent. Si vous utilisez des fonctions telles que La fonction Ref ou La fonction Fn::GetAtt pour définir une propriété basée sur une autre ressource, CloudFormation mettra également à jour la ressource de référence lorsque celle référencée changera.
-
Pour plus d’informations sur les effets de la mise à jour de propriétés de ressources particulières, consultez la Référence des types de ressources et de propriétés AWS. 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
-
-
Vous pouvez vérifier la syntaxe JSON ou YAML de votre modèle à l’aide de la commande CLI validate-template ou en spécifiant votre modèle sur la console. La console effectue automatiquement la validation. Cependant, ces méthodes vérifient uniquement la syntaxe de votre modèle et ne valident pas la validité des valeurs de propriété que vous avez spécifiées pour une ressource. Pour des validations plus complexes ou pour vérifier les bonnes pratiques, vous pouvez également utiliser des outils supplémentaires tels que CloudFormation Linter (cfn-lint)
et CloudFormation Rain (rain fmt) .
Note
Parfois, CloudFormation n’autorise pas certaines modifications que vous essayez d’apporter et vous informe que la modification n’est pas autorisée. Ce message peut toutefois s’afficher de manière asynchrone, car les ressources sont créées et mises à jour par CloudFormation dans un ordre non déterministe par défaut.
