GitHub Actions로 CI 자동화하기
작업 절차 / github-actions-ci.html
push할 때마다 자동으로 테스트를 돌리는 기본 CI 워크플로를 만드는 절차입니다.
💬 push마다 자동으로 검사하게 하면, 깨진 코드가 합쳐지는 일을 줄일 수 있습니다.
작업 전 준비
- 저장소에 push 권한이 있어야 합니다.
- 테스트 명령이 로컬에서 먼저 성공해야 합니다.
실행 순서
# 1) 워크플로 폴더 생성
mkdir -p .github/workflows
# 2) 파일 작성 후
git add .github/workflows/ci.yml
git commit -m "ci: add CI workflow"
git push
워크플로 예시 (Node.js)
name: CI
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: 20, cache: npm }
- run: npm ci
- run: npm test
결과 확인
- 저장소 상단 Actions 탭에서 각 실행의 성공/실패를 봅니다.
- 실패한 단계를 펼치면 로그를 볼 수 있습니다.
오류 발생 시 대응
- npm ci 실패: lock 파일(package-lock.json)이 커밋됐는지 확인하세요.
- 테스트만 실패: 로그의 마지막 명령을 로컬에서 그대로 실행해 재현하세요.
출처
- 공식 문서 GitHub Actions docs — 공식 문서
- GitHub actions/checkout — 공식 액션
검증일은 자료의 최신성을 나타냅니다. 오래된 자료는 적용 조건을 확인하세요.