はじめに
GitHub Actions を使って CI/CD の自動化を進める中で、「手動でワークフローを実行したい」という場面があります。workflow_dispatch はそんなニーズに応えてくれる便利な仕組みです。
個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。
今回は、push などのトリガーを使わず、手動で GitHub Actions を実行する方法について備忘録としてまとめました。
書こうと思ったきっかけ
開発中、「ちょっとだけ処理を流して確認したい」と思っても、コミットやPushが不要な変更では、トリガーできず面倒でした。
workflow_dispatch を使えば、ボタンひとつで必要なときにだけ実行できるため、開発フローの効率化につながると感じたため記録しています。
GitHub Actions連携（workflow_dispatch）
GitHub Actionsを使うことで、ECSを含むさまざまなワークフローを自動化・効率化できます。
その中でも workflow_dispatch は手動実行のためのトリガーとして非常に便利です。
workflow_dispatch とは？
GitHub Actionsのワークフローを「ボタン1つ」で手動実行できる仕組みです。これにより、次のような利点があります：
- pushやpull requestを必要とせず、必要なときだけトリガーできる
- 設定や挙動のテストを、コードの更新なしで行える
- チーム開発で同じ環境・手順での実行が可能になる
使用例（YAMLの記述）
name: Deploy to ECS
on:
workflow_dispatch:
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v2
- name: Deploy to ECS
run: echo "ここにECSデプロイの処理を書く"
このように設定することで、GitHub上から「手動実行ボタン」を使って、任意のタイミングでワークフローを動かすことができます。
まとめ
GitHub Actionsにおける workflow_dispatch は、「今このタイミングで実行したい」という開発者のニーズにフィットする便利な機能です。
pushなどのトリガーに頼らずに操作できるため、検証作業や一時的な処理実行に非常に有効です。
実際の現場でも「ちょっと確認したいけどコード変更したくない…」という場面で多く使われており、開発フローの柔軟性を高める一手となります。
必要な処理だけ安全に実行できる仕組みとして、ぜひ活用していきたいと思います。