View a markdown version of this page

Compréhension AWS AppConfig extensions - AWS AppConfig

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Compréhension AWS AppConfig extensions

Cette rubrique présente les concepts et la terminologie des AWS AppConfig extensions. Les informations sont abordées dans le contexte de chaque étape requise pour configurer et utiliser les AWS AppConfig extensions.

Étape 1 : Déterminez ce que vous voulez faire avec les extensions

Souhaitez-vous recevoir une notification concernant un webhook qui envoie des messages à Slack chaque fois qu'un AWS AppConfig déploiement est terminé ? Souhaitez-vous sauvegarder un profil de configuration dans un compartiment Amazon Simple Storage Service (Amazon S3) avant le déploiement d'une configuration ? Souhaitez-vous nettoyer les données de configuration à la recherche d'informations sensibles avant le déploiement de la configuration ? Vous pouvez utiliser des extensions pour effectuer ces types de tâches et bien plus encore. Vous pouvez créer des extensions personnalisées ou utiliser les AWS extensions créées incluses dans. AWS AppConfig

Note

Dans la plupart des cas d'utilisation, pour créer une extension personnalisée, vous devez créer une AWS Lambda fonction permettant d'effectuer tous les calculs et traitements définis dans l'extension. Pour plus d’informations, consultez Procédure pas à pas : création personnalisée AWS AppConfig extensions.

Les extensions AWS créées ci-dessous peuvent vous aider à intégrer rapidement les déploiements de configuration à d'autres services. Vous pouvez utiliser ces extensions dans la AWS AppConfig console ou en appelant des actions d'API d'extension directement depuis le AWS CLI Outils AWS pour PowerShell, ou le SDK.

Extension Description

AWS AppConfig événements de déploiement pour EventBridge

Cette extension envoie des événements au bus d'événements EventBridge par défaut lorsqu'une configuration est déployée.

AWS AppConfig événements de déploiement sur Amazon Simple Notification Service (Amazon SNS)

Cette extension envoie des messages à une rubrique Amazon SNS que vous spécifiez lorsqu'une configuration est déployée.

AWS AppConfig événements de déploiement sur Amazon Simple Queue Service (Amazon SQS)

Cette extension place les messages dans votre file d'attente Amazon SQS lorsqu'une configuration est déployée.

Extension d'intégration : Atlassian Jira

Cette extension permet de créer et AWS AppConfig de mettre à jour des problèmes chaque fois que vous apportez des modifications à un indicateur de fonctionnalité.

Étape 2 : Déterminez quand vous souhaitez que l'extension s'exécute

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.

  • PRE_CREATE_HOSTED_CONFIGURATION_VERSION

  • PRE_START_DEPLOYMENT

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.

  • ON_DEPLOYMENT_START

  • ON_DEPLOYMENT_STEP

  • ON_DEPLOYMENT_BAKING

  • ON_DEPLOYMENT_COMPLETE

  • ON_DEPLOYMENT_ROLLED_BACK

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.

  • AT_DEPLOYMENT_TICK

Étape 3 : Création d'une association d'extension

Pour créer une extension ou configurer une extension AWS créée, vous définissez les points d'action qui invoquent une extension lorsqu'une AWS AppConfig ressource spécifique est utilisée. Par exemple, vous pouvez choisir d'exécuter l'AWS AppConfig deployment events to Amazon SNSextension et de recevoir des notifications sur un sujet Amazon SNS chaque fois qu'un déploiement de configuration est lancé pour une application spécifique. La définition des points d'action qui invoquent une extension pour une AWS AppConfig ressource spécifique s'appelle une association d'extension. Une association d'extension est une relation spécifiée entre une extension et une AWS AppConfig ressource, telle qu'une application ou un profil de configuration.

Une seule AWS AppConfig application peut inclure plusieurs environnements et profils de configuration. Si vous associez une extension à une application ou à un environnement, AWS AppConfig invoque l'extension pour tous les flux de travail liés à l'application ou aux ressources de l'environnement, le cas échéant.

Par exemple, supposons que vous ayez une AWS AppConfig application appelée MobileApps qui inclut un profil de configuration appelé AccessList. Supposons que l' MobileApps application inclut des environnements bêta, d'intégration et de production. Vous créez une association d'extension pour l'extension AWS de notification Amazon SNS créée et vous associez l'extension à l' MobileApps application. L'extension de notification Amazon SNS est invoquée chaque fois que la configuration de l'application est déployée dans l'un des trois environnements.

Note

Il n'est pas nécessaire de créer une extension pour AWS utiliser des extensions créées, mais vous devez créer une association d'extensions.

Étape 4 : Déployer une configuration et vérifier que les actions d'extension sont effectuées

Après avoir créé une association, lorsqu'une configuration hébergée est créée ou qu'une configuration est déployée AWS AppConfig , appelle l'extension et exécute les actions spécifiées. Lorsqu'une extension est invoquée, si le système rencontre une erreur lors d'un point PRE-* d'action, AWS AppConfig renvoie des informations sur cette erreur.