在模板中创建等待条件

如需在堆栈中使用等待条件：

1. 在堆栈模板中声明 AWS::CloudFormation::WaitConditionHandle 资源。等待条件句柄并无属性；但是，WaitConditionHandle 资源参考将解析您用于向 WaitCondition 发送成功或失败信号的预签名 URL。例如：

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

2. 在堆栈模板中声明 AWS::CloudFormation::WaitCondition 资源。WaitCondition 资源具有两项必需属性：句柄为模板中已声明 WaitConditionHandle 的参考，超时为 Amazon CloudFormation 等待的秒数。另外，您可以选择设置计数属性，其将确定 Amazon CloudFormation 重新开始创建堆栈前，等待条件必须接收的成功信号数量。

   您应在等待条件中设置 DependsOn 属性，才能在等待条件触发后进行控制操作。DependsOn 子句将资源与等待条件相关联。Amazon CloudFormation 创建 DependsOn 资源后，它将阻止堆栈资源的进一步创建直至以下其中一种情况发生：a) 超时周期过期；b) 接收到必要数量的成功信号；c) 接收到失败信号。

   此处为等待条件的一项示例，其在 Ec2Instance 资源成功创建后开始，它运用 myWaitHandle 资源作为 WaitConditionHandle，超时为 4500 秒，默认计数为 1（因尚未指定计数属性）：

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

3. 获取用于发送信号的预签名 URL。

   在模板中，可通过将 AWS::CloudFormation::WaitConditionHandle 资源的逻辑名称传输至 Ref 内部函数，实现对预签名 URL 的检索。例如，您可以使用 AWS::EC2::Instance 资源的 UserData 属性将预签名 URL 传递给 Amazon EC2 实例，以使这些实例上运行的脚本或应用程序可以向 Amazon CloudFormation 发送成功或失败信号：

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

   注意：在 Amazon Web Services Management Console 或 Amazon CloudFormation 命令行工具中，预签名 URL 显示为等待条件句柄资源的物理 ID。

4. 当堆栈进入等待条件后，选择检测方法。

   如果您通过启用的通知创建堆栈，那么 Amazon CloudFormation 将向指定主题发布针对每项堆栈事件的通知。如果您或您的应用程序订阅了该主题，您可以监测针对等待条件句柄创建事件的通知，并通过通知消息来检索预签名 URL。

   您还可以使用 Amazon Web Services Management Console、Amazon CloudFormation 命令行工具或 Amazon CloudFormation API 来监控堆栈事件。

5. 利用预签名 URL 发送成功或失败信号。

   您需要通过预签名 URL 发送 HTTP 请求消息之后，才能发送信号。请求方法必须为 PUT，并且内容类型标题必须为空字符串或省略。请求消息必须为 等待条件信号 JSON 格式 指定表单的 JSON 结构。

   您需要针对 Amazon CloudFormation 按顺序发送由计数属性指定数量的成功信息，才能继续堆栈创建。如果您的计数超过 1，则在发送到特定等待条件的所有信号中，每个信号的 UniqueId 值必须是唯一的。UniqueId 是随机的字母数字字符串。

   Curl 命令是发送信号的一种方式。以下示例显示了向等待条件发送成功信号的 Curl 命令行。

   
   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"
               

   其中文件 /tmp/a 包含以下 JSON 结构：

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

   此示例显示发送同一成功信号的 Curl 命令行，不同的是，它将 JSON 结构作为命令行参数发送。

   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"