워크플로 및 작업 다시 실행

워크플로 실행, 워크플로 실행에서 실패한 모든 작업 또는 워크플로 실행의 특정 작업을 처음 실행한 후 최대 30일 후에 다시 실행할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

People with write permissions to a repository can re-run workflows in the repository.

Tool navigation

이 문서의 내용

참고: GitHub 호스트 실행기는 현재 GitHub Enterprise Server에서 지원되지 않습니다. GitHub public roadmap에 예정된 향후 지원에 대해 자세히 알아볼 수 있습니다.

워크플로 및 작업 다시 실행 정보

워크플로 또는 워크플로의 작업의 다시 실행은 워크플로 실행을 트리거한 원래 이벤트의 동일한 GITHUB_SHA(커밋 SHA) 및 GITHUB_REF(Git ref)를 사용합니다. 워크플로는 다시 실행을 시작한 행위자의 권한이 아니라 처음에 워크플로를 트리거한 행위자의 권한을 사용합니다. 처음 실행하고 최대 30일 후에 워크플로 또는 워크플로의 작업을 다시 실행할 수 있습니다. 로그가 보존 한도를 초과하면 워크플로에서 작업을 다시 실행할 수 없습니다. 자세한 내용은 "사용 제한, 청구, 관리"을(를) 참조하세요. 워크플로 또는 워크플로 내 작업을 재실행할 때, 재실행을 위한 디버그 로깅을 사용하도록 설정할 수 있습니다. 이렇게 하면 다시 실행에 대한 실행기 진단 로깅 및 단계 디버그 로깅이 사용하도록 설정됩니다. 디버그 로깅에 대한 자세한 내용은 "디버그 로깅 사용"을(를) 참조하세요.

워크플로에서 모든 작업 다시 실행

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

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

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

  3. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다.

    "작업" 탭의 왼쪽 사이드바 스크린샷. "CodeQL"이라는 워크플로가 진한 주황색 윤곽선으로 표시되어 있습니다.

  4. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

  5. 워크플로의 오른쪽 위 모서리에서 작업을 다시 실행합니다.

    • 작업이 실패한 경우 작업 다시 실행 드롭다운 메뉴를 선택하고 모든 작업 다시 실행을 클릭합니다.

    • 실패한 작업이 없으면 모든 작업 다시 실행을 클릭합니다.

  6. 필요에 따라 다시 실행하기 위해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 디버그 로깅 사용을 선택합니다.

  7. 작업 다시 실행을 클릭합니다.

Dependabot alerts의 자세한 내용은 “GitHub CLI 정보”를 참조하세요.

실패한 워크플로 실행을 다시 실행하려면 run rerun 하위 명령을 사용합니다. run-id를 다시 실행하려는 실패한 실행의 ID로 바꿉니다. run-id를 지정하지 않으면 GitHub CLI가 최근 실패한 실행을 선택할 수 있는 대화형 메뉴를 반환합니다.

gh run rerun RUN_ID

다시 실행에 대해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 --debug 플래그를 사용합니다.

gh run rerun RUN_ID --debug

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

gh run watch

워크플로에서 실패한 작업 다시 실행

워크플로 실행의 작업이 실패한 경우 실패한 작업만 다시 실행할 수 있습니다. 워크플로에서 실패한 작업을 다시 실행하면 실패한 모든 작업 및 해당 종속 작업에 대해 새 워크플로 실행이 시작됩니다. 이전 워크플로 실행에서 성공한 작업에 대한 모든 출력은 다시 실행에 사용됩니다. 초기 실행에서 만든 모든 아티팩트가 다시 실행될 때 사용할 수 있습니다. 이전 실행에서 전달된 모든 환경 보호 규칙은 다시 실행으로 자동 전달됩니다.

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

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

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

  3. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다.

    "작업" 탭의 왼쪽 사이드바 스크린샷. "CodeQL"이라는 워크플로가 진한 주황색 윤곽선으로 표시되어 있습니다.

  4. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

  5. 워크플로의 오른쪽 위 모서리에서 작업 다시 실행 드롭다운 메뉴를 선택하고 실패한 작업 다시 실행을 클릭합니다.

  6. 필요에 따라 다시 실행하기 위해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 디버그 로깅 사용을 선택합니다.

  7. 작업 다시 실행을 클릭합니다.

