Aktiviere einen Lambda Hook in deinem Konto

Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

Wählen Sie in der Navigationsleiste oben auf dem Bildschirm die AWS-Region Stelle aus, an der Sie den Hook-In erstellen möchten.

Wenn Sie keine Lambda-Funktion für den Hook erstellt haben, gehen Sie wie folgt vor:

Wenn Sie Ihre Lambda-Funktion bereits erstellt haben, fahren Sie mit dem nächsten Schritt fort.

Wählen Sie als Hook-Name eine der folgenden Optionen aus:

Geben Sie für die Lambda-Funktion die Lambda-Funktion an, die mit diesem Hook verwendet werden soll. Sie können Folgendes verwenden:

Wählen Sie für Hook-Ziele aus, was ausgewertet werden soll:

Wählen Sie unter Aktionen aus, welche Aktionen (Erstellen, Aktualisieren, Löschen) Ihren Hook aufrufen sollen.

Wählen Sie für den Hook-Modus aus, wie der Hook reagiert, wenn die vom Hook aufgerufene Lambda-Funktion eine FAILED Antwort zurückgibt:

Wählen Sie für die Ausführungsrolle die IAM-Rolle aus, von der der Hook annimmt, um Ihre Lambda-Funktion aufzurufen. Sie können entweder zulassen CloudFormation , dass automatisch eine Ausführungsrolle für Sie erstellt wird, oder Sie können eine Rolle angeben, die Sie erstellt haben.

Wählen Sie Weiter.

(Optional) Gehen Sie für Hook-Filter wie folgt vor:

1. Geben Sie unter Ressourcenfilter an, welche Ressourcentypen den Hook aufrufen können. Dadurch wird sichergestellt, dass der Hook nur für relevante Ressourcen aufgerufen wird.

2. Wählen Sie unter Filterkriterien die Logik für die Anwendung von Stacknamen- und Stack-Rollenfiltern aus:

   • Alle Stack-Namen und Stack-Rollen — Der Hook wird nur aufgerufen, wenn alle angegebenen Filter übereinstimmen.

   • Beliebige Stack-Namen und Stack-Rollen — Der Hook wird aufgerufen, wenn mindestens einer der angegebenen Filter übereinstimmt.

   Anmerkung

   Bei Cloud Control API-Vorgängen werden alle Filter für Stack-Namen und Stack-Rollen ignoriert.

3. Schließen Sie bei Stack-Namen bestimmte Stacks in Hook-Aufrufe ein oder aus.

   • Geben Sie für Include die Stack-Namen an, die eingeschlossen werden sollen. Verwenden Sie dies, wenn Sie über eine kleine Gruppe bestimmter Stacks verfügen, auf die Sie abzielen möchten. Nur die in dieser Liste angegebenen Stapel rufen den Hook auf.

   • Geben Sie für Exclude die Stack-Namen an, die ausgeschlossen werden sollen. Verwenden Sie dies, wenn Sie den Hook für die meisten Stacks aufrufen, aber einige bestimmte ausschließen möchten. Alle Stapel außer den hier aufgeführten rufen den Hook auf.

4. Schließen Sie bei Stack-Rollen je nach den zugehörigen IAM-Rollen bestimmte Stacks in Hook-Aufrufe ein oder aus.

   • Geben Sie für Include eine oder mehrere IAM-Rollen an, die auf Stacks abzielen ARNs sollen, die diesen Rollen zugeordnet sind. Nur Stack-Operationen, die von diesen Rollen initiiert wurden, rufen den Hook auf.

   • Geben Sie für Exclude eine oder mehrere IAM-Rollen ARNs für Stacks an, die Sie ausschließen möchten. Der Hook wird für alle Stacks aufgerufen, mit Ausnahme der Stacks, die von den angegebenen Rollen initiiert wurden.

Wählen Sie Weiter.

Überprüfen Sie auf der Seite Überprüfen und aktivieren Ihre Auswahl. Um Änderungen vorzunehmen, wählen Sie im entsprechenden Abschnitt Bearbeiten aus.

Wenn Sie bereit sind, fortzufahren, wählen Sie „Hook aktivieren“.

Verwenden Sie Folgendes, um mit der Aktivierung eines Hooks zu beginnen activate-typeBefehl, der die Platzhalter durch Ihre spezifischen Werte ersetzt. Dieser Befehl autorisiert den Hook, eine angegebene Ausführungsrolle von Ihnen zu verwenden. AWS-Konto

aws cloudformation activate-type --type HOOK \
  --type-name AWS::Hooks::LambdaHook \
  --publisher-id aws-hooks \
  --execution-role arn:aws:iam::123456789012:role/my-execution-role \
  --type-name-alias Private::Lambda::MyTestHook \
  --region us-west-2

Um die Aktivierung des Hooks abzuschließen, müssen Sie ihn mithilfe einer JSON-Konfigurationsdatei konfigurieren.

Verwenden Sie den cat Befehl, um eine JSON-Datei mit der folgenden Struktur zu erstellen. Weitere Informationen finden Sie unter Syntaxreferenz für das Hook-Konfigurationsschema.

$ cat > config.json
{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "CLOUD_CONTROL"
      ],
      "FailureMode": "WARN",
      "Properties": {
        "LambdaFunction": "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
      },
      "TargetFilters": {
        "Actions": [
          "CREATE",
          "UPDATE",
          "DELETE"
        ]
      }
    }
  }
}

Verwenden Sie Folgendes set-type-configurationBefehl zusammen mit der von Ihnen erstellten JSON-Datei, um die Konfiguration anzuwenden. Ersetzen Sie die Platzhalter durch Ihre spezifischen Werte.

aws cloudformation set-type-configuration \
  --configuration file://config.json \
  --type-arn "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyTestHook" \
  --region us-west-2