워크플로우 수동 실행하기

워크플로우 수동 실행하기

워크플로우가 workflow_dispatch 이벤트에서 실행되도록 구성된 경우, GitHub의 Actions 탭, GitHub CLI 또는 REST API를 사용해 워크플로우를 실행할 수 있어요.

출처: 문서

본문

워크플로우가 workflow_dispatch 이벤트에서 실행되도록 구성된 경우, GitHub의 Actions 탭, GitHub CLI 또는 REST API를 사용해 워크플로우를 실행할 수 있어요.

수동 실행을 위한 워크플로우 구성

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

workflow_dispatch 이벤트를 트리거하려면 워크플로우가 기본 브랜치에 있어야 해요. workflow_dispatch 이벤트 구성에 대한 자세한 내용은 Events that trigger workflows를 참고하세요.

이 단계를 수행하려면 저장소에 대한 쓰기 권한이 필요합니다.

워크플로우 실행하기

  1. GitHub에서 저장소의 메인 페이지로 이동하세요.

  2. 저장소 이름 아래에서 Actions을 클릭하세요.

    Screenshot of the tabs for the "github/docs" repository. The "Actions" tab is highlighted with an orange outline.

  3. 왼쪽 사이드바에서 실행하려는 워크플로우의 이름을 클릭하세요.

    Screenshot of the "Actions" page. In the left sidebar, a workflow name is highlighted with an outline in dark orange.

  4. 워크플로우 실행 목록 위에서 Run workflow 버튼을 클릭하세요.

    [!NOTE] Run workflow 버튼을 보려면 워크플로우 파일이 workflow_dispatch 이벤트 트리거를 사용해야 해요. workflow_dispatch 이벤트 트리거를 사용하는 워크플로우 파일만 Run workflow 버튼으로 워크플로우를 수동으로 실행할 수 있어요. workflow_dispatch 이벤트 구성에 대한 자세한 내용은 Events that trigger workflows를 참고하세요.

    Screenshot of a workflow page. Above the list of workflow runs, a button, labeled "Run workflow", is outlined in dark orange.

  5. Branch 드롭다운 메뉴를 선택하고 워크플로우를 실행할 브랜치를 클릭하세요.

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

  7. Run workflow를 클릭하세요.

[!NOTE] GitHub CLI에 대해 더 자세히 알아보려면 About 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 [email protected]

표준 입력을 사용해 입력을 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를 사용할 때는 inputs와 ref를 요청 본문 매개변수로 구성해요. 입력을 생략하면 워크플로우 파일에 정의된 기본값이 사용됩니다.

[!NOTE] workflow_dispatch 이벤트에 최대 25개의 inputs를 정의할 수 있어요.

REST API 사용에 대한 자세한 내용은 REST API endpoints for workflows를 참고하세요.

더 알아보기 (Learn more)