로그가 문제를 해결하기에 충분하지 않은 경우 추가 정보를 얻고 로그를 더 유용하게 만들기 위해 수행할 수 있는 몇 가지 단계가 있습니다.
단계 디버그 로깅 활성화
단계별 디버그 로깅은 실행 중 및 실행 후 작업 로그의 상세 수준을 증가시킵니다.
단계 디버그 로깅을 사용하도록 설정하려면 다음을 수행합니다.
- 워크플로가 포함된 리포지토리에서 다음 비밀 또는 변수
ACTIONS_STEP_DEBUG를true로 설정합니다. 비밀과 변수가 모두 설정된 경우 비밀 값이 변수보다 우선합니다. - 워크플로를 다시 실행하거나 새 실행을 트리거합니다.
비밀 또는 변수를 설정하면 더 많은 디버그 이벤트가 단계 로그에 표시됩니다. 워크플로 실행 로그 사용을(를) 참조하세요.
runner.debug 컨텍스트를 사용하여 디버그 로깅이 활성화되어 있는 경우에만 조건부로 단계를 실행할 수 있습니다.
문맥 참조을(를) 참조하세요.
디버깅 아티팩트 만들기 CodeQL
경고
CodeQL 디버깅 아티팩트에서는 분석 CodeQL중인 소스 코드의 복사본을 포함하므로 이러한 번들을 해당 소스 코드에 액세스할 권한이 있는 사용자와만 공유하는 것이 좋습니다.
디버그 CodeQL하는 데 도움이 되는 아티팩트도 가져올 수 있습니다.
디버그 아티팩트가 워크플로 실행 시 이름이 로 시작하는 debug-artifacts아티팩트로 업로드됩니다. 워크플로 실행의 일부로 여러 언어를 동시에 분석하는 경우 CodeQL 모든 언어에 대해 하나의 아티팩트가 있습니다. 데이터에는 CodeQL 로그, CodeQL 데이터베이스, 추출된 소스 코드 파일 및 워크플로에서 생성된 모든 SARIF 파일이 포함됩니다. 아티팩트 다운로드에 대한 자세한 내용은 CodeQL을 참조하세요.
이러한 아티팩트는 CodeQLcode scanning의 문제를 디버그하는 데 도움이 됩니다. GitHub 지원에 연락하면 이 데이터를 요청할 수 있습니다.
기본 설정에 대한 CodeQL 디버깅 아티팩트 만들기 CodeQL
CodeQL 디버깅 아티팩트는 단계 디버그 로깅을 사용 설정하고(단계 디버그 로깅 사용 설정 참조) 예를 들어 끌어오기 요청 브랜치에 새 커밋을 푸시하여 새 CodeQL 분석을 시작하면 만들 수 있습니다.
프라이빗 레지스트리에 대한 액세스 권한을 부여 CodeQL 한 경우 이름이 시작되는 proxy-log-file 추가 아티팩트가 제공됩니다. 여기에는 기본 설정에서 프라이빗 레지스트리에 CodeQL 대한 요청을 인증하는 데 사용되며 프라이빗 레지스트리 구성 문제를 해결하는 데 사용할 수 있는 인증 프록시의 로그가 포함됩니다. 자세한 내용은 프라이빗 레지스트리에 대한 보안 기능 액세스 부여을(를) 참조하세요.
고급 설치를 위한 CodeQL 디버깅 아티팩트 만들기 CodeQL
고급 설치를 위한 CodeQL 디버깅 아티팩트도 여러 가지 방법으로 얻을 수 있습니다.
디버그 로깅을 사용하도록 설정된 작업 다시 실행
고급 설정에 대한 CodeQL 디버깅 아티팩트 만들기의 가장 쉬운 옵션은 디버그 로깅을 사용하도록 설정된 작업을 다시 실행하는 것입니다. 워크플로 및 작업을 다시 실행하는 GitHub Actions 방법에 대한 자세한 내용은 워크플로 및 작업 다시 실행을 참조하세요.
디버그 로깅 사용을 선택해야 합니다. 이 옵션은 다시 실행에 대한 실행기 진단 로깅 및 단계 디버그 로깅이 사용하도록 설정합니다. 그런 다음 디버깅 아티팩트 다운로드 CodeQL 를 통해 자세히 조사할 수 있습니다. 작업을 다시 실행하여 디버깅 아티팩트 만들기 CodeQL 시 워크플로 파일을 수정할 필요가 없습니다.
워크플로 플래그 사용
워크플로에서 플래그를 사용하여 디버깅 아티팩트를 만들 CodeQL 수 있습니다. 이를 위해 CodeQL 분석 워크플로 파일의 init 단계를 수정하고 debug: true를 설정해야 합니다.
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
GitHub Actions 단계별 디버그 로깅 사용
단계 디버그 로깅 GitHub Actions 을 사용하도록 설정 CodeQL 하면 디버깅 아티팩트도 생성되고 워크플로 실행의 일부로 업로드됩니다. 지침은 단계 디버그 로깅 사용 설정을 참조하세요.