Étape 3 : créer une personnalisation AWS AppConfig Extension

Une extension définit une ou plusieurs actions qu'elle effectue au cours d'un AWS AppConfig flux de travail. Par exemple, l' AWS AWS AppConfig deployment events to Amazon SNSextension créée inclut une action pour envoyer une notification à une rubrique Amazon SNS. Chaque action est invoquée lorsque vous interagissez avec AWS AppConfig ou lorsque AWS AppConfig vous exécutez un processus en votre nom. C'est ce que l'on appelle des points d'action. AWS AppConfig les extensions prennent en charge les points d'action suivants :

Points d'action PRE_*  : les actions d'extension configurées sur les points PRE_* d'action sont appliquées après la validation de la demande, mais avant AWS AppConfig l'exécution de l'activité correspondant au nom du point d'action. Ces appels d'action sont traités en même temps qu'une demande. Si plusieurs demandes sont effectuées, les appels d'action sont exécutés de manière séquentielle. Notez également que les points PRE_* d'action reçoivent et peuvent modifier le contenu d'une configuration. PRE_*les points d'action peuvent également répondre à une erreur et empêcher qu'une action ne se produise.

Points d'action ON_*  : une extension peut également être exécutée en parallèle avec un AWS AppConfig flux de travail à l'aide d'un point d'ON_*action. ON_*les points d'action sont invoqués de manière asynchrone. ON_*les points d'action ne reçoivent pas le contenu d'une configuration. Si une extension rencontre une erreur lors d'un point ON_* d'action, le service ignore l'erreur et poursuit le flux de travail.

Points d'action AT_*  : les actions d'extension configurées sur les points AT_* d'action sont invoquées de manière synchrone et en parallèle à un flux de travail. AWS AppConfig Si une extension rencontre une erreur lors d'un point AT_* d'action, le service arrête le flux de travail et annule le déploiement.

Le point AT_DEPLOYMENT_TICK d'action prend en charge l'intégration de la surveillance par des tiers. AT_DEPLOYMENT_TICKest invoqué lors de l'orchestration du traitement du déploiement de la configuration. Si vous utilisez une solution de surveillance tierce (Datadog ou New Relic, par exemple), vous pouvez créer une AWS AppConfig extension qui vérifie la présence d'alarmes au point AT_DEPLOYMENT_TICK d'action et, par mesure de sécurité, annule le déploiement s'il a déclenché une alarme.

Si vous utilisez une solution de surveillance tierce telle que Datadog ou New Relic, vous pouvez créer une AWS AppConfig extension qui vérifie la présence d'alarmes au point AT_DEPLOYMENT_TICK d'action et, par mesure de sécurité, annule le déploiement s'il a déclenché une alarme. Pour plus d'informations, consultez les exemples d'intégration de Datadog et New Relic suivants sur : GitHub

Pour plus d'informations sur AWS AppConfig les extensions, consultez les rubriques suivantes :

Exemple d'extension

L'exemple d'extension suivant définit une action qui appelle le point PRE_CREATE_HOSTED_CONFIGURATION_VERSION d'action. Dans le Uri champ, l'action spécifie le nom de ressource Amazon (ARN) de la fonction MyS3ConfigurationBackUpExtension Lambda créée plus tôt dans cette procédure pas à pas. L'action spécifie également l'ARN du rôle d'assume Gestion des identités et des accès AWS (IAM) créé plus tôt dans cette procédure pas à pas.

Exemple d' AWS AppConfig extension

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