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

# 自動觸發 AWS CodeBuild 建置
<a name="build-triggers"></a>

您可以在專案上建立觸發來排定每小時、每天或每週執行一次組建。您也可以編輯觸發條件，以使用具有 Amazon CloudWatch Cron 表達式的自訂規則。例如，您可以使用 cron 表達式來排定在每個工作日的特定時間執行組建。如需建立和編輯觸發程序的資訊，請參閱 [建立 AWS CodeBuild 觸發條件](#trigger-create)和 [編輯 AWS CodeBuild 觸發條件](triggers-edit.md)。

**Topics**
+ [建立 AWS CodeBuild 觸發條件](#trigger-create)
+ [編輯 AWS CodeBuild 觸發條件](triggers-edit.md)

## 建立 AWS CodeBuild 觸發條件
<a name="trigger-create"></a>

您可以在專案上建立觸發來排定每小時、每天或每週執行一次組建。您也可以使用具有 Amazon CloudWatch Cron 表達式的自訂規則來建立觸發。例如，您可以使用 cron 表達式來排定在每個工作日的特定時間執行組建。

**注意**  
您無法從組建觸發條件、Amazon EventBridge 事件或 AWS Step Functions 任務啟動批次組建。

**Topics**
+ [建立 AWS CodeBuild 觸發 （主控台）](#trigger-create-console)
+ [以程式設計方式建立 AWS CodeBuild 觸發](#trigger-create-code)

### 建立 AWS CodeBuild 觸發 （主控台）
<a name="trigger-create-console"></a>

使用下列程序，使用 建立觸發 AWS 管理主控台。

**建立觸發** 

1. 在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1. 在導覽窗格中，選擇 **Build projects (建置專案)**。

1. 選擇您想要新增觸發的組建專案的連結，然後選擇 **Build triggers (組建觸發)** 索引標籤。
**注意**  
根據預設，會顯示 100 個最新的建置專案。若要檢視更多組建專案，請選擇齒輪圖示，然後針對 **Projects per page (每頁顯示專案數)** 選擇不同的值，或使用向前和向後箭頭。

1. 選擇 **Create trigger (建立觸發)**。

1. 在 **Trigger name (觸發名稱)** 中輸入名稱。

1. 從 **Frequency (頻率)** 下拉式清單中，選擇觸發的頻率。如果想要使用 Cron 表達式建立頻率，請選擇 **Custom (自訂)**。

1. 指定觸發的頻率參數。您可以在文字方塊中鍵入選項的前幾個字元來篩選下拉式選單項目。
**注意**  
 開始時間和分鐘為零。開始分鐘是介於零到 59 之間的數字。開始時間是介於零到 23 之間的數字。例如，每天下午 12：15 開始的每日觸發。開始時間為 12，開始時間為 15。每日午夜開始的觸發，開始時間為零，開始分鐘為零。每日觸發會在每天下午 11：59 開始。開始時間為 23，開始時間為 59。  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/build-triggers.html)

1.  選取 **Enable this trigger (啟用此觸發)**。

1.  (選用) 展開 **Advanced (進階)** 區段。在 **Source version (來源版本)** 中，輸入來源的版本。
   +  針對 Amazon S3，輸入對應至您要建置之輸入成品版本的版本 ID。如果 **Source version** (來源版本) 為空白，將使用最新版本。
   +  對於 AWS CodeCommit，輸入遞交 ID。如果 **Source version (來源版本)** 為空白，將使用預設分支的 HEAD 遞交 ID。
   + 針對 GitHub 或 GitHub Enterprise，輸入遞交 ID、提取要求 ID、分支名稱，或與您想要建置之原始碼版本對應的標籤名稱。如果指定提取要求 ID，其格式必須為 `pr/{{pull-request-ID}}` (例如，`pr/25`)。如果指定分支名稱，將使用分支的 HEAD 遞交 ID。如果 **Source version (來源版本)** 空白，則會使用預設分支的 HEAD 遞交 ID。
   + 針對 Bitbucket，輸入遞交 ID、分支名稱，或與您想要建置之原始碼版本對應的標籤名稱。如果指定分支名稱，將使用分支的 HEAD 遞交 ID。如果 **Source version (來源版本)** 空白，則會使用預設分支的 HEAD 遞交 ID。

1. （選用） 指定介於 5 分鐘到 2160 分鐘 (36 小時） 之間的逾時。此值指定建置在停止之前 AWS CodeBuild 嘗試建置的時間長度。如果 **Hours (小時)** 和 **Minutes (分鐘)** 空白，則會使用專案中指定的預設逾時值。

1. 選擇 **Create trigger (建立觸發)**。

### 以程式設計方式建立 AWS CodeBuild 觸發
<a name="trigger-create-code"></a>

CodeBuild 使用 Amazon EventBridge 規則進行建置觸發。您可以使用 EventBridge API，以程式設計方式為您的 CodeBuild 專案建立建置觸發。如需詳細資訊，請參閱 [Amazon EventBridge API 參考](https://docs.aws.amazon.com/eventbridge/latest/APIReference/)。