{"meta":{"title":"수동으로 워크플로 실행","intro":"워크플로가 이벤트에서 실행 workflow_dispatch 되도록 구성된 경우 작업 탭 GitHubGitHub CLI또는 REST API를 사용하여 워크플로를 실행할 수 있습니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/how-tos","title":"사용법"},{"href":"/ko/actions/how-tos/manage-workflow-runs","title":"워크플로 실행 관리"},{"href":"/ko/actions/how-tos/manage-workflow-runs/manually-run-a-workflow","title":"워크플로 수동 실행"}],"documentType":"article"},"body":"# 수동으로 워크플로 실행\n\n워크플로가 이벤트에서 실행 workflow_dispatch 되도록 구성된 경우 작업 탭 GitHubGitHub CLI또는 REST API를 사용하여 워크플로를 실행할 수 있습니다.\n\n## 수동으로 실행하도록 워크플로 구성\n\n워크플로를 수동으로 실행하려면 워크플로가 `workflow_dispatch` 이벤트에서 실행되도록 구성해야 합니다.\n\n`workflow_dispatch` 이벤트를 트리거하려면 워크플로가 기본 분기에 있어야 합니다.\n`workflow_dispatch` 이벤트 구성에 대한 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)을(를) 참조하세요.\n\n해당 단계를 수행하려면 리포지토리에 대한 쓰기 권한이 필요합니다.\n\n## 워크플로 실행\n\n
\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n\n2. 리포지토리 이름에서 ** 작업**을 클릭합니다.\n\n ![\"github/docs\" 리포지토리의 탭 스크린샷. \"작업\" 탭은 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-tab-global-nav-update.png)\n\n3. 실행할 워크플로 이름을 왼쪽 사이드바에서 클릭합니다.\n\n ![\"작업\" 창의 스크린샷. 왼쪽 사이드바에서 워크플로 이름은 진한 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-select-workflow-2022.png)\n\n4. **워크플로 실행** 단추를 워크플로 실행 목록 위에서 클릭합니다.\n\n > \\[!NOTE]\n > **워크플로 실행** 단추를 보려면 워크플로 파일이 `workflow_dispatch` 이벤트 트리거를 사용해야 합니다. `workflow_dispatch` 이벤트 트리거를 사용하는 워크플로 파일만 **워크플로 실행** 단추를 사용하여 워크플로를 수동으로 실행하는 옵션이 있습니다. `workflow_dispatch` 이벤트 구성에 대한 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch)을(를) 참조하세요.\n\n ![워크플로 페이지의 스크린샷. \"워크플로 실행\"이라는 레이블이 지정된 단추가 워크플로 실행 목록 위에 진한 주황색으로 표시됩니다.](/assets/images/help/actions/actions-workflow-dispatch.png)\n\n5. **분기** 드롭다운 메뉴를 선택하고 분기를 클릭하여 워크플로를 실행하세요.\n\n6. 워크플로에 입력이 필요한 경우 필드를 입력하세요.\n\n7. **워크플로 실행**을 클릭합니다.\n\n
\n\n
\n\n> \\[!NOTE]\n> GitHub CLI에 대한 자세한 내용은 [GitHub CLI 정보](/ko/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> 이벤트에 대해 최대 25 `inputs`을 정의할 `workflow_dispatch` 수 있습니다.\n\n[워크플로에 대한 REST API 엔드포인트](/ko/rest/actions/workflows#create-a-workflow-dispatch-event)에서 REST API 사용에 대한 자세한 정보를 참조하세요."}