Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 範例：工作流程中的觸發條件 下列範例示範如何在 Amazon CodeCatalyst 工作流程定義檔案中新增不同類型的觸發。 關於觸發條件的詳細資訊，請參閱 [使用觸發程序自動啟動工作流程執行](workflows-add-trigger.md)。 **Topics** + [範例：簡單的程式碼推送觸發程序](#workflows-add-trigger-examples-push-simple) + [範例：簡單的「推送至主要」觸發](#workflows-add-trigger-examples-push-main) + [範例：簡易的提取請求觸發程序](#workflows-add-trigger-examples-pull-simple) + [範例：簡單的排程觸發](#workflows-add-trigger-examples-schedule-simple) + [範例：具有排程和分支的觸發](#workflows-add-trigger-examples-schedule-branches) + [範例：具有排程、推送和分支的觸發](#workflows-add-trigger-examples-schedule-push-branches) + [範例：具有提取和分支的觸發](#workflows-add-trigger-examples-pull-branches) + [範例：具有提取、分支和「關閉」事件的觸發](#workflows-add-trigger-examples-push-pull-close) + [範例：具有推送、分支和檔案的觸發](#workflows-add-trigger-examples-push-multi) + [範例：手動觸發](#workflows-add-trigger-examples-manual) + [範例：CI/CD 多工作流程設定中的觸發](#workflows-add-trigger-usecases) ## 範例：簡單的程式碼推送觸發程序 下列範例顯示每當程式碼推送到來源儲存庫中的任何**分支時，啟動工作流程執行的觸發。 啟用此觸發時，CodeCatalyst 會使用您推送*到*的分支 （即目的地分支） 中的檔案啟動工作流程執行。 例如，如果您將遞交推送至 `main`，CodeCatalyst 會使用 Workfow 定義檔案和 上的其他來源檔案啟動工作流程執行`main`。 另一個範例是，如果您將遞交推送至 `feature-branch-123`，CodeCatalyst 會使用 Workfow 定義檔案和 上的其他來源檔案啟動工作流程執行`feature-branch-123`。 ``` Triggers: - Type: PUSH ``` **注意** 如果您希望工作流程執行只在您推送至 時啟動`main`，請參閱 [範例：簡單的「推送至主要」觸發](#workflows-add-trigger-examples-push-main)。 ## 範例：簡單的「推送至主要」觸發 下列範例顯示觸發程序，會在程式碼推送至**`main`來源儲存庫中的`main`分支時啟動工作流程。 ``` Triggers: - Type: PUSH Branches: - main ``` ## 範例：簡易的提取請求觸發程序 下列範例顯示在來源儲存庫中建立或修改提取請求時啟動工作流程執行的觸發。 啟用此觸發時，CodeCatalyst 會使用工作流程定義檔案和您*從*中提取的分支 （即來源分支） 中的其他來源檔案啟動工作流程執行。 例如，如果您使用名為 的來源分支`feature-123`和名為 的目的地分支建立提取請求`main`，CodeCatalyst 會使用 Workfow 定義檔案和 上的其他來源檔案啟動工作流程執行`feature-123`。 ``` Triggers: - Type: PULLREQUEST Events: - OPEN - REVISION ``` ## 範例：簡單的排程觸發 下列範例顯示的觸發會在每個週一至週五的午夜 (UTC\$10) 啟動工作流程執行。 啟用此觸發條件時，CodeCatalyst 會針對來源儲存庫中的每個分支啟動單一工作流程執行，其中包含具有此觸發條件的工作流程定義檔案。 例如，如果您的來源儲存庫中有三個分支，`main`、`release-v1``feature-123`、，且每個分支都包含一個工作流程定義檔案，其觸發條件如下，則 CodeCatalyst 會啟動三個工作流程執行：一個使用 中的檔案`main`，另一個使用 中的檔案`release-v1`，另一個使用 中的檔案`feature-123`。 ``` Triggers: - Type: SCHEDULE Expression: "0 0 ? * MON-FRI *" ``` 如需您可以在 `Expression` 屬性中使用的 cron 表達式的更多範例，請參閱 [Expression](workflow-reference.md#workflow.triggers.expression)。 ## 範例：具有排程和分支的觸發 下列範例顯示的觸發會在每天下午 6：15 (UTC\$10) 啟動工作流程執行。 啟用此觸發時，CodeCatalyst 會使用`main`分支中的檔案啟動工作流程執行，並針對以 開頭的每個分支啟動額外的執行`release-`。 例如，如果您的來源儲存庫`bugfix-2`中有名為 `main`、`bugfix-1`、 `release-v1`和 的分支，CodeCatalyst 會啟動兩個工作流程執行：一個使用 中的檔案`main`，另一個使用 中的檔案`release-v1`。它*不會*啟動 `bugfix-1`和 `bugfix-1`分支的工作流程執行。 ``` Triggers: - Type: SCHEDULE Expression: "15 18 * * ? *" Branches: - main - release\-.* ``` 如需您可以在 `Expression` 屬性中使用的 cron 表達式的更多範例，請參閱 [Expression](workflow-reference.md#workflow.triggers.expression)。 ## 範例：具有排程、推送和分支的觸發 下列範例顯示每天午夜 (UTC\$10) 開始工作流程執行的觸發，以及每當程式碼推送到`main`分支時。 在此範例中： + 工作流程執行會在每天午夜開始。工作流程執行會使用工作流程定義檔案和`main`分支中的其他來源檔案。 + 每當您將遞交推送到`main`分支時，工作流程執行也會開始。工作流程執行會使用目的地分支 () 中的工作流程定義檔案和其他來源檔案`main`。 ``` Triggers: - Type: SCHEDULE Expression: "0 0 * * ? *" Branches: - main - Type: PUSH Branches: - main ``` 如需您可以在 `Expression` 屬性中使用的 cron 表達式的更多範例，請參閱 [Expression](workflow-reference.md#workflow.triggers.expression)。 ## 範例：具有提取和分支的觸發 下列範例顯示觸發程序，會在有人開啟或修改具有名為 之目的地分支的提取請求時啟動工作流程執行`main`。雖然`Triggers`組態中指定的分支是 `main`，工作流程執行將使用工作流程定義檔案和來源分支 （您正在*提取*的分支） 中的其他*來源*檔案。 ``` Triggers: - Type: PULLREQUEST Branches: - main Events: - OPEN - REVISION ``` ## 範例：具有提取、分支和「關閉」事件的觸發 下列範例顯示每當提取請求在開頭為 的分支上關閉時，啟動工作流程執行的觸發`main`。 在此範例中： + 當您以開頭為 的目的地分支關閉提取請求時`main`，工作流程執行會使用工作流程定義檔案和 （現在已關閉） 來源分支中的其他來源檔案自動啟動。 + 如果您已將來源儲存庫設定為在提取請求合併後自動刪除分支，則這些分支將永遠無法進入 `CLOSED` 狀態。這表示合併的分支不會啟用提取請求`CLOSED`觸發。在此案例中啟用`CLOSED`觸發程序的唯一方法是關閉提取請求而不合併。 ``` Triggers: - Type: PULLREQUEST Branches: - main.* Events: - CLOSED ``` ## 範例：具有推送、分支和檔案的觸發 下列範例顯示觸發程序，會在對 `main` 分支上的 `filename.txt` 檔案或 `src`目錄中的任何檔案進行變更時啟動工作流程執行。 啟用此觸發時，CodeCatalyst 會使用工作流程定義檔案和`main`分支中的其他來源檔案啟動工作流程執行。 ``` Triggers: - Type: PUSH Branches: - main FilesChanged: - filename.txt - src\/.* ``` ## 範例：手動觸發 若要設定手動觸發，請省略工作流程定義檔案中的 `Triggers`區段。如果沒有本節，使用者在 CodeCatalyst 主控台中選擇**執行**按鈕，強制使用者手動啟動工作流程。如需詳細資訊，請參閱[手動啟動工作流程執行](workflows-manually-start.md)。 ## 範例：CI/CD 多工作流程設定中的觸發 此範例說明如何在想要使用單獨的 Amazon CodeCatalyst 工作流程進行持續整合 (CI) 和持續部署 (CD) 時設定觸發。 在此案例中，您會設定兩個工作流程： + **CI 工作流程** – 此工作流程會在建立或修改提取請求時建置和測試您的應用程式。 + **CD 工作流程** – 此工作流程會在提取請求合併時建置和部署您的應用程式。 **CI 工作流程**的定義檔案如下所示： ``` Triggers: - Type: PULLREQUEST Branches: - main Events: - OPEN - REVISION Actions: BuildAction: instructions-for-building-the-app TestAction: instructions-for-test-the-app ``` `Triggers` 程式碼指出每當軟體開發人員建立提取請求 （或修改[請求](pull-requests-update.md))，要求將其功能分支合併到`main`分支時， 會自動啟動工作流程執行。CodeCatalyst 會使用來源分支 （即功能分支） 中的來源碼啟動工作流程執行。 **CD 工作流程**的定義檔案如下所示： ``` Triggers: - Type: PUSH Branches: - main Actions: BuildAction: instructions-for-building-the-app DeployAction: instructions-for-deploying-the-app ``` `Triggers` 程式碼指出 會在合併`main`到 時自動啟動工作流程。CodeCatalyst 會使用`main`分支中的原始程式碼啟動工作流程執行。