Creación de condiciones de espera en una plantilla de CloudFormation

Para utilizar una condición de espera en una pila:

1. Declare un recurso AWS::CloudFormation::WaitConditionHandle en la plantilla de la pila. Un identificador de condición de espera no tiene propiedades; sin embargo, una referencia a un recurso WaitConditionHandle se resuelve en una URL prefirmada que puede utilizar para señalar el éxito o el error de WaitCondition. Por ejemplo:

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

2. Declare un recurso AWS::CloudFormation::WaitCondition en la plantilla de la pila. Un recurso WaitCondition tiene dos propiedades obligatorias: Handle es una referencia a un WaitConditionHandle declarado en la plantilla y Timeout es el número de segundos que AWS CloudFormation debe esperar. Si lo desea, puede configurar la propiedad Count, que determina el número de señales de éxito que la condición de espera debe recibir antes de que AWS CloudFormation pueda reanudar la creación de la pila.

   Para controlar cuándo se activa la condición de espera, se establece un atributo DependsOn en la condición de espera. Una cláusula DependsOn asocia un recurso con la condición de espera. Después de que AWS CloudFormation cree el recurso DependsOn, bloquea cualquier creación de recursos de pila hasta que se produzca cualquiera de los siguientes eventos: a) vence el periodo de tiempo de espera, b) se recibe el número necesario de señales de éxito o c) se recibe una señal de error.

   A continuación se muestra un ejemplo de una condición de espera que comienza después de la creación del recurso Ec2Instance, utiliza el recurso myWaitHandle como el WaitConditionHandle, tiene un tiempo de espera de 4500 segundos y cuya propiedad Count predeterminada es 1 (dado que no se especifica ninguna propiedad Count):

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

3. Obtenga la URL prefirmada para utilizarla para señalización.

   En la plantilla, la URL prefirmada puede recuperarse pasando el nombre lógico del recurso AWS::CloudFormation::WaitConditionHandle a la función intrínseca Ref. Por ejemplo, puede utilizar la propiedad UserData en los recursos AWS::EC2::Instance para pasar la URL prefirmada a las instancias de Amazon EC2 para que los scripts o aplicaciones que se ejecutan en estas instancias puedan señalar el éxito o el error a AWS CloudFormation:

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

   Nota: En la AWS Management Console o las herramientas de línea de comandos de AWS CloudFormation, la URL prefirmada se muestra con el ID físico de la condición de espera del recurso del administrador de condición de espera.

4. Seleccione un método para detectar cuándo pasa la pila a la condición de espera.

   Si crea la pila con las notificaciones habilitadas, AWS CloudFormation publica una notificación para cada evento de pila al tema especificado. Si usted o su aplicación se suscriben a ese tema, puede monitorizar las notificaciones para el evento de creación del identificador de la condición de espera y recuperar la URL prefirmada del mensaje de notificación.

   También puede supervisar los eventos de la pila mediante la AWS Management Console, las herramientas de línea de comandos de AWS CloudFormation o la API de AWS CloudFormation.

5. Utilice la URL prefirmada para señalar el éxito o el error.

   Para enviar una señal, envía un mensaje de solicitud HTTP usando la URL prefirmada. El método de solicitudes debe ser PUT y el encabezado Content-Type debe ser una cadena vacía u omitirse. El mensaje de solicitud debe ser una estructura JSON con la forma especificada en Formato JSON de señal de condición de espera.

   Debe enviar el número de señales de éxito que se especifica en la propiedad Count para que AWS CloudFormation continúe con la creación de la pila. Si la propiedad Count es superior a 1, el valor UniqueId para cada señal debe ser único entre todas las señales enviadas a una condición de espera en particular. El UniqueId es una cadena alfanumérica arbitraria.

   Un comando curl es una forma de enviar una señal. El siguiente ejemplo muestra una línea de comandos curl que señala el éxito a una condición 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"

   donde el archivo /tmp/a contiene la siguiente estructura JSON:

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

   En este ejemplo se muestra una línea de comandos curl que envía la misma señal de éxito, salvo que envía la estructura JSON como parámetro en la línea de comandos.

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