Criar condições de espera em um modelo do CloudFormation

Para usar uma condição de espera em uma pilha:

1. Declare um recurso AWS::CloudFormation::WaitConditionHandle no modelo da pilha. Um identificador de condição de espera não tem propriedades. No entanto, uma referência a um recurso WaitConditionHandle retorna um URL pré-assinado que você pode usar para sinalizar o êxito ou a falha à WaitCondition. Por exemplo:

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

2. Declare um recurso AWS::CloudFormation::WaitCondition no modelo da pilha. Um recurso WaitCondition tem duas propriedades necessárias: Handle é uma referência a um WaitConditionHandle declarado no modelo, e Timeout é o número de segundos que o AWS CloudFormation aguardará. Opcionalmente, você pode definir a propriedade Count, que determina o número de sinais de êxito que a condição de espera deve receber para que o AWS CloudFormation possa retomar a criação da pilha.

   Para determinar quando a condição de espera será acionada, defina um atributo DependsOn na condição de espera. Uma cláusula DependsOn associa um recurso à condição de espera. Depois que o AWS CloudFormation cria o recurso DependsOn, ele bloqueia a criação de recursos de pilha até que um dos seguintes eventos ocorra: a) o período de tempo limite expire; b) o número de requisito de sinais de êxito seja recebido; c) um sinal de falha seja recebido.

   Este é um exemplo de uma condição de espera que começa após a criação com êxito do recurso Ec2Instance, usa o recurso myWaitHandle como o WaitConditionHandle, tem um tempo limite de 4.500 segundos e tem a Count padrão de 1 (desde que nenhuma propriedade Count seja especificada):

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

3. Obtenha o pre-signed URL a ser usada para sinalização.

   No modelo, o URL pré-assinado pode ser recuperado ao transmitir o nome lógico do recurso AWS::CloudFormation::WaitConditionHandle para a função intrínseca Ref. Por exemplo, você pode usar a propriedade UserData nos recursos AWS::EC2::Instance para transmitir o URL pré-assinado para as instâncias do Amazon EC2, a fim de que os scripts ou as aplicações em execução nessas instâncias possam sinalizar o êxito ou a falha para o AWS CloudFormation:

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

   Observação: no AWS Management Console ou nas ferramentas de linha de comando do AWS CloudFormation, o URL pré-assinado é exibido como ID físico do recurso de identificador de condição de espera.

4. Selecione um método para detectar quando a pilha informará a condição de espera.

   Se você criar a pilha com notificações habilitadas, o AWS CloudFormation publicará uma notificação para cada evento de pilha no tópico especificado. Se você ou seu aplicativo se inscrever nesse tópico, você poderá monitorar as notificações do evento de criação do identificador de condição de espera e recuperará o pre-signed URL na mensagem de notificação.

   Você também poderá monitorar os eventos da pilha usando o AWS Management Console, as ferramentas de linha de comando do AWS CloudFormation ou a API do AWS CloudFormation.

5. Use o pre-signed URL para sinalizar sucesso ou falha.

   Para enviar um sinal, envie uma mensagem de solicitação HTTP usando o pre-signed URL. O método de solicitação deve ser PUT, e o cabeçalho Content-Type deve ser omitido ou uma string vazia. A mensagem de solicitação deve ser uma estrutura JSON do formulário especificado em Formato JSON do sinal da condição de espera.

   Você precisa enviar o número de sinais de êxito especificados pela propriedade Count para que o AWS CloudFormation continue com a criação da pilha. Se a propriedade Count for maior do que 1, o valor do UniqueId de cada sinal deverá ser exclusivo em todos os sinais enviados a uma condição de espera específica. O UniqueId é uma string alfanumérica arbitrária.

   Um comando curl é uma forma de enviar um sinal. O exemplo a seguir mostra uma linha do comando curl que sinaliza o êxito para uma condição de espera.

   $ 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"

   em que o arquivo/tmp/a contém a seguinte estrutura JSON:

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

   Este exemplo mostra uma linha do comando curl que envia o mesmo sinal de êxito, exceto que ele envia a estrutura JSON como um parâmetro na linha de comando.

   $ 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"