Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トリガーとブランチの使用ガイドライン
<a name="workflows-add-trigger-considerations"></a>

このセクションでは、ブランチを含む Amazon CodeCatalyst トリガーを設定する際の主なガイドラインについて説明します。

トリガーについての詳細は、「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。
+ **ガイドライン 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` のファイルを使用するようにすることは可能)。`test` のファイルを使用してワークフローが自動的に実行されない理由については、**ガイドライン 2** を参照してください。

  次のプルリクエストトリガーも検討してください。

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

  このトリガーを含むワークフロー定義ファイルが `main` に存在する場合、`main` のファイルを使用してワークフローが実行されることはありません (ただし、`main` から `test` ブランチを作成すると、`test` のファイルを使用してワークフローが実行されます)。その理由については**ガイドライン 3** を参照してください。