自動觸發 AWS CodeBuild 構建 - AWS CodeBuild
建立建置觸發

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

自動觸發 AWS CodeBuild 構建

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

主題

建立 AWS CodeBuild 觸發器

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

注意

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

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

請使用下列程序來建立使用的觸發程序 AWS Management Console。

建立觸發

  1. 在https://console.aws.amazon.com/codesuite/代碼生成/家中打開 AWS CodeBuild 控制台。

  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。如果原始碼版本保留空白，則會使用預設分支的HEAD提交 ID。

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

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

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

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

編程創建 AWS CodeBuild 觸發器

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