2026년 GitHub Actions로 CI/CD 파이프라인 구축하기

• 더 빨라진 러너(Runner): 작년 대비 빌드 속도가 평균 40% 개선됐어요
• AI 기반 오류 추천: 워크플로우 실패 시 자동으로 해결 방법을 제안해줘요
• 향상된 보안: OIDC 기반 인증이 기본값으로 설정돼서 더 안전해졌어요
• 무료 사용량 증가: Public 저장소는 물론이고, Private도 월 3,000분으로 늘었어요

name: CI/CD Pipeline

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install dependencies
        run: npm ci
      
      - name: Run tests
        run: npm test
      
      - name: Build project
        run: npm run build

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run tests
        run: npm test

  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build application
        run: npm run build
      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/

  deploy:
    needs: build
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - name: Download artifacts
        uses: actions/download-artifact@v4
        with:
          name: build-output
      - name: Deploy to production
        run: ./deploy.sh

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      NODE_ENV: production
      API_URL: https://api.example.com
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Deploy with credentials
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          DB_PASSWORD: ${{ secrets.DB_PASSWORD }}
        run: |
          echo "Deploying to production..."
          ./deploy.sh

# .github/workflows/reusable-build.yml
name: Reusable Build Workflow

on:
  workflow_call:
    inputs:
      node-version:
        required: true
        type: string
    secrets:
      npm-token:
        required: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ inputs.node-version }}
      - run: npm ci
        env:
          NODE_AUTH_TOKEN: ${{ secrets.npm-token }}
      - run: npm run build

# .github/workflows/main.yml
name: Main CI

on: [push]

jobs:
  call-build:
    uses: ./.github/workflows/reusable-build.yml
    with:
      node-version: '20'
    secrets:
      npm-token: ${{ secrets.NPM_TOKEN }}

name: CI Pipeline

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    
    steps:
    - name: 코드 체크아웃
      uses: actions/checkout@v4
      
    - name: Node.js 설정
      uses: actions/setup-node@v4
      with:
        node-version: '20'
        cache: 'npm'
    
    - name: 의존성 설치
      run: npm ci
      
    - name: 린트 검사
      run: npm run lint
      
    - name: 테스트 실행
      run: npm test
      
    - name: 빌드
      run: npm run build

• 환경별 분리: 개발, 스테이징, 프로덕션 환경을 명확히 구분해요
• 승인 프로세스: 프로덕션 배포 전 수동 승인 단계를 넣는 게 좋아요
• 롤백 전략: 문제 발생 시 이전 버전으로 돌아갈 수 있어야 해요
• 알림 시스템: Slack이나 이메일로 배포 상태를 알려주면 완전 편해요

name: Deploy to Production

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production
    
    steps:
    - uses: actions/checkout@v4
    
    - name: Node.js 설정
      uses: actions/setup-node@v4
      with:
        node-version: '20'
    
    - name: 의존성 설치 및 빌드
      run: |
        npm ci
        npm run build
    
    - name: AWS 자격증명 설정
      uses: aws-actions/configure-aws-credentials@v4
      with:
        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        aws-region: ap-northeast-2
    
    - name: S3에 배포
      run: |
        aws s3 sync ./dist s3://your-bucket-name --delete
    
    - name: CloudFront 캐시 무효화
      run: |
        aws cloudfront create-invalidation \
          --distribution-id ${{ secrets.CLOUDFRONT_DISTRIBUTION_ID }} \
          --paths "/*"

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]
        node-version: [18, 20, 22]
    
    steps:
    - uses: actions/checkout@v4
    - name: Node.js ${{ matrix.node-version }} 설정
      uses: actions/setup-node@v4
      with:
        node-version: ${{ matrix.node-version }}
    - run: npm ci
    - run: npm test

1. npm 캐시: setup-node 액션의 cache 옵션을 'npm'으로 설정하세요
2. 빌드 결과물: actions/cache를 사용해서 빌드 결과를 캐싱할 수 있어요
3. Docker 레이어: 도커 이미지를 사용한다면 레이어 캐싱도 고려해보세요
4. 적절한 키 설정: package-lock.json 해시를 캐시 키로 사용하면 의존성이 바뀔 때만 재설치돼요

# .github/workflows/reusable-test.yml
name: Reusable Test Workflow

on:
  workflow_call:
    inputs:
      node-version:
        required: false
        type: string
        default: '20'

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with:
        node-version: ${{ inputs.node-version }}
    - run: npm ci
    - run: npm test

# 다른 워크플로우에서 호출
name: Main CI
on: [push]
jobs:
  call-test:
    uses: ./.github/workflows/reusable-test.yml
    with:
      node-version: '20'

