通知と AWS Chatbot との統合の設定 - デベロッパーツールコンソール
Slack チャンネルの AWS Chatbot クライアントの設定Microsoft Teams チャネルの AWS Chatbot クライアントの設定Slack または Amazon Chime のクライアントの手動設定

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

通知と AWS Chatbot との統合の設定

AWS Chatbot は、DevOps やソフトウェア開発チームが Amazon Chime チャットルーム、Slack チャンネル、Microsoft Team チャネルを使用し、AWS クラウド 内の運用イベントをモニタリングして対応できるようにする AWS のサービスです。通知ルールのターゲットと AWS Chatbot との統合を設定すると、選択した Amazon Chime ルーム、Slack チャンネル、または Microsoft Teams チャネルにイベントに関する通知を表示できます。詳細については、「AWS Chatbot ドキュメント」を参照してください。

AWS Chatbot との統合を設定する前に、通知ルールとルールのターゲットを設定する必要があります。詳細については、セットアップ および 通知ルールの作成 を参照してください。また、AWS Chatbot で Slack チャンネル、Microsoft Teams チャネル、または Amazon Chime チャットルームも設定する必要があります。詳細については、これらのサービスのドキュメントを参照してください。

Slack チャンネルの AWS Chatbot クライアントの設定

AWS Chatbot クライアントをターゲットとして使用する通知ルールを作成できます。Slack チャネルのクライアントを作成すると、このクライアントを通知ルールの作成ワークフローでターゲットとして直接使用できます。これは、Slack チャネルに表示される通知を設定する最も簡単な方法です。

ターゲットとして使用する AWS Chatbot クライアントを Slack で作成するには

  1. 「AWS Chatbot 管理者ガイド」の「AWS Chatbot を Slack で設定する」の手順に従ってください。この場合、通知との統合を最適化するために以下の選択肢を検討してください。

    • IAM ロールを作成するときに、このロールの目的を端的に示すロール名 (AWSCodeStarNotifications-Chatbot-Slack-Role など) を選択します。これにより、以後、ロールの使用目的がわかりやすくなります。

    • [SNS topics] では、トピックや AWS リージョンを選択する必要はありません。AWS Chatbot クライアントをターゲットとして選択すると、通知ルールの作成プロセスの一環として、すべての必要なアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアントとして作成および設定されます。

  2. クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「通知ルールの作成」を参照してください。

    注記

    Amazon SNS トピックの設定後は、そのトピックを AWS Chatbot クライアントから削除しないでください。削除すると、Slack に通知が送信されなくなります。

Microsoft Teams チャネルの AWS Chatbot クライアントの設定

AWS Chatbot クライアントをターゲットとして使用する通知ルールを作成できます。Microsoft Teams チャネルのクライアントを作成すると、このクライアントを通知ルールの作成ワークフローでターゲットとして直接使用できます。これは、Microsoft Teams チャネルに表示される通知を設定する最も簡単な方法です。

ターゲットとして使用する AWS Chatbot クライアントを Microsoft Teams で作成するには

  1. 「AWS Chatbot 管理者ガイド」の「AWS Chatbot を Microsoft Teams で設定する」の手順に従ってください。この場合、通知との統合を最適化するために以下の選択肢を検討してください。

    • IAM ロールを作成するときに、このロールの目的を端的に示すロール名 (AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role など) を選択します。これにより、以後、ロールの使用目的がわかりやすくなります。

    • [SNS topics] では、トピックや AWS リージョンを選択する必要はありません。AWS Chatbot クライアントをターゲットとして選択すると、通知ルールの作成プロセスの一環として、すべての必要なアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアントとして作成および設定されます。

  2. クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「通知ルールの作成」を参照してください。

    注記

    Amazon SNS トピックの設定後は、そのトピックを AWS Chatbot クライアントから削除しないでください。削除すると、Microsoft Teams に通知が送信されなくなります。

Slack または Amazon Chime のクライアントの手動設定

Slack や Amazon Chime と通知との統合を直接作成することを選択できます。これは、Amazon Chime チャットルームへの通知を設定するための唯一の方法です。この統合を手動で設定する場合は、通知ルールのターゲットとして以前に設定したAmazon SNS トピックを使用する AWS Chatbot クライアントを作成します。

