GitHub Actions
GitHub Actions 작업이 실패하면 이벤트·브랜치·실행 권한·Secret 이름·작업 디렉터리·아티팩트 경로를 분리해 로그와 Workflow 파일을 비교해야 합니다.
플랫폼 정의
GitHub Actions는 저장소 이벤트가 발생했을 때 Workflow에 정의한 작업을 실행합니다. 로컬 명령이 성공했더라도 실행 브랜치, 권한, Secret, Node.js 버전과 작업 디렉터리가 다르면 결과가 달라질 수 있습니다.
Workflow 실패 확인
- 실패한 Workflow의 이벤트, 브랜치와 커밋 SHA를 기록합니다.
- 실패한 step의 첫 오류와 실행된 명령을 확인합니다.
${{ secrets.NAME }}의 이름과 저장소·환경 범위를 확인합니다. 값을 로그에 출력하지 않습니다.- 모노리포라면 작업 디렉터리, 설치 경로와 업로드할 산출물 경로를 비교합니다.
Secret 누락은 GitHub Actions Secret 누락 가이드 (새 창에서 열림), 권한 거부는 권한 오류 가이드 (새 창에서 열림)에서 이어서 확인합니다.
관련 구성요소
공식 참고 자료
GitHub Actions 공식 문서 (새 창에서 열림)
최종 검토일: 2026-07-27