• Slack 통합: slack-send 액션으로 빌드 결과를 바로 전송할 수 있어요
• 이메일 알림: GitHub에서 기본 제공하는 이메일 알림도 괜찮아요
• Discord 웹훅: 개인 프로젝트라면 Discord도 좋은 선택이에요
• 모바일 푸시: GitHub 모바일 앱에서도 알림을 받을 수 있어요

• 처음부터 완벽한 파이프라인을 만들려고 하지 마세요. 점진적으로 개선하는 게 더 좋아요
• 테스트가 너무 오래 걸리면 병렬 실행을 고려해보세요
• 프로덕션 배포는 반드시 수동 승인 단계를 거치는 게 안전해요
• 시크릿 관리를 철저히 하세요. 로그에 민감한 정보가 노출될 수 있어요

name: Docker Deploy

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_TOKEN }}

      - name: Build and Push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: |
            myapp:latest
            myapp:${{ github.sha }}
          cache-from: type=registry,ref=myapp:buildcache
          cache-to: type=registry,ref=myapp:buildcache,mode=max

      - name: Deploy to Server
        uses: appleboy/ssh-action@v1.0.0
        with:
          host: ${{ secrets.SERVER_HOST }}
          username: ${{ secrets.SERVER_USER }}
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          script: |
            docker pull myapp:latest
            docker stop myapp || true
            docker rm myapp || true
            docker run -d --name myapp -p 80:3000 myapp:latest

- name: Deploy to ECS
  uses: aws-actions/amazon-ecs-deploy-task-definition@v1
  with:
    task-definition: task-definition.json
    service: my-service
    cluster: my-cluster
    wait-for-service-stability: true

- name: Deploy to Cloud Run
  uses: google-github-actions/deploy-cloudrun@v2
  with:
    service: my-service
    image: gcr.io/project/myapp:${{ github.sha }}
    region: asia-northeast3

- name: Deploy to Vercel
  uses: amondnet/vercel-action@v25
  with:
    vercel-token: ${{ secrets.VERCEL_TOKEN }}
    vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
    vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
    vercel-args: '--prod'

jobs:
  deploy-staging:
    runs-on: ubuntu-latest
    environment: staging
    steps:
      - name: Deploy to Staging
        run: |
          echo "API_URL=${{ secrets.API_URL }}"
          echo "DB_HOST=${{ secrets.DB_HOST }}"

  deploy-production:
    runs-on: ubuntu-latest
    environment: production
    needs: deploy-staging
    steps:
      - name: Deploy to Production
        run: |
          echo "API_URL=${{ secrets.API_URL }}"
          echo "DB_HOST=${{ secrets.DB_HOST }}"

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: production
      url: https://myapp.com
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Wait for approval
        run: echo "Deployment approved!"

      - name: Deploy
        run: ./deploy.sh

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy New Version
        id: deploy
        run: ./deploy.sh
        continue-on-error: true

      - name: Health Check
        id: health
        run: |
          sleep 30
          curl -f https://myapp.com/health || exit 1
        continue-on-error: true

      - name: Rollback on Failure
        if: steps.deploy.outcome == 'failure' || steps.health.outcome == 'failure'
        run: |
          echo "Deployment failed! Rolling back..."
          docker pull myapp:previous
          docker stop myapp
          docker run -d --name myapp myapp:previous

      - name: Notify Team
        if: failure()
        uses: 8398a7/action-slack@v3
        with:
          status: ${{ job.status }}
          text: '? 배포 실패! 자동 롤백 완료'
          webhook_url: ${{ secrets.SLACK_WEBHOOK }}

- name: Notify Deployment Success
  uses: 8398a7/action-slack@v3
  with:
    status: custom
    fields: repo,message,commit,author,action,eventName,ref,workflow
    custom_payload: |
      {
        attachments: [{
          color: 'good',
          text: `✅ 배포 완료!
${process.env.AS_REPO}
Commit: ${process.env.AS_COMMIT}
By: ${process.env.AS_AUTHOR}`
        }]
      }
    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
  if: success()

- name: Notify Deployment Failure
  uses: 8398a7/action-slack@v3
  with:
    status: ${{ job.status }}
    text: '? 배포 실패! 즉시 확인 필요'
    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
  if: failure()

name: Matrix Build
on: [push]

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]
        node-version: [18, 20, 22]
        include:
          - os: ubuntu-latest
            experimental: true
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
      - run: npm test

- name: Cache dependencies
  uses: actions/cache@v4
  with:
    path: |
      ~/.npm
      node_modules
      .next/cache
    key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-npm-

