Ch4. Turborepo 파이프라인과 캐싱

// turbo.json
{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": ["**/.env.*local"],
  "globalEnv": ["NODE_ENV", "VERCEL_URL"],
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", ".env*"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "lint": {
      "dependsOn": ["^build"]
    },
    "test": {
      "dependsOn": ["^build"],
      "inputs": ["src/**", "tests/**", "vitest.config.*"]
    },
    "typecheck": {
      "dependsOn": ["^build"]
    }
  }
}

해시 입력:
  ├── 소스 파일 내용 (inputs에 매칭되는 파일)
  ├── 의존 패키지의 해시
  ├── turbo.json의 태스크 설정
  ├── env에 선언된 환경 변수 값
  └── globalDependencies 파일 내용

# Vercel Remote Cache 연결
npx turbo login
npx turbo link

# CI 환경 변수 (GitHub Actions)
env:
  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
  TURBO_TEAM: ${{ vars.TURBO_TEAM }}

{
  "globalEnv": ["NODE_ENV"],     // 모든 태스크의 캐시 키에 포함
  "globalPassThroughEnv": ["CI"], // 캐시 키에서 제외 (런타임에만 사용)
  "tasks": {
    "build": {
      "env": ["DATABASE_URL"],   // 이 태스크 캐시 키에만 포함
      "passThroughEnv": ["DEBUG"] // 이 태스크에서 캐시 키 제외
    }
  }
}

# 캐시 히트/미스 상세 확인
turbo run build --summarize

# 특정 패키지만 빌드 (필터)
turbo run build --filter=apps/web

# 변경된 패키지만 빌드 (since)
turbo run build --filter=...[HEAD~1]

# 캐시 무시하고 전체 빌드
turbo run build --force

// apps/web/turbo.json — 앱별 태스크 오버라이드
{
  "extends": ["//"],
  "tasks": {
    "build": {
      "env": ["NEXT_PUBLIC_API_URL"]
    }
  }
}

// turbo.json
{
  "boundaries": {
    "tags": {
      "packages/ui": ["ui"],
      "packages/db": ["data"]
    },
    "deny": [
      { "from": "ui", "to": "data" }
    ]
  }
}