Configurer l'intégration entre les notifications et AWS Chatbot

AWS Chatbot est un service AWS qui permet aux équipes DevOps et de développement logiciel d'utiliser les salles de conversation Amazon Chime, les canaux Slack et les canaux Microsoft Teams pour surveiller les événements opérationnels et y répondre dans le AWS Cloud. Vous pouvez configurer l'intégration entre les cibles de règle de notification et AWS Chatbot afin que les notifications sur les événements s'affichent dans l'espace de conversation Amazon Chime, le canal Slack ou le canal Microsoft Teams que vous choisissez. Pour en savoir plus, consultez la documentation AWS Chatbot.

Avant de configurer l'intégration à AWS Chatbot, vous devez configurer une règle de notification et une cible de règle. Pour plus d'informations, consultez Configuration et Création d'une règle de notification. Vous devez également configurer un canal Slack, un canal Microsoft Teams ou une salle de conversation Amazon Chime dans AWS Chatbot. Pour plus d'informations, consultez la documentation de ces services.

Configurer un client AWS Chatbot pour un canal Slack

Vous pouvez créer des règles de notification qui utilisent un client AWS Chatbot comme cible. Si vous créez un client pour un canal Slack, vous pouvez l'utiliser directement comme cible dans le flux de travail pour créer une règle de notification. C'est le moyen le plus simple de configurer les notifications qui apparaissent dans les canaux Slack.

Pour créer un client AWS Chatbot avec Slack à utiliser comme cible

1. Suivez les instructions de Configuration d'AWS Chatbot avec Slack dans le Guide de l'administrateur AWS Chatbot. Dans cette situation, vous devez envisager les options suivantes pour une intégration optimale avec les notifications :

   • Lors de la création d'un rôle IAM, vous pouvez choisir un nom de rôle qui facilite l'identification de l'objet de ce rôle (par exemple, AWSCodeStarNotifications-Chatbot-Slack-Role). Cela peut vous aider à identifier l'objet du rôle à l'avenir.

   • Dans les rubriques SNS, vous n'avez pas à choisir une rubrique ou une région AWS. Lorsque vous choisissez le client AWS Chatbot comme cible, une rubrique Amazon SNS avec toutes les autorisations requises est créée et configurée pour le client AWS Chatbot dans le cadre du processus de création de règle de notification.

2. Terminez le processus de création du client. Vous pouvez alors choisir ce client comme cible lors de la création de règles de notification. Pour de plus amples informations, veuillez consulter Création d'une règle de notification.

   Note

   Ne supprimez pas la rubrique Amazon SNS du client AWS Chatbot une fois qu'elle a été configurée pour vous. Cela empêchera l'envoi de notifications à Slack.

Configurer un client AWS Chatbot pour un canal Microsoft Teams

Vous pouvez créer des règles de notification qui utilisent un client AWS Chatbot comme cible. Si vous créez un client pour un canal Microsoft Teams, vous pouvez l'utiliser directement comme cible dans le flux de travail pour créer une règle de notification. C'est le moyen le plus simple de configurer les notifications qui apparaissent dans les canaux Microsoft Teams.

Pour créer un client AWS Chatbot avec Microsoft Teams à utiliser comme cible

1. Suivez les instructions de Configuration de AWS Chatbot avec Microsoft Teams dans le Guide de l'administrateur AWS Chatbot. Dans cette situation, vous devez envisager les options suivantes pour une intégration optimale avec les notifications :

   • Lors de la création d'un rôle IAM, vous pouvez choisir un nom de rôle qui facilite l'identification de l'objet de ce rôle (par exemple, AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role). Cela peut vous aider à identifier l'objet du rôle à l'avenir.

   • Dans les rubriques SNS, vous n'avez pas à choisir une rubrique ou une région AWS. Lorsque vous choisissez le client AWS Chatbot comme cible, une rubrique Amazon SNS avec toutes les autorisations requises est créée et configurée pour le client AWS Chatbot dans le cadre du processus de création de règle de notification.

2. Terminez le processus de création du client. Vous pouvez alors choisir ce client comme cible lors de la création de règles de notification. Pour de plus amples informations, veuillez consulter Création d'une règle de notification.

   Note

   Ne supprimez pas la rubrique Amazon SNS du client AWS Chatbot une fois qu'elle a été configurée pour vous. Cela empêchera l'envoi de notifications à Microsoft Teams.

Configurer manuellement les clients pour Slack ou Amazon Chime

Vous pouvez choisir de créer l'intégration entre les notifications et Slack ou Amazon Chime directement. Il s'agit de la seule méthode disponible pour configurer les notifications aux salles de discussion Amazon Chime. Lorsque vous configurez cette intégration manuellement, vous créez un client AWS Chatbot qui utilise une rubrique Amazon SNS que vous avez précédemment configurée comme cible pour une règle de notification.

Pour intégrer manuellement les notifications avec AWS Chatbot et Slack

1. Ouvrez la console Outils pour développeurs AWS à l'adresse https://console.aws.amazon.com/codesuite/settings/notifications.

2. Choisissez Settings (Paramètres), puis Notification rules (Règles de notification).

3. Dans Notification rule targets (Cibles de règle de notification), recherchez et copiez la cible.

   Note

   Vous pouvez configurer plusieurs règles de notification pour utiliser la même rubrique Amazon SNS comme cible. Cela peut vous aider à consolider la messagerie, mais cela peut également avoir des conséquences imprévues si la liste des abonnements est destinée à être spécifique à une règle de notification ou à une ressource.

4. Ouvrez la console AWS Chatbot à l'adresse https://console.aws.amazon.com/chatbot/.

