GitHub Actions에서 pnpm과 Turborepo 모노레포 빠르게 하기(astro: 528초에서 30초로)
GitHub Actions의 pnpm과 Turborepo 모노레포에서 느린 작업의 대부분은 두 단계예요. 새 VM에서의 pnpm install, 그리고 VM에 결과가 없는 작업을 돌리는 turbo run build test예요. 이 순서로 고치세요. 변경이 건드린 패키지만 돌리세요(이력이 있는 체크아웃으로 turbo run build --affected). 작업보다 오래 사는 캐시를 turbo에 주세요. 결과가 GitHub가 작업마다 지우는 머신의 .turbo/cache에 있으니까요. Remote Caching이나 actions/cache로 복원하는 .turbo예요. 그리고 pnpm 스토어를 남기세요. GitHub의 실행기에서는 그 캐시 하나하나가 작업마다의 다운로드예요. 디스크를 유지하는 머신에서는 그냥 거기 있어요. astro의 CI 작업은 GitHub에서 528초, Skipbox 전용 머신에서 30초였고, turbo가 남겨 둔 캐시에서 빌드 작업 40개를 모두 재생했어요.
Skipbox는 작업을 내 계정 전용 머신에서 돌리고, 그 머신은 pnpm 스토어, 도구, 체크아웃의 .turbo를 작업 사이에도 남겨요. 원격 캐시도, 캐시 키도 없어요. runs-on: skipbox 한 줄만 바꾸면 월 $39 정액, 실행 시간 무제한이에요.
모노레포 작업이 시간을 쓰는 곳
| 단계 | 새 GitHub VM에서는 |
|---|---|
| 체크아웃 | 기본은 얕은 클론. --affected에는 이력이 필요하니 전체 클론 |
| Node와 pnpm 준비 | 도구 캐시에 그 버전이 없으면 내려받아요 |
pnpm install | 캐시 아카이브에서 스토어를 복원하고(또는 레지스트리에서 내려받고), 그다음 모든 패키지에 node_modules를 링크해요 |
turbo run build | .turbo/cache를 복원했거나 원격 캐시가 응답하지 않는 한, 모든 작업이 돌아요 |
turbo run test | 마찬가지이고, 프라이빗 리포지토리의 ubuntu-latest에서는 CPU 2개로 돌아요 |
1. 바뀐 것만 돌리기
Turborepo의 CI 가이드에 따르면 turbo run build --affected는 기준 브랜치와 비교해 바뀐 패키지의 작업만 돌려요. GitHub Actions에서는 풀 리퀘스트에서 GITHUB_BASE_REF를, 푸시에서 GITHUB_EVENT_PATH를 읽어요. 얕은 클론에서는 모든 패키지가 바뀐 것으로 세어지므로, 이력을 체크아웃하세요.
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web은 작업이 돌아야 하는지 알려 주므로, 건드리지 않은 앱의 작업은 install을 건너뛸 수 있어요.
2. 작업보다 오래 사는 캐시를 turbo에 주기
Turborepo는 작업 결과를 머신의 .turbo/cache에 저장해요. GitHub 호스팅 작업의 머신은 끝나면 지워지므로, CI에서 그 캐시는 매번 빈 채로 시작해요. Turborepo의 GitHub Actions 가이드에 나오는 우회 방법은 둘이에요.
- Remote Caching.
TURBO_TOKEN과TURBO_TEAM을 정하세요(Vercel Remote Cache나 직접 호스팅한 서버). 적중할 때마다 그곳에서 내려받아요. .turbo에 거는actions/cache.${{ runner.os }}-turbo-${{ github.sha }}를 키로,restore-keys: ${{ runner.os }}-turbo-로 정하세요. 실행마다 새 항목을 저장하고, 리포지토리가 캐시하는 다른 모든 것과 함께 리포지토리당 GitHub의 10 GB 안에 들어가요.
3. pnpm 스토어 남기기
cache: pnpm을 준 actions/setup-node나, pnpm store path에 거는 actions/cache는 pnpm-lock.yaml을 키로 스토어를 복원해요. node_modules는 복원하지 않으므로, pnpm은 여전히 모든 패키지를 링크해요. pnpm의 CI 문서도 스토어를 캐시한다고 설치가 빨라진다는 보장은 없다고 분명히 적고 있어요. CI에서 pnpm은 스스로 --frozen-lockfile로 바뀌어요.
4. 코어 쓰기
turbo는 서로 독립된 작업을 병렬로 돌리고, 빌드나 테스트 도구마다 자기 워커를 띄우므로, 모노레포는 받은 코어를 모두 써요. 프라이빗 리포지토리의 ubuntu-latest는 2개예요.
GitHub의 실행기에서 각 해결책에 드는 비용
- Remote Caching은 서비스 하나와 토큰 하나가 더 늘고, 캐시 적중마다 네트워크를 건너요.
.turbo용actions/cache는 실행마다 항목을 쓰고, pnpm 스토어, Docker의 레이어, 모든 브랜치의 캐시와 같은 10 GB를 두고 다퉈요. 7일 동안 쓰지 않은 항목은 사라져요.- 더 큰 실행기는 GitHub Team이나 Enterprise Cloud의 대형 실행기이고, 1분마다 청구돼요.
해결책이 디스크를 유지하는 머신일 때
워크플로를 바꾸지 않은 astro 자체의 CI, 실제 프로젝트를 돌린 우리 실행에서:
| GitHub(퍼블릭 리포지토리, 4 vCPU, 16 GB) | Skipbox 전용 머신(4 vCPU) | |
|---|---|---|
| 작업 | 528초 | 30초(31초, 28초) |
| 빌드 작업 | 40개 실행 | 40개를 turbo의 캐시에서 재생 |
| 테스트 작업 | 실행 | turbo의 캐시에서 재생 |
전용 머신이 지난 작업의 체크아웃 .turbo와 pnpm 스토어를 남겨 두었으므로, turbo는 내려받을 것 없이 모든 작업의 결과를 찾았어요. turbo는 입력의 해시가 같을 때만 작업을 재생하므로, 실제 커밋은 자기가 건드린 패키지를 다시 돌리고 나머지를 재생해요.
Skipbox는 모노레포의 상태를 남겨요
요금제마다 작업 사이에도 유지되는 내 계정 전용 머신이 따라와요.
- pnpm 스토어가 남아요.
~/.local/share/pnpm/store에, npm 캐시와 도구마다의~/.cache와 함께요.pnpm install이 내려받지 않고 디스크에서 링크해요. - turbo의 캐시가 남아요.
turbo.json이 turbo 2의 것이면(tasks키가 있고,pipeline이 없고,"envMode": "loose"가 아니면) 체크아웃의 최상위.turbo가 작업 사이에도 남아요.TURBO_TOKEN도, 캐시 단계도 필요 없어요. node_modules는 작업이 끝날 때마다 지워요. 그래서 체크아웃 하나를 나눠 쓰는 Node 버전 행렬이 다른 Node용으로 빌드된 네이티브 애드온을 불러오는 일이 없어요.- 도구가 남아요:
setup-node가 설치한 Node 버전, pnpm 자체, Docker의 이미지와 레이어.
S에서도 GitHub 캐시 공간의 7배 이상이에요. 작업은 레이블로 크기를 골라요.
| 레이블 | 머신 | 요금제 |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, 월 $39 |
skipbox-8x16 | 8 vCPU · 16 GB | M, 월 $79 |
skipbox-16x32 | 16 vCPU · 32 GB | L, 월 $149 |
실행 시간은 무제한이에요. 4 vCPU로 월 20,000분이면 GitHub는 $222를 청구하고, Skipbox S는 $39로 $183 적어요.
옮기는 건 한 줄이에요
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
- uses: pnpm/action-setup@v3
- uses: actions/setup-node@v4
with:
node-version: 22
cache: pnpm
- run: pnpm install
- run: pnpm turbo run build test --affected
- GitHub로 Skipbox에 로그인하세요.
- Skipbox GitHub App을 설치하고 리포지토리를 고르세요.
runs-on을 바꾸고 푸시하세요.
캐시 단계는 그대로 두세요. 그것이 저장한 것은 머신 옆에 남아요.
보안
- 머신은 내 계정만 써요. 다른 회사의 작업은 그 머신에서 돌지 않아요.
- 작업이 끝날 때마다 실행기의 자격 증명, 프로세스, 컨테이너를 지우고, 남겨 둔 체크아웃의 git 자격 증명, 훅, 추적되지 않는 파일도 지워요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요.
- 쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 새 VM에서 돌고, 그 VM은 캐시를 읽을 수만 있고 바꿀 수는 없어요.
자세한 내용은 작업을 분리하는 방식에 있어요.
모노레포로 체험해 보세요
무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지 무료이고, 카드가 필요 없어요. 빌드 작업을 runs-on: skipbox로 옮기고, 두 번 돌린 뒤, 두 번째 실행의 install과 turbo 줄(cached 대 executing)을 GitHub의 것과 나란히 놓아 보세요.
자주 묻는 질문
GitHub Actions에서 큰 pnpm/Turborepo 모노레포를 빠르게 하려면 어떻게 하나요?
세 가지를 차례로 하세요. 바뀐 것만 돌리기: 이력이 있는 체크아웃(fetch-depth: 0과 filter: blob:none)으로 turbo run build --affected. 작업보다 오래 사는 캐시를 turbo에 주기: Turborepo의 Remote Cache, 또는 actions/cache로 복원하는 .turbo. 그리고 pnpm 스토어 남기기: setup-node의 cache: pnpm이나 스토어 경로에 거는 actions/cache. GitHub의 새 VM에서는 그 하나하나가 작업마다의 다운로드이고, 디스크를 유지하는 머신에서는 이미 거기 있어요. astro의 CI는 GitHub에서 528초, turbo의 캐시와 pnpm 스토어를 남기는 Skipbox 전용 머신에서 30초였어요.
스토어를 캐시해도 GitHub Actions에서 pnpm install이 왜 느린가요?
복원한 스토어도 결국 새 VM에 내려받아 푸는 아카이브이고, 그다음 pnpm이 워크스페이스의 모든 패키지에 node_modules를 링크하기 때문이에요. pnpm 자체의 CI 문서도 스토어를 캐시한다고 설치가 빨라진다는 보장은 없다고 해요. 이미 머신의 디스크에 있는 스토어는 다운로드를 건너뛰고, 링크만 남아요.
GitHub Actions에서 Turborepo 캐시가 효과가 있나요?
캐시가 작업보다 오래 살 때만이에요. Turborepo는 작업 결과를 머신의 .turbo/cache에 두는데, GitHub 호스팅 작업의 머신은 끝나면 사라져요. 그래서 CI에는 Remote Caching(TURBO_TOKEN과 TURBO_TEAM, Vercel의 것이나 직접 호스팅한 것)이나 .turbo용 actions/cache 단계가 필요해요. Skipbox 전용 머신에서는 turbo 2 프로젝트라면 체크아웃의 .turbo가 작업 사이에도 남으므로, 원격 캐시 없이 turbo가 바뀌지 않은 작업을 재생해요.
GitHub Actions에서 turbo --affected가 되나요?
돼요. Turborepo는 비교할 기준을 찾으려고 풀 리퀘스트에서는 GITHUB_BASE_REF를, 푸시에서는 GITHUB_EVENT_PATH를 읽어요. 이력이 필요해요. 얕은 클론에서는 모든 패키지가 바뀐 것으로 세어져요. actions/checkout에 fetch-depth: 0과 filter: blob:none을 정하세요.
Skipbox는 Turborepo 모노레포에서 무엇을 남기나요?
pnpm 스토어, npm과 도구마다의 캐시, setup-node가 설치하는 도구, Docker의 레이어, 그리고 turbo.json이 turbo 2의 것일 때(tasks 키가 있고, pipeline이 없고, envMode loose가 아닐 때) 체크아웃과 그 최상위 .turbo예요. node_modules는 작업이 끝날 때마다 지우므로 install은 돌지만, 디스크의 스토어에서 돌아요. turbo는 입력의 해시가 같을 때만 작업을 재생하므로, 커밋은 자기가 건드린 것을 다시 돌려요.
체험하는 데 비용이 얼마나 드나요?
들지 않아요. 무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지이고, 카드가 필요 없어요. 모노레포의 빌드 작업을 runs-on: skipbox 레이블로 옮기고, 두 번 돌린 뒤, 두 번째 실행의 install과 turbo 단계를 GitHub의 것과 비교해 보세요.
2026년 11월 13일 업데이트