🚀 CI/CD 워크플로우 최적화

🚀 CI/CD 워크플로우 최적화: 의존성 관리, 테스트 병렬 실행, 다중 Node 버전 지원 완전 정복!

 

“CI/CD에서 패키지 버전 고정은 왜 필요할까? 테스트 병렬 실행을 하면 속도가 얼마나 빨라질까? 매트릭스 전략은 어떻게 활용할까?”

최적화된 CI/CD 워크플로우를 구축하는 핵심 전략을 모두 살펴보자!

📌 목차

 

1️⃣ 패키지 버전 고정 (Dependency Management)

2️⃣ 테스트 분할 (Sharding) & 병렬 실행 최적화

3️⃣ 다중 Node 버전 지원 & 매트릭스 테스트 전략

4️⃣ 실전 예제 (GitHub Actions 기반)

5️⃣ 결론

1️⃣ 패키지 버전 고정 (Dependency Management) 🏗️

 

📌 왜 패키지 버전 고정이 필요할까?

 

프론트엔드 CI/CD 파이프라인에서 패키지 버전을 고정하는 것은 매우 중요해요.

🚨 이유:

• CI/CD 환경에서 실행하는 코드가 개발 환경과 다르면 예기치 않은 오류 발생 😨

• 종속된 패키지의 업데이트로 인해 불안정한 빌드가 생성될 수 있음

• 여러 개발자가 같은 프로젝트를 다룰 때 일관된 실행 환경 유지

 

✅ 해결 방법:

✔️ lock 파일을 유지 (package-lock.json, yarn.lock)

✔️ 패키지 버전 명시적으로 고정 (dependencies와 devDependencies에서 ^나 ~ 제거)

✔️ 의존성 캐싱 활용 (cache: yarn 설정 등)

 

📌 CI/CD에서 패키지 버전 고정 예제 (GitHub Actions)

jobs:
  install:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Cache Node.js modules
        uses: actions/cache@v3
        with:
          path: ~/.yarn/cache # Yarn Berry 사용 시
          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
          restore-keys: |
            ${{ runner.os }}-yarn-

      - name: Install dependencies
        run: yarn install --frozen-lockfile

💡 yarn install --frozen-lockfile

• package.json과 yarn.lock이 일치하지 않으면 오류 발생 (일관된 패키지 환경 유지)

2️⃣ 테스트 분할 (Sharding) & 병렬 실행 최적화 🏎️

 

📌 Sharding (샤딩)이란?

 

🚀 CI/CD에서 **Sharding(샤딩)**은 테스트를 여러 개의 작은 조각(Shard)으로 나눠서 병렬 실행하는 기법이에요.

즉, 한 개의 머신에서 모든 테스트를 실행하는 대신, 여러 머신에서 테스트를 나눠서 실행하면 속도가 훨씬 빨라져요!

 

✅ Sharding의 장점

✔️ 테스트 속도 극대화 (Build Time 단축!)

✔️ 병렬 실행으로 실행 시간 절반 이하로 감소 가능

✔️ 큰 프로젝트에서도 효율적인 테스트 실행

 

📌 예제: Cypress 병렬 테스트 실행 (GitHub Actions)

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        shard: [1, 2, 3, 4] # 4개의 샤드로 나눔 (테스트 병렬 실행)
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Install dependencies
        run: yarn install --frozen-lockfile

      - name: Run Cypress tests in parallel
        run: npx cypress run --record --parallel --group shard-${{ matrix.shard }}

💡 위 설정에서 Cypress 테스트가 **4개의 샤드(Shard)**로 분할되어 실행됨.

• --parallel: 병렬 실행 옵션

• --group shard-${{ matrix.shard }}: 샤드 그룹 설정

3️⃣ 다중 Node 버전 지원 & 매트릭스 테스트 전략

 

📌 다중 Node.js 버전 지원 (Multi-Version Testing)

 

CI/CD 환경에서는 여러 Node.js 버전에서 테스트를 수행하는 것이 중요해요.

🚨 이유는?

1️⃣ 팀 내 다양한 Node.js 버전을 사용하는 경우 버전 간 호환성 체크 가능

2️⃣ 프로젝트가 Node.js 최신 버전에서도 정상 작동하는지 검증

3️⃣ 라이브러리 업데이트 시 특정 버전에서 발생할 수 있는 문제 사전 발견

 

✅ 해결 방법:

✔️ GitHub Actions에서 matrix 전략을 활용하여 여러 Node.js 버전에서 병렬 테스트 실행

✔️ 최소 지원 버전과 최신 버전에서 실행하여 문제 발생 여부 확인

 

📌 다중 Node.js 버전 테스트 예제 (GitHub Actions)

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [14, 16, 18] # 지원할 Node.js 버전 지정
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

      - name: Install dependencies
        run: yarn install --frozen-lockfile

      - name: Run tests
        run: yarn test

💡 위 설정에서 Node.js 14, 16, 18 버전에서 테스트 병렬 실행!

• matrix.node-version을 활용하여 여러 버전 테스트

• setup-node@v3 액션으로 Node.js 버전 설정

4️⃣ 실전 예제 (GitHub Actions 기반 CI/CD 최적화) 🛠️

name: CI/CD Workflow

on:
  push:
    branches:
      - main

jobs:
  install:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Cache dependencies
        uses: actions/cache@v3
        with:
          path: ~/.yarn/cache
          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}

      - name: Install dependencies
        run: yarn install --frozen-lockfile

  test:
    needs: install
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [14, 16, 18]
        shard: [1, 2, 3, 4]
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

      - name: Install dependencies
        run: yarn install --frozen-lockfile

      - name: Run tests in parallel
        run: npx jest --shard=${{ matrix.shard }}

✅ 이 워크플로우에서 하는 일:

✔️ yarn.lock을 활용한 패키지 버전 고정

✔️ 병렬 테스트 실행 (Sharding)

✔️ 다중 Node.js 버전 테스트 (Matrix Strategy)

5️⃣ 결론: CI/CD 성능을 극대화하는 방법!

 

✅ 의존성 관리를 통해 일관된 실행 환경 유지!

✅ Sharding을 사용해 병렬 테스트로 속도 최적화!

✅ 다중 Node.js 버전 테스트로 호환성 확보!

 

🎯 CI/CD의 속도와 안정성을 모두 잡고 싶은 개발자라면?

👉 위 방법들을 적용해서 최적화된 빌드 파이프라인을 만들어보세요! 🚀

 

🌷 전설의 개발자가 되어봅시당! 🌷 🚀