# GitHub Actions에서 pnpm과 Turborepo 모노레포 빠르게 하기(astro: 528초에서 30초로)

> GitHub Actions의 pnpm과 Turborepo 모노레포에서 시간의 대부분은 새 VM에서의 pnpm install과, 결과가 VM에 없는 작업을 turbo가 돌리는 데 들어요. 영향받은 패키지만 돌리고, turbo에 캐시를 주고, pnpm 스토어를 남기세요. 아니면 둘 다 남기는 머신에서 돌리세요. astro의 CI는 GitHub에서 528초, Skipbox에서 30초였고, 월 $39 정액이에요.

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 정액, 실행 시간 무제한이에요.

- astro의 CI: GitHub에서 528초, Skipbox에서 30초. turbo가 빌드 작업 40개와 테스트 작업을 재생했어요
- pnpm 스토어와 turbo의 `.turbo`가 내 머신에 남아요. 설정할 원격 캐시도, 내려받을 아카이브도 없어요
- 4 vCPU로 월 20,000분: GitHub에서 $222, Skipbox에서 $39

**GitHub Actions를 정액으로, 실행 시간 무제한** Skipbox는 GitHub Actions 작업을 나만 쓰는 전용 머신에서 돌려요. 몇 분을 돌리든 가격은 월 $39 그대로예요. Docker 레이어와 의존성 캐시가 작업 사이에도 남아서 다음 작업이 바로 시작돼요.

4 vCPU 실행기, 매달 20,000분: GitHub $222 → Skipbox $39. 매달 $183 절약.

옮기는 데는 한 줄이면 돼요: `runs-on: skipbox`.

[7일 무료 체험 시작하기](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-ko)

## 모노레포 작업이 시간을 쓰는 곳

| 단계 | 새 GitHub VM에서는 |
|---|---|
| 체크아웃 | 기본은 얕은 클론. `--affected`에는 이력이 필요하니 전체 클론 |
| Node와 pnpm 준비 | 도구 캐시에 그 버전이 없으면 내려받아요 |
| `pnpm install` | 캐시 아카이브에서 스토어를 복원하고(또는 레지스트리에서 내려받고), 그다음 모든 패키지에 `node_modules`를 링크해요 |
| `turbo run build` | `.turbo/cache`를 복원했거나 원격 캐시가 응답하지 않는 한, 모든 작업이 돌아요 |
| `turbo run test` | 마찬가지이고, 프라이빗 리포지토리의 `ubuntu-latest`에서는 CPU 2개로 돌아요 |

## 1. 바뀐 것만 돌리기

[Turborepo의 CI 가이드](https://turborepo.dev/docs/crafting-your-repository/constructing-ci)에 따르면 `turbo run build --affected`는 기준 브랜치와 비교해 바뀐 패키지의 작업만 돌려요. GitHub Actions에서는 풀 리퀘스트에서 `GITHUB_BASE_REF`를, 푸시에서 `GITHUB_EVENT_PATH`를 읽어요. 얕은 클론에서는 모든 패키지가 바뀐 것으로 세어지므로, 이력을 체크아웃하세요.

```yaml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0
    filter: blob:none
```

`turbo query affected --packages web`은 작업이 돌아야 하는지 알려 주므로, 건드리지 않은 앱의 작업은 install을 건너뛸 수 있어요.

## 2. 작업보다 오래 사는 캐시를 turbo에 주기

Turborepo는 작업 결과를 [머신의](https://turborepo.dev/docs/crafting-your-repository/caching) `.turbo/cache`에 저장해요. GitHub 호스팅 작업의 머신은 끝나면 지워지므로, CI에서 그 캐시는 매번 빈 채로 시작해요. [Turborepo의 GitHub Actions 가이드](https://turborepo.dev/docs/guides/ci-vendors/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 문서](https://pnpm.io/continuous-integration)도 스토어를 캐시한다고 설치가 빨라진다는 보장은 없다고 분명히 적고 있어요. 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, [실제 프로젝트를 돌린 우리 실행](https://skipbox.dev/ko/guides/rust-cache-slow-rust-ci)에서:

| | GitHub(퍼블릭 리포지토리, 4 vCPU, 16 GB) | Skipbox 전용 머신(4 vCPU) |
|---|---|---|
| 작업 | 528초 | **30초**([31초](https://github.com/skipbox-dev/astro/actions/runs/43351547473), [28초](https://github.com/skipbox-dev/astro/actions/runs/43351638436)) |
| 빌드 작업 | 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 적어요.

## 옮기는 건 한 줄이에요

```yaml
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
```

1. GitHub로 Skipbox에 로그인하세요.
2. Skipbox GitHub App을 설치하고 리포지토리를 고르세요.
3. `runs-on`을 바꾸고 푸시하세요.

캐시 단계는 그대로 두세요. 그것이 저장한 것은 머신 옆에 남아요.

## 보안

- 머신은 내 계정만 써요. 다른 회사의 작업은 그 머신에서 돌지 않아요.
- 작업이 끝날 때마다 실행기의 자격 증명, 프로세스, 컨테이너를 지우고, 남겨 둔 체크아웃의 git 자격 증명, 훅, 추적되지 않는 파일도 지워요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요.
- 쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 새 VM에서 돌고, 그 VM은 캐시를 읽을 수만 있고 바꿀 수는 없어요.

자세한 내용은 [작업을 분리하는 방식](https://docs.skipbox.dev/ko/isolation)에 있어요.

## 모노레포로 체험해 보세요

무료 체험은 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 업데이트 · https://skipbox.dev/ko/guides/pnpm-turborepo-monorepo-github-actions