워크플로 실행에서 실패한 작업을 다시 실행하려면 --failed 플래그와 함께 run rerun 하위 명령을 사용합니다. run-id를 실패한 작업을 다시 실행하려는 실행의 ID로 바꿉니다. run-id를 지정하지 않으면 GitHub CLI가 최근 실패한 실행을 선택할 수 있는 대화형 메뉴를 반환합니다.

gh run rerun RUN_ID --failed

다시 실행에 대해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 --debug 플래그를 사용합니다.

gh run rerun RUN_ID --failed --debug

워크플로에서 특정 작업 다시 실행

워크플로에서 특정 작업을 다시 실행하면 작업 및 종속 항목에 대해 새 워크플로 실행이 시작됩니다. 이전 워크플로 실행의 다른 작업에 대한 출력은 다시 실행에 사용됩니다. 초기 실행에서 만든 모든 아티팩트가 다시 실행될 때 사용할 수 있습니다. 이전 실행에서 전달된 모든 환경 보호 규칙은 다시 실행으로 자동 전달됩니다.

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

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

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

  3. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다.

    "작업" 탭의 왼쪽 사이드바 스크린샷. "CodeQL"이라는 워크플로가 진한 주황색 윤곽선으로 표시되어 있습니다.

  4. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

  5. 왼쪽 사이드바의 '작업' 섹션에서 다시 실행하려는 작업 옆에 있는 아이콘을 클릭합니다.

  6. 필요에 따라 다시 실행하기 위해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 디버그 로깅 사용을 선택합니다.

  7. 작업 다시 실행을 클릭합니다.

워크플로 실행에서 특정 작업을 다시 실행하려면 --job 플래그와 함께 run rerun 하위 명령을 사용합니다. job-id를 다시 실행하려는 작업의 ID로 바꿉니다.

gh run rerun --job JOB_ID

다시 실행에 대해 실행기 진단 로깅 및 단계 디버그 로깅을 사용하도록 설정하려면 --debug 플래그를 사용합니다.

gh run rerun --job JOB_ID --debug

재사용 가능한 워크플로를 사용하여 워크플로 및 작업 다시 실행

퍼블릭 리포지토리에서 재사용 가능한 워크플로는 SHA, 릴리스 태그 또는 분기 이름을 사용하여 참조할 수 있습니다. 자세한 내용은 "워크플로 다시 사용"을(를) 참조하세요.

재사용 가능한 워크플로를 사용하는 워크플로를 다시 실행했으며 참조가 SHA가 아닌 경우 다음과 같은 몇 가지 동작을 주의해야 합니다.

  • 워크플로에서 모든 작업을 다시 실행하면 지정된 참조에서 재사용 가능한 워크플로가 사용됩니다. 워크플로의 모든 작업을 다시 실행하는 방법에 대한 자세한 내용은 "워크플로 및 작업 다시 실행"을 참조하세요.
  • 실패한 작업 또는 워크플로의 특정 작업을 다시 실행하면 첫 번째 시도와 동일한 커밋 SHA에서 재사용 가능한 워크플로가 사용됩니다. 워크플로에서 실패한 작업을 다시 실행하는 방법에 대한 자세한 내용은 "워크플로 및 작업 다시 실행"을 참조하세요. 워크플로에서 특정 작업을 다시 실행하는 방법에 대한 자세한 내용은 "워크플로 및 작업 다시 실행"을 참조하세요.

이전 워크플로 실행 검토

워크플로를 실행할 때 이전 시도의 결과를 볼 수 있습니다. API를 사용하여 이전 워크플로 실행을 볼 수도 있습니다. 자세한 내용은 "워크플로 실행에 대한 REST API 엔드포인트"을(를) 참조하세요.

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

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

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

  3. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다.

    "작업" 탭의 왼쪽 사이드바 스크린샷. "CodeQL"이라는 워크플로가 진한 주황색 윤곽선으로 표시되어 있습니다.

  4. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

  5. 실행 이름 오른쪽에서 최신 드롭다운 메뉴를 선택하고 이전 실행 시도를 클릭합니다.