Buat kondisi tunggu di CloudFormation template

Untuk menggunakan kondisi tunggu di tumpukan:

1. Mendeklarasikan AWS::CloudFormation::WaitConditionHandle sumber daya dalam template stack. Pegangan kondisi tunggu tidak memiliki properti; Namun, referensi ke WaitConditionHandle sumber daya menyelesaikan presigned URL yang dapat Anda gunakan untuk memberi sinyal keberhasilan atau kegagalan pada. WaitCondition Sebagai contoh:

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

2. Mendeklarasikan AWS::CloudFormation::WaitCondition sumber daya dalam template stack. WaitConditionSumber daya memiliki dua properti yang diperlukan: Handle adalah referensi ke yang WaitConditionHandle dideklarasikan dalam templat dan Timeout merupakan angka detik untuk AWS CloudFormation untuk menunggu. Anda dapat secara opsional mengatur Count properti, yang menentukan jumlah sinyal keberhasilan yang harus diterima oleh kondisi tunggu sebelumnya AWS CloudFormation dapat melanjutkan membuat tumpukan.

   Untuk mengontrol kapan kondisi tunggu dipicu, Anda menetapkan DependsOn atribut pada kondisi tunggu. Sebuah DependsOn klausa mengaitkan sumber daya dengan kondisi tunggu. Setelah AWS CloudFormation membuat DependsOn sumber daya, itu memblokir pembuatan sumber daya tumpukan lebih lanjut sampai salah satu peristiwa berikut terjadi: a) periode batas waktu berakhir b) Jumlah sinyal keberhasilan yang diperlukan diterima c) Sinyal kegagalan diterima.

   Berikut adalah contoh kondisi tunggu yang dimulai setelah keberhasilan pembuatan Ec2Instance sumber daya, menggunakan sumber daya sebagaiWaitConditionHandle, memiliki batas waktu 4500 detik, dan memiliki default Count 1 (karena tidak ada Count properti yang ditentukan): myWaitHandle

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

3. Dapatkan presigned URL untuk digunakan untuk pensinyalan.

   Dalam template, presigned URL dapat diambil dengan meneruskan nama logis AWS::CloudFormation::WaitConditionHandle sumber daya ke fungsi intrinsik Ref. Misalnya, Anda dapat menggunakan UserData properti pada AWS::EC2::Instance sumber daya untuk meneruskan EC2 instans yang telah ditetapkan sebelumnya URL ke Amazon sehingga skrip atau aplikasi yang berjalan pada instans tersebut dapat menandakan keberhasilan atau kegagalan AWS CloudFormation:

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

   Catatan: Di AWS Management Console atau AWS CloudFormation alat baris perintah, presigned URL ditampilkan sebagai ID fisik dari sumber daya penanganan kondisi tunggu.

4. Pilih metode untuk mendeteksi ketika tumpukan memasuki kondisi tunggu.

   Jika Anda membuat tumpukan dengan notifikasi diaktifkan, AWS CloudFormation menerbitkan pemberitahuan untuk setiap peristiwa tumpukan ke topik yang ditentukan. Jika Anda atau aplikasi berlangganan topik tersebut, Anda dapat memantau notifikasi untuk acara pembuatan penanganan kondisi tunggu dan mengambil presigned URL dari pesan notifikasi.

   Anda juga dapat memantau peristiwa tumpukan menggunakan AWS Management Console, AWS CloudFormation alat baris perintah, atau AWS CloudFormation API.

5. Gunakan presigned URL untuk menandakan keberhasilan atau kegagalan.

   Untuk mengirim sinyal, Anda mengirim pesan HTTP permintaan menggunakan presignedURL. Metode permintaan harus PUT dan Content-Type header harus berupa string kosong atau dihilangkan. Pesan permintaan harus berupa JSON struktur formulir yang ditentukan dalamJSONFormat sinyal kondisi tunggu.

   Anda perlu mengirim jumlah sinyal keberhasilan yang ditentukan oleh Count properti agar AWS CloudFormation untuk melanjutkan pembuatan tumpukan. Jika Anda memiliki Count yang lebih besar dari 1, UniqueId nilai untuk setiap sinyal harus unik di semua sinyal yang dikirim ke kondisi tunggu tertentu. UniqueIdIni adalah string alfanumerik arbitrer.

   curlPerintah adalah salah satu cara untuk mengirim sinyal. Contoh berikut menunjukkan baris curl perintah yang menandakan keberhasilan untuk kondisi menunggu.

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

   dimana file /tmp/a berisi struktur berikut: JSON

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

   Contoh ini menunjukkan baris curl perintah yang mengirimkan sinyal sukses yang sama kecuali mengirimkan JSON struktur sebagai parameter pada baris perintah.

   $ 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%3Aaws-region%3A034017226601%3Astack%2Fstack-gosar-20110427004224-test-stack-with-WaitCondition--VEYW%2Fe498ce60-70a1-11e0-81a7-5081d0136786%2FmyWaitConditionHandle?Expires=1303976584&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=ik1twT6hpS4cgNAw7wyOoRejVoo%3D"