Creazione delle condizioni di attesa in un modello

Per usare una condizione di attesa in uno stack:

1. Dichiarare una risorsa AWS::CloudFormation::WaitConditionHandle nel modello di stack. Un handle della condizione di attesa non ha proprietà. Tuttavia, un riferimento a una risorsa WaitConditionHandle restituisce un URL prefirmato che puoi utilizzare per segnalare un'operazione riuscita o non riuscita alla risorsa WaitCondition. Per esempio:

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

2. Dichiarare una risorsa AWS::CloudFormation::WaitCondition nel modello di stack. Una WaitCondition risorsa ha due proprietà obbligatorie: Handle è un riferimento a un valore WaitConditionHandle dichiarato nel modello e Timeout rappresenta il numero di secondi di attesa. AWS CloudFormation Facoltativamente, è possibile impostare la Count proprietà, che determina il numero di segnali di successo che la condizione di attesa deve ricevere prima di AWS CloudFormation poter riprendere la creazione dello stack.

   Per controllare quando la condizione di attesa viene attivata, imposta un attributo DependsOn sulla condizione di attesa. Una clausola DependsOn associa una risorsa alla condizione di attesa. Dopo aver AWS CloudFormation creato la DependsOn risorsa, blocca l'ulteriore creazione di risorse dello stack finché non si verifica uno dei seguenti eventi: a) il periodo di timeout b) Viene ricevuto il numero richiesto di segnali di successo c) Viene ricevuto un segnale di errore.

   Di seguito è riportato un esempio di condizione di attesa che viene avviata dopo la creazione riuscita di una risorsa Ec2Instance, utilizza la risorsa myWaitHandle come risorsa WaitConditionHandle, ha un timeout pari a 4.500 secondi e ha una proprietà Count impostata sul valore predefinito di 1 (perché non è stata specificata alcuna proprietà Count):

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

3. Recuperare l'URL prefirmato da usare per la segnalazione.

   Nel modello, l'URL prefirmato può essere recuperato passando il nome logico della risorsa AWS::CloudFormation::WaitConditionHandle alla funzione intrinseca Ref. Ad esempio, puoi utilizzare la proprietà UserData sulle risorse AWS::EC2::Instance per passare l'URL prefirmato alle istanze Amazon EC2, in modo che gli script o le applicazioni in esecuzione su tali istanze possano segnalare le operazioni riuscite o non riuscite a AWS CloudFormation:

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

   Nota: negli AWS Management Console strumenti a riga di AWS CloudFormation comando, l'URL predefinito viene visualizzato come ID fisico della risorsa wait condition handle.

4. Selezionare un metodo per rilevare quando lo stack entra nella condizione di attesa.

   Se crei lo stack con le notifiche abilitate, AWS CloudFormation pubblica una notifica per ogni evento dello stack sull'argomento specificato. Se tu o l'applicazione effettua la sottoscrizione a tale argomento, puoi monitorare le notifiche relative all'evento di reazione degli handle delle condizioni di attesa e recuperare l'URL prefirmato dal messaggio di notifica.

   Puoi anche monitorare gli eventi dello stack utilizzando gli strumenti della AWS Management Console riga di AWS CloudFormation comando o l'API. AWS CloudFormation

5. Utilizza l'URL prefirmato per segnalare le operazioni riuscite o non riuscite.

   Per inviare un segnale, invia un messaggio di richiesta HTTP utilizzando l'URL prefirmato. Il metodo della richiesta deve essere PUT e l'intestazione Content-Type deve essere una stringa vuota o deve essere omessa. Il messaggio di richiesta deve essere una struttura JSON con il formato specificato nel Formato JSON del segnale della condizione di attesa.

   È necessario inviare il numero di segnali di successo specificati dalla Count proprietà per AWS CloudFormation continuare la creazione dello stack. Se il valore della proprietà Count è maggiore di 1, il valore UniqueId per ogni segnale deve essere univoco per tutti i segnali inviati a una determinata condizione di attesa. Il valore UniqueId è una stringa alfanumerica arbitraria.

   Un comando curl è un modo per inviare un segnale. L'esempio seguente mostra una riga di comando curl che segnala l'operazione riuscita a una condizione di attesa.

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

   dove il file /tmp/a contiene la seguente struttura JSON:

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

   Questo esempio illustra una riga di comando curl che invia lo stesso segnale di operazione riuscita, ma che invia la struttura JSON come parametro alla riga di 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%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"