Konfigurieren der Integration zwischen Benachrichtigungen und AWS Chatbot

AWS Chatbot ist ein AWS-Service, der es DevOps- und Softwareentwicklungsteams ermöglicht, Amazon-Chime-Chatrooms, Slack-Kanäle und Microsoft Teams-Kanäle zu verwenden, um betriebliche Ereignisse in der AWS Cloud zu überwachen und darauf zu reagieren. Sie können die Integration zwischen Benachrichtigungsregelzielen und AWS Chatbot so konfigurieren, dass Benachrichtigungen zu Ereignissen in dem von Ihnen ausgewählten Amazon-Chime-Chatroom, Slack-Kanal oder Microsoft Teams-Kanal angezeigt werden. Weitere Informationen finden Sie in der AWS-Chatbot-Dokumentation.

Bevor Sie die Integration mit AWS Chatbot konfigurieren, müssen Sie eine Benachrichtigungsregel und ein Regelziel konfigurieren. Weitere Informationen finden Sie unter Einrichtung und Erstellen einer Benachrichtigungsregel. Außerdem müssen Sie einen Slack-Kanal, Microsoft Teams-Kanal oder einen Amazon-Chime-Chatroom in AWS Chatbot konfigurieren. Weitere Informationen finden Sie in der Dokumentation zu diesen Services.

Konfigurieren eines AWS-Chatbot-Clients für einen Slack-Kanal

Sie können Benachrichtigungsregeln erstellen, die einen AWS-Chatbot-Client als Ziel verwenden. Wenn Sie einen Client für einen Slack-Kanal erstellen, können Sie diesen Client direkt als Ziel im Workflow zum Erstellen einer Benachrichtigungsregel verwenden. Dies ist der einfachste Weg, um Benachrichtigungen einzurichten, die in Slack-Kanälen angezeigt werden.

So erstellen Sie einen AWS-Chatbot-Client mit Slack als Ziel

1. Folgen Sie den Anweisungen unter Einrichten von AWS Chatbot mit Slack im AWS-Chatbot-Administratorhandbuch. Berücksichtigen Sie dabei die folgenden Optionen für eine optimale Integration mit Benachrichtigungen:

   • Wenn Sie eine IAM-Rolle erstellen, sollten Sie einen Rollennamen auswählen, der die Identifizierung des Zwecks dieser Rolle erleichtert (z. B. AWSCodeStarNotifications-Chatbot-Slack-Role). Dies kann Ihnen helfen, den Zweck der Rolle in der Zukunft zu identifizieren.

   • Unter SNS topics (SNS-Themen) müssen Sie kein Thema oder eine AWS-Region auswählen. Wenn Sie den AWS-Chatbot-Client als Ziel auswählen, wird ein Amazon-SNS-Thema mit allen erforderlichen Berechtigungen erstellt und für den AWS-Chatbot-Client im Rahmen des Erstellungsprozesses für Benachrichtigungsregeln konfiguriert.

2. Schließen Sie den Client-Erstellungsprozess ab. Dieser Client steht Ihnen dann zur Verfügung, wenn Sie Benachrichtigungsregeln erstellen. Weitere Informationen finden Sie unter Erstellen einer Benachrichtigungsregel.

   Anmerkung

   Entfernen Sie das Amazon-SNS-Thema nicht vom AWS-Chatbot-Client, nachdem es für Sie konfiguriert wurde. Andernfalls wird verhindert, dass Benachrichtigungen an Slack gesendet werden.

Konfigurieren eines AWS-Chatbot-Clients für einen Microsoft Teams-Kanal

Sie können Benachrichtigungsregeln erstellen, die einen AWS-Chatbot-Client als Ziel verwenden. Wenn Sie einen Client für einen Microsoft Teams-Kanal erstellen, können Sie diesen Client direkt als Ziel im Workflow zum Erstellen einer Benachrichtigungsregel verwenden. Dies ist der einfachste Weg, um Benachrichtigungen einzurichten, die in Microsoft Teams-Kanälen angezeigt werden.

So erstellen Sie einen AWS-Chatbot-Client mit Microsoft Teams als Ziel

1. Folgen Sie den Anweisungen unter Einrichten von AWS Chatbot mit Microsoft Teams im AWS-Chatbot-Administratorhandbuch. Berücksichtigen Sie dabei die folgenden Optionen für eine optimale Integration mit Benachrichtigungen:

   • Wenn Sie eine IAM-Rolle erstellen, sollten Sie einen Rollennamen auswählen, der die Identifizierung des Zwecks dieser Rolle erleichtert (z. B. AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role). Dies kann Ihnen helfen, den Zweck der Rolle in der Zukunft zu identifizieren.

   • Unter SNS topics (SNS-Themen) müssen Sie kein Thema oder eine AWS-Region auswählen. Wenn Sie den AWS-Chatbot-Client als Ziel auswählen, wird ein Amazon-SNS-Thema mit allen erforderlichen Berechtigungen erstellt und für den AWS-Chatbot-Client im Rahmen des Erstellungsprozesses für Benachrichtigungsregeln konfiguriert.

