在範本中建立等待條件

在堆疊中使用等待條件：

1. 在堆疊的範本中宣告 AWS::CloudFormation::WaitConditionHandle 資源。等待條件控點沒有屬性；不過，WaitConditionHandle 資源的參考會解析為預先簽章的 URL，以便您用來將成功或失敗訊號傳送至 WaitCondition。例如：

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

2. 在堆疊的範本中宣告 AWS::CloudFormation::WaitCondition 資源。WaitCondition資源有兩個必要的屬性：Handle是對範本中WaitConditionHandle宣告的參考，Timeout是等待 AWS CloudFormation 的秒數。您可以選擇性地設定Count屬性，以決定等待條件必須接收的成功訊號數目，才 AWS CloudFormation 能繼續建立堆疊。

   若要控制何時觸發等待條件，您可以在等待條件中設定 DependsOn 屬性。DependsOn 子句會建立資源與等待條件的關聯。 AWS CloudFormation 建立DependsOn資源之後，會封鎖進一步的堆疊資源建立，直到發生下列其中一個事件為止：a) 逾時期限到期 b) 收到必要的成功訊號數 c) 收到失敗訊號。

   以下是等待條件範例，該等待條件會在成功建立 Ec2Instance 資源之後開始，並使用 myWaitHandle 資源作為 WaitConditionHandle，其逾時為 4500 秒，而其預設 Count 為 1 (因為未指定 Count 屬性)：

   "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 執行個體，讓這些執行個體上執行的指令碼或應用程式可以將成功或失敗訊號傳送至 AWS CloudFormation：

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

   附註：在 AWS Management Console 或 AWS CloudFormation 命令列工具中，預先簽署的 URL 會顯示為等待條件處理碼資源的實體 ID。

4. 選取用於偵測堆疊何時進入等待條件的方法。

   如果您建立啟用通知的堆疊，則會將每個堆疊事件的通知 AWS CloudFormation 發佈到指定主題。如果您或您的應用程式訂閱該主題，您可以監控等待條件控點建立事件的通知，並從通知訊息擷取預先簽章的 URL。

   您也可以使用 AWS Management Console、 AWS CloudFormation 命令列工具或 AWS CloudFormation API 監視堆疊的事件。

5. 使用預先簽章的 URL 傳送成功或失敗訊號。

   若要傳送訊號，您可以使用預先簽章的 URL 傳送 HTTP 請求訊息。請求方法必須是 PUT，而且 Content-Type 標頭必須是空白字串或予以省略。請求訊息必須是 等待條件訊號 JSON 格式 中指定格式的 JSON 結構。

   您必須傳送Count屬性指定的成功訊號數，才能 AWS CloudFormation 繼續建立堆疊。如果您的 Count 大於 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"