GitHub Actions CI/CD

# GitHub Actions CI/CD 가이드

## 학습 목표
GitHub Actions로 자동화된 CI/CD 파이프라인을 구축합니다.

## 1. GitHub Actions란?
GitHub에서 제공하는 자동화 CI/CD 플랫폼입니다.
- 코드 푸시 시 자동 빌드/테스트
- PR 자동 검증
- 자동 배포
- 무료 사용량 제공

## 2. Workflow 파일 위치
프로젝트 루트에 .github/workflows/ 디렉토리 생성
YAML 파일로 워크플로우 정의
예: .github/workflows/ci.yml

## 3. 기본 구조
name: CI
on: [push, pull_request]

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node
uses: actions/setup-node@v4
with:
node-version: 20
- run: npm install
- run: npm test

## 4. 트리거 이벤트
Push:
on:
push:
branches: [main, develop]
paths:
- "src/**"

Pull Request:
on:
pull_request:
branches: [main]

스케줄:
on:
schedule:
- cron: "0 9 * * 1-5"

수동 실행:
on: workflow_dispatch

## 5. 환경변수와 시크릿
환경변수:
env:
NODE_ENV: production

jobs:
build:
env:
DATABASE_URL: postgres://localhost/test

시크릿 사용:
steps:
- name: Deploy
env:
API_KEY: ${{ secrets.API_KEY }}
run: ./deploy.sh

## 6. 매트릭스 빌드
strategy:
matrix:
node: [18, 20, 22]
os: [ubuntu-latest, windows-latest]

runs-on: ${{ matrix.os }}
steps:
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node }}

## 7. 캐싱
- name: Cache node modules
uses: actions/cache@v4
with:
path: ~/.npm
key: ${{ runner.os }}-node-${{ hashFiles("**/package-lock.json") }}
restore-keys: |
${{ runner.os }}-node-

## 8. 아티팩트
업로드:
- uses: actions/upload-artifact@v4
with:
name: build
path: dist/

다운로드:
- uses: actions/download-artifact@v4
with:
name: build

## 9. 조건부 실행
if: github.event_name == "push"
if: github.ref == "refs/heads/main"
if: contains(github.event.head_commit.message, "[skip ci]") == false
if: success()
if: failure()
if: always()

## 10. Docker 빌드 및 푸시
- name: Login to Docker Hub
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}

- name: Build and push
uses: docker/build-push-action@v5
with:
push: true
tags: user/app:latest

## 11. 배포 예시
Vercel:
- uses: amondnet/vercel-action@v25
with:
vercel-token: ${{ secrets.VERCEL_TOKEN }}
vercel-org-id: ${{ secrets.ORG_ID }}
vercel-project-id: ${{ secrets.PROJECT_ID }}
vercel-args: "--prod"

SSH 배포:
- name: Deploy via SSH
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.SSH_KEY }}
script: |
cd /var/www/app
git pull
npm install
pm2 restart all

## 12. 재사용 가능 워크플로우
.github/workflows/reusable.yml:
on:
workflow_call:
inputs:
environment:
required: true
type: string

호출:
jobs:
deploy:
uses: ./.github/workflows/reusable.yml
with:
environment: production

## 추천 학습 순서
1. 기본 워크플로우 작성
2. 트리거와 조건 이해
3. 캐싱으로 속도 개선
4. 배포 자동화
5. 재사용 워크플로우