在中構建觸發器 AWS CodeBuild

建立 AWS CodeBuild 觸發

創建AWS CodeBuild觸發器（控制台）

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

注意

無法從建置觸發器、Amazon EventBridge 事件或AWS Step Functions任務啟動批次建置。

建立觸發

1. 請在以下位置開啟AWS CodeBuild主控台。 https://console.aws.amazon.com/codesuite/codebuild/home

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

3. 選擇您想要新增觸發的組建專案的連結，然後選擇 Build triggers (組建觸發) 索引標籤。

   注意

   依預設，會顯示 100 個最新的建置專案。若要檢視更多組建專案，請選擇齒輪圖示，然後針對 Projects per page (每頁顯示專案數) 選擇不同的值，或使用向前和向後箭頭。

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

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

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

7. 指定觸發的頻率參數。您可以在文字方塊中鍵入選項的前幾個字元來篩選下拉式選單項目。

   注意

   開始時數和分鐘是從零開始的。開始分鐘是介於零到 59 之間的數字。開始時間是介於零到 23 之間的數字。例如，每天下午 12:15 開始的每日觸發器的開始小時為 12，開始分鐘為 15。每天午夜開始的每日觸發器的開始小時為零，開始分鐘為零。每天晚上 11:59 開始的每日觸發器的開始時間為 23，開始分鐘為 59。

   頻率	必要參數	詳細資訊
   每小時	起始分鐘	使用 Start minute (起始分鐘) 下拉式選單。
   每日	起始分鐘 起始小時	使用 Start minute (起始分鐘) 下拉式選單。 使用 Start hour (起始小時) 下拉式選單。
   每週	起始分鐘 起始小時 起始日	使用 Start minute (起始分鐘) 下拉式選單。 使用 Start hour (起始小時) 下拉式選單。 使用 Start day (起始日) 下拉式選單。
   自訂	Cron 表達式	在 Cron expression (Cron 表達式) 中輸入 cron 表達式。Cron 表達式有六個必要欄位，以空格隔開。這些欄位指定了分鐘、小時、日、月、星期和年的起始值。您也可以使用萬用字元來指定一個範圍、其他值等。例如，cron 運算式會在每個工作日上午 9:00 0 9 ? * MON-FRI * 排程建置，如需詳細資訊，請參閱 Amazon CloudWatch 事件使用者指南中的 Cron 運算式。

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

9. (選用) 展開 Advanced (進階) 區段。在 Source version (來源版本) 中，輸入來源的版本。

   • 對於 Amazon S3，請輸入與您要建立之輸入成品版本對應的版本 ID。如果 Source version (來源版本) 為空白，將使用最新版本。

   • 針對 AWS CodeCommit，輸入遞交 ID。如果 Source version (來源版本) 為空白，將使用預設分支的 HEAD 遞交 ID。

   • 針對 GitHub 或 GitHub Enterprise，請輸入對應至您要建置之原始程式碼版本的提交 ID、提取要求識別碼、分支名稱或標籤名稱。如果指定提取要求 ID，其格式必須為 pr/pull-request-ID (例如，pr/25)。如果指定分支名稱，將使用分支的 HEAD 遞交 ID。如果 Source version (來源版本) 空白，則會使用預設分支的 HEAD 遞交 ID。

   • 針對 Bitbucket，輸入遞交 ID、分支名稱，或與您想要建置之原始碼版本對應的標籤名稱。如果指定分支名稱，將使用分支的 HEAD 遞交 ID。如果 Source version (來源版本) 空白，則會使用預設分支的 HEAD 遞交 ID。

10. (選用) 指定介於 5 分鐘到 480 分鐘 (8 小時) 的逾時。此值指定 AWS CodeBuild 嘗試組建時多久之後停止。如果 Hours (小時) 和 Minutes (分鐘) 空白，則會使用專案中指定的預設逾時值。

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

編程創建AWS CodeBuild觸發器

CodeBuild 使用 Amazon EventBridge 規則進行構建觸發器。您可以使用 EventBridge API 以程式設計方式建立 CodeBuild 專案的建置觸發程式。如需詳細資訊，請參閱 Amazon EventBridge API 參考。

編輯 AWS CodeBuild 觸發條件

編輯AWS CodeBuild觸發器（控制台）

您可以在專案上編輯觸發來排定每小時、每天或每週執行一次組建。您也可以編輯觸發器，將自訂規則與 Amazon CloudWatch cron 運算式搭配使用。例如，您可以使用 cron 表達式來排定在每個工作日的特定時間執行組建。如需有關建立觸發的資訊，請參閱建立 AWS CodeBuild 觸發。

如何編輯觸發條件

1. 請在以下位置開啟AWS CodeBuild主控台。 https://console.aws.amazon.com/codesuite/codebuild/home

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

3. 選擇您想要變更的組建專案的連結，然後選擇 Build triggers (組建觸發) 索引標籤。

   注意

   依預設，會顯示 100 個最新的建置專案。若要檢視更多組建專案，請選擇齒輪圖示，然後針對 Projects per page (每頁顯示專案數) 選擇不同的值，或使用向前和向後箭頭。

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

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

6. 指定觸發的頻率參數。您可以在文字方塊中鍵入選項的前幾個字元來篩選下拉式選單項目。

   注意

   開始時數和分鐘是從零開始的。開始分鐘是介於零到 59 之間的數字。開始時間是介於零到 23 之間的數字。例如，每天下午 12:15 開始的每日觸發器的開始小時為 12，開始分鐘為 15。每天午夜開始的每日觸發器的開始小時為零，開始分鐘為零。每天晚上 11:59 開始的每日觸發器的開始時間為 23，開始分鐘為 59。

   頻率	必要參數	詳細資訊
   每小時	起始分鐘	使用 Start minute (起始分鐘) 下拉式選單。
   每日	起始分鐘 起始小時	使用 Start minute (起始分鐘) 下拉式選單。 使用 Start hour (起始小時) 下拉式選單。
   每週	起始分鐘 起始小時 起始日	使用 Start minute (起始分鐘) 下拉式選單。 使用 Start hour (起始小時) 下拉式選單。 使用 Start day (起始日) 下拉式選單。
   自訂	Cron 表達式	在 Cron expression (Cron 表達式) 中輸入 cron 表達式。Cron 表達式有六個必要欄位，以空格隔開。這些欄位指定了分鐘、小時、日、月、星期和年的起始值。您也可以使用萬用字元來指定一個範圍、其他值等。例如，cron 運算式會在每個工作日上午 9:00 0 9 ? * MON-FRI * 排程建置，如需詳細資訊，請參閱 Amazon CloudWatch 事件使用者指南中的 Cron 運算式。

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

注意

您可以使用 Amazon CloudWatch 主控台，網址為 https://console.aws.amazon.com/cloudwatch/ 編輯中未提供的來源版本、逾時和其他選項AWS CodeBuild。

編輯AWS CodeBuild觸發程式

CodeBuild 使用 Amazon EventBridge 規則進行構建觸發器。您可以使用 EventBridge API 以程式設計方式編輯 CodeBuild 專案的建置觸發程式。如需詳細資訊，請參閱 Amazon EventBridge API 參考。