Schritt 3: Erstellen Sie eine benutzerdefinierte AWS AppConfig extension

Eine Erweiterung definiert eine oder mehrere Aktionen, die sie während eines AWS AppConfig Workflows ausführt. Die AWS erstellte AWS AppConfig deployment events to Amazon SNS Erweiterung beinhaltet beispielsweise eine Aktion zum Senden einer Benachrichtigung zu einem Amazon SNS-Thema. Jede Aktion wird entweder aufgerufen, wenn Sie mit Ihnen interagieren AWS AppConfig oder wenn AWS AppConfig Sie einen Prozess in Ihrem Namen ausführen. Diese werden Aktionspunkte genannt. AWS AppConfig Erweiterungen unterstützen die folgenden Aktionspunkte:

PRE_*-Aktionspunkte: Auf PRE_* Aktionspunkten konfigurierte Erweiterungsaktionen werden nach der Überprüfung der Anfrage angewendet, jedoch bevor die Aktivität AWS AppConfig ausgeführt wird, die dem Namen des Aktionspunkts entspricht. Diese Aktionsaufrufe werden gleichzeitig mit einer Anforderung verarbeitet. Wenn mehr als eine Anforderung gestellt wird, werden Aktionsaufrufe sequentiell ausgeführt. Beachten Sie auch, dass PRE_* Aktionspunkte den Inhalt einer Konfiguration empfangen und ändern können. PRE_*Aktionspunkte können auch auf einen Fehler reagieren und verhindern, dass eine Aktion ausgeführt wird.

ON_*-Aktionspunkte: Eine Erweiterung kann mithilfe eines ON_* Aktionspunkts auch parallel zu einem AWS AppConfig Workflow ausgeführt werden. ON_*Aktionspunkte werden asynchron aufgerufen. ON_*Aktionspunkte erhalten nicht den Inhalt einer Konfiguration. Wenn bei einer Erweiterung während eines ON_* Aktionspunkts ein Fehler auftritt, ignoriert der Dienst den Fehler und setzt den Workflow fort.

AT_*-Aktionspunkte: Auf AT_* Aktionspunkten konfigurierte Erweiterungsaktionen werden synchron und parallel zu einem Workflow aufgerufen. AWS AppConfig Wenn bei einer Erweiterung während eines AT_* Aktionspunkts ein Fehler auftritt, stoppt der Dienst den Workflow und führt ein Rollback der Bereitstellung durch.

Der AT_DEPLOYMENT_TICK Aktionspunkt unterstützt die Integration der Überwachung durch Dritte. AT_DEPLOYMENT_TICKwird während der Orchestrierung der Konfiguration, Bereitstellung, Verarbeitung aufgerufen. Wenn Sie eine Überwachungslösung eines Drittanbieters verwenden (z. B. Datadog oder New Relic), können Sie eine AWS AppConfig Erweiterung erstellen, die am AT_DEPLOYMENT_TICK Aktionspunkt nach Alarmen sucht und als Sicherheitsmaßnahme die Bereitstellung rückgängig macht, wenn sie einen Alarm ausgelöst hat.

Wenn Sie eine Überwachungslösung eines Drittanbieters wie Datadog oder New Relic verwenden, können Sie eine AWS AppConfig Erweiterung erstellen, die am AT_DEPLOYMENT_TICK Aktionspunkt nach Alarmen sucht und als Sicherheitsleitplanke die Bereitstellung rückgängig macht, wenn sie einen Alarm ausgelöst hat. Weitere Informationen finden Sie in den folgenden Integrationsbeispielen für Datadog und New Relic unter: GitHub

Weitere Informationen zu AWS AppConfig Erweiterungen finden Sie in den folgenden Themen:

Beispiel für eine Erweiterung

Die folgende Beispielerweiterung definiert eine Aktion, die den PRE_CREATE_HOSTED_CONFIGURATION_VERSION Aktionspunkt aufruft. In dem Uri Feld gibt die Aktion den Amazon-Ressourcennamen (ARN) der MyS3ConfigurationBackUpExtension Lambda-Funktion an, die zuvor in dieser exemplarischen Vorgehensweise erstellt wurde. Die Aktion gibt auch den ARN an, der die Rolle AWS Identity and Access Management (IAM) annimmt, der weiter oben in dieser exemplarischen Vorgehensweise erstellt wurde.

Beispiel für eine Erweiterung AWS AppConfig

{
    "Name": "MySampleExtension",
    "Description": "A sample extension that backs up configurations to an S3 bucket.",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "PreCreateHostedConfigVersionActionForS3Backup",
                "Uri": "arn:aws:lambda:aws-region:111122223333:function:MyS3ConfigurationBackUpExtension",
                "RoleArn": "arn:aws:iam::111122223333:role/ExtensionsTestRole"
            }
        ]
    },
    "Parameters" : {
        "S3_BUCKET": {
            "Required": false
        }
    }
}