5. Choisissez Configure new client (Configurer un nouveau client), puis Slack.

6. Choisissez Configure (Configurer).

7. Connectez-vous à votre espace de travail Slack.

8. Lorsque vous êtes invité à confirmer les choix, choisissez Allow (Autoriser).

9. Choisissez Configure new client (Configurer un nouveau client).

10. Dans Configuration details (Détails de la configuration), dans Configuration name (Nom de la configuration), entrez un nom pour votre client. Il s'agit du nom qui apparaît dans la liste des cibles disponibles pour le type de cible AWS Chatbot (Slack) lorsque vous créez des règles de notification.

11. Dans Configure Slack Channel (Configurer le canal Slack), pour Channel type (Type de canal), choisissez Public ou Private (Privé), selon le type de canal que vous souhaitez utiliser pour l'intégration.

    • Dans Public channel (Canal public), choisissez le nom du canal Slack dans la liste.

    • Dans Private channel ID (ID de canal privé), entrez le code de canal ou l'URL.

12. Dans IAM permissions (Autorisations IAM), dans Role (Rôle), choisissez Create an IAM role using a template (Créer un rôle IAM à l'aide d'un modèle). Dans Policy templates (Modèles de stratégie), choisissez Notification permissions (Autorisations de notification). Dans Role name (Nom du rôle), saisissez le nom de ce rôle, par exemple AWSCodeStarNotifications-Chatbot-Slack-Role. Dans Policy templates (Modèles de stratégie), choisissez Notification permissions (Autorisations de notification).

13. Dans SNS topics (Rubriques SNS), pour SNS Region (Région SNS), choisissez la Région AWS dans laquelle vous avez créé la cible de règle de notification. Dans SNS topics (Rubriques SNS), choisissez le nom de la rubrique Amazon SNS que vous avez configurée comme cible de règle de notification.

    Note

    Cette étape n'est pas nécessaire si vous créez une règle de notification utilisant ce client comme cible.

14. Choisissez Configure (Configurer).

    Note

    Si vous avez configuré l'intégration avec un canal privé, vous devez inviter AWS Chatbot sur le canal avant de voir les notifications sur ce canal. Pour en savoir plus, consultez la documentation AWS Chatbot.

15. (Facultatif) Afin de tester l'intégration, modifiez la ressource qui correspond à un type d'événement pour une règle de notification qui est configurée pour utiliser la rubrique Amazon SNS comme cible. Par exemple, si vous avez une règle de notification configurée pour envoyer des notifications lorsque des commentaires sont effectués sur une demande d'extraction, faites un commentaire sur une demande d'extraction, puis regardez le canal Slack dans le navigateur pour voir quand la notification s'affiche.

Pour intégrer les notifications avec AWS Chatbot et Amazon Chime

1. Ouvrez la console Outils pour développeurs AWS à l'adresse https://console.aws.amazon.com/codesuite/settings/notifications.

2. Choisissez Settings (Paramètres), puis Notification rules (Règles de notification).

3. Dans Notification rule targets (Cibles de règle de notification), recherchez et copiez la cible.

   Note

   Vous pouvez configurer plusieurs règles de notification pour utiliser la même rubrique Amazon SNS comme cible. Cela peut vous aider à consolider la messagerie, mais cela peut également avoir des conséquences imprévues si la liste des abonnements est destinée à être spécifique à une règle de notification ou à une ressource.

4. Dans Amazon Chime, ouvrez la salle de conversation que vous souhaitez configurer pour l'intégration.

5. Choisissez l'icône d'engrenage dans le coin supérieur droit, puis choisissez Manage webhooks (Gérer les webhooks).

6. Dans la boîte de dialogue Manage webhooks (Gérer les webhooks), choisissez New (Nouveau), saisissez un nom pour le webhook et choisissez Create (Créer).

7. Vérifiez que le webhook apparaît, puis choisissez Copy webhook URL (Copier l'URL du webhook).

8. Ouvrez la console AWS Chatbot à l'adresse https://console.aws.amazon.com/chatbot/.

9. Choisissez Configure new client (Configurer un nouveau client), puis choisissez Amazon Chime.

10. Dans Configuration details (Détails de la configuration), dans Configuration name (Nom de la configuration), entrez un nom pour votre client.

11. Dans Webhook URL (URL du webhook), collez l'URL. Dans la Webhook description (Description du webhook), fournissez une description facultative.

12. Dans IAM permissions (Autorisations IAM), dans Role (Rôle), choisissez Create an IAM role using a template (Créer un rôle IAM à l'aide d'un modèle). Dans Policy templates (Modèles de stratégie), choisissez Notification permissions (Autorisations de notification). Dans Role name (Nom du rôle), saisissez le nom de ce rôle, par exemple AWSCodeStarNotifications-Chatbot-Chime-Role.

13. Dans SNS topics (Rubriques SNS), pour SNS Region (Région SNS), choisissez la Région AWS dans laquelle vous avez créé la cible de règle de notification. Dans SNS topics (Rubriques SNS), choisissez le nom de la rubrique Amazon SNS que vous avez configurée comme cible de règle de notification.

14. Choisissez Configure (Configurer).

15. (Facultatif) Afin de tester l'intégration, modifiez la ressource qui correspond à un type d'événement pour une règle de notification qui est configurée pour utiliser la rubrique Amazon SNS comme cible. Par exemple, si vous avez une règle de notification configurée pour envoyer des notifications lorsque des commentaires sont effectués sur une demande d'extraction, faites un commentaire sur une demande d'extraction, puis regardez la salle de conversation Amazon Chime pour voir quand la notification s'affiche dans cette salle.