ワークフローは、何らかのきっかけで実行されます。GitHub Actions では、on セクションに実行のきっかけとなるイベントを指定します。イベントには、ブランチへのプッシュやプルリクエストの変更など、GitHub が対応する操作があります。
継続的インテグレーション · レッスン 2
ワークフローのトリガー
イベントとブランチのフィルターから、GitHub Actions のワークフローがいつ実行されるかを読み取ります。
プッシュの条件を読む
ワークフローのこの部分を読んでみましょう。YAML ではインデントを見ると、branches が push の設定だと分かります。
on:
push:
branches:
- main
ワークフローが有効で、ほかの必要な条件も満たされていれば、main ブランチにコミットをプッシュしたときに実行されます。手元のターミナルでコミットしただけでは、変更は GitHub に送られていません。この設定が監視するのはプッシュです。
このプッシュのトリガーに当てはまる操作はどれですか?
プルリクエストの条件を読む
別のイベントを使うと、変更案をマージする前に確認できます。この例では、ブランチのフィルターがプルリクエストの取り込み先に適用されます。
on:
pull_request:
branches:
- main
health-page から main への提案は、このフィルターに当てはまります。デフォルトのアクティビティの種類では、プルリクエストを開いたときや、変更元のブランチにコミットを追加でプッシュしたときなどにワークフローが実行されます。
notes の変更を main に取り込むプルリクエストがあります。このフィルターではどの名前が使われますか?
複数のトリガーを読む
同じ on キーの下に両方のイベントを設定できます。プルリクエストで実行すると、提案された統合内容を確認できます。マージで main が更新されると、プッシュによる実行でそのブランチの新しい状態を確認できます。結果はそれぞれの実行画面に表示されるイベントとリビジョンに対応します。
ワークフローに上の二つのトリガーが設定されています。マージで main が更新されたとき、どのイベントが当てはまりますか?
レッスン完了
ワークフローのトリガー を完了しました
リポジトリのイベントがどのワークフローのトリガーに当てはまるかを判断できるようになりました。
プッシュイベントと、そのブランチフィルターを読み取ります。
プルリクエストのフィルターが適用される取り込み先ブランチを見つけます。
ワークフローの結果と、実行のきっかけになったイベントを対応付けます。