# 手动运行工作流
将工作流配置为在workflow_dispatch事件上运行时，可以使用“GitHubGitHub CLI操作”选项卡或 REST API 运行工作流。
> \[!NOTE]
> GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。
## 配置工作流手动运行
要手动运行工作流，必须将工作流配置为在 `workflow_dispatch` 事件上运行。
要触发 `workflow_dispatch` 事件，工作流必须位于默认分支中。 有关配置 `workflow_dispatch` 事件的详细信息，请参阅 [触发工作流的事件](/zh/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)。
执行这些步骤需要对仓库的写入访问权限。
## 运行工作流
> \[!NOTE]
> 若要详细了解 GitHub CLI，请参阅“[关于 GitHub CLI](/zh/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
```
## 使用 REST API 运行工作流
使用 REST API 时，应将 `inputs` 和 `ref` 配置为请求正文参数。 如果忽略输入，则使用工作流文件中定义的默认值。
> \[!NOTE]
> 最多可以为事件定义 10`inputs`。`workflow_dispatch`
有关使用 REST API 的详细信息，请参阅 [工作流的 REST API 终结点](/zh/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event)。