Skip to main content

워크플로 수동 실행

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

Tool navigation

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

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

workflow_dispatch 이벤트를 트리거하려면 워크플로가 기본 분기에 있어야 합니다. workflow_dispatch 이벤트 구성에 대한 자세한 내용은 "워크플로를 트리거하는 이벤트"을 참조하세요.

해당 단계를 수행하려면 리포지토리에 대한 쓰기 권한이 필요합니다.

워크플로 실행

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 작업을 클릭합니다.

    "github/docs" 리포지토리의 탭 스크린샷. "작업" 탭은 주황색 윤곽선으로 강조 표시됩니다.

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

    "작업" 페이지의 스크린샷. 왼쪽 사이드바에서 워크플로 이름은 진한 주황색 윤곽선으로 강조 표시됩니다.

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

    참고: 워크플로** 실행 버튼을 보려면 **워크플로 파일이 workflow_dispatch 이벤트 트리거를 사용해야 합니다. workflow_dispatch 이벤트 트리거를 사용하는 워크플로 파일만 워크플로 실행 단추를 사용하여 워크플로를 수동으로 실행하는 옵션이 있습니다. workflow_dispatch 이벤트 구성에 대한 자세한 내용은 "워크플로를 트리거하는 이벤트"을 참조하세요.

    워크플로 페이지의 스크린샷. 워크플로 실행 목록 위에는 "워크플로 실행"이라는 레이블이 지정된 단추가 진한 주황색으로 표시됩니다.

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

  6. 워크플로에 입력이 필요한 경우 필드를 입력합니다.

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

GitHub CLI에 대한 자세한 내용은 "GitHub CLI 정보.

워크플로를 실행하려면 workflow run 하위 명령을 사용합니다. workflow 매개 변수를 실행할 워크플로의 이름, ID 또는 파일 이름으로 바꿉니다. 예를 들어 "Link Checker", 1234567 또는 "link-check-test.yml"입니다. 워크플로를 지정하지 않으면 GitHub CLI에서 워크플로를 선택할 수 있는 대화형 메뉴를 반환합니다.

gh workflow run WORKFLOW

워크플로에서 입력을 수락하면 GitHub CLI에서 입력하라는 메시지가 표시됩니다. 또는 -f 또는 -F를 사용하여 key=value 형식에 입력을 추가할 수 있습니다. -F를 사용하여 파일에서 읽습니다.

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

표준 입력을 사용하여 입력을 JSON으로 전달할 수도 있습니다.

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

리포지토리의 기본 분기가 아닌 분기에서 워크플로를 실행하려면 --ref 플래그를 사용합니다.

gh workflow run WORKFLOW --ref BRANCH

워크플로 실행의 진행률을 보려면 run watch 하위 명령을 사용하고 대화형 목록에서 실행을 선택합니다.

gh run watch

REST API를 사용하여 워크플로 실행

REST API를 사용하는 경우 inputsref를 요청 본문 매개 변수로 구성합니다. 입력을 생략하면 워크플로 파일에 정의된 기본값이 사용됩니다.

참고: workflow_dispatch 이벤트에 대해 최대 10개의 inputs을 정의할 수 있습니다.

REST API 사용에 대한 자세한 정보는 "워크플로에 대한 REST API 엔드포인트"을(를) 참조하세요.