# .github/workflows/reusable-build.yml
name: Reusable Build
on:
  workflow_call:
    inputs:
      node-version:
        required: true
        type: string
      environment:
        required: false
        type: string
        default: 'production'
    secrets:
      deploy-token:
        required: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ inputs.node-version }}
      - run: npm ci
      - run: npm run build
      - name: Deploy
        run: npm run deploy
        env:
          TOKEN: ${{ secrets.deploy-token }}
          ENV: ${{ inputs.environment }}

name: Production Deploy
on:
  push:
    branches: [main]

jobs:
  call-build:
    uses: ./.github/workflows/reusable-build.yml
    with:
      node-version: '20'
      environment: 'production'
    secrets:
      deploy-token: ${{ secrets.PROD_TOKEN }}

Environment 기능은 공개 저장소에서는 무료지만, 사설 저장소는 GitHub Pro 이상이 필요해요. 참고로 2026년 현재 기준이니까 꼭 확인해보세요!

name: Smart Build
on: [push, pull_request]

jobs:
  detect-changes:
    runs-on: ubuntu-latest
    outputs:
      frontend: ${{ steps.filter.outputs.frontend }}
      backend: ${{ steps.filter.outputs.backend }}
      docs: ${{ steps.filter.outputs.docs }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: filter
        with:
          filters: |
            frontend:
              - 'frontend/**'
            backend:
              - 'backend/**'
            docs:
              - 'docs/**'

  build-frontend:
    needs: detect-changes
    if: needs.detect-changes.outputs.frontend == 'true'
    runs-on: ubuntu-latest
    steps:
      - run: echo "Frontend 빌드 실행"

  build-backend:
    needs: detect-changes
    if: needs.detect-changes.outputs.backend == 'true'
    runs-on: ubuntu-latest
    steps:
      - run: echo "Backend 빌드 실행"

제가 실무에서 쓰는 보안 설정 템플릿을 공유할게요. 이걸 각 워크플로우 상단에 추가하면 기본적인 보안은 확보할 수 있어요:

permissions:
  contents: read
  pull-requests: write
  issues: write

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

• GITHUB_TOKEN 권한: Settings → Actions → General에서 "Read and write permissions" 확인하세요
• Secrets 설정: 대소문자 정확히 일치하는지, 만료되지 않았는지 확인해야 해요
• SSH 키: 공개키가 제대로 등록되어 있는지 다시 한 번 체크하세요
• AWS 권한: IAM 정책에서 필요한 모든 액션이 허용되어 있는지 확인하세요

1. 타임아웃 설정 조정
   기본 타임아웃이 너무 짧으면 늘려주세요. timeout-minutes를 job이나 step 레벨에서 설정할 수 있어요.
2. 병렬 테스트 실행
   Matrix strategy를 활용해서 여러 테스트를 동시에 돌리면 시간이 훨씬 단축돼요.
3. 의존성 캐싱 최적화
   node_modules를 매번 새로 설치하면 느려요. actions/cache를 꼭 사용하세요.
4. 불필요한 step 제거
   정말 필요한 작업만 실행하도록 조건문을 잘 활용하세요.

• SSH 연결 테스트: 먼저 수동으로 서버에 접속이 되는지 확인하세요
• 파일 경로 확인: 배포 스크립트의 절대 경로가 맞는지 체크해야 해요
• 환경별 설정: dev, staging, production 환경 설정을 제대로 분리했는지 확인하세요
• 롤백 준비: 실패했을 때 이전 버전으로 돌아갈 수 있도록 백업해두세요

# ❌ 잘못된 사용
echo ${{ secrets.API_KEY }}  # 보안상 절대 출력하면 안 돼요!

# ✅ 올바른 사용
- name: Set environment variables
  env:
    API_KEY: ${{ secrets.API_KEY }}
    DATABASE_URL: ${{ secrets.DATABASE_URL }}
  run: |
    echo "환경 변수가 설정되었습니다"
    # 실제 값은 출력하지 않기

# ✅ 파일로 저장하기
- name: Create env file
  run: |
    echo "API_KEY=${{ secrets.API_KEY }}" >> .env
    echo "DB_URL=${{ secrets.DATABASE_URL }}" >> .env

문제를 찾기 어려울 때는 디버그 모드를 켜보세요. 리포지토리 Settings → Secrets에서 다음 변수를 추가하면 돼요:

• ACTIONS_RUNNER_DEBUG: true로 설정하면 러너의 상세 로그가 나와요
• ACTIONS_STEP_DEBUG: true로 설정하면 각 step의 디버그 정보가 출력돼요

진짜 자세한 정보가 나오니까 문제 파악하기 훨씬 쉬워져요. 다만 로그가 엄청 길어지니까 주의하세요!