Verwenden der Erweiterung AWS AppConfig deployment events to Amazon SNS - AWS AppConfig
Verwenden der Erweiterung

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.

Verwenden der Erweiterung AWS AppConfig deployment events to Amazon SNS

Bei der AWS AppConfig deployment events to Amazon SNS Erweiterung handelt es sich um eine AWS eigens erstellte Erweiterung, mit der Sie den Workflow für die AWS AppConfig Konfigurationsbereitstellung überwachen und entsprechend handeln können. Die Erweiterung veröffentlicht Nachrichten zu einem SNS Amazon-Thema, wenn eine Konfiguration bereitgestellt wird. Nachdem Sie die Erweiterung einer Ihrer AWS AppConfig Anwendungen, Umgebungen oder Konfigurationsprofile zugeordnet haben, AWS AppConfig veröffentlicht sie nach jedem Start, Ende und Rollback der Konfigurationsbereitstellung eine Nachricht zu diesem Thema.

Wenn Sie mehr Kontrolle darüber haben möchten, an welchen Aktionspunkten SNS Amazon-Benachrichtigungen gesendet werden, können Sie eine benutzerdefinierte Erweiterung erstellen und ein SNS Amazon-Thema Amazon Resource Name (ARN) für das URI Feld eingeben. Informationen zum Erstellen einer Erweiterung finden Sie unterExemplarische Vorgehensweise: Benutzerdefinierte Erweiterungen erstellen AWS AppConfig.

Verwenden der Erweiterung

In diesem Abschnitt wird beschrieben, wie Sie die AWS AppConfig deployment events to Amazon SNS Erweiterung verwenden.

Schritt 1: So konfigurieren AWS AppConfig , dass Nachrichten zu einem Thema veröffentlicht werden

Fügen Sie Ihrem SNS Amazon-Thema zur Gewährung von AWS AppConfig (appconfig.amazonaws.com) Veröffentlichungsberechtigungen (sns:Publish) eine Zugriffskontrollrichtlinie hinzu. Weitere Informationen finden Sie unter Beispielfälle für Amazon SNS Access Control.

Schritt 2: Erstellen Sie eine Erweiterungszuordnung

Hängen Sie die Erweiterung an eine Ihrer AWS AppConfig Ressourcen an, indem Sie eine Erweiterungszuordnung erstellen. Sie erstellen die Zuordnung mithilfe der AWS AppConfig Konsole oder der CreateExtensionAssociationAPIAktion. Wenn Sie die Zuordnung erstellen, geben Sie die ARN eines AWS AppConfig Anwendungs-, Umgebungs- oder Konfigurationsprofils an. Wenn Sie die Erweiterung einer Anwendung oder Umgebung zuordnen, wird eine Benachrichtigung für jedes Konfigurationsprofil gesendet, das in der angegebenen Anwendung oder Umgebung enthalten ist. Wenn Sie die Zuordnung erstellen, müssen Sie einen Wert für den topicArn Parameter eingeben, ARN der das SNS Amazon-Thema enthält, das Sie verwenden möchten.

Wenn Sie die Zuordnung erstellt haben und eine Konfiguration für die angegebene AWS AppConfig Ressource bereitgestellt wird, wird die AWS AppConfig Erweiterung aufgerufen und Benachrichtigungen gemäß den in der Erweiterung angegebenen Aktionspunkten gesendet.

Anmerkung

Diese Erweiterung wird von den folgenden Aktionspunkten aufgerufen:

  • ON_DEPLOYMENT_START

  • ON_DEPLOYMENT_COMPLETE

  • ON_DEPLOYMENT_ROLLED_BACK

Sie können die Aktionspunkte für diese Erweiterung nicht anpassen. Um verschiedene Aktionspunkte aufzurufen, können Sie Ihre eigene Erweiterung erstellen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Benutzerdefinierte Erweiterungen erstellen AWS AppConfig.

Gehen Sie wie folgt vor, um eine AWS AppConfig Erweiterungszuordnung mithilfe der AWS Systems Manager Konsole oder der AWS CLI zu erstellen.

So erstellen Sie eine Erweiterungszuordnung (Konsole)

  1. Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/appconfig/.

  2. Wählen Sie im Navigationsbereich AWS AppConfig aus.

  3. Wählen Sie auf der Registerkarte Erweiterungen die Option Zur Ressource hinzufügen aus.

  4. Wählen Sie im Abschnitt Details zur Erweiterungsressource unter Ressourcentyp einen AWS AppConfig Ressourcentyp aus. Abhängig von der ausgewählten Ressource werden Sie AWS AppConfig aufgefordert, andere Ressourcen auszuwählen.

  5. Wählen Sie Zuordnung zur Ressource erstellen aus.

Hier ist ein Beispiel für die Nachricht, die an das SNS Amazon-Thema gesendet wird, wenn die Erweiterung aufgerufen wird.

{
    "Type": "Notification",
    "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28",
    "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic",
    "Message": {
        "InvocationId": "7itcaxp",
        "Parameters": {
            "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic"
        },
        "Application": {
            "Id": "1a2b3c4d",
            "Name": MyApp
        },
        "Environment": {
            "Id": "1a2b3c4d",
            "Name": MyEnv
        },
        "ConfigurationProfile": {
            "Id": "1a2b3c4d",
            "Name": "MyConfigProfile"
        },
        "Description": null,
        "DeploymentNumber": "3",
        "ConfigurationVersion": "1",
        "Type": "OnDeploymentComplete"
    },
    "Timestamp": "2022-06-30T20:26:52.067Z",
    "SignatureVersion": "1",
    "Signature": "<...>",
    "SigningCertURL": "<...>",
    "UnsubscribeURL": "<...>",
    "MessageAttributes": {
        "MessageType": {
            "Type": "String",
            "Value": "OnDeploymentStart"
        }
    }
}