Utilisation des événements AWS AppConfig de déploiement vers l'extension Amazon SNS

L'AWS AppConfig deployment events to Amazon SNSextension est une extension AWS créée qui vous aide à surveiller et à agir sur le flux de travail de déploiement AWS AppConfig de la configuration. L'extension publie des messages sur une rubrique Amazon SNS chaque fois qu'une configuration est déployée. Une fois que vous avez associé l'extension à l'une de vos AWS AppConfig applications, environnements ou profils de configuration, AWS AppConfig publiez un message dans le sujet après le début, la fin et l'annulation de chaque déploiement de configuration.

Si vous souhaitez mieux contrôler les points d'action qui envoient des notifications Amazon SNS, vous pouvez créer une extension personnalisée et saisir une rubrique Amazon SNS (Amazon Resource Name (ARN) pour le champ URI. Pour plus d'informations sur la création d'une extension, consultezProcédure pas à pas : création d'extensions personnalisées AWS AppConfig.

Utilisation de l'extension

Cette section décrit comment utiliser l'AWS AppConfig deployment events to Amazon SNSextension.

Étape 1 : configurer AWS AppConfig pour publier des messages dans un sujet

Ajoutez une politique de contrôle d'accès à votre rubrique Amazon SNS en accordant AWS AppConfig (appconfig.amazonaws.com) des autorisations de publication (sns:Publish). Pour plus d'informations, consultez Exemples de cas relatifs au contrôle d'accès Amazon SNS.

Étape 2 : créer une association d'extensions

Associez l'extension à l'une de vos AWS AppConfig ressources en créant une association d'extensions. Vous créez l'association à l'aide de la AWS AppConfig console ou de l'action CreateExtensionAssociationAPI. Lorsque vous créez l'association, vous spécifiez l'ARN d'une AWS AppConfig application, d'un environnement ou d'un profil de configuration. Si vous associez l'extension à une application ou à un environnement, une notification est envoyée pour tout profil de configuration contenu dans l'application ou l'environnement spécifié. Lorsque vous créez l'association, vous devez saisir une valeur pour le topicArn paramètre qui contient l'ARN de la rubrique Amazon SNS que vous souhaitez utiliser.

Après avoir créé l'association, lorsqu'une configuration pour la AWS AppConfig ressource spécifiée est déployée, AWS AppConfig appelle l'extension et envoie des notifications en fonction des points d'action spécifiés dans l'extension.

Note

Cette extension est invoquée par les points d'action suivants :

• ON_DEPLOYMENT_START

• ON_DEPLOYMENT_COMPLETE

• ON_DEPLOYMENT_ROLLED_BACK

Vous ne pouvez pas personnaliser les points d'action pour cette extension. Pour invoquer différents points d'action, vous pouvez créer votre propre extension. Pour de plus amples informations, veuillez consulter Procédure pas à pas : création d'extensions personnalisées AWS AppConfig.

Utilisez les procédures suivantes pour créer une association d' AWS AppConfig extension à l'aide de la AWS Systems Manager console ou du AWS CLI.

Pour créer une association d'extensions (console)

1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/appconfig/.

2. Dans le panneau de navigation, sélectionnez AWS AppConfig.

3. Dans l'onglet Extensions, choisissez Ajouter à la ressource.

4. Dans la section Détails de la ressource d'extension, pour Type de ressource, choisissez un type de AWS AppConfig ressource. En fonction de la ressource que vous choisissez, vous AWS AppConfig invite à choisir d'autres ressources.

5. Choisissez Créer une association à la ressource.

Voici un exemple du message envoyé à la rubrique Amazon SNS lorsque l'extension est invoquée.

{
    "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"
        }
    }
}