GitHub Actions 실무 스터디 가이드

1. GitHub Actions란?

GitHub Actions는 GitHub 저장소에 직접 통합된 CI/CD 및 자동화 플랫폼입니다. 이벤트(푸시, PR, 이슈 생성 등)를 트리거로 워크플로우를 실행하며, YAML로 정의된 파이프라인을 통해 빌드, 테스트, 배포 등을 자동화할 수 있습니다.

3대 핵심 능력

2. 왜 써야 하는가?

기존 CI/CD 도구(Jenkins, CircleCI, Travis CI)와 비교했을 때 GitHub Actions의 장점은 명확합니다.

3. 핵심 개념

워크플로우는 YAML로 작성되며, 크게 Workflow, Job, Step, Action, Runner로 구성됩니다.

• Workflow: 자동화 프로세스의 최상위 단위. 하나 이상의 Job으로 구성.
• Job: 동일한 러너에서 실행되는 Step의 집합. 병렬/순차 실행 가능.
• Step: 개별 작업 (액션 실행 또는 셸 명령).
• Action: 재사용 가능한 단위 (마켓플레이스 또는 직접 작성).
• Runner: 워크플로우를 실행하는 서버 (GitHub 호스팅 or 셀프호스팅).

4. 퀵스타트

① 설치 (별도 설치 불필요)

GitHub Actions는 GitHub에 내장되어 있습니다. 저장소에 .github/workflows/ 디렉터리를 만들고 YAML 파일을 추가하기만 하면 됩니다.

② 첫 번째 워크플로우 예제 (Python)

저장소 루트에 .github/workflows/ci.yml 파일 생성:

name: Python CI
on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.10", "3.11", "3.12"]

    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
      - name: Run tests
        run: pytest tests/ --verbose

③ CLI로 워크플로우 상태 확인

gh CLI를 사용하면 터미널에서 직접 워크플로우를 확인하고 트리거할 수 있습니다.

# 워크플로우 목록 보기
gh run list --limit 5

# 특정 워크플로우 실행 (workflow_dispatch)
gh workflow run ci.yml --ref main

# 최근 실행 상세 보기
gh run view --log

5. 핵심 설정 레퍼런스

더 자세한 옵션은 공식 문서를 참고하세요.

6. 실무 팁 & 트러블슈팅

- uses: actions/setup-python@v5
  with:
    python-version: '3.11'
    cache: 'pip'

추가 팁:

• ✅ actions/cache를 활용하여 pip, npm, Docker 레이어 등을 캐싱하세요.
• ✅ 민감 정보는 Settings → Secrets and variables → Actions에 저장하고 ${{ secrets.SECRET_NAME }}로 참조하세요.
• ✅ 로컬에서 act 툴을 사용하면 워크플로우를 로컬에서 테스트할 수 있습니다.

7. 참고 자료

• GitHub Actions 공식 문서
• GitHub Marketplace – Actions
• 워크플로우 문법 레퍼런스
• act – 로컬 워크플로우 실행 도구
• 보안 강화 가이드