Slack 通知の使用開始 - Amazon CodeCatalyst

Slack 通知の使用開始

プロジェクトを作成したら、チームがプロジェクトリソースをモニタリングするのに役立つ Slack 通知を設定できます。

これらのステップでは、CodeCatalyst で初めて Slack 通知を設定する方法について説明します。通知を既に設定している場合は、「CodeCatalyst からの Slack 通知および E メール通知を送信する」を参照してください。

注記

通知チャネルに送信できるプロジェクトイベントのセットは、ユーザーが E メールで通知することを選択できるイベントセットと同じではありません。詳細については、「CodeCatalyst からの Slack 通知および E メール通知を送信する」を参照してください。

前提条件

開始するには、以下が必要です。

  • CodeCatalyst スペース。CodeCatalyst スペースの作成と初めてサインインする場合の詳細については、「CodeCatalyst をセットアップしてサインインする」を参照してください。

  • CodeCatalyst プロジェクト。詳細については、「「プロジェクトの作成」」を参照してください。

  • [プロジェクト管理者] または [スペース管理者] ロールを持つ CodeCatalyst アカウント。詳細については、「ユーザーロールによってアクセス権を付与する」を参照してください。

  • CodeCatalyst がアクセスできる Slack アカウントと Slack ワークスペース。

  • CodeCatalyst が通知を送信する Slack チャネル。チャンネルは、パブリックでもプライベートでもかまいません。

ステップ 1: CodeCatalyst を Slack ワークスペースに接続する

[スペース管理者] ロールを持つユーザーのみが Slack ワークスペースを追加または削除できます。Slack ワークスペースを追加または削除すると、スペース内のすべてのプロジェクトに影響します。CodeCatalyst と Slack 間の接続を確立するために、CodeCatalyst は Slack ワークスペースで安全な OAuth 認証ハンドシェイクを実行します。

CodeCatalyst を Slack ワークスペースに接続するには、以下の手順に従います。

注記

これは、Slack ワークスペースごとに 1 回だけ実行する必要があります。その後、Slack チャネルで通知を設定できます。

CodeCatalyst を Slack ワークスペースに接続するには
  1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

  2. プロジェクトに移動します。

  3. ナビゲーションペインで、[プロジェクト設定] を選択します。

  4. [通知] タブを選択します。

  5. [通知の設定] を選択します。

  6. [Slack ワークスペースに接続] を選択します。

  7. ダイアログボックスの内容を読み、[Slack ワークスペースに接続] を選択します。

  8. [AWS Chatbot] メッセージ:

    1. 右上で、チャンネルを含む Slack ワークスペースを選択します。

    2. [Allow] (許可) を選択します。

    CodeCatalyst コンソールに戻ります。

  9. ステップ 2: CodeCatalyst に Slack チャネルを追加する」に進みます。

ステップ 2: CodeCatalyst に Slack チャネルを追加する

CodeCatalyst にチャンネルを追加するには、Slack チャンネル ID が必要です。

Slack チャンネル ID を取得するには
  1. Slack にサインインします。詳細については、「Slack へのサインイン」を参照してください。

  2. 通知の送信先のチャネルを含む Slack ワークスペースに移動します。詳細については、「Slack ワークスペースを切り替える」または「追加の Slack ワークスペース にサインインする」を参照してください。

  3. ナビゲーションペインで、通知を行うチャンネルのコンテキスト (右クリック) メニューを開き、[チャンネルの詳細を開く] を選択します。

    チャンネル ID はダイアログボックスの下部に表示されます。

  4. [チャンネル ID] の値をコピーします。これは次のステップで必要になります。

コピーしたチャンネル ID を使用して、Slack チャンネルを CodeCatalyst に接続できるようになりました。

Slack チャンネルを CodeCatalyst に追加するには
  1. 開始する前に、Slack チャンネルがプライベートの場合は、次のように AWS Chatbot アプリをチャンネルに追加します。

    1. Slack チャンネルのメッセージボックスに、 ダイアログボックスに「@aws」を入力し、[aws アプリ]を選択します。

    2. [Enter] キーを押します。

      Slackbot メッセージが表示され、プライベートチャンネルにないことを示す AWS Chatbot が表示されます。

    3. AWS Chatbot をチャンネルに招待するには、[Invite Them] を選択します。

  2. CodeCatalyst コンソールで、[次へ] を選択します。

  3. [チャンネル ID] で、前に取得した Slack チャンネル ID を貼り付けます。

  4. [チャンネル名] に名前を入力します。Slack チャンネル名を使用することをお勧めします。

  5. [Next] を選択します。

  6. [通知イベントを選択] で、通知を受け取るイベントを選択します。

  7. [Finish] を選択します。

ステップ 3: CodeCatalyst から Slack への通知をテストする

ワークフローステータスの通知を送信するようにプロジェクトを設定したら、Slack で通知を表示できます。

Slack で通知を表示するには
  1. CodeCatalyst プロジェクトで、ワークフローの実行を完了するためにワークフローを手動で開始し、実行が完了するとステータス通知を受け取ります。

  2. Slack で、通知用に設定したチャンネルを表示します。通知には、各ワークフロー実行の最新ステータスと、失敗したか成功したかが表示されます。

ステップ 4: 次のステップ

CodeCatalyst スペースに Slack ワークスペースを設定したら、既存の CodeCatalyst プロジェクトを Slack チャネルに追加し、作成後に新しいプロジェクトに追加できます。また、プロジェクトユーザーに Slack メンバー ID の個人用 Slack 通知を設定し、E メールを受信するイベントを設定できることを知らせることもできます。詳細については、「CodeCatalyst からの Slack 通知および E メール通知を送信する」を参照してください。