本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

開始使用通知的最簡單方法是在其中一個建置專案、部署應用程式、管道或儲存庫上設定通知規則。

**注意**  
第一次建立通知規則時，系統會在您的帳戶中建立服務連結角色。如需詳細資訊，請參閱[使用 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)

## 先決條件
<a name="getting-started-prerequisites"></a>

完成「[設定](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)或使用現有的儲存庫。

# 建立儲存庫的通知規則
<a name="getting-started-repository"></a>

您可以建立通知規則，以傳送對您而言很重要的儲存庫事件的相關通知。下列步驟說明如何在單一儲存庫事件上設定通知規則。這些步驟的撰寫假設您的帳戶中已設定儲存庫 AWS 。

**重要**  
如果您在 2019 年 11 月 5 日之前在 CodeCommit 中設定通知，則用於這些通知的 Amazon SNS 主題將包含允許 CodeCommit 發佈至它的政策，其中包含與 AWS CodeStar Notifications 所需的許可不同的許可。不建議使用這些主題。如果您想要使用針對該體驗建立的政策，除了已存在的政策之外，還必須新增 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 (建立通知規則)**。您也可以選擇 **Settings (設定)**、選擇 **Notifications (通知)**，然後選擇 **Create notification rule (建立通知規則)**。

1. 在 **Notification name (通知名稱)** 中，輸入規則的名稱。

