觸發程序自動 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/Codebuild/home 開啟 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 Events 使用者指南 中的 Cron Expressions。

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

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

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

    • 對於 AWS CodeCommit，輸入遞交 ID。如果來源版本保留空白，則會使用預設分支的HEAD遞交 ID。

    • 對於 GitHub 或 GitHub Enterprise，輸入遞交 ID、提取請求 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 專案建立建置觸發程序。如需詳細資訊，請參閱 Amazon EventBridge API 參考。