GitHub Actions는 「코드 푸시·PR 시 자동으로 테스트·빌드·배포」를 실행하는 GitHub 내장 CI/CD입니다.

파이썬 프로젝트의 사실상 표준.

기본 구조.

.github/workflows/test.yml에 YAML로 워크플로 정의.

on: [push, pull_request]로 트리거.

jobs.test.runs-on: ubuntu-latest.

steps에 actions/checkout, setup-python, pip install, pytest 같은 단계 나열.

최소 예시.

- uses: actions/checkout@v4 / - uses: actions/setup-python@v5 with python-version: "3.11" / - run: pip install -r requirements.txt / - run: pytest.

세 단계로 매 커밋마다 테스트 자동.

매트릭스 빌드.

strategy.matrix: python-version: ["3.9", "3.10", "3.11", "3.12"].

한 워크플로가 자동으로 4개 버전에서 테스트.

라이브러리 호환성 검증의 표준 패턴.

추가 가능한 단계.

1) 캐시 — pip 캐시로 시간 단축.

2) 커버리지 — codecov 업로드.

3) 빌드 — wheel 만들기.

4) 자동 배포 — main 브랜치 머지 시 PyPI 업로드(twine + 토큰).

5) 알림 — 슬랙·디스코드.

한 파일에 다 표현 가능.

한 줄 요약

GitHub Actions는 푸시·PR 자동 CI/CD.

setup-python + pytest 3줄로 시작, 매트릭스로 다중 버전 테스트, 캐시·배포·알림까지 한 YAML에.

사실상 표준.

더 알아볼 것

- actions/cache로 pip 캐시

- secrets 관리

- reusable workflow