디버그 로깅 활성화하기
디버그 로깅 활성화하기
워크플로우 로그로 워크플로우, 작업, 단계가 예상대로 작동하지 않는 이유를 진단하기에 충분하지 않다면, 추가 디버그 로깅을 활성화할 수 있어요.
출처: 문서
본문
워크플로우 로그로 워크플로우, 작업, 단계가 예상대로 작동하지 않는 이유를 진단하기에 충분하지 않다면, 추가 디버그 로깅을 활성화할 수 있어요.
이 추가 로그는 워크플로우가 포함된 저장소에서 시크릿(secret) 또는 변수(variable)를 설정해 활성화되므로, 동일한 권한 요구 사항이 적용됩니다:
- 조직 저장소의 GitHub에서 시크릿 또는 변수를 만들려면
write권한이 있어야 해요. 개인 계정 저장소에서는 저장소 협업자여야 합니다. - 개인 계정 저장소의 환경(environment)에 대한 시크릿 또는 변수를 만들려면 저장소 소유자여야 해요. 조직 저장소의 환경에 대한 시크릿 또는 변수를 만들려면
admin권한이 있어야 합니다. 환경에 대한 자세한 내용은 Managing environments for deployment를 참고하세요. - 조직 소유자는 조직 수준에서 시크릿 또는 변수를 만들 수 있어요.
시크릿과 변수 설정에 대한 자세한 내용은 Using secrets in GitHub Actions와 Store information in variables를 참고하세요.
또한 워크플로우를 실행할 수 있는 권한이 있는 사람이라면 누구나 워크플로우 재실행에 대해 러너 진단 로깅과 단계 디버그 로깅을 활성화할 수 있어요. 자세한 내용은 Re-running workflows and jobs를 참고하세요.
러너 진단 로깅 활성화하기
러너 진단 로깅은 러너가 작업을 어떻게 실행하는지에 대한 정보가 포함된 추가 로그 파일을 제공해요. 로그 아카이브에 두 개의 추가 로그 파일이 추가됩니다:
- 작업을 실행하기 위해 러너를 조정하고 설정하는 방법에 대한 정보가 포함된 러너 프로세스 로그
- 작업 실행을 기록하는 워커 프로세스 로그
- 러너 진단 로깅을 활성화하려면 워크플로우가 포함된 저장소에 다음 시크릿 또는 변수를 설정하세요:
ACTIONS_RUNNER_DEBUG를true로 설정. 시크릿과 변수가 모두 설정된 경우 시크릿의 값이 변수보다 우선해요. - 러너 진단 로그를 다운로드하려면 워크플로우 실행의 로그 아카이브를 다운로드하세요. 러너 진단 로그는
runner-diagnostic-logs폴더에 포함되어 있어요. 로그 다운로드에 대한 자세한 내용은 Using workflow run logs를 참고하세요.
단계 디버그 로깅 활성화하기
단계 디버그 로깅은 작업 실행 중과 후에 작업 로그의 상세 수준을 높여줘요.
- 단계 디버그 로깅을 활성화하려면 워크플로우가 포함된 저장소에 다음 시크릿 또는 변수를 설정하세요:
ACTIONS_STEP_DEBUG를true로 설정. 시크릿과 변수가 모두 설정된 경우 시크릿의 값이 변수보다 우선해요. - 시크릿 또는 변수를 설정한 후 단계 로그에 더 많은 디버그 이벤트가 표시됩니다. 자세한 내용은 Using workflow run logs를 참고하세요.
또한 runner.debug 컨텍스트를 사용해 디버그 로깅이 활성화된 경우에만 단계가 실행되도록 조건부로 설정할 수 있어요. 자세한 내용은 Contexts reference를 참고하세요.