Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

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

# CodeCatalyst からの通知を送信する
<a name="notifications"></a>

CodeCatalyst でプロジェクトとリソースをモニタリングするための通知を設定できます。ユーザーは、メンバーである任意のプロジェクトで E メールを受け取るプロジェクトイベントを選択できます。CodeCatalyst スペースと Slack ワークスペース間のアクセスを設定し、その Slack ワークスペース内の 1 つまたは複数のチャンネルに送信するプロジェクトの通知を設定することで、Slack などのチームメッセージングアプリケーション内のチーム全体に送信する通知を設定することもできます。CodeCatalyst スペースと Slack ワークスペース間のアクセスを設定すると、プロジェクトメンバーは自分の Slack メンバー ID を追加して、接続された Slack ワークスペースとチャンネルで CodeCatalyst イベントについて直接通知を受けることもできます。

**注記**  
Slack に送信できるプロジェクトイベントのセットは、ユーザーが E メールで通知を受け取るように設定できるイベントセットと同じではありません。

**Topics**
+ [通知はどのような仕組みで機能しますか?](notifications-concepts.md)
+ [Slack 通知の使用開始](getting-started-notifications.md)
+ [CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)

# 通知はどのような仕組みで機能しますか?
<a name="notifications-concepts"></a>

Slack などのチームメッセージングアプリケーションに通知を送信するようにプロジェクトを設定することができます。



## 通知には必要なアクセス許可
<a name="notifications-concepts-permissions"></a>

CodeCatalyst では、プロジェクトメンバーなら誰でも、チャンネルの通知設定の編集、表示、更新、削除を行うことができます。ただし、Slack ワークスペースを追加または削除できるのは、**スペース管理者**ロールを持つユーザーのみです。どのユーザーでも、CodeCatalyst で自分が属するプロジェクトにおいて、どのプロジェクトイベントに関する E メールを受け取りたいかを設定できます。

## 通知を設定できる CodeCatalyst イベント
<a name="notifications-concepts-events"></a>

ワークフローイベントに関する通知を 1 つまたは複数の Slack チャンネルに配信するように CodeCatalyst を設定できます。CodeCatalyst プロジェクトと Slack の間で通知が設定されると、プロジェクトユーザーは自分の Slack メンバー ID を追加して、CodeCatalyst イベントに関するダイレクトメッセージを Slack チャンネルで受け取ることができます。ユーザーが Slack メンバー ID を追加すると、プロジェクト用に設定された Slack チャンネルで各自の ID が直接メンションされ、それぞれ関心のあるイベントに関する認識を高めることができます。

どのイベントについて E メールを受け取るかを選択することもできます。これらの E メールは、 AWS ビルダー ID 用に設定された E メールアドレスに送信されます。

## 通知の配信方法
<a name="notifications-concepts-delivery"></a>

1 つまたは複数の Slack チャンネルに通知を配信するように CodeCatalyst を設定できます。CodeCatalyst に Slack ワークスペースへのアクセス許可を付与するように認可する必要があります。認可されると、CodeCatalyst は設定された Slack チャンネルに通知を配信できます。プロジェクトメンバーが Slack メンバー ID を追加すると、そのプロジェクト用に設定された Slack チャンネルで CodeCatalyst イベントに関するメンションを受け取ることができます。

## 通知の設定方法
<a name="notifications-concepts-setup"></a>

E メール通知は CodeCatalyst の一部として設定されます。プロジェクトユーザーは、**[マイ設定]** ページで、どのイベントに関する E メールを受け取るかを選択できます。

プロジェクトリソースに対する Slack 通知を設定するには、次の大まかなタスクを完了する必要があります。

**通知を設定するには (概要レベルのタスク)**

1. CodeCatalyst では、CodeCatalyst と Slack などのメッセージングクライアント間の**接続を確立します**。Slack ワークスペースが接続されると、そのスペース内のすべてのプロジェクトで使用できるようになります。
**注記**  
スペース管理者ロールを持つユーザーのみが Slack ワークスペースを追加または削除できます。

