Création de conditions Wait dans un gabarit

Pour utiliser une condition d'attente dans une pile :

1. Déclarez une ressource AWS::CloudFormation::WaitConditionHandle dans le modèle de la pile. Un descripteur de condition d'attente ne possède aucune propriété. Toutefois, une référence à une ressource WaitConditionHandle correspond à une URL pré-signée que vous pouvez utiliser pour signaler la réussite ou la défaillance de WaitCondition. Par exemple :

   "myWaitHandle" : {
        "Type" : "AWS::CloudFormation::WaitConditionHandle",
        "Properties" : {
        }
   }

2. Déclarez une ressource AWS::CloudFormation::WaitCondition dans le modèle de la pile. Une WaitCondition ressource possède deux propriétés obligatoires : elle Handle fait référence à une ressource WaitConditionHandle déclarée dans le modèle et Timeout représente le nombre de secondes AWS CloudFormation d'attente. Vous pouvez éventuellement définir la Count propriété, qui détermine le nombre de signaux de réussite que la condition d'attente doit recevoir avant de AWS CloudFormation pouvoir reprendre la création de la pile.

   Pour contrôler quand la condition d'attente est déclenchée, vous définissez l'attribut DependsOn au niveau de celle-ci. Une clause DependsOn associe une ressource à la condition d'attente. Après avoir AWS CloudFormation créé la DependsOn ressource, il bloque la création de nouvelles ressources de pile jusqu'à ce que l'un des événements suivants se produise : a) le délai d'expiration b) Le nombre requis de signaux de réussite est reçu c) Un signal d'échec est reçu.

   Voici un exemple de condition d'attente qui commence après la création réussie de la ressource Ec2Instance, utilise la ressource myWaitHandle comme WaitConditionHandle, a un délai d'attente de 4 500 secondes et a la valeur par défaut Count de 1 (puisqu'aucune propriété Count n'est spécifiée) :

   "myWaitCondition" : {
       "Type" : "AWS::CloudFormation::WaitCondition",
       "DependsOn" : "Ec2Instance",
       "Properties" : {
           "Handle" : { "Ref" : "myWaitHandle" },
           "Timeout" : "4500"
       }
   }

3. Obtenez l'URL pré-signée à utiliser pour le signalement.

   Dans le modèle, l'URL pré-signée peut être récupérée en transmettant le nom logique de la ressource AWS::CloudFormation::WaitConditionHandle à la fonction intrinsèque Ref. Par exemple, vous pouvez utiliser la propriété UserData sur les ressources AWS::EC2::Instance pour transmettre l'URL pré-signée aux instances Amazon EC2 de sorte que les scripts ou les applications qui s'exécutent sur ces instances puissent signaler une réussite ou une défaillance à AWS CloudFormation :

   "UserData" : {
      "Fn::Base64" : {
          "Fn::Join" : [ "", ["SignalURL=", { "Ref" : "myWaitHandle" } ] ]
      }
   }

   Remarque : Dans les outils de ligne de AWS CloudFormation commande AWS Management Console ou dans les outils de ligne de commande, l'URL présignée est affichée sous forme d'identifiant physique de la ressource de gestion des conditions d'attente.

4. Sélectionnez une méthode de détection du moment où la pile active la condition d'attente.

   Si vous créez la pile avec les notifications activées, AWS CloudFormation publie une notification pour chaque événement de la pile dans le sujet spécifié. Si vous ou votre application vous abonnez à cette rubrique, vous pouvez suivre les notifications d'événement de création de descripteur de condition d'attente et récupérer l'URL pré-signée à partir de cette notification.

   Vous pouvez également surveiller les événements de la pile à l' AWS Management Console aide des outils de ligne de AWS CloudFormation commande ou de l' AWS CloudFormation API.

5. Utilisez l'URL pré-signée pour signaler la réussite ou l'échec.

   Pour envoyer un signal, vous envoyez un message de requête HTTP à l'aide de l'URL pré-signée. Il doit s'agir d'une méthode de requête PUT, et l'en-tête Content-Type doit être une chaîne vide ou doit être omise. Le message de requête doit correspondre à une structure JSON dont le format est similaire à celui qui est spécifié dans Format JSON d'un signal envoyé à une condition d'attente.

   Vous devez envoyer le nombre de signaux de réussite spécifié par la Count propriété afin de AWS CloudFormation poursuivre la création de la pile. Si la valeur de Count est supérieure à 1, la valeur UniqueId de chaque signal doit être unique pour tous les signaux envoyés à une condition d'attente particulière. UniqueId constitue une chaîne alphanumérique arbitraire.

   Une commande curl est l'un des moyens permettant d'envoyer un signal. L'exemple suivant montre une ligne de commande curl qui indique la réussite à une condition d'attente.

   $ curl -T /tmp/a \
     "https://cloudformation-waitcondition-test.s3.amazonaws.com/arn%3Aaws%3Acloudformation%3Aus-east-2%3A034017226601%3Astack%2Fstack-gosar-20110427004224-test-stack-with-WaitCondition--VEYW%2Fe498ce60-70a1-11e0-81a7-5081d0136786%2FmyWaitConditionHandle?Expires=1303976584&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=ik1twT6hpS4cgNAw7wyOoRejVoo%3D"

   où le fichier/tmp/a contient la structure JSON suivante :

   
   {
      "Status" : "SUCCESS",
      "Reason" : "Configuration Complete",
      "UniqueId" : "ID1234",
      "Data" : "Application has completed configuration."
   }

   Cet exemple montre une ligne de commande curl qui envoie le même signal de réussite, sauf qu'il envoie la structure JSON comme paramètre dans la ligne de commande.

   $ curl -X PUT \
     -H 'Content-Type:' --data-binary '{"Status" : "SUCCESS","Reason" : "Configuration Complete","UniqueId" : "ID1234","Data" : "Application has completed configuration."}' \
     "https://cloudformation-waitcondition-test.s3.amazonaws.com/arn%3Aaws%3Acloudformation%3Aus-east-2%3A034017226601%3Astack%2Fstack-gosar-20110427004224-test-stack-with-WaitCondition--VEYW%2Fe498ce60-70a1-11e0-81a7-5081d0136786%2FmyWaitConditionHandle?Expires=1303976584&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=ik1twT6hpS4cgNAw7wyOoRejVoo%3D"