觸發器和分支的使用指南

本節說明設定包含分支的 Amazon CodeCatalyst 觸發器時的一些主要準則。

關於觸發條件的詳細資訊，請參閱 使用觸發器啟動工作流程自動執行。

• 指導方針 1：對於推送和提取請求觸發器，如果要指定分支，則必須在觸發器配置中指定目的地（或「到」）分支。永遠不要指定源（或「來自」）分支。

  在下列範例中，從任何分支推送以main啟動工作流程。

  Triggers:
    - Type: PUSH
      Branches:
        - main

  在下列範例中，從任何分支到的提取要求main會啟動工作流程。

  Triggers:
    - Type: PULLREQUEST
      Branches:
        - main
      Events:
        - OPEN
        - REVISION

• 指導原則 2：對於推送觸發器，在啟動工作流程之後，工作流程將使用目標分支中的工作流程定義檔案和來源檔案執行。

• 指導原則 3：對於提取要求觸發程序，在啟動工作流程之後，工作流程將使用來源分支中的工作流程定義檔案和來源檔案執行 (即使您在觸發器組態中指定了目的地分支)。

• 指南 4：一個分支中完全相同的觸發器可能無法在另一個分支中運行。

  請考慮下列推送觸發器：

  Triggers:
    - Type: PUSH
      Branches:
        - main

  如果包含此觸發程序的工作流程定義檔案存在main且被複製到中test，則工作流程將永遠不會自動開始使用中的檔案 test (雖然您可以手動啟動工作流程以使其使用中的檔案test)。檢閱指導原則 2，瞭解為何工作流程永遠不會使用中的檔案自動執行test。

  另請考慮下列提取要求觸發程序：

  Triggers:
    - Type: PULLREQUEST
      Branches:
        - main
      Events:
        - OPEN
        - REVISION

  如果中存在包含此觸發器的工作流程定義檔案main，則工作流程將永遠不會使用中的檔案來執行main。(但是，如果您建立關閉的test分支main，工作流程將會使用中的檔案執行test。) 檢閱指引 3 以了解原因。