# ワークフローの手動実行

workflow_dispatch イベントで実行するようにワークフローが構成されている場合は、GitHub、GitHub CLI、または REST API の [アクション] タブを使用してワークフローを実行できます。

> \[!NOTE]
> GitHub Enterprise Server ホステッド ランナーは、現在 GitHub ではサポートされていません。

## ワークフローを手動実行する設定

ワークフローを手動で実行するには、`workflow_dispatch` イベントで実行するようにワークフローを設定する必要があります。

`workflow_dispatch` イベントをトリガーするには、ワークフローが既定のブランチに存在する必要があります。
`workflow_dispatch` イベントの構成方法については、「[ワークフローをトリガーするイベント](/ja/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)」を参照してください。

これらのステップを実行するには、リポジトリへの書き込みアクセスが必要です。

## ワークフローの実行

<div class="ghd-tool webui">

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある **\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> Actions]** をクリックします。

   !["github/docs" リポジトリのタブのスクリーンショット。 \[アクション\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/actions-tab-global-nav-update.png)

3. 左側のサイド バーで、実行するワークフローの名前をクリックします。

   ![\[アクション\] ページのスクリーンショット。 ワークフロー名が、左側のサイド バーで濃いオレンジ色の輪郭で強調表示されています。](/assets/images/help/repository/actions-select-workflow-2022.png)

4. ワークフロー実行の一覧の上にある **\[ワークフローの実行]** ボタンをクリックします。

   > \[!NOTE]
   > **\[Run workflow]** ボタンが表示されるには、ワークフロー ファイルで `workflow_dispatch` イベント トリガーが使われている必要があります。 `workflow_dispatch` ボタンを使ってワークフローを手動で実行できるのは、\*\*\*\* イベント トリガーを使っているワークフロー ファイルだけです。 `workflow_dispatch` イベントの構成方法については、「[ワークフローをトリガーするイベント](/ja/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)」を参照してください。

   ![ワークフロー ページのスクリーンショット。 ワークフロー実行の一覧の上に、\[Run workflow\] (ワークフローの実行) というラベルの付いたボタンが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/actions/actions-workflow-dispatch.png)

5. **\[Branch] (ブランチ)** ドロップダウン メニューを選択し、ワークフローを実行するブランチをクリックします。

6. ワークフローに入力が必要な場合は、フィールドに入力します。

7. **\[ワークフローの実行]** をクリックします。

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> GitHub CLI の詳細については、「[GitHub CLI について](/ja/enterprise-server@3.22/github-cli/github-cli/about-github-cli)」を参照してください。

ワークフローを実行するには、`workflow run` サブコマンドを使用します。
`workflow` パラメーターを、実行するワークフローの名前、ID、またはファイル名のいずれかに置き換えます。 たとえば、「`"Link Checker"`」、「`1234567`」、「`"link-check-test.yml"`」のように指定します。 ワークフローを指定しない場合、 GitHub CLI はワークフローを選択するための対話型メニューを返します。

```shell
gh workflow run WORKFLOW
```

ワークフローが入力を受け入れる場合、 GitHub CLI は入力を求められます。 または、`-f` または `-F` を使用して `key=value` 形式の入力を追加できます。
`-F` を使用してファイルから読み取ります。

```shell
gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt
```

標準入力を使用して、入力を JSON として渡すこともできます。

```shell
echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json
```

リポジトリの既定のブランチ以外のブランチでワークフローを実行するには、`--ref` フラグを使用します。

```shell
gh workflow run WORKFLOW --ref BRANCH
```

ワークフロー実行の進行状況を表示するには、`run watch` サブコマンドを使用して、インタラクティブ リストから実行を選択します。

```shell
gh run watch
```

</div>

## REST API を使用してワークフローを実行する

REST API を使用する場合は、要求本文パラメーターとして `inputs` と `ref` を構成します。 入力を省略すると、ワークフロー ファイルで定義されているデフォルト値が使用されます。

> \[!NOTE]
> 25 10 `inputs``workflow_dispatch`を定義できます。

REST API の使用の詳細については、「[ワークフローの REST API エンドポイント](/ja/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event)」を参照してください。