Utilisation des liens de création rapide pour créer des piles CloudFormation - AWS CloudFormation
Format d’URLExempleCréation d’une pile à l’aide d’un lien de création rapide

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.

Utilisation des liens de création rapide pour créer des piles CloudFormation

Ils offrent une méthode accélérée pour lancer directement des piles CloudFormation via des URL pointant vers la console CloudFormation. En spécifiant l’URL du modèle, le nom de la pile et les paramètres du modèle dans les paramètres de requête de l’URL, vous pouvez préremplir une seule page Créer une pile, ce qui accélère le processus. Cette approche simplifie le processus de création des piles en réduisant le nombre d’étapes dans l’assistant et la quantité d’informations à saisir par l’utilisateur. Elle optimise aussi la réutilisation des modèles en permettant de créer plusieurs URL avec des valeurs différentes pour le même modèle.

Le lien de création rapide suit le format d’URL suivant :

https://region-code.console.aws.amazon.com/cloudformation/home?region=region-code#/stacks/create/review
   ?templateURL=TemplateURL
   &stackName=StackName
   &param_parameterName=parameterValue

CloudFormation prend en charge les paramètres de requête d'URL suivants :

URL de modèle

Obligatoire. Le paramètre templateURL indique l’URL du modèle stocké dans un compartiment Amazon S3. Pour éviter tout problème avec une URL S3 pré-signée, encodez correctement l’URL.

Formats d’URL S3 pris en charge :

  • https://s3.region-code.amazonaws.com/bucket-name/template-name

  • https://bucket-name.s3.region-code.amazonaws.com/template-name

  • https://s3-region-code.amazonaws.com/bucket-name/template-name (format hérité)

Nom de la pile

Facultatif. Utilisez le paramètre stackName pour spécifier le nom de la pile CloudFormation à créer. Un nom de pile ne peut contenir que des caractères alphanumériques (sensibles à la casse) et des traits d'union. Il doit commencer par un caractère alphabétique et ne doit pas dépasser 128 caractères.

Paramètres du modèle

Facultatif. Pour les paramètres du modèle qui ne sont pas du type NoEcho, utilisez le format param_parameterName dans la chaîne de requête URL. Le paramètre d'URL doit comprendre le préfixe param_ et le segment de nom du paramètre doit correspondre exactement au nom du paramètre dans le modèle. Par exemple: param_DBName.

CloudFormation ignore les paramètres absents du modèle, ainsi que les paramètres définis avec leur propriété NoEcho définie sur true (en général, les noms d'utilisateur et les mots de passe). Les paramètres d'URL remplacent les valeurs par défaut spécifiées dans le modèle. Vous pouvez inclure autant de paramètres que nécessaire.

Important

Plutôt que d’intégrer des informations sensibles directement dans vos modèles CloudFormation, nous vous recommandons d’utiliser des paramètres dynamiques dans le modèle de pile pour faire référence aux informations sensibles stockées et gérées en dehors de CloudFormation, par exemple dans AWS Systems Manager Parameter Store ou AWS Secrets Manager.

Pour de plus amples informations, veuillez consulter la bonne pratique N'incorporez pas d'informations d'identification dans vos modèles.

Tous les noms des paramètres de requête sont sensibles à la casse. Les utilisateurs peuvent remplacer ces valeurs dans la console avant de créer la pile.

L'exemple suivant est basé sur l'exemple de modèle Instance unique de base de WordPress. La chaîne de requête inclut le paramètre obligatoire templateURL et les paramètres stackName, DBName, InstanceType et KeyName.

Pour plus de clarté, des sauts de ligne ont été ajoutés à L'URL suivante.

https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review
   ?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template
   &stackName=MyWPBlog
   &param_DBName=mywpblog
   &param_InstanceType=t2.medium

L'URL suivante comprend les mêmes paramètres que l'exemple précédent, mais les sauts de ligne ont été supprimés. Il s'agit du format d'URL réel.

https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template&stackName=MyWPBlog&param_DBName=mywpblog&param_InstanceType=t2.medium

Lorsque vous ouvrez un lien de création rapide, vous êtes dirigé vers la console CloudFormation. La console s’ouvre directement sur la page Création rapide d’une pile, les valeurs fournies étant utilisées automatiquement pour les paramètres.

Création d’une pile à l’aide d’un lien de création rapide (console)

  1. Sur la page Création rapide d’une pile, pour Modèle, URL du modèle, vérifiez que l’URL du modèle est correcte.

  2. Développez la section Afficher le modèle pour vérifier le modèle.

  3. Pour Nom de la pile, vérifiez le nom prérempli de la pile.

  4. Consultez la section Paramètres. Vérifiez que les valeurs préremplies des paramètres sont correctes. Renseignez tous les paramètres obligatoires qui ne sont pas spécifiés dans l’URL. Modifiez les valeurs préremplies si nécessaire.

  5. Vous pouvez ensuite configurer les paramètres suivants :

    • Balises : organisez les ressources à l’aide de paires clé-valeur.

    • Autorisations : choisissez le rôle de service IAM utilisé pour les opérations sur la pile.

    • Options en cas d’échec de la pile : choisissez de restaurer (par défaut) ou de conserver les ressources.

    • Stratégie de pile : contrôlez les autorisations de mise à jour des ressources.

    • Configuration de restauration : configurez la restauration basée sur les alarmes CloudWatch.

    • Options de notification : configurez les notifications Amazon SNS pour les événements de pile.

    • Options de création de pile : définissez la durée maximale de création de la pile et activez la protection contre la suppression pour éviter les suppressions accidentelles.

    Pour de plus amples informations, consultez Configuration des options de pile.

  6. Pour Capacités, complétez toutes les confirmations requises. Par exemple, si votre modèle contient des ressources IAM, sélectionnez Je sais que ce modèle peut créer des ressources IAM pour indiquer que vous souhaitez utiliser des ressources IAM dans le modèle. Pour de plus amples informations, consultez Confirmation des ressources IAM dans les modèles CloudFormation.

  7. (Facultatif) Vous pouvez créer un jeu de modifications pour prévisualiser la configuration de la pile avant sa création. Choisissez Créer un jeu de modifications et suivez les instructions. Pour de plus amples informations, consultez Prévisualisation de la configuration de la pile.

  8. Lorsque vous êtes prêt, choisissez Créer une pile pour lancer la pile, puis surveillez la progression de la création de la pile dans l’onglet Événements. Pour de plus amples informations, consultez Surveiller la progression de la pile.