翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 通知の使用開始
通知の使用を開始する最も簡単な方法は、ビルドプロジェクト、デプロイアプリケーション、パイプライン、またはリポジトリのいずれかに通知ルールを設定することです。
**注記**
通知ルールを初めて作成すると、サービスにリンクされたロールがアカウントに作成されます。詳細については、「[AWS CodeStar Notifications のサービスにリンクされたロールの使用](using-service-linked-roles.md)」を参照してください。
**Topics**
+ [前提条件](#getting-started-prerequisites)
+ [リポジトリの通知ルールを作成する](getting-started-repository.md)
+ [ビルドプロジェクトの通知ルールを作成する](getting-started-build.md)
+ [デプロイアプリケーションの通知ルールを作成する](getting-started-deploy.md)
+ [パイプラインの通知ルールを作成する](getting-started-pipeline.md)
## 前提条件
「[セットアップ](setting-up.md)」のステップを完了します。通知ルールを作成するリソースも必要です。
+ [CodeBuild でビルドプロジェクトを作成](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html)するか、既存のプロジェクトを使用します。
+ [アプリケーションを作成](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html)するか、既存のデプロイアプリケーションを使用します。
+ [CodePipeline でパイプラインを作成](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)するか、既存のパイプラインを使用します。
+ [AWS CodeCommit リポジトリを作成する](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html)か、既存のリポジトリを使用します。
# リポジトリの通知ルールを作成する
通知ルールを作成して、重要なリポジトリイベントに関する通知を送信できます。以下のステップは、単一のリポジトリイベントに関する通知ルールを設定する方法を示しています。これらのステップは、 AWS アカウントにリポジトリが設定されていることを前提としています。
**重要**
2019 年 11 月 5 日より前に CodeCommit で通知を設定した場合、それらの通知に使用される Amazon SNS トピックには、CodeStar Notifications に必要な AWS CodeStar CodeCommit への発行を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既存のポリシーに加えて、 AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用に Amazon SNS トピックを設定する](set-up-sns.md)」および「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/) で CodeCommit コンソールを開きます。
1. リストからリポジトリを選択して開きます。
1. [**Notify (通知)**]、[**Create notification rule (通知ルールの作成)**] の順に選択します。[**設定**]、[**通知**]、[**通知ルールの作成**] の順に選択することもできます。
1. [**通知名**] に、ルールの名前を入力します。
1. Amazon EventBridge に提供された情報のみを通知に含める場合は、**[Detail type (詳細タイプ)]** で **[Basic (基本)]** を選択します。Amazon EventBridge に提供される情報に加えて、リソースサービスまたは通知マネージャから提供される場合がある情報も含める場合は、**[Full]** (完全) を選択します。
詳細については、「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**Events that trigger notifications (通知をトリガーするイベント)**] の [**ブランチとタグ**] で、[**作成済み**] を選択します。
1. [**ターゲット**] で、[**SNS トピックの作成**] を選択します。
**注記**
通知ルールの作成の一環としてトピックを作成すると、CodeCommit にトピックへのイベントの発行を許可するポリシーが適用されます。通知ルール用に作成されたトピックを使用すると、このリポジトリに関する通知の受信を希望するユーザーのみをサブスクライブできます。
[**codestar-notifications-**] プレフィックスの後にトピックの名前を入力し、[**送信**] を選択します。
**注記**
新しいトピックを作成する代わりに既存の Amazon SNS トピックを使用する場合は、[**Targets (ターゲット)**] でその ARN を選択します。トピックに適切なアクセスポリシーがあり、リソースに関する情報を表示できるユーザーのみがサブスクライバーリストに含まれていることを確認します。Amazon SNS トピックが 2019 年 11 月 5 日より前に CodeCommit 通知に使用されたトピックである場合、CodeStar Notifications に必要な AWS CodeStar CodeCommit への発行を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既存のポリシーに加えて、 AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用に Amazon SNS トピックを設定する](set-up-sns.md)」および「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**送信**] を選択し、通知ルールを確認します。
1. 自分のメールアドレスを作成した Amazon SNS トピックにサブスクライブします。詳細については、「[通知に使用する Amazon SNS トピックにユーザーをサブスクライブするには](subscribe-users-sns.md#set-up-sns-subscribe)」を参照してください。
1. リポジトリに移動し、デフォルトブランチからテストブランチを作成します。
1. ブランチを作成すると、通知ルールによって、そのイベントに関する情報を含む通知がすべてのトピックサブスクライバーに送信されます。
# ビルドプロジェクトの通知ルールを作成する
通知ルールを作成して、ビルドプロジェクトでの重要なイベントに関する通知を送信できます。以下のステップは、単一のビルドプロジェクトイベントに関する通知ルールを設定する方法を示しています。これらのステップは、 AWS アカウントでビルドプロジェクトが設定されていることを前提としています。
1. CodeBuild コンソール ([https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)) を開きます。
1. リストからビルドプロジェクトを選択して開きます。
1. [**Notify (通知)**]、[**Create notification rule (通知ルールの作成)**] の順に選択します。[**設定**]、[**通知ルールの作成**] の順に選択することもできます。
1. [**通知名**] に、ルールの名前を入力します。
1.
Amazon EventBridge に提供された情報のみを通知に含める場合は、**[Detail type (詳細タイプ)]** で **[Basic (基本)]** を選択します。Amazon EventBridge に提供される情報に加えて、リソースサービスまたは通知マネージャから提供される場合がある情報も含める場合は、**[Full]** (完全) を選択します。
詳細については、「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**Events that trigger notifications (通知をトリガーするイベント)**] の [**ビルドフェーズ**] で、[**成功**] を選択します。
1. [**ターゲット**] で、[**SNS トピックの作成**] を選択します。
**注記**
通知ルールの作成の一環としてトピックを作成すると、CodeBuild にトピックへのイベントの発行を許可するポリシーが適用されます。通知ルール用に作成されたトピックを使用すると、このビルドプロジェクトに関する通知の受信を希望するユーザーのみをサブスクライブできます。
[**codestar-notifications-**] プレフィックスの後にトピックの名前を入力し、[**送信**] を選択します。
**注記**
新しいトピックを作成する代わりに既存の Amazon SNS トピックを使用する場合は、[**Targets (ターゲット)**] でその ARN を選択します。トピックに適切なアクセスポリシーがあり、リソースに関する情報を表示できるユーザーのみがサブスクライバーリストに含まれていることを確認します。Amazon SNS トピックが 2019 年 11 月 5 日より前に CodeCommit 通知に使用されたトピックである場合、CodeStar Notifications に必要な AWS CodeStar CodeCommit への発行を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既存のポリシーに加えて、 AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用に Amazon SNS トピックを設定する](set-up-sns.md)」および「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**送信**] を選択し、通知ルールを確認します。
1. 自分のメールアドレスを作成した Amazon SNS トピックにサブスクライブします。詳細については、「[通知に使用する Amazon SNS トピックにユーザーをサブスクライブするには](subscribe-users-sns.md#set-up-sns-subscribe)」を参照してください。
1. ビルドプロジェクトに移動し、ビルドを開始します。
1. ビルドフェーズが正常に完了すると、通知ルールは、そのイベントに関する情報を含む通知をすべてのトピックサブスクライバーに送信します。
# デプロイアプリケーションの通知ルールを作成する
通知ルールを作成して、デプロイアプリケーションでの重要なイベントに関する通知を送信できます。以下のステップは、単一のビルドプロジェクトイベントに関する通知ルールを設定する方法を示しています。これらの手順は、 AWS アカウントにデプロイアプリケーションが設定されていることを前提としています。
1. CodeDeploy コンソールは次の URL で開きます。[https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/)
1. リストからアプリケーションを選択して開きます。
1. [**Notify (通知)**]、[**Create notification rule (通知ルールの作成)**] の順に選択します。[**設定**]、[**通知ルールの作成**] の順に選択することもできます。
1. [**通知名**] に、ルールの名前を入力します。
1. Amazon EventBridge に提供された情報のみを通知に含める場合は、**[Detail type (詳細タイプ)]** で **[Basic (基本)]** を選択します。Amazon EventBridge に提供される情報に加えて、リソースサービスまたは通知マネージャから提供される場合がある情報も含める場合は、**[Full]** (完全) を選択します。
詳細については、「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**Events that trigger notifications (通知をトリガーするイベント)**] の [**デプロイ**] で、[**成功**] を選択します。
1. [**ターゲット**] で、[**SNS トピックの作成**] を選択します。
**注記**
通知ルールの作成の一環としてトピックを作成すると、CodeDeploy にトピックへのイベントの発行を許可するポリシーが適用されます。通知ルール用に作成されたトピックを使用すると、このデプロイアプリケーションに関する通知の受信を希望するユーザーのみをサブスクライブできます。
[**codestar-notifications-**] プレフィックスの後にトピックの名前を入力し、[**送信**] を選択します。
**注記**
新しいトピックを作成する代わりに既存の Amazon SNS トピックを使用する場合は、[**Targets (ターゲット)**] でその ARN を選択します。トピックに適切なアクセスポリシーがあり、リソースに関する情報を表示できるユーザーのみがサブスクライバーリストに含まれていることを確認します。Amazon SNS トピックが 2019 年 11 月 5 日より前に CodeCommit 通知に使用されたトピックである場合、CodeStar Notifications に必要な AWS CodeStar CodeCommit への発行を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既存のポリシーに加えて、 AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用に Amazon SNS トピックを設定する](set-up-sns.md)」および「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**送信**] を選択し、通知ルールを確認します。
1. 自分のメールアドレスを作成した Amazon SNS トピックにサブスクライブします。詳細については、「[通知に使用する Amazon SNS トピックにユーザーをサブスクライブするには](subscribe-users-sns.md#set-up-sns-subscribe)」を参照してください。
1. デプロイアプリケーションに移動し、デプロイを開始します。
1. デプロイが成功すると、通知ルールによって、そのイベントに関する情報を含む通知がすべてのトピックサブスクライバーに送信されます。
# パイプラインの通知ルールを作成する
通知ルールを作成して、パイプラインの重要なイベントに関する通知を送信できます。以下のステップは、単一のパイプラインイベントに関する通知ルールを設定する方法を示しています。これらのステップは、 AWS アカウントにパイプラインが設定されていることを前提としています。
1. CodePipeline コンソールは次の URL で開きます。[https://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codepipeline/)
1. リストからパイプラインを選択して開きます。
1. [**Notify (通知)**]、[**Create notification rule (通知ルールの作成)**] の順に選択します。[**設定**]、[**通知ルールの作成**] の順に選択することもできます。
1. [**通知名**] に、ルールの名前を入力します。
1. Amazon EventBridge に提供された情報のみを通知に含める場合は、**[Detail type (詳細タイプ)]** で **[Basic (基本)]** を選択します。Amazon EventBridge に提供される情報に加えて、リソースサービスまたは通知マネージャから提供される場合がある情報も含める場合は、**[Full]** (完全) を選択します。
詳細については、「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**Events that trigger notifications (通知をトリガーするイベント)**] の [**アクションの実行**] で、[**開始済**] を選択します。
1. [**ターゲット**] で、[**SNS トピックの作成**] を選択します。
**注記**
通知ルールの作成の一環としてトピックを作成すると、CodePipeline にトピックへのイベントの発行を許可するポリシーが適用されます。通知ルール用に作成されたトピックを使用すると、このパイプラインに関する通知の受信を希望するユーザーのみをサブスクライブできます。
[**codestar-notifications-**] プレフィックスの後にトピックの名前を入力し、[**送信**] を選択します。
**注記**
新しいトピックを作成する代わりに既存の Amazon SNS トピックを使用する場合は、[**Targets (ターゲット)**] でその ARN を選択します。トピックに適切なアクセスポリシーがあり、リソースに関する情報を表示できるユーザーのみがサブスクライバーリストに含まれていることを確認します。Amazon SNS トピックが 2019 年 11 月 5 日より前に CodeCommit 通知に使用されたトピックである場合、CodeStar Notifications に必要な AWS CodeStar CodeCommit への発行を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既存のポリシーに加えて、 AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用に Amazon SNS トピックを設定する](set-up-sns.md)」および「[通知の内容とセキュリティについて](security.md#security-notifications)」を参照してください。
1. [**送信**] を選択し、通知ルールを確認します。
1. 自分のメールアドレスを作成した Amazon SNS トピックにサブスクライブします。詳細については、「[通知に使用する Amazon SNS トピックにユーザーをサブスクライブするには](subscribe-users-sns.md#set-up-sns-subscribe)」を参照してください。
1. パイプラインに移動し、[**Release change (変更のリリース)**] を選択します。
1. アクションが開始されると、通知ルールによって、そのイベントに関する情報を含む通知がすべてのトピックサブスクライバーに送信されます。