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

# 自動觸發 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. 開啟 AWS CodeBuild 主控台，網址為 http：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home)。

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/)。

# 編輯 AWS CodeBuild 觸發
<a name="triggers-edit"></a>

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

**Topics**
+ [編輯 AWS CodeBuild 觸發 （主控台）](#triggers-edit-console)
+ [以程式設計方式編輯 AWS CodeBuild 觸發](#trigger-edit-code)

## 編輯 AWS CodeBuild 觸發 （主控台）
<a name="triggers-edit-console"></a>

使用下列程序來編輯使用 的觸發 AWS 管理主控台。

**如何編輯觸發條件**

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

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

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

1. 選擇您想要變更的觸發旁邊的選項按鈕，然後選擇 **Edit (編輯)**。

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/triggers-edit.html)

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

**注意**  
您可以使用 Amazon CloudWatch 主控台，網址為 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)：// AWS CodeBuild https：//www.microsoft.com/microsoft.com/microsoft.com/microsoft.com/microsoft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/soft.com/

## 以程式設計方式編輯 AWS CodeBuild 觸發
<a name="trigger-edit-code"></a>

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