workflow dispatchとは？
workflow dispatchはGitHub Actionsのトリガータイプの一つで、push、pull request、scheduleを待つのではなく、人（またはAPI呼び出し）がオンデマンドで手動でワークフローを開始できるようにします。型付きのinputを受け取れるため、デプロイ先の環境やバージョンを選ぶなど、同じワークフローを異なるパラメータで実行できます。
なぜ重要か
手動デプロイ、アドホックなメンテナンスジョブ、一度きりのデータ処理など、一部のワークフローは人間が判断したときにカスタムのinputで実行すべきです。workflow dispatchはUIとAPIを備えた、制御された手動エントリーポイントを提供し、自動のイベントトリガーやscheduleトリガーを補完します。
関連する概念
- 手動トリガー、pushやscheduleを補完する
- ユーザーから型付きのinputを受け取る
- ChatOps向けにAPI経由で呼び出せる
関連ガイド
What Is a Cron Schedule?A cron schedule uses a five-field time expression to trigger jobs at recurring times, such as nightly builds…
What Is a Webhook?A webhook is an HTTP callback that a system sends to a URL you specify when an event occurs, enabling event-d…
What Is a Reusable Workflow?A reusable workflow is a complete workflow that other workflows can call with inputs, letting teams share CI…