通知と AWS Chatbot や Slack とを手動で統合するには

  1. AWS デベロッパーツールコンソールは、次の URL で開きます。https://console.aws.amazon.com/codesuite/settings/notifications

  2. [Settings (設定)]、[Notification rules (通知ルール)] の順に選択します。

  3. [通知ルールのターゲット] で、ターゲットを検索してコピーします。

    注記

    そのターゲットと同じ Amazon SNS トピックを使用する通知ルールを複数設定できます。これはメッセージングを統合するのに役立ちますが、サブスクリプションリストが 1 つの通知ルールまたはリソースを対象としている場合、意図しない結果が生じることがあります。

  4. AWS Chatbot コンソールは、次の URL で開きます。https://console.aws.amazon.com/opsworks/

  5. [Configure new client]、[Slack] の順に選択します。

  6. [Configure] (設定) を選択します。

  7. Slack ワークスペースにサインインします。

  8. 選択内容を確認するメッセージが表示されたら、[Allow (許可)] を選択します。

  9. [Configure new channel] を選択します。

  10. [Configuration details] で、[Configuration name] にクライアント名を入力します。これは、通知ルールの作成時に AWS Chatbot (Slack) ターゲットタイプの使用可能なターゲットのリストに表示される名前です。

  11. [Configure Slack Channel] (Slack チャネルの設定) の [Channel type] (チャネルタイプ) で、統合するチャネルのタイプに応じて [Public] (パブリック) または [Private] (プライベート) を選択します。

    • [Public channel (パブリックチャネル)] で、Slack チャネルの名前をリストから選択します。

    • [Private channel ID (プライベートチャネル ID)] に、チャネルコードまたは URL を入力します。

  12. [IAM permissions] (IAM アクセス許可) の [Role] (ロール) で、[Create an IAM role using a template] (テンプレートを使用して IAM ロールを作成する) を選択します。[ポリシーテンプレート] で、[通知のアクセス許可] を選択します。[ロール名] に、このロールの名前（AWSCodeStarNotifications-Chatbot-Slack-Role など）を入力します。[ポリシーテンプレート] で、[通知のアクセス許可] を選択します。

  13. [SNS topics] (SNS トピック) の [SNS Region] (SNS リージョン) で、通知ルールのターゲットを作成した AWS リージョン を選択します。[SNS topics] で、通知ルールのターゲットとして設定した Amazon SNS トピックの名前を選択します。

    注記

    このステップは、このクライアントをターゲットとして使用する通知ルールを作成する場合は必要ありません。

  14. [Configure] (設定) を選択します。

    注記

    プライベートチャンネルとの統合を設定した場合、そのチャンネルに通知が表示されるには AWS Chatbot をチャンネルに招待する必要があります。詳細については、「AWS Chatbot ドキュメント」を参照してください。

  15. (オプション) 統合をテストするには、ターゲットとして Amazon SNS トピックを使用するように設定された通知ルールのイベントタイプに対応するリソースを変更します。例えば、プルリクエストに対してコメントが作成されたときに通知を送信するように設定された通知ルールがある場合は、プルリクエストにコメントし、ブラウザで Slack チャネルを監視して、通知がいつ表示されるかを確認します。

通知を AWS Chatbot および Amazon Chime と統合するには

  1. AWS デベロッパーツールコンソールは、次の URL で開きます。https://console.aws.amazon.com/codesuite/settings/notifications

  2. [Settings (設定)]、[Notification rules (通知ルール)] の順に選択します。

  3. [通知ルールのターゲット] で、ターゲットを検索してコピーします。

    注記

    そのターゲットと同じ Amazon SNS トピックを使用する通知ルールを複数設定できます。これはメッセージングを統合するのに役立ちますが、サブスクリプションリストが 1 つの通知ルールまたはリソース用である場合、意図しない結果が生じることがあります。

  4. Amazon Chime で、統合用に設定するチャットルームを開きます。

  5. 右上の歯車アイコンを選択して、[Manage webhooks] を選択します。

  6. [Manage webhooks (ウェブフックの管理)] ダイアログボックスで [新規] を選択し、ウェブフックの名前を入力して [作成] を選択します。

  7. Webhook が表示されることを確認し、[Copy webhook URL (Webhook URL のコピー)] を選択します。

  8. AWS Chatbot コンソールは、次の URL で開きます。https://console.aws.amazon.com/opsworks/

  9. [Configure new client] (新しいクライアントを設定) 、[Amazon Chime] の順に選択します。

  10. [Configuration details] で、[Configuration name] にクライアント名を入力します。

  11. [Webhook URL] で、URL を貼り付けます。[Webhook description (Webhook の説明)] に、オプションの説明を入力します。

  12. [IAM permissions] (IAM アクセス許可) の [Role] (ロール) で、[Create an IAM role using a template] (テンプレートを使用して IAM ロールを作成する) を選択します。[ポリシーテンプレート] で、[通知のアクセス許可] を選択します。[ロール名] に、このロールの名前（AWSCodeStarNotifications-Chatbot-Chime-Role など）を入力します。

  13. [SNS topics] (SNS トピック) の [SNS Region] (SNS リージョン) で、通知ルールのターゲットを作成した AWS リージョン を選択します。[SNS topics (SNS トピック)] で、通知ルールのターゲットとして設定した Amazon SNS トピックの名前を選択します。

  14. [Configure] (設定) を選択します。

  15. (オプション) 統合をテストするには、ターゲットとして Amazon SNS トピックを使用するように設定された通知ルールのイベントタイプに対応するリソースを変更します。例えば、プルリクエストに対してコメントが作成されたときに通知を送信するように設定された通知ルールがある場合は、プルリクエストにコメントし、Amazon Chime チャットルームを監視して通知がいつ表示されるかを確認します。