Skip to main content

디버그 로깅 사용

워크플로 로그가 워크플로, 작업 또는 단계가 예상대로 작동하지 않는 이유를 진단하기에 충분한 세부 정보를 제공하지 않는 경우 추가 디버그 로깅을 사용하도록 설정할 수 있습니다.

워크플로가 포함된 리포지토리에서 비밀 또는 변수를 설정하면 추가 로그를 사용할 수 있으므로 동일한 권한 요구 사항이 적용됩니다.

  • 리포지토리 소유자만 개인 계정 리포지토리의 GitHub에 비밀 또는 변수를 만들 수 있습니다. admin 액세스 권한이 있는 사용자만 조직 리포지토리에 대한 에 비밀 또는 변수를 만들 수 있습니다. 마지막으로, 협력자 액세스 권한이 있는 사용자만 REST API를 통해 개인 계정 리포지토리 또는 조직 리포지토리에 대한 비밀 또는 변수를 만들 수 있습니다.
  • 개인 계정 리포지토리에서 환경에 대한 비밀 또는 변수를 만들려면 리포지토리 소유자여야 합니다. 조직 리포지토리에서 환경에 대한 비밀 또는 변수를 만들려면 admin 액세스 권한이 있어야 합니다. 환경에 대한 자세한 내용은 "배포에 환경 사용"을 참조하세요.
  • 조직 소유자 및 "조직 작업 변수 관리" 또는 "조직 작업 비밀 관리" 권한을 가진 사용자는 조직 수준에서 비밀 또는 변수를 만들 수 있습니다.

자세한 내용은 "사용자 지정 조직 역할 소개"을 참조하세요.

비밀 및 변수 설정에 대한 자세한 내용은 "GitHub Actions에서 비밀 사용" 및 "variables" 섹션을 참조하세요.

또한 워크플로를 실행할 수 있는 액세스 권한이 있는 사용자는 누구나 실행기 진단 로깅을 사용하도록 설정하고 워크플로를 다시 실행하기 위한 디버그 로깅을 단계별로 실행할 수 있습니다. 자세한 정보는 "워크플로 및 작업 다시 실행"을(를) 참조하세요.

실행기 진단 로깅 사용

실행기 진단 로깅은 실행기의 작업 실행 현황에 대한 정보가 포함된 추가 로그 파일을 제공합니다. 다음 두 개의 로그 파일이 로그 보관 파일에 추가됩니다.

  • 실행기 프로세스 로그 - 작업을 실행할 실행기를 조정하고 설정하는 방법에 대한 정보가 포함됩니다.
  • 작업자 프로세스 로그 - 작업 실행을 로깅합니다.
  1. 실행기 진단 로깅을 사용하도록 설정하려면 워크플로가 포함된 리포지토리에서 다음 비밀 또는 변수를 설정합니다(ACTIONS_RUNNER_DEBUGtrue로 설정함). 비밀과 변수가 모두 설정된 경우 비밀 값이 변수보다 우선합니다.
  2. 실행기 진단 로그를 다운로드하려면 워크플로 실행의 로그 보관 파일을 다운로드합니다. 실행기 진단 로그는 runner-diagnostic-logs 폴더에 포함됩니다. 로그 다운로드 방법에 대한 자세한 내용은 "워크플로 실행 로그 사용"을(를) 참조하세요.

단계 디버그 로깅 사용

단계 디버그 로깅은 작업 실행 중 및 실행 후 작업 로그의 세부 정보 표시를 늘립니다.

  1. 단계 디버그 로깅을 사용하도록 설정하려면 워크플로가 포함된 리포지토리에서 다음 비밀 또는 변수를 설정합니다(ACTIONS_STEP_DEBUGtrue로 설정함). 비밀과 변수가 모두 설정된 경우 비밀 값이 변수보다 우선합니다.
  2. 비밀 또는 변수를 설정하면 더 많은 디버그 이벤트가 단계 로그에 표시됩니다. 자세한 내용은 "워크플로 실행 로그 사용"을(를) 참조하세요.