Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Schritt 3: Erstellen Sie eine benutzerdefinierte AWS AppConfig Erweiterung Eine Erweiterung definiert eine oder mehrere Aktionen, die sie während eines AWS AppConfig Workflows ausführt. Die AWS verfasste `AWS AppConfig deployment events to Amazon SNS` Erweiterung umfasst beispielsweise eine Aktion zum Senden einer Benachrichtigung an ein Amazon SNS SNS-Thema. Jede Aktion wird entweder aufgerufen, wenn Sie mit einem Prozess interagieren AWS AppConfig oder wenn ein Prozess in AWS AppConfig Ihrem Namen ausgeführt wird. Diese Punkte werden *Aktionspunkte* genannt. AWS AppConfig Erweiterungen unterstützen die folgenden Aktionspunkte: **PRE\$1\$1-Aktionspunkte**: Für `PRE_*` Aktionspunkte 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 Anfrage verarbeitet. Wenn mehr als eine Anforderung gestellt wird, werden Aktionsaufrufe nacheinander 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. + `PRE_CREATE_HOSTED_CONFIGURATION_VERSION` + `PRE_START_DEPLOYMENT` **ON\$1\$1-Aktionspunkte**: Eine Erweiterung kann auch parallel zu einem AWS AppConfig Workflow ausgeführt werden, indem ein `ON_*` Aktionspunkt verwendet wird. `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. + `ON_DEPLOYMENT_START` + `ON_DEPLOYMENT_STEP` + `ON_DEPLOYMENT_BAKING` + `ON_DEPLOYMENT_COMPLETE` + `ON_DEPLOYMENT_ROLLED_BACK` **AT\$1\$1-Aktionspunkte**: Für `AT_*` Aktionspunkte 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 setzt die Bereitstellung zurück. + `AT_DEPLOYMENT_TICK` Der `AT_DEPLOYMENT_TICK` Aktionspunkt unterstützt die Integration der Überwachung durch Drittanbieter. `AT_DEPLOYMENT_TICK`wird während der Konfiguration, Bereitstellung, Verarbeitung und Orchestrierung 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, falls 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, falls sie einen Alarm ausgelöst hat. Weitere Informationen finden Sie in den folgenden Integrationsbeispielen für Datadog und New Relic unter: GitHub + [Datadog](https://github.com/aws-samples/aws-appconfig-tick-extn-for-datadog) + [New Relic](https://github.com/aws-samples/sample-aws-appconfig-tick-extn-for-newrelic) Weitere Informationen zu AWS AppConfig Erweiterungen finden Sie in den folgenden Themen: + [Erweiterung von AWS AppConfig Workflows mithilfe von Erweiterungen](working-with-appconfig-extensions.md) + [Exemplarische Vorgehensweise: Benutzerdefinierte Erweiterungen erstellen AWS AppConfig](working-with-appconfig-extensions-creating-custom.md) **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 für die Übernahme der Rolle AWS Identity and Access Management (IAM) an, 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 } } } ``` **Anmerkung** Informationen zur Anforderungssyntax und zu den Feldbeschreibungen beim Erstellen einer Erweiterung finden Sie unter dem [CreateExtension](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtension.html)Thema in der *AWS AppConfig API-Referenz*. **So erstellen Sie eine Erweiterung (Konsole)** 1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/). 1. Wählen Sie im Navigationsbereich **AWS AppConfig** aus. 1. Wählen Sie auf der Registerkarte **Erweiterungen** die Option Erweiterung **erstellen** aus. 1. Geben Sie **unter Erweiterungsname** einen eindeutigen Namen ein. Geben **MyS3ConfigurationBackUpExtension** Sie für die Zwecke dieser exemplarischen Vorgehensweise ein. Geben Sie optional eine Beschreibung ein. 1. Wählen Sie im Abschnitt **Aktionen** die Option **Neue Aktion hinzufügen** aus. 1. Geben Sie für **Aktionsname** einen eindeutigen Namen ein. Geben **PreCreateHostedConfigVersionActionForS3Backup** Sie für die Zwecke dieser exemplarischen Vorgehensweise ein. Dieser Name beschreibt den Aktionspunkt, der von der Aktion verwendet wurde, und den Zweck der Erweiterung. 1. Wählen Sie in der Liste der **Aktionspunkte** **PRE\$1CREATE\$1HOSTED\$1CONFIGURATION\$1VERSION** aus. 1. Wählen Sie für **Uri** die **Lambda-Funktion** und dann die Funktion in der **Lambda-Funktionsliste** aus. Wenn Sie Ihre Funktion nicht sehen, vergewissern Sie sich, dass Sie sich in derselben AWS-Region Datei befinden, in der Sie die Funktion erstellt haben. 1. Wählen Sie für **IAM-Rolle** die Rolle aus, die Sie zuvor in dieser exemplarischen Vorgehensweise erstellt haben. 1. Wählen Sie im Abschnitt **Erweiterungsparameter (optional)** die Option **Neuen Parameter hinzufügen** aus. 1. Geben Sie **unter Parametername** einen Namen ein. Geben **S3\$1BUCKET** Sie für die Zwecke dieser exemplarischen Vorgehensweise ein. 1. Wiederholen Sie die Schritte 5—11, um eine zweite Aktion für den `PRE_START_DEPLOYMENT` Aktionspunkt zu erstellen. 1. Wählen Sie Erweiterung **erstellen**. # Anpassen der erstellten AWS Benachrichtigungserweiterungen Sie müssen kein Lambda oder eine Erweiterung erstellen, um [AWS verfasste](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined.html) Benachrichtigungserweiterungen zu verwenden. Sie können einfach eine Erweiterungszuordnung erstellen und dann einen Vorgang ausführen, der einen der unterstützten Aktionspunkte aufruft. Standardmäßig unterstützen die erstellten AWS Benachrichtigungserweiterungen die folgenden Aktionspunkte: + `ON_DEPLOYMENT_START` + `ON_DEPLOYMENT_COMPLETE` + `ON_DEPLOYMENT_ROLLED_BACK` Wenn Sie benutzerdefinierte Versionen der `AWS AppConfig deployment events to Amazon SNS` Erweiterung und der `AWS AppConfig deployment events to Amazon SQS` Erweiterungen erstellen, können Sie die Aktionspunkte angeben, für die Sie Benachrichtigungen erhalten möchten. **Anmerkung** Die `AWS AppConfig deployment events to EventBridge` Erweiterung unterstützt die `PRE_*` Aktionspunkte nicht. Sie können eine benutzerdefinierte Version erstellen, wenn Sie einige der Standard-Aktionspunkte entfernen möchten, die der erstellten Version zugewiesen AWS sind. Sie müssen keine Lambda-Funktion erstellen, wenn Sie benutzerdefinierte Versionen der erstellten AWS Benachrichtigungserweiterungen erstellen. Sie müssen nur einen Amazon-Ressourcennamen (ARN) in das `Uri` Feld für die neue Erweiterungsversion eingeben. + Geben Sie für eine benutzerdefinierte EventBridge Benachrichtigungserweiterung den ARN der EventBridge Standardereignisse in das `Uri` Feld ein. + Für eine benutzerdefinierte Amazon SNS SNS-Benachrichtigungserweiterung geben Sie den ARN eines Amazon SNS SNS-Themas in das `Uri` Feld ein. + Für eine benutzerdefinierte Amazon SQS SQS-Benachrichtigungserweiterung geben Sie den ARN einer Amazon SQS SQS-Nachrichtenwarteschlange in das `Uri` Feld ein.