Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

워크플로 실행 로그 사용

워크플로 실행의 각 작업에 대한 로그를 보고, 검색하고, 다운로드할 수 있습니다.

워크플로 실행 페이지에서 워크플로 실행이 진행 중인지 아니면 완료되었는지 확인할 수 있습니다. 퍼블릭 리포지토리를 포함하여 워크플로 실행 정보를 보려면 GitHub 계정에 로그인해야 합니다. 자세한 내용은 “GitHub 대한 액세스 권한”을 참조하세요.

실행이 완료되면 결과가 성공, 실패, 취소 또는 중립인지 확인할 수 있습니다. 실행이 실패한 경우 빌드 로그를 보고 검색하여 실패를 진단하고 워크플로를 다시 실행할 수 있습니다. 청구 가능한 작업 실행 시간(분)을 보거나 로그를 다운로드하고 아티팩트를 빌드할 수도 있습니다.

GitHub Actions는 Checks API를 사용하여 워크플로의 상태, 결과, 로그를 출력합니다. GitHub는 각 워크플로 실행에 대한 새 검사 도구 모음을 만듭니다. 확인 도구 모음에는 워크플로의 각 작업에 대한 검사 실행이 포함되며 각 작업에는 여러 단계가 포함됩니다. GitHub Actions는 워크플로의 한 단계로 실행됩니다. Checks API에 대한 자세한 내용은 “검사”를 참조하세요.

참고: 리포지토리에 유효한 워크플로 파일만 커밋해야 합니다. .github/workflows에 잘못된 워크플로 파일이 포함된 경우 GitHub Actions는 모든 새 커밋에 대해 실패한 워크플로 실행을 생성합니다.

로그 확인을 통한 실패 진단

워크플로 실행이 실패하는 경우 실패가 발생한 단계를 확인하고 실패한 단계의 빌드 로그를 검토하여 문제를 해결할 수 있습니다. 각 단계를 실행하는 데 걸린 시간을 확인할 수 있습니다. 로그 파일의 특정 줄에 permalink를 복사하여 팀과 공유할 수도 있습니다. 해당 단계를 수행하려면 리포지토리에 대한 읽기 권한이 필요합니다.

워크플로 파일에 구성된 단계 외에도 GitHub는 각 작업에 두 단계를 추가하여 작업 실행을 설정하고 완료합니다. 단계는 “작업 설정” 및 “작업 완료”라는 이름으로 워크플로 실행에 기록됩니다.

GitHub에서 호스트되는 실행기에서 실행되는 작업의 경우 “작업 설정”은 실행기의 이미지에 대한 세부 정보를 기록하고 실행기 컴퓨터에 있던 사전 설치된 도구 목록 링크를 포함합니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 이름 아래에서 Actions를 클릭합니다. 기본 리포지토리 탐색의 작업 탭 1. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다. 왼쪽 사이드바의 워크플로 목록 1. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

    워크플로 실행의 이름 1. 작업 또는 시각화 그래프에서 보려는 작업을 클릭합니다.

    린트 코드베이스 작업 1. 실패한 단계는 결과를 표시하도록 자동으로 확장됩니다.

    Super Linter 워크플로 결과 1. 필요에 따라 로그의 특정 줄에 대한 링크를 얻으려면 단계의 줄 번호를 클릭합니다. 그런 다음 웹 브라우저의 주소 표시줄에서 링크를 복사할 수 있습니다.

    링크 복사 단추

로그 검색

특정 단계에 대한 빌드 로그를 검색할 수 있습니다. 로그를 검색하면 확장된 단계만 결과에 포함됩니다. 해당 단계를 수행하려면 리포지토리에 대한 읽기 권한이 필요합니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 이름 아래에서 Actions를 클릭합니다. 기본 리포지토리 탐색의 작업 탭 1. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다. 왼쪽 사이드바의 워크플로 목록 1. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

    워크플로 실행의 이름 1. 작업 또는 시각화 그래프에서 보려는 작업을 클릭합니다.

    린트 코드베이스 작업

  2. 로그 출력의 오른쪽 상단의 검색 로그 검색 상자에 검색 쿼리를 입력합니다. 로그를 검색하는 검색 상자

로그 다운로드

워크플로 실행에서 로그 파일을 다운로드할 수 있습니다. 워크플로의 아티팩트를 다운로드할 수도 있습니다. 자세한 내용은 “아티팩트를 사용하여 워크플로 데이터 유지”를 참조하세요. 해당 단계를 수행하려면 리포지토리에 대한 읽기 권한이 필요합니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 이름 아래에서 Actions를 클릭합니다. 기본 리포지토리 탐색의 작업 탭 1. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다. 왼쪽 사이드바의 워크플로 목록 1. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

    워크플로 실행의 이름 1. 작업 또는 시각화 그래프에서 보려는 작업을 클릭합니다.

    린트 코드베이스 작업

  2. 오른쪽 상단의 아이콘을 클릭하고 로그 보관 계층 다운로드를 선택합니다.

    로그 다운로드 드롭다운 메뉴

참고: 부분적으로 다시 실행된 워크플로에 대한 로그 보관 계층을 다운로드하는 경우 보관 계층에는 다시 실행된 작업만 포함됩니다. 워크플로에서 실행된 작업에 대한 전체 로그 집합을 가져오려면 다른 작업을 실행한 이전 실행 시도에 대한 로그 보관 계층을 다운로드해야 합니다.

로그 삭제

워크플로 실행에서 로그 파일을 삭제할 수 있습니다. 해당 단계를 수행하려면 리포지토리에 대한 쓰기 권한이 필요합니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 이름 아래에서 Actions를 클릭합니다. 기본 리포지토리 탐색의 작업 탭 1. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다. 왼쪽 사이드바의 워크플로 목록 1. 워크플로 실행 목록에서 실행 이름을 클릭하여 워크플로 실행 요약을 확인합니다.

    워크플로 실행의 이름

  2. 오른쪽 상단의 아이콘을 클릭합니다.

    Kebab 가로 아이콘

  3. 로그 파일을 삭제하려면 모든 로그 삭제 단추를 클릭하고 확인 프롬프트를 검토합니다.

    모든 로그 삭제

로그를 삭제하면 모든 로그 삭제 단추가 사라지며 워크플로 실행에 남아 있는 로그 파일이 없음을 나타냅니다.

GitHub CLI를 사용하여 로그 보기

GitHub CLI에 대한 자세한 내용은 “GitHub CLI 정보”를 참조하세요.

특정 작업에 대한 로그를 보려면 run view 하위 명령을 사용합니다. run-id를 로그를 보려는 실행의 ID로 바꿉니다. GitHub CLI는 실행에서 작업을 선택할 수 있는 대화형 메뉴를 반환합니다. run-id를 지정하지 않으면 GitHub CLI에서 최근 실행을 선택할 수 있는 대화형 메뉴를 반환한 다음 실행에서 작업을 선택할 수 있는 다른 대화형 메뉴를 반환합니다.

gh run view RUN_ID --log

--job 플래그를 사용하여 작업 ID를 지정할 수도 있습니다. job-id를 로그를 보려는 작업의 ID로 바꿉니다.

gh run view --job JOB_ID --log

grep을 사용하여 로그를 검색할 수 있습니다. 예를 들어 이 명령은 error라는 단어를 포함하는 모든 로그 항목을 반환합니다.

gh run view --job JOB_ID --log | grep error

실패한 단계에 대한 로그를 필터링하려면 --log 대신에 --log-failed를 사용합니다.

gh run view --job JOB_ID --log-failed