1. CodeCatalyst のプロジェクトで、チームが通知を受け取る**チャンネルを追加します**。

1. CodeCatalyst で、ワークフローの実行失敗などのさまざまなイベントの**通知を有効にし**、送信するチャネルを指定します。

詳細なステップについては、「[Slack 通知の使用開始](getting-started-notifications.md)」を参照してください。

CodeCatalyst スペースと Slack の間で通知が設定されると、ユーザーは自分の Slack メンバー ID を追加して、各自のプロジェクト用に設定された Slack チャンネルで CodeCatalyst イベントに関するダイレクトメッセージを受け取ることができます。

# Slack 通知の使用開始
<a name="getting-started-notifications"></a>

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

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

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

**Topics**
+ [前提条件](#getting-started-notifications-prerequisites)
+ [ステップ 1: CodeCatalyst を Slack ワークスペースに接続する](#getting-started-notifications-connect-slack)
+ [ステップ 2: CodeCatalyst に Slack チャネルを追加する](#getting-started-notifications-add-slack-channel)
+ [ステップ 3: CodeCatalyst から Slack への通知をテストする](#getting-started-notifications-next-steps)
+ [ステップ 4: 次のステップ](#getting-started-notifications-test)

## 前提条件
<a name="getting-started-notifications-prerequisites"></a>

開始するには、以下が必要です。
+ CodeCatalyst スペース。CodeCatalyst スペースの作成と初めてサインインする場合の詳細については、「[CodeCatalyst をセットアップしてサインインするCodeCatalyst をセットアップしてサインインする](setting-up-topnode.md)」を参照してください。
+ CodeCatalyst プロジェクト。詳細については、「[プロジェクトの作成](projects-create.md)」を参照してください。
+ **[プロジェクト管理者]** または **[スペース管理者]** ロールを持つ CodeCatalyst アカウント。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。
+ CodeCatalyst がアクセスできる Slack アカウントと Slack ワークスペース。
+ CodeCatalyst が通知を送信する Slack チャネル。チャンネルは、パブリックでもプライベートでもかまいません。

## ステップ 1: CodeCatalyst を Slack ワークスペースに接続する
<a name="getting-started-notifications-connect-slack"></a>

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

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

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

**CodeCatalyst を Slack ワークスペースに接続するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

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

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

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

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

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

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

1. **Amazon Q Developer in chat applications** のメッセージに対して、次の操作を行います。

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

   1. [**許可**] を選択します。

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

1. 「[ステップ 2: CodeCatalyst に Slack チャネルを追加する](#getting-started-notifications-add-slack-channel)」に進みます。

## ステップ 2: CodeCatalyst に Slack チャネルを追加する
<a name="getting-started-notifications-add-slack-channel"></a>

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

**Slack チャンネル ID を取得するには**

1. Slack にサインインします。詳細については、「[Slack へのサインイン](https://slack.com/help/articles/212681477-Sign-in-to-Slack)」を参照してください。

1. 通知の送信先のチャネルを含む Slack ワークスペースに移動します。詳細については、「[Slack ワークスペースを切り替える](https://slack.com/help/articles/1500002200741-Switch-between-workspaces)」または「[追加の Slack ワークスペース にサインインする](https://slack.com/help/articles/212681477-Sign-in-to-Slack)」を参照してください。

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

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

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

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

**Slack チャンネルを CodeCatalyst に追加するには**

1. 開始する前に、Slack チャンネルがプライベートの場合は、次のように Amazon Q Developer in chat applications をチャンネルに追加します。

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

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

      Amazon Q Developer in chat applications がプライベートチャンネルにないことを示す Slackbot メッセージが表示されます。

   1. **[招待する]** を選択して、Amazon Q Developer in chat applications をチャンネルに招待します。

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

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

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

1. [**次へ**] を選択します。

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

1. [**Finish**] を選択してください。

## ステップ 3: CodeCatalyst から Slack への通知をテストする
<a name="getting-started-notifications-next-steps"></a>



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

**Slack で通知を表示するには**

1. CodeCatalyst プロジェクトで、ワークフローの実行を完了するために[ワークフローを手動で開始](workflows-manually-start.md)し、実行が完了するとステータス通知を受け取ります。

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

## ステップ 4: 次のステップ
<a name="getting-started-notifications-test"></a>

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

# CodeCatalyst からの Slack 通知および E メール通知を送信する
<a name="notifications-manage"></a>

CodeCatalyst を設定して、プロジェクトで発生したイベントに関する通知を送信できます。CodeCatalyst は、Slack チャンネルなどのメッセージングクライアントに通知を送信できます。CodeCatalyst が Slack チャンネルにメッセージを送信することで、チーム全体がワークフローの失敗などの重要なイベントを認識できるようになります。対応するダイレクトメッセージ (DM) を受信できるように、CodeCatalyst が送信する Slack メッセージで @mention を使って自分をメンションさせることもできます。

CodeCatalyst は、E メールで通知をユーザーに直接送信することもできます。E メール通知は、ユーザーがメンバーであるプロジェクト内のイベントについて送信されます。こうした E メールは、AWS ビルダー ID で設定された E メールアドレスに送信されます。

**注記**  
Slack チャンネルに送信できるイベントは、E メールで送信されるイベントとは異なる場合があります。

**Topics**
+ [E メール通知を設定する](notifications-personal.md)
+ [Slack チャンネルに通知を送信する](notifications-projects.md)
+ [Slack ダイレクトメッセージを設定する](notifications-personal-slack.md)
+ [通知チャネルの通知を編集する](notifications-edit.md)
+ [チャンネルを削除する](notifications-remove-channel.md)

# E メール通知を設定する
<a name="notifications-personal"></a>

メンバーであるプロジェクトのイベントに関する E メール通知を受け取るように設定できます。こうした E メールは、 AWS ビルダー ID で設定された E メールアドレスに送信されます。デフォルトでは、E メール通知の対象となるすべてのプロジェクトイベントに関する E メールが送信されます。<a name="notifications-personal-email"></a>

**プロジェクトイベントの E メール通知を設定するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。CodeCatalyst の **[マイ設定]** ページが開きます。
**ヒント**  
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。

1. **[E メール通知]** で、E メール通知を設定するリストでプロジェクトを検索し、**[編集]** を選択します。

1. E メールを受信するイベントを選択し、**[保存]** を選択します。

# Slack チャンネルに通知を送信する
<a name="notifications-projects"></a>

CodeCatalyst を設定して、プロジェクトのイベントに関する通知をチームの Slack チャンネルに送信できます。これにより、ワークフローの実行が失敗した場合など、チーム全体が重要なイベントを認識できるようになります。

**注記**  
プロジェクトのメンバーは誰でも、そのプロジェクトのチャンネルに送信される通知を管理できます。ただし、Slack ワークスペースを追加または削除できるのは、**スペース管理者**ロールを持つユーザーのみです。

通知を送信する Slack チャンネルを追加するには、次の手順を実行します。

**通知用の Slack チャンネルを追加するには**

1. 最初の Slack チャンネルを追加する場合は、代わりに「[Slack 通知の使用開始](getting-started-notifications.md)」を参照してください。

   最初のチャンネルを設定したら、この手順に戻って追加のチャンネルを設定してください。

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

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

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

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

1. **[チャンネルの追加]** を選択します。

1. **[workspace を選択]** を選択し、通知を送信するチャンネルを含む Slack ワークスペースを選択します。

   Slack ワークスペースがリストにない場合は、「[Slack 通知の使用開始](getting-started-notifications.md)」の指示に従って追加します。

1. **[チャネル ID]** を入力する前に、追加する Slack チャンネルがプライベートの場合は、次の手順を実行します。

   1. Slack チャンネルのメッセージボックスで、「**@aws**」と入力してポップアップから **[aws app]** を選択します。

   1. Enter キーを押します。

      Amazon Q Developer in chat applications がプライベートチャンネルにないことを示す Slackbot メッセージが表示されます。

   1. **[招待する]** を選択して、Amazon Q Developer in chat applications をチャンネルに招待します。

1. CodeCatalyst の **[チャネル ID]** フィールドに、Slack チャンネル ID を入力します。ID を検索するには、Slack に移動し、ナビゲーションペインでチャンネルを右クリックして、**[Open channel details]** を選択します。

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

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

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

1. **[Add]** (追加) を選択します。

# Slack ダイレクトメッセージを設定する
<a name="notifications-personal-slack"></a>

CodeCatalyst プロジェクトが [Slack チャンネルに通知を送信する](notifications-projects.md)ように設定されている場合、この通知はダイレクトメッセージ (DM) として送信することもできます。通知を DM として直接送信することで、ロールが割り当てられているプロジェクトで発生するイベントに対する認識を高めることができます。DM を有効にするには、Slack メンバー ID を CodeCatalyst に追加する必要があります。

**Slack ダイレクトメッセージを設定するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。CodeCatalyst の **[マイ設定]** ページが開きます。
**ヒント**  
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。

1. **[個人用 Slack 通知]** で、**[Slack ID の接続]** を選択し、**[Slack ワークスペースに接続]** を選択します。別のウィンドウが開きます。
**ヒント**  
このオプションは、**スペース管理者**ロールを持つユーザーが CodeCatalyst スペースに Slack ワークスペースを追加しない限り設定できません。詳細については、「[Slack 通知の使用開始](getting-started-notifications.md)」および「[Slack チャンネルに通知を送信する](notifications-projects.md)」を参照してください。

1. アクセス許可リクエストウィンドウで、ワークスペースの名前が CodeCatalyst スペース用に設定された Slack ワークスペースと一致することを確認します。**[許可]** を選択し、Amazon Q Developer in chat applications にワークスペースへのアクセスを許可します。ウィンドウが閉じ、Slack ワークスペースに **[Connection Status]** が **[Connected]** として表示されます。
**ヒント**  
接続ステータスが変更されない場合は、Slack ワークスペースの接続でエラーが発生していないかどうかを確認します。エラーを表示するには、上にスクロールする必要がある場合があります。

1. 個人用 Slack 通知の受信を停止するには、接続された Slack ワークスペースを選択し、**[Slack ID の切断]** を選択します。

# 通知チャネルの通知を編集する
<a name="notifications-edit"></a>

通知の送信先チャネルを変更したり、特定の通知を完全にオフにしたりできます。

**通知を編集するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

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

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

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

1. **[通知の編集]** を選択します。

1. 次のいずれかを行います:
   + 特定のチャンネルに通知を送信するには、ドロップダウンリストからチャンネルを選択します。
   + 通知をグローバルにオフにするには、通知の横にあるトグルを選択します。
   + 特定のチャンネルへの通知の送信を停止するには、チャンネルの **[X]** をクリックします。

1. **[保存]** を選択します。

# チャンネルを削除する
<a name="notifications-remove-channel"></a>

Amazon CodeCatalyst から Slack チャンネルを削除できます。Slack チャンネルを削除することで、選択した CodeCatalyst プロジェクトに関する通知はチャンネルに送信されなくなります。

**チャンネルを削除するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

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

1. **[プロジェクト設定]** ページで、**[通知]** タブを選択します。

1. 削除するチャンネルの横にあるインジケータを選択し、**[チャンネルの削除]** を選択します。確認ウィンドウで、**[OK]** をクリックします。