1. 如果您只希望提供給 Amazon EventBridge 的資訊包含在通知中，請在 **Detail type (詳細資訊類型)** 中，選擇 **Basic (基本)**。如果您想包含提供給 Amazon EventBridge 的資訊，以及可能由資源服務或通知管理工具提供的資訊，請選擇 **Full (完整)**。

   如需詳細資訊，請參閱[了解通知內容和安全性](security.md#security-notifications)。

1. 在 **Events that trigger notifications (觸發通知的事件)** 的 **Branches and tags (分支和標籤)** 下，選取 **Created (已建立)**。

1. 在 **Targets (目標)** 中，選擇 **Create SNS topic (建立 SNS 主題)**。
**注意**  
您在建立通知規則的過程中建立主題時，系統會為您套用允許 CodeCommit 將事件發佈至主題的政策。使用針對通知規則建立的主題，有助於確保您只訂閱需要接收此儲存庫相關通知的使用者。

   在 **codestar-notifications-** 字首之後，輸入主題的名稱，然後選擇 **Submit (提交)**。
**注意**  
如果您要使用現有 Amazon SNS 主題而非建立新主題，請在 **Targets (目標)** 中選擇其 ARN。請確定主題具有適當的存取政策，而且訂閱者清單只包含允許查看資源相關資訊的使用者。如果 Amazon SNS 主題是在 2019 年 11 月 5 日之前用於 CodeCommit 通知的主題，它將包含允許 CodeCommit 發佈至它的政策，其中包含與 AWS CodeStar Notifications 所需的許可不同的許可。不建議使用這些主題。如果您想要使用針對該體驗建立的政策，除了已存在的政策之外，還必須新增 AWS CodeStar Notifications 所需的政策。如需詳細資訊，請參閱[設定通知的 Amazon SNS 主題](set-up-sns.md)及[了解通知內容和安全性](security.md#security-notifications)。

1. 選擇 **Submit (提交)**，然後檢閱通知規則。

1. 以您的電子郵件地址訂閱您剛建立的 Amazon SNS 主題。如需詳細資訊，請參閱[讓使用者訂閱用於通知的 Amazon SNS 主題](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 前往您的儲存庫，並從預設分支建立測試分支。

1. 建立分支後，通知規則會傳送通知給所有主題訂閱者，其中包含該事件的相關資訊。

# 建立建置專案的通知規則
<a name="getting-started-build"></a>

您可以建立通知規則，以傳送組建專案上對您而言很重要的事件的相關通知。下列步驟說明如何在單一組建專案事件上設定通知規則。這些步驟的撰寫假設您的帳戶中已設定建置專案 AWS 。

1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

1. 從清單中選擇組建專案並開啟它。

1. 選擇 **Notify (通知)**，然後選擇 **Create notification rule (建立通知規則)**。您也可以選擇 **Settings (設定)**，然後選擇 **Create notification rule (建立通知規則)**。

1. 在 **Notification name (通知名稱)** 中，輸入規則的名稱。

1. 

   如果您只希望提供給 Amazon EventBridge 的資訊包含在通知中，請在 **Detail type (詳細資訊類型)** 中，選擇 **Basic (基本)**。如果您想包含提供給 Amazon EventBridge 的資訊，以及可能由資源服務或通知管理工具提供的資訊，請選擇 **Full (完整)**。

   如需詳細資訊，請參閱[了解通知內容和安全性](security.md#security-notifications)。

1.  在 **Events that trigger notifications (觸發通知的事件)** 的 **Build phase (組建階段)** 下，選取 **Success (成功)**。

1. 在 **Targets (目標)** 中，選擇 **Create SNS topic (建立 SNS 主題)**。
**注意**  
您在建立通知規則的過程中建立主題時，系統會為您套用允許 CodeBuild 將事件發佈至主題的政策。使用針對通知規則建立的主題，有助於確保您只訂閱需要接收此組建專案相關通知的使用者。

   在 **codestar-notifications-** 字首之後，輸入主題的名稱，然後選擇 **Submit (提交)**。
**注意**  
如果您要使用現有 Amazon SNS 主題而非建立新主題，請在 **Targets (目標)** 中選擇其 ARN。請確定主題具有適當的存取政策，而且訂閱者清單只包含允許查看資源相關資訊的使用者。如果 Amazon SNS 主題是在 2019 年 11 月 5 日之前用於 CodeCommit 通知的主題，它將包含允許 CodeCommit 發佈至它的政策，其中包含與 AWS CodeStar Notifications 所需的許可不同的許可。不建議使用這些主題。如果您想要使用針對該體驗建立的政策，除了已存在的政策之外，還必須新增 AWS CodeStar Notifications 所需的政策。如需詳細資訊，請參閱[設定通知的 Amazon SNS 主題](set-up-sns.md)及[了解通知內容和安全性](security.md#security-notifications)。

1. 選擇 **Submit (提交)**，然後檢閱通知規則。

1. 以您的電子郵件地址訂閱您剛建立的 Amazon SNS 主題。如需詳細資訊，請參閱[讓使用者訂閱用於通知的 Amazon SNS 主題](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 導覽至您的組建專案並啟動組建。

1. 成功完成組建階段之後，通知規則會傳送通知給所有主題訂閱者，其中包含該事件的相關資訊。

# 建立部署應用程式的通知規則
<a name="getting-started-deploy"></a>

您可以建立通知規則，以傳送部署應用程式上對您而言很重要的事件的相關通知。下列步驟說明如何在單一組建專案事件上設定通知規則。這些步驟假設您已在 AWS 帳戶中設定部署應用程式。

1. 前往 [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/) 開啟 CodeDeploy 主控台。

1. 從清單中選擇應用程式並開啟它。

1. 選擇 **Notify (通知)**，然後選擇 **Create notification rule (建立通知規則)**。您也可以選擇 **Settings (設定)**，然後選擇 **Create notification rule (建立通知規則)**。

1. 在 **Notification name (通知名稱)** 中，輸入規則的名稱。

1. 如果您只希望提供給 Amazon EventBridge 的資訊包含在通知中，請在 **Detail type (詳細資訊類型)** 中，選擇 **Basic (基本)**。如果您想包含提供給 Amazon EventBridge 的資訊，以及可能由資源服務或通知管理工具提供的資訊，請選擇 **Full (完整)**。

   如需詳細資訊，請參閱[了解通知內容和安全性](security.md#security-notifications)。

   

1.  在 **Events that trigger notifications (觸發通知的事件)** 的 **Deployment (部署)** 下，選取 **Succeeded (成功)**。

1. 在 **Targets (目標)** 中，選擇 **Create SNS topic (建立 SNS 主題)**。
**注意**  
您在建立通知規則的過程中建立主題時，系統會為您套用允許 CodeDeploy 將事件發佈至主題的政策。使用針對通知規則建立的主題，有助於確保您只訂閱需要接收此部署應用程式相關通知的使用者。

   在 **codestar-notifications-** 字首之後，輸入主題的名稱，然後選擇 **Submit (提交)**。
**注意**  
如果您要使用現有 Amazon SNS 主題而非建立新主題，請在 **Targets (目標)** 中選擇其 ARN。請確定主題具有適當的存取政策，而且訂閱者清單只包含允許查看資源相關資訊的使用者。如果 Amazon SNS 主題是在 2019 年 11 月 5 日之前用於 CodeCommit 通知的主題，它將包含允許 CodeCommit 發佈至它的政策，其中包含與 AWS CodeStar Notifications 所需的許可不同的許可。不建議使用這些主題。如果您想要使用針對該體驗建立的政策，除了已存在的政策之外，還必須新增 AWS CodeStar Notifications 所需的政策。如需詳細資訊，請參閱[設定通知的 Amazon SNS 主題](set-up-sns.md)及[了解通知內容和安全性](security.md#security-notifications)。

1. 選擇 **Submit (提交)**，然後檢閱通知規則。

1. 以您的電子郵件地址訂閱您剛建立的 Amazon SNS 主題。如需詳細資訊，請參閱[讓使用者訂閱用於通知的 Amazon SNS 主題](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 前往您的部署應用程式並開始部署。

1. 部署成功之後，通知規則會傳送通知給所有主題訂閱者，其中包含該事件的相關資訊。

# 建立管道的通知規則
<a name="getting-started-pipeline"></a>

您可以建立通知規則，以傳送您管道上對您至關重要的事件通知。下列步驟說明如何在單一管道事件上設定通知規則。這些步驟的撰寫假設您的帳戶中已設定管道 AWS 。

1. 前往 [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/) 開啟 CodePipeline 主控台。

1. 從清單中選擇管道並開啟它。

1. 選擇 **Notify (通知)**，然後選擇 **Create notification rule (建立通知規則)**。您也可以選擇 **Settings (設定)**，然後選擇 **Create notification rule (建立通知規則)**。

1. 在 **Notification name (通知名稱)** 中，輸入規則的名稱。

1. 如果您只希望提供給 Amazon EventBridge 的資訊包含在通知中，請在 **Detail type (詳細資訊類型)** 中，選擇 **Basic (基本)**。如果您想包含提供給 Amazon EventBridge 的資訊，以及可能由資源服務或通知管理工具提供的資訊，請選擇 **Full (完整)**。

   如需詳細資訊，請參閱[了解通知內容和安全性](security.md#security-notifications)。

1. 在 **Events that trigger notifications (觸發通知的事件)** 的 **Action execution (動作執行)** 下，選取 **Started (已開始)**。

1. 在 **Targets (目標)** 中，選擇 **Create SNS topic (建立 SNS 主題)**。
**注意**  
您在建立通知規則的過程中建立主題時，系統會為您套用允許 CodePipeline 將事件發佈至主題的政策。使用針對通知規則建立的主題，有助於確保您只訂閱需要接收此管道相關通知的使用者。

   在 **codestar-notifications-** 字首之後，輸入主題的名稱，然後選擇 **Submit (提交)**。
**注意**  
如果您要使用現有 Amazon SNS 主題而非建立新主題，請在 **Targets (目標)** 中選擇其 ARN。請確定主題具有適當的存取政策，而且訂閱者清單只包含允許查看資源相關資訊的使用者。如果 Amazon SNS 主題是在 2019 年 11 月 5 日之前用於 CodeCommit 通知的主題，它將包含允許 CodeCommit 發佈至它的政策，其中包含與 AWS CodeStar Notifications 所需的許可不同的許可。不建議使用這些主題。如果您想要使用針對該體驗建立的政策，除了已存在的政策之外，還必須新增 AWS CodeStar Notifications 所需的政策。如需詳細資訊，請參閱[設定通知的 Amazon SNS 主題](set-up-sns.md)及[了解通知內容和安全性](security.md#security-notifications)。

1. 選擇 **Submit (提交)**，然後檢閱通知規則。

1. 以您的電子郵件地址訂閱您剛建立的 Amazon SNS 主題。如需詳細資訊，請參閱[讓使用者訂閱用於通知的 Amazon SNS 主題](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 導覽至您的管道，然後選擇 **Release change (版本變更)**。

1. 動作開始時，通知規則會傳送通知給所有主題訂閱者，其中包含該事件的相關資訊。