--- name: github-actions-logs description: > GitHub Actions 워크플로우 로그를 조회하고 분석합니다. "CI 로그 확인해줘", "워크플로우 실패 원인 분석해줘", "GitHub Actions 상태 알려줘", "빌드 로그 보여줘", "테스트 실패 로그 확인" 등을 요청할 때 활성화됩니다. --- # GitHub Actions 로그 조회 스킬 ## 개요 이 스킬은 GitHub Actions 워크플로우의 로그를 조회하고 분석하는 방법을 제공합니다. CI\/CD 파이프라인의 실패 원인을 빠르게 파악하고, 문제를 해결하는 데 도움을 줍니다. ## 실행 조건 다음과 같은 요청 시 이 스킬이 활성화됩니다: - "CI 로그 확인해줘" - "워크플로우 실패 원인 분석해줘" - "GitHub Actions 상태 알려줘" - "빌드 로그 보여줘" - "테스트 실패 로그 확인" - "CI 왜 실패했어?" ## 사전 조건 - GitHub CLI (`gh`)가 설치되어 있어야 합니다 (SessionStart hook에서 자동 설치) - `GITHUB_TOKEN` 또는 `GH_TOKEN` 환경 변수가 설정되어 있어야 합니다 - Git 저장소가 GitHub에 연결되어 있어야 합니다 ## 중요: 프록시 환경 지원 SessionStart hook이 자동으로 `gh.repo` git config를 설정합니다. **모든 `gh` 명령어는 다음과 같이 실행해야 합니다:** ```bash GH_REPO=$(git config --get gh.repo) gh <명령어> ``` 예시: ```bash GH_REPO=$(git config --get gh.repo) gh run list --limit 5 ``` ## 사용 가능한 명령어 ### 1. 최근 워크플로우 실행 목록 조회 ```bash gh run list --limit 10 ``` 출력 예시: ``` STATUS TITLE WORKFLOW BRANCH EVENT ID ELAPSED AGE ✓ fix: update deps CI main push 1234567890 2m30s 5m ✗ feat: new feature CI dev push 1234567889 1m45s 10m ``` ### 2. 특정 워크플로우 실행 상세 정보 조회 ```bash gh run view ``` 또는 최근 실패한 워크플로우: ```bash gh run view $(gh run list --status failure --limit 1 --json databaseId --jq '.[0].databaseId') ``` ### 3. 워크플로우 Jobs 목록 조회 ```bash gh run view --json jobs --jq '.jobs[] | {name: .name, status: .status, conclusion: .conclusion}' ``` ### 4. 실패한 Job의 로그 조회 ```bash gh run view --log-failed ``` 이 명령은 실패한 step의 로그만 출력합니다. ### 5. 전체 로그 조회 ```bash gh run view --log ``` 주의: 전체 로그는 매우 길 수 있습니다. ### 6. 특정 Job의 로그만 조회 ```bash gh run view --job --log ``` ### 7. 현재 커밋의 워크플로우 상태 확인 ```bash # 현재 HEAD 커밋의 워크플로우 조회 COMMIT_SHA=$(git rev-parse HEAD) gh api "repos\/{owner}\/{repo}\/actions\/runs?head_sha=$COMMIT_SHA" --jq '.workflow_runs[] | {name: .name, status: .status, conclusion: .conclusion, url: .html_url}' ``` ## 문제 해결 가이드 ### 워크플로우가 실패했을 때 1. **실패한 워크플로우 확인** ```bash gh run list --status failure --limit 5 ``` 2. **실패 원인 분석** ```bash gh run view --log-failed ``` 3. **상세 로그 확인** (필요한 경우) ```bash gh run view --log ``` ### 일반적인 실패 원인 #### 테스트 실패 - 로그에서 `FAIL`, `Error`, `AssertionError` 등을 검색 - 실패한 테스트 케이스 이름 확인 - 예상값과 실제값 비교 #### 빌드 실패 - 컴파일 에러 메시지 확인 - 의존성 설치 실패 여부 확인 - Node.js\/Python 버전 호환성 확인 #### 린트 실패 - ESLint, Prettier 등의 에러 메시지 확인 - 자동 수정 가능 여부: `npm run lint:fix` #### 타임아웃 - 워크플로우 실행 시간 확인 - 무한 루프나 느린 테스트 확인 ## API를 통한 상세 조회 ### 워크플로우 실행 정보 ```bash gh api repos\/{owner}\/{repo}\/actions\/runs\/{run_id} ``` ### Jobs 목록 ```bash gh api repos\/{owner}\/{repo}\/actions\/runs\/{run_id}\/jobs ``` ### Job 로그 다운로드 ```bash gh api repos\/{owner}\/{repo}\/actions\/jobs\/{job_id}\/logs ``` ## 예시 시나리오 ### 시나리오 1: CI가 실패했을 때 원인 파악 ```bash # 1. 최근 실패한 워크플로우 확인 gh run list --status failure --limit 1 # 2. 실패 로그 확인 gh run view --log-failed # 3. 실패한 step 분석 # 로그에서 에러 메시지를 찾아 원인 파악 ``` ### 시나리오 2: 특정 커밋의 CI 상태 확인 ```bash # 현재 커밋의 워크플로우 상태 COMMIT=$(git rev-parse HEAD) gh run list --commit $COMMIT ``` ### 시나리오 3: 워크플로우 재실행 ```bash # 실패한 워크플로우 재실행 gh run rerun # 실패한 job만 재실행 gh run rerun --failed ``` ## 출력 형식 ### JSON 출력 (스크립트용) ```bash gh run list --json status,conclusion,name,databaseId --limit 5 ``` ### 필터링된 출력 ```bash gh run list --json status,name --jq '.[] | select(.status == "failure") | .name' ``` ## 주의사항 1. **토큰 권한**: `repo` 및 `actions:read` 권한이 필요합니다 2. **API 제한**: GitHub API에는 rate limit이 있으므로 과도한 요청을 피하세요 3. **로그 크기**: 전체 로그는 매우 클 수 있으므로 `--log-failed` 옵션을 우선 사용하세요 4. **비공개 저장소**: 적절한 인증이 필요합니다