GitHub Actions を使っていると、ファイルパスとブランチのANDが取れたときだけワークフローを動かしたくなることがある。

例えば、各ファイルに紐づくワークフローがあり、あるブランチにマージしたときだけ動かしたいとき。ここでは、未更新ファイルに紐づくワークフローは動いてほしくない。

期待はこう。

ファイル A を更新 → ワークフロー A だけが動く
ファイル B を更新 → ワークフロー B だけが動く

こうすればOK

workflow_A.yml

on:
  push:
    branches:
      - main
    paths:
      - 'file_A' #このワークフローに紐づくファイル名を指定

ただ、公式Doc に明示的に仕様が書かれていなかったので、いくつかのパターンで検証してみました。

検証

ファイル構成はこんな感じ。ワークフローの中身はこちら。

.
├── .github
│   └── workflows
│       ├── workflow_A.yml
│       └── workflow_B.yml
├── file_A
└── file_B
└── file_C

以上の結果から、on.push.branches と on.push.paths を併用した場合は、ANDが取れた場合にのみ更新されることが確かめられました。