Turborepo 사용 가이드

주요 명령어

개발

• •pnpm dev: 모든 앱 개발 서버 실행
• •pnpm dev --filter=mumak-next: 특정 앱만 실행

빌드

• •pnpm build: 전체 빌드
• •pnpm build --filter=mumak-next: 특정 앱만 빌드
• •pnpm build --filter=...mumak-next: 앱과 의존성 모두 빌드

변경 감지

• •pnpm affected: 변경된 부분만 빌드/테스트
• •pnpm affected:dry: 실행 계획만 확인

디버깅

• •pnpm turbo:dry: 실행될 태스크 미리 확인
• •pnpm turbo:graph: 의존성 그래프 확인 (HTML 생성)
• •pnpm turbo run build --force: 캐시 무시하고 실행
• •pnpm turbo:clean: 모든 캐시 및 빌드 결과 삭제

필터 문법

기본 필터

• •--filter=mumak-next: 특정 패키지만
• •--filter=...mumak-next: 패키지 + 의존성 모두
• •--filter=mumak-next...: 패키지 + dependents
• •--filter=!moomin-money: 특정 패키지 제외

Git 기반 필터

• •--filter=[HEAD^1]: 현재 커밋과 이전 커밋 사이 변경
• •--filter=[main]: main 브랜치 대비 변경
• •--filter=[origin/main...HEAD]: origin/main과 HEAD 사이 변경

조합

• •--filter=...mumak-next --filter=!@mumak/ui: 의존성 포함하되 특정 패키지 제외

캐시 관리

캐시 문제 해결

# 캐시 무시하고 실행
pnpm turbo run build --force

# 전체 캐시 삭제
pnpm turbo:clean
pnpm install

Remote Cache 설정

GitHub Secrets 필요:

• •TURBO_TOKEN: Turbo Cloud 토큰
• •TURBO_TEAM: 팀 이름 (Variables)

CI/CD 동작

변경 감지 전략

1. •paths 필터: apps/**, packages/** 변경 시에만 실행
2. •detect-scopes: 변경된 파일 분석 → 영향받는 앱 감지
3. •동적 matrix: 감지된 앱별로 병렬 job 실행

앱 설정

.github/app-config/apps.yml에서 CI/CD 대상 앱 관리:

apps:
  - app: blog
    type: next
    hasE2E: true

• •packages/** 변경 시 모든 앱 포함
• •apps/{app}/** 변경 시 해당 앱만 포함

문제 해결

태스크 설정