2. Schließen Sie den Client-Erstellungsprozess ab. Dieser Client steht Ihnen dann zur Verfügung, wenn Sie Benachrichtigungsregeln erstellen. Weitere Informationen finden Sie unter Erstellen einer Benachrichtigungsregel.

   Anmerkung

   Entfernen Sie das Amazon-SNS-Thema nicht vom AWS-Chatbot-Client, nachdem es für Sie konfiguriert wurde. Andernfalls wird verhindert, dass Benachrichtigungen an Microsoft Teams gesendet werden.

Manuelles Konfigurieren von Clients für Slack oder Amazon Chime

Sie können die Integration zwischen Benachrichtigungen und Slack oder Amazon Chime direkt erstellen. Dies ist die einzige Möglichkeit für die Konfiguration von Benachrichtigungen für Amazon-Chime-Chatrooms. Wenn Sie diese Integration manuell konfigurieren, erstellen Sie einen AWS-Chatbot-Client, der ein Amazon-SNS-Thema verwendet, das Sie zuvor als Ziel für eine Benachrichtigungsregel konfiguriert haben.

So integrieren Sie Benachrichtigungen mit AWS Chatbot und Slack manuell

1. Öffnen Sie die AWS-Entwicklertools-Konsole unter https://console.aws.amazon.com/codesuite/settings/notifications.

2. Wählen Sie Settings (Einstellungen) und dann Notification rules (Benachrichtigungsregeln) aus.

3. Suchen Sie das Ziel unter Notification rule targets (Benachrichtigungsregelziele) und kopieren Sie es.

   Anmerkung

   Sie können mehr als eine Benachrichtigungsregel so konfigurieren, dass dasselbe Amazon-SNS-Thema als Ziel verwendet wird. Dies kann Ihnen helfen, das Messaging zu konsolidieren, kann aber unbeabsichtigte Folgen haben, wenn die Abonnementliste für eine einzelne Benachrichtigungsregel oder Ressource vorgesehen ist.

4. Öffnen Sie die AWS-Chatbot-Konsole unter https://console.aws.amazon.com/chatbot/.

5. Wählen Sie Configure new client (Neuen Client konfigurieren) und dann Slack.

6. Wählen Sie Konfigurieren aus.

7. Melden Sie sich bei Ihrem Slack-Workspace an.

8. Wenn Sie aufgefordert werden, Ihre Auswahl zu bestätigen, wählen Sie Allow (Zulassen) aus.

9. Wählen Sie Configure new channel (Neuen Kanal konfigurieren) aus.

10. Geben Sie unter Configuration details (Konfigurationsdetails) in Configuration name (Konfigurationsname) einen Namen für Ihren Client ein. Dies ist der Name, der in der Liste der verfügbaren Ziele für den Zieltyp AWS Chatbot (Slack) angezeigt wird, wenn Sie Benachrichtigungsregeln erstellen.

11. Wählen Sie unter Configure Slack Channel (Slack-Channel konfigurieren) unter Channel type (Channel-Typ) die Option Public (Öffentlich) oder Private (Privat) aus, je nachdem, welchen Channel Sie integrieren möchten.

    • Wählen Sie unter Public channel (Öffentlicher Kanal), den Namen des Slack-Kanals aus der Liste aus.

    • Geben Sie unter Private Channel ID (ID des privaten Kanals), den Kanalcode oder die URL ein.

12. Gehen Sie zu IAM permissions (IAM-Berechtigungen) und wählen Sie unter Role (Rolle) die Option Create an IAM role using a template (IAM-Rolle mit einer Vorlage erstellen) aus. Wählen Sie in Policy templates (Richtlinienvorlagen) die Option Notification permissions (Benachrichtigungsberechtigungen) aus. Geben Sie unter Role name (Rollenname) einen Namen für diese Rolle ein (z. B. AWSCodeStarNotifications-Chatbot-Slack-Role). Wählen Sie in Policy templates (Richtlinienvorlagen) die Option Notification permissions (Benachrichtigungsberechtigungen) aus.

13. Wählen Sie unter SNS topics (SNS-Themen) in SNS Region die AWS-Region aus, in der Sie das Benachrichtigungsregelziel erstellt haben. Wählen Sie unter SNS topics (SNS-Themen) den Namen des Amazon-SNS-Themas aus, das Sie als Benachrichtigungsregelziel konfiguriert haben.

    Anmerkung

    Dieser Schritt ist nicht erforderlich, wenn Sie eine Benachrichtigungsregel mit diesem Client als Ziel erstellen.

14. Wählen Sie Konfigurieren aus.

    Anmerkung

    Wenn Sie die Integration mit einem privaten Kanal konfiguriert haben, müssen Sie AWS Chatbot zum Kanal einladen, bevor in diesem Kanal Benachrichtigungen angezeigt werden. Weitere Informationen finden Sie in der AWS-Chatbot-Dokumentation.

15. (Optional) Um die Integration zu testen, nehmen Sie eine Änderung an der Ressource vor, die einem Ereignistyp für eine Benachrichtigungsregel entspricht, die für die Verwendung des Amazon-SNS-Themas als Ziel konfiguriert ist. Wenn Sie beispielsweise eine Benachrichtigungsregel so konfiguriert haben, dass Benachrichtigungen gesendet werden, wenn Kommentare zu einer Pull-Anforderung gemacht werden, kommentieren Sie eine Pull-Anforderung und beobachten Sie dann den Slack-Kanal im Browser, um zu sehen, wann die Benachrichtigung erscheint.

So integrieren Sie Benachrichtigungen in AWS Chatbot und Amazon Chime

1. Öffnen Sie die AWS-Entwicklertools-Konsole unter https://console.aws.amazon.com/codesuite/settings/notifications.

2. Wählen Sie Settings (Einstellungen) und dann Notification rules (Benachrichtigungsregeln) aus.

3. Suchen Sie das Ziel unter Notification rule targets (Benachrichtigungsregelziele) und kopieren Sie es.

   Anmerkung

   Sie können mehr als eine Benachrichtigungsregel so konfigurieren, dass dasselbe Amazon-SNS-Thema als Ziel verwendet wird. Dies kann Ihnen helfen, das Messaging zu konsolidieren, kann aber unbeabsichtigte Folgen haben, wenn die Abonnementliste für eine einzelne Benachrichtigungsregel oder Ressource sein soll.

4. Öffnen Sie in Amazon Chime den Chatroom, den Sie für die Integration konfigurieren möchten.

5. Wählen Sie das Zahnradsymbol rechts oben und anschließend Manage webhooks (Webhooks verwalten) aus.

6. Wählen Sie im Dialogfeld Manage webhooks (Webhooks verwalten) New (Neu) aus, geben Sie einen Namen für den Webhook ein und wählen Sie anschließend Create (Erstellen) aus.

7. Überprüfen Sie, ob der Webhook angezeigt wird, und wählen Sie dann Copy webhook URL (Webhook-URL kopieren) aus.

8. Öffnen Sie die AWS-Chatbot-Konsole unter https://console.aws.amazon.com/chatbot/.

9. Wählen Sie Configure new client (Neuen Client konfigurieren) und dann Amazon Chime.

10. Geben Sie unter Configuration details (Konfigurationsdetails) in Configuration name (Konfigurationsname) einen Namen für Ihren Client ein.

11. Fügen Sie in Webhook URL die URL ein. Geben Sie in Webhook description (Webhook-Beschreibung) eine optionale Beschreibung an.

12. Gehen Sie zu IAM permissions (IAM-Berechtigungen) und wählen Sie unter Role (Rolle) die Option Create an IAM role using a template (IAM-Rolle mit einer Vorlage erstellen) aus. Wählen Sie in Policy templates (Richtlinienvorlagen) die Option Notification permissions (Benachrichtigungsberechtigungen) aus. Geben Sie unter Role name (Rollenname) einen Namen für diese Rolle ein (z. B. AWSCodeStarNotifications-Chatbot-Chime-Role).

13. Wählen Sie unter SNS topics (SNS-Themen) in SNS Region die AWS-Region aus, in der Sie das Benachrichtigungsregelziel erstellt haben. Wählen Sie unter SNS topics (SNS-Themen) den Namen des Amazon-SNS-Themas aus, das Sie als Benachrichtigungsregelziel konfiguriert haben.

14. Wählen Sie Konfigurieren aus.

15. (Optional) Um die Integration zu testen, nehmen Sie eine Änderung an der Ressource vor, die einem Ereignistyp für eine Benachrichtigungsregel entspricht, die für die Verwendung des Amazon-SNS-Themas als Ziel konfiguriert ist. Wenn Sie beispielsweise eine Benachrichtigungsregel so konfiguriert haben, dass Benachrichtigungen gesendet werden, wenn Kommentare zu einer Pull-Anforderung gemacht werden, kommentieren Sie eine Pull-Anforderung und beobachten Sie dann den Amazon-Chime-Chatroom, um zu sehen, wann die Benachrichtigung erscheint.