Membuat kondisi menunggu dalam templat

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 URL yang telah ditentukan sebelumnya yang dapat Anda gunakan untuk memberi sinyal keberhasilan atau kegagalan. 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 template dan Timeout merupakan angka detik AWS CloudFormation untuk menunggu. Anda dapat mengatur Count properti secara opsional, yang menentukan jumlah sinyal keberhasilan yang harus diterima kondisi tunggu sebelum AWS CloudFormation dapat melanjutkan pembuatan tumpukan.

   Untuk mengontrol kapan kondisi tunggu dipicu, Anda menetapkan DependsOn atribut pada kondisi tunggu. DependsOnKlausa mengaitkan sumber daya dengan kondisi tunggu. Setelah AWS CloudFormation membuat DependsOn sumber daya, ia 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 URL yang telah ditandatangani untuk mengirim sinyal.

   Dalam template, URL presigned 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 URL yang telah ditetapkan sebelumnya ke instans Amazon EC2 sehingga skrip atau aplikasi yang berjalan pada instans tersebut dapat menandakan keberhasilan atau kegagalan untuk: AWS CloudFormation

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

   Catatan: Di AWS Management Console atau alat baris AWS CloudFormation perintah, URL presigned ditampilkan sebagai ID fisik 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 notifikasi untuk setiap peristiwa tumpukan ke topik yang ditentukan. Jika Anda atau aplikasi Anda berlangganan topik itu, Anda dapat memantau pemberitahuan untuk peristiwa pembuatan penanganan kondisi tunggu dan mengambil URL yang telah ditandatangani dari pesan pemberitahuan.

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

5. Gunakan URL yang telah ditandatangani untuk menandakan keberhasilan atau kegagalan.

   Untuk mengirim sinyal, Anda mengirim pesan permintaan HTTP menggunakan URL yang telah ditandatangani. Metode permintaan harus PUT dan Content-Type header harus berupa string kosong atau dihilangkan. Pesan permintaan harus berupa struktur formulir JSON yang ditentukan dalam Sinyal kondisi tunggu format JSON.

   Anda perlu mengirim jumlah sinyal sukses yang ditentukan oleh Count properti agar dapat AWS CloudFormation 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%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"

   Tempat file /tmp/a mengandung struktur JSON berikut:

   
   {
      "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 struktur JSON 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%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"