

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.

# AWS AppConfig Erweiterungen verstehen
<a name="working-with-appconfig-extensions-about"></a>

In diesem Thema werden Konzepte und Terminologie von AWS AppConfig Erweiterungen vorgestellt. Die Informationen werden im Kontext der einzelnen Schritte behandelt, die für die Einrichtung und Verwendung von AWS AppConfig Erweiterungen erforderlich sind.

**Topics**
+ [Schritt 1: Ermitteln Sie, was Sie mit Erweiterungen machen möchten](#working-with-appconfig-extensions-how-it-works-step-1)
+ [Schritt 2: Ermitteln Sie, wann die Erweiterung ausgeführt werden soll](#working-with-appconfig-extensions-how-it-works-step-2)
+ [Schritt 3: Erstellen Sie eine Erweiterungszuordnung](#working-with-appconfig-extensions-how-it-works-step-3)
+ [Schritt 4: Stellen Sie eine Konfiguration bereit und überprüfen Sie, ob die Erweiterungsaktionen ausgeführt wurden](#working-with-appconfig-extensions-how-it-works-step-4)

## Schritt 1: Ermitteln Sie, was Sie mit Erweiterungen machen möchten
<a name="working-with-appconfig-extensions-how-it-works-step-1"></a>

Möchtest du eine Benachrichtigung an einen Webhook erhalten, der jedes Mal, wenn eine AWS AppConfig Bereitstellung abgeschlossen ist, Nachrichten an Slack sendet? Möchten Sie ein Konfigurationsprofil in einem Amazon Simple Storage Service (Amazon S3) -Bucket sichern, bevor eine Konfiguration bereitgestellt wird? Möchten Sie die Konfigurationsdaten nach vertraulichen Informationen durchsuchen, bevor die Konfiguration bereitgestellt wird? Sie können Erweiterungen verwenden, um diese Art von Aufgaben und mehr auszuführen. Sie können benutzerdefinierte Erweiterungen erstellen oder die erstellten Erweiterungen verwenden, AWS die im Lieferumfang enthalten sind. AWS AppConfig

**Anmerkung**  
In den meisten Anwendungsfällen müssen Sie zum Erstellen einer benutzerdefinierten Erweiterung eine AWS Lambda Funktion erstellen, die alle in der Erweiterung definierten Berechnungen und Verarbeitungen durchführt. Weitere Informationen finden Sie unter [Exemplarische Vorgehensweise: Benutzerdefinierte Erweiterungen erstellen AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

Die folgenden erstellten AWS Erweiterungen können Ihnen helfen, Konfigurationsbereitstellungen schnell in andere Dienste zu integrieren. Sie können diese Erweiterungen in der AWS AppConfig Konsole verwenden oder indem Sie [API-Aktionen](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_Operations.html) für Erweiterungen direkt über das AWS CLI, AWS -Tools für PowerShell, oder das SDK aufrufen.


****  

| Erweiterung | Description | 
| --- | --- | 
|  [AWS AppConfig Bereitstellungsereignisse für EventBridge](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-eventbridge.html)  |  Diese Erweiterung sendet Ereignisse an den EventBridge Standard-Event-Bus, wenn eine Konfiguration bereitgestellt wird.   | 
|  [AWS AppConfig Bereitstellungsereignisse für Amazon Simple Notification Service (Amazon SNS)](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sns.html)  |  Diese Erweiterung sendet Nachrichten an ein Amazon SNS SNS-Thema, das Sie angeben, wenn eine Konfiguration bereitgestellt wird.   | 
|  [AWS AppConfig Bereitstellungsereignisse für Amazon Simple Queue Service (Amazon SQS)](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sqs.html)  |  Diese Erweiterung stellt Nachrichten in Ihre Amazon SQS SQS-Warteschlange, wenn eine Konfiguration bereitgestellt wird.  | 
|  [Integrationserweiterung — Atlassian Jira](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-jira.html)  |  [Mit dieser Erweiterung kannst du Probleme erstellen und aktualisieren AWS AppConfig , wenn du Änderungen an einem Feature-Flag vornimmst.](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-feature-flags)   | 

## Schritt 2: Ermitteln Sie, wann die Erweiterung ausgeführt werden soll
<a name="working-with-appconfig-extensions-how-it-works-step-2"></a>

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`

## Schritt 3: Erstellen Sie eine Erweiterungszuordnung
<a name="working-with-appconfig-extensions-how-it-works-step-3"></a>

Um eine Erweiterung zu erstellen oder eine AWS erstellte Erweiterung zu konfigurieren, definieren Sie die Aktionspunkte, die eine Erweiterung aufrufen, wenn eine bestimmte AWS AppConfig Ressource verwendet wird. Sie können sich beispielsweise dafür entscheiden, die `AWS AppConfig deployment events to Amazon SNS` Erweiterung auszuführen und Benachrichtigungen zu einem Amazon SNS SNS-Thema zu erhalten, wenn eine Konfigurationsbereitstellung für eine bestimmte Anwendung gestartet wird. Die Definition, welche Aktionspunkte eine Erweiterung für eine bestimmte AWS AppConfig Ressource aufrufen, wird als *Erweiterungszuordnung* bezeichnet. Eine Erweiterungszuordnung ist eine bestimmte Beziehung zwischen einer Erweiterung und einer AWS AppConfig Ressource, z. B. einer Anwendung oder einem Konfigurationsprofil.

Eine einzelne AWS AppConfig Anwendung kann mehrere Umgebungen und Konfigurationsprofile enthalten. Wenn Sie einer Anwendung oder einer Umgebung eine Erweiterung zuordnen, AWS AppConfig ruft sie die Erweiterung für alle Workflows auf, die sich auf die Anwendungs- oder Umgebungsressourcen beziehen, sofern zutreffend.

Angenommen, Sie haben eine AWS AppConfig Anwendung aufgerufen MobileApps , die ein Konfigurationsprofil namens AccessList enthält. Nehmen wir an, die MobileApps Anwendung umfasst Beta-, Integrations- und Produktionsumgebungen. Sie erstellen eine Erweiterungszuordnung für die AWS verfasste Amazon SNS SNS-Benachrichtigungserweiterung und ordnen die Erweiterung der Anwendung zu. MobileApps Die Amazon SNS SNS-Benachrichtigungserweiterung wird immer dann aufgerufen, wenn die Konfiguration für die Anwendung in einer der drei Umgebungen bereitgestellt wird. 

**Anmerkung**  
Sie müssen keine Erweiterung erstellen, um AWS erstellte Erweiterungen verwenden zu können, aber Sie müssen eine Erweiterungszuordnung erstellen.

## Schritt 4: Stellen Sie eine Konfiguration bereit und überprüfen Sie, ob die Erweiterungsaktionen ausgeführt wurden
<a name="working-with-appconfig-extensions-how-it-works-step-4"></a>

Wenn Sie eine Zuordnung erstellt haben, wenn eine gehostete Konfiguration erstellt oder eine Konfiguration bereitgestellt wird, wird AWS AppConfig die Erweiterung aufgerufen und die angegebenen Aktionen ausgeführt. Wenn beim Aufrufen einer Erweiterung während eines `PRE-*` Aktionspunkts im System ein Fehler auftritt, werden Informationen zu diesem Fehler AWS AppConfig zurückgegeben.