# 수동으로 워크플로 실행

워크플로가 이벤트에서 실행 workflow_dispatch 되도록 구성된 경우 작업 탭 GitHubGitHub CLI또는 REST API를 사용하여 워크플로를 실행할 수 있습니다.

> \[!NOTE]
> GitHub Enterprise Server 호스트 실행기는 현재 GitHub에서 지원되지 않습니다.

## 수동으로 실행하도록 워크플로 구성

워크플로를 수동으로 실행하려면 워크플로가 `workflow_dispatch` 이벤트에서 실행되도록 구성해야 합니다.

`workflow_dispatch` 이벤트를 트리거하려면 워크플로가 기본 분기에 있어야 합니다.
`workflow_dispatch` 이벤트 구성에 대한 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/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> 작업**을 클릭합니다.

   !["github/docs" 리포지토리의 탭 스크린샷. "작업" 탭은 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-tab-global-nav-update.png)

3. 실행할 워크플로 이름을 왼쪽 사이드바에서 클릭합니다.

   !["작업" 창의 스크린샷. 왼쪽 사이드바에서 워크플로 이름은 진한 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-select-workflow-2022.png)

4. **워크플로 실행** 단추를 워크플로 실행 목록 위에서 클릭합니다.

   > \[!NOTE]
   > **워크플로 실행** 단추를 보려면 워크플로 파일이 `workflow_dispatch` 이벤트 트리거를 사용해야 합니다. `workflow_dispatch` 이벤트 트리거를 사용하는 워크플로 파일만 **워크플로 실행** 단추를 사용하여 워크플로를 수동으로 실행하는 옵션이 있습니다. `workflow_dispatch` 이벤트 구성에 대한 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)을(를) 참조하세요.

   ![워크플로 페이지의 스크린샷. "워크플로 실행"이라는 레이블이 지정된 단추가 워크플로 실행 목록 위에 진한 주황색으로 표시됩니다.](/assets/images/help/actions/actions-workflow-dispatch.png)

5. **분기** 드롭다운 메뉴를 선택하고 분기를 클릭하여 워크플로를 실행하세요.

6. 워크플로에 입력이 필요한 경우 필드를 입력하세요.

7. **워크플로 실행**을 클릭합니다.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> GitHub CLI에 대한 자세한 내용은 [GitHub CLI 정보](/ko/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]
> 이벤트에 대해 최대 10`inputs`을 정의할 `workflow_dispatch` 수 있습니다.

[워크플로에 대한 REST API 엔드포인트](/ko/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event)에서 REST API 사용에 대한 자세한 정보를 참조하세요.