dispatchトリガーを使ってGitHub Actionsのデバッグをちょっと楽する

GitHub Actionsには様々なトリガー条件があります。
push, pull_request などを設定して、リリースブランチにコミットがあったらデプロイする、PRの各コミットでlinterやテストを動かす、などが一般的な使い方でしょうか。

そこから一歩進めて特定のファイルに差分があれば～のようなトリガー条件を設定したとき、動作確認やデバッグで思うように発火させられずにちょっとだけ面倒な思いをしたことはありませんか？ 私はあります。あなたもあるはずです¹。
たとえばこのブログを管理しているリポジトリにもそういう形跡はあって²、このような涙ぐましいコミットをしてなんとか誤魔化していたようです。
他の解法としては、トリガー条件を緩くする、などでしょうか。
なんにせよ、作業のたびに虚無の変更を加えたり、トリガー条件の戻し忘れに震えたりしないといけないのはいまいちであります。

このような苦しみを抱えている人は、ワークフローファイルの通常のトリガーに加えて、workflow_dispatchを追加しておくのがおすすめです。

on:
  push:
    paths:
      - **.ts
      - **.tsx
  workflow_dispatch:

workflow_dispatchを設定することで、リポジトリのActionsタブやGitHub CLIから任意のタイミングでワークフローを起動できるようになります。そのため、テストやLintなど、構築後も定期的に設定を見直すものについてはとりあえずworkflow_dispatchを添えておくといざというときに便利です。

この便利さに気付いてからというもの、誰かがCI職人をしていると³「それ、workflow_dispatch追加しときな～」と声をかける不審者おじさんになってしまいました。終わり。

Footnotes

1. Actionsのデバッグももちろんながら、linterの設定だったり外部ツールとの連携だったりとこういう苦しみを背負う瞬間は思ったより多い ↩
2. こういうのを見て、rebaseして綺麗なコミットログを作れと言われることもあるが、綺麗なコミットログよりも苦しんだ時の思考を追跡できたほうが便利だと思っているので基本そのままにしている ↩
3. デプロイワークフローは手元から発火できるとまずいので例外 ↩