English

GitHub Actions로 CI 자동화하기

작업 절차 / github-actions-ci.html

procedures환경: GitHub 저장소, Node 또는 Python 프로젝트검증: 2026-10-19

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)이 커밋됐는지 확인하세요.
  • 테스트만 실패: 로그의 마지막 명령을 로컬에서 그대로 실행해 재현하세요.

출처

검증일은 자료의 최신성을 나타냅니다. 오래된 자료는 적용 조건을 확인하세요.