{"meta":{"title":"ワークフローの手動実行","intro":"workflow_dispatch イベントで実行するようにワークフローが構成されている場合は、GitHub、GitHub CLI、または REST API の [アクション] タブを使用してワークフローを実行できます。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/actions","title":"GitHub Actions"},{"href":"/ja/actions/how-tos","title":"方法"},{"href":"/ja/actions/how-tos/manage-workflow-runs","title":"ワークフローの実行の管理"},{"href":"/ja/actions/how-tos/manage-workflow-runs/manually-run-a-workflow","title":"ワークフローを手動で実行する"}],"documentType":"article"},"body":"# ワークフローの手動実行\n\nworkflow_dispatch イベントで実行するようにワークフローが構成されている場合は、GitHub、GitHub CLI、または REST API の [アクション] タブを使用してワークフローを実行できます。\n\n## ワークフローを手動実行する設定\n\nワークフローを手動で実行するには、`workflow_dispatch` イベントで実行するようにワークフローを設定する必要があります。\n\n`workflow_dispatch` イベントをトリガーするには、ワークフローが既定のブランチに存在する必要があります。\n`workflow_dispatch` イベントの構成方法については、「[ワークフローをトリガーするイベント](/ja/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)」を参照してください。\n\nこれらのステップを実行するには、リポジトリへの書き込みアクセスが必要です。\n\n## ワークフローの実行\n\n\n\n\n\n> \\[!NOTE]\n> GitHub CLI の詳細については、「[GitHub CLI について](/ja/github-cli/github-cli/about-github-cli)」を参照してください。\n\nワークフローを実行するには、`workflow run` サブコマンドを使用します。\n`workflow` パラメーターを、実行するワークフローの名前、ID、またはファイル名のいずれかに置き換えます。 たとえば、「`\"Link Checker\"`」、「`1234567`」、「`\"link-check-test.yml\"`」のように指定します。 ワークフローを指定しない場合、 GitHub CLI はワークフローを選択するための対話型メニューを返します。\n\n```shell\ngh workflow run WORKFLOW\n```\n\nワークフローが入力を受け入れる場合、 GitHub CLI は入力を求められます。 または、`-f` または `-F` を使用して `key=value` 形式の入力を追加できます。\n`-F` を使用してファイルから読み取ります。\n\n```shell\ngh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt\n```\n\n標準入力を使用して、入力を JSON として渡すこともできます。\n\n```shell\necho '{\"name\":\"mona\", \"greeting\":\"hello\"}' | gh workflow run greet.yml --json\n```\n\nリポジトリの既定のブランチ以外のブランチでワークフローを実行するには、`--ref` フラグを使用します。\n\n```shell\ngh workflow run WORKFLOW --ref BRANCH\n```\n\nワークフロー実行の進行状況を表示するには、`run watch` サブコマンドを使用して、インタラクティブ リストから実行を選択します。\n\n```shell\ngh run watch\n```\n\n
\n\n## REST API を使用してワークフローを実行する\n\nREST API を使用する場合は、要求本文パラメーターとして `inputs` と `ref` を構成します。 入力を省略すると、ワークフロー ファイルで定義されているデフォルト値が使用されます。\n\n> \\[!NOTE]\n> イベントに対して最大10 `inputs``workflow_dispatch`を定義できます。\n\nREST API の使用の詳細については、「[ワークフローの REST API エンドポイント](/ja/rest/actions/workflows#create-a-workflow-dispatch-event)」を参照してください。"}