# เร่งความเร็ว monorepo แบบ pnpm และ Turborepo ใน GitHub Actions (astro: 528 วินาที เหลือ 30 วินาที)

> ใน monorepo แบบ pnpm และ Turborepo บน GitHub Actions เวลาส่วนใหญ่คือ pnpm install บน VM ใหม่ และ turbo ที่รัน task ซึ่งผลลัพธ์ไม่อยู่บนเครื่องนั้น รันเฉพาะแพ็กเกจที่ได้รับผลกระทบ ให้แคชแก่ turbo และเก็บ store ของ pnpm ไว้ หรือรันบนเครื่องที่เก็บทั้งสองอย่างไว้: CI ของ astro จาก 528 วินาทีบน GitHub เหลือ 30 วินาทีบน Skipbox ในราคาเหมาจ่าย $39 ต่อเดือน

ใน monorepo แบบ pnpm และ Turborepo บน GitHub Actions จ็อบที่ช้าส่วนใหญ่คือสองขั้นตอน: `pnpm install` บน VM ใหม่ และ `turbo run build test` ที่รัน task ซึ่ง VM ไม่มีผลลัพธ์ของมัน แก้ตามลำดับนี้ รันเฉพาะแพ็กเกจที่การเปลี่ยนแปลงแตะ (`turbo run build --affected` กับการ checkout ที่มีประวัติ) ให้แคชแก่ turbo ที่อยู่ได้นานกว่าจ็อบ เพราะผลลัพธ์ของมันอยู่ใน `.turbo/cache` บนเครื่องที่ GitHub ลบทิ้งหลังทุกจ็อบ: Remote Caching หรือ `.turbo` ที่กู้คืนด้วย `actions/cache` และเก็บ store ของ pnpm ไว้ บนรันเนอร์ของ GitHub แคชแต่ละอย่างคือการดาวน์โหลดทุกจ็อบ บนเครื่องที่เก็บดิสก์ไว้ มันก็อยู่ที่นั่นเลย: จ็อบ CI ของ astro ใช้ 528 วินาทีบน GitHub และ 30 วินาทีบนเครื่องเฉพาะของตัวเองใน Skipbox ซึ่งเล่นซ้ำ build task ทั้ง 40 ตัวจากแคชของ turbo ที่เก็บไว้

Skipbox รันจ็อบของคุณบนเครื่องที่โฮสต์ให้บัญชีของคุณเท่านั้น ซึ่งเก็บ store ของ pnpm เครื่องมือ และ `.turbo` ในโค้ดที่ checkout ไว้ระหว่างจ็อบ โดยไม่ต้องมี remote cache และไม่ต้องมี cache key เปลี่ยนบรรทัดเดียว `runs-on: skipbox` ในราคาเหมาจ่าย $39 ต่อเดือน ไม่จำกัดนาที

- CI ของ astro: 528 วินาทีบน GitHub และ 30 วินาทีบน Skipbox โดย turbo เล่นซ้ำ build task 40 ตัวและ test task
- store ของ pnpm และ `.turbo` ของ turbo อยู่บนเครื่องของคุณ: ไม่มี remote cache ให้ตั้งค่า ไม่มีไฟล์บีบอัดให้ดาวน์โหลด
- 20,000 นาทีต่อเดือนบน 4 vCPU: บน GitHub $222 บน Skipbox $39

**GitHub Actions ราคาเหมาจ่าย ไม่จำกัดนาที** Skipbox รันจ็อบ GitHub Actions บนเครื่องเฉพาะของคุณเอง: $39 ต่อเดือน ไม่ว่าจะรันกี่นาที layer ของ Docker และแคช dependency ยังอยู่ระหว่างจ็อบ จ็อบถัดไปจึงเริ่มได้ทันที

รันเนอร์ 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-th)

## จ็อบของ monorepo ใช้เวลาไปที่ไหน

| ขั้นตอน | บน VM ใหม่ของ GitHub |
|---|---|
| Checkout | shallow clone เป็นค่าเริ่มต้น `--affected` ต้องการประวัติ จึงต้อง clone เต็ม |
| ตั้งค่า Node และ pnpm | ดาวน์โหลด เว้นแต่ tool cache มีเวอร์ชันนั้น |
| `pnpm install` | store กู้คืนจากไฟล์บีบอัดของแคช (หรือดาวน์โหลดจาก registry) แล้ว link `node_modules` ให้ทุกแพ็กเกจ |
| `turbo run build` | ทุก task รัน เว้นแต่ `.turbo/cache` ถูกกู้คืน หรือ remote cache ตอบ |
| `turbo run test` | เหมือนกัน บน 2 CPU ของ `ubuntu-latest` บนรีโพสิทอรีส่วนตัว |

## 1. รันเฉพาะสิ่งที่เปลี่ยน

จาก[คู่มือ CI ของ Turborepo](https://turborepo.dev/docs/crafting-your-repository/constructing-ci) (ภาษาอังกฤษ): `turbo run build --affected` รัน task เฉพาะในแพ็กเกจที่เปลี่ยนเทียบกับ base branch ใน GitHub Actions มันอ่าน `GITHUB_BASE_REF` บน pull request และ `GITHUB_EVENT_PATH` บน push ถ้าเป็น shallow clone ทุกแพ็กเกจจะนับว่าเปลี่ยน จึงต้อง checkout ประวัติ:

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

`turbo query affected --packages web` บอกจ็อบว่าควรรันหรือไม่ จ็อบของแอปที่ไม่ถูกแตะจึงข้าม install ได้

## 2. ให้แคชแก่ turbo ที่อยู่ได้นานกว่าจ็อบ

Turborepo เก็บผลลัพธ์ของ task ไว้ใน `.turbo/cache` [บนเครื่อง](https://turborepo.dev/docs/crafting-your-repository/caching) (ภาษาอังกฤษ) เครื่องของจ็อบบนรันเนอร์ที่ GitHub โฮสต์ถูกลบเมื่อจ็อบจบ ใน CI แคชนั้นจึงเริ่มว่างทุกครั้ง มีสองทางเลี่ยง จาก[คู่มือ GitHub Actions ของ Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions) (ภาษาอังกฤษ):

- **Remote Caching** ตั้ง `TURBO_TOKEN` และ `TURBO_TEAM` (Vercel Remote Cache หรือเซิร์ฟเวอร์แบบ self-hosted) ทุกครั้งที่ hit คือการดาวน์โหลดจากมัน
- **`actions/cache` บน `.turbo`** ใช้ key `${{ runner.os }}-turbo-${{ github.sha }}` กับ `restore-keys: ${{ runner.os }}-turbo-` มันบันทึกรายการใหม่ทุกการรัน ภายใน 10 GB ต่อรีโพสิทอรีของ GitHub ร่วมกับทุกอย่างที่รีโพสิทอรีแคชไว้

## 3. เก็บ store ของ pnpm ไว้

`actions/setup-node` กับ `cache: pnpm` หรือ `actions/cache` บน `pnpm store path` กู้คืน store ด้วย key จาก `pnpm-lock.yaml` มันไม่กู้คืน `node_modules` pnpm จึงยังต้อง link ทุกแพ็กเกจ [เอกสาร CI ของ pnpm](https://pnpm.io/continuous-integration) (ภาษาอังกฤษ) บอกไว้ตรงๆ ว่าการแคช store ไม่ได้รับประกันว่าการติดตั้งจะเร็วขึ้น ใน CI pnpm เปลี่ยนไปใช้ `--frozen-lockfile` เอง

## 4. ใช้คอร์ให้คุ้ม

turbo รัน task ที่ไม่ขึ้นต่อกันแบบขนาน และเครื่องมือ build หรือเทสต์แต่ละตัวเริ่ม worker ของตัวเอง monorepo จึงใช้ทุกคอร์ที่ได้ `ubuntu-latest` ของรีโพสิทอรีส่วนตัวมี 2

## แต่ละวิธีแก้มีต้นทุนอะไรบนรันเนอร์ของ GitHub

- **Remote Caching** คือบริการอีกตัวและ token อีกตัว และทุก cache hit ข้ามเครือข่าย
- **`actions/cache` สำหรับ `.turbo`** เขียนรายการใหม่ทุกการรัน และแย่ง 10 GB เดียวกันกับ store ของ pnpm layer ของ Docker และแคชของทุก branch รายการที่ไม่ได้ใช้ 7 วันจะถูกลบ
- **รันเนอร์ที่ใหญ่กว่า** คือรันเนอร์ขนาดใหญ่บน GitHub Team หรือ Enterprise Cloud ที่คิดเงินรายนาที

## เมื่อวิธีแก้คือเครื่องที่เก็บดิสก์ไว้

CI ของ astro เอง โดยไม่แก้เวิร์กโฟลว์ จาก[การรันโปรเจกต์จริงของเรา](https://skipbox.dev/th/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)) |
| build task | รัน 40 ตัว | เล่นซ้ำ 40 ตัวจากแคชของ turbo |
| test task | รัน | เล่นซ้ำจากแคชของ turbo |

เครื่องเฉพาะของตัวเองเก็บ `.turbo` ในโค้ดที่ checkout ไว้และ store ของ pnpm จากจ็อบล่าสุด turbo จึงเจอผลลัพธ์ของทุก task โดยไม่ต้องดาวน์โหลดอะไร turbo เล่นซ้ำ task เฉพาะเมื่อ hash ของ input เท่าเดิม commit จริงจึงรันแพ็กเกจที่มันแตะซ้ำ และเล่นซ้ำส่วนที่เหลือ

## Skipbox เก็บสถานะของ monorepo ไว้

ทุกแพ็กเกจมาพร้อมเครื่องเฉพาะของบัญชีคุณ ที่เก็บไว้ระหว่างจ็อบ:

- **store ของ pnpm อยู่ต่อ** ใน `~/.local/share/pnpm/store` พร้อมแคชของ npm และ `~/.cache` ของแต่ละเครื่องมือ `pnpm install` link จากดิสก์แทนการดาวน์โหลด
- **แคชของ turbo อยู่ต่อ** `.turbo` ระดับบนสุดในโค้ดที่ checkout ไว้ถูกเก็บระหว่างจ็อบเมื่อ `turbo.json` เป็นของ turbo 2: มี key `tasks` ไม่มี `pipeline` และไม่มี `"envMode": "loose"` ไม่ต้องมี `TURBO_TOKEN` ไม่ต้องมีขั้นตอนแคช
- **`node_modules` ถูกลบหลังแต่ละจ็อบ** matrix ของเวอร์ชัน Node ที่ใช้โค้ดที่ checkout ไว้ชุดเดียวกันจึงไม่โหลด native addon ที่ build ไว้สำหรับ Node เวอร์ชันอื่น
- **เครื่องมืออยู่ต่อ:** เวอร์ชัน Node ที่ `setup-node` ติดตั้ง ตัว pnpm เอง อิมเมจและ layer ของ Docker

พื้นที่แคชอย่างน้อย 7× ของ GitHub บน S จ็อบเลือกขนาดด้วยเลเบล:

| เลเบล | เครื่อง | แพ็กเกจ |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 ต่อเดือน |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 ต่อเดือน |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 ต่อเดือน |

ไม่จำกัดนาที ที่ 20,000 นาทีต่อเดือนบน 4 vCPU 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. เข้าสู่ระบบ Skipbox ด้วย GitHub
2. ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
3. เปลี่ยน `runs-on` แล้ว push

คงขั้นตอนแคชไว้ตามเดิม สิ่งที่มันบันทึกอยู่ข้างเครื่อง

## ความปลอดภัย

- เครื่องเป็นของบัญชีคุณเท่านั้น ไม่มีจ็อบของบริษัทอื่นรันบนเครื่องนี้
- หลังทุกจ็อบ ข้อมูลรับรองของรันเนอร์ โปรเซส และคอนเทนเนอร์จะถูกลบ รวมถึงข้อมูลรับรองของ git, hook และไฟล์ที่ไม่ถูก track ในโค้ดที่ checkout เก็บไว้ การตั้งค่า **VM ใหม่ทุกจ็อบ** ให้แต่ละจ็อบได้เครื่องใหม่แทน
- โค้ดจากคนที่ไม่มีสิทธิ์เขียน (เช่น pull request จาก fork) รันบน VM ใหม่ที่อ่านแคชของคุณได้แต่แก้ไขไม่ได้

รายละเอียดอยู่ใน[วิธีแยกจ็อบออกจากกัน](https://docs.skipbox.dev/th/isolation)

## ลองกับ monorepo

ทดลองใช้ฟรี 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร ย้ายจ็อบ build ไปที่ `runs-on: skipbox` รันสองครั้ง แล้ววางบรรทัด install และ turbo ของการรันครั้งที่สอง (`cached` เทียบกับ `executing`) ไว้ข้างของ GitHub

## คำถามที่พบบ่อย

### จะเร่งความเร็ว monorepo แบบ pnpm/Turborepo ขนาดใหญ่ใน GitHub Actions อย่างไร

สามอย่าง ตามลำดับ รันเฉพาะสิ่งที่เปลี่ยน: turbo run build --affected กับการ checkout ที่มีประวัติ (fetch-depth: 0 และ filter: blob:none) ให้แคชแก่ turbo ที่อยู่รอดหลังจ็อบ: Remote Cache ของ Turborepo หรือ .turbo ที่กู้คืนด้วย actions/cache และเก็บ store ของ pnpm ไว้: cache: pnpm ของ setup-node หรือ actions/cache บน path ของ store บน VM ใหม่ของ GitHub ทุกอย่างนั้นคือการดาวน์โหลดทุกจ็อบ บนเครื่องที่เก็บดิสก์ไว้ มันอยู่ที่นั่นแล้ว CI ของ astro ใช้ 528 วินาทีบน GitHub และ 30 วินาทีบนเครื่องเฉพาะของตัวเองใน Skipbox ที่เก็บแคชของ turbo และ store ของ pnpm ไว้

### ทำไม pnpm install ถึงช้าใน GitHub Actions แม้จะแคช store ไว้แล้ว

เพราะ store ที่กู้คืนก็ยังเป็นไฟล์บีบอัดที่ดาวน์โหลดและแตกไฟล์บน VM ใหม่ แล้ว pnpm ก็ link node_modules ให้ทุกแพ็กเกจของ workspace เอกสาร CI ของ pnpm เองบอกว่าการแคช store ไม่ได้รับประกันว่าการติดตั้งจะเร็วขึ้น store ที่อยู่บนดิสก์ของเครื่องอยู่แล้วข้ามการดาวน์โหลดไปได้ เหลือแค่การ link

### แคชของ Turborepo ใช้ได้ใน GitHub Actions ไหม

ใช้ได้เฉพาะเมื่อแคชอยู่ได้นานกว่าจ็อบ Turborepo เก็บผลลัพธ์ของ task ไว้ใน .turbo/cache บนเครื่อง และเครื่องของจ็อบบนรันเนอร์ที่ GitHub โฮสต์หายไปเมื่อจ็อบจบ CI จึงต้องใช้ Remote Caching (TURBO_TOKEN และ TURBO_TEAM ของ Vercel หรือแบบ self-hosted) หรือขั้นตอน actions/cache สำหรับ .turbo บนเครื่องเฉพาะของตัวเองใน Skipbox .turbo ในโค้ดที่ checkout ไว้อยู่ต่อระหว่างจ็อบสำหรับโปรเจกต์ turbo 2 turbo จึงเล่นซ้ำ task ที่ไม่เปลี่ยนได้โดยไม่ต้องมี remote cache

### turbo --affected ใช้ได้ใน GitHub Actions ไหม

ใช้ได้ Turborepo อ่าน GITHUB_BASE_REF บน pull request และ GITHUB_EVENT_PATH บน push เพื่อหา base ที่ใช้เทียบ มันต้องการประวัติ: ถ้าเป็น shallow clone ทุกแพ็กเกจจะนับว่าเปลี่ยน ตั้ง fetch-depth: 0 และ filter: blob:none บน actions/checkout

### Skipbox เก็บอะไรไว้ให้ monorepo แบบ Turborepo

store ของ pnpm แคชของ npm และของแต่ละเครื่องมือ เครื่องมือที่ setup-node ติดตั้ง layer ของ Docker และโค้ดที่ checkout ไว้พร้อม .turbo ระดับบนสุดเมื่อ turbo.json เป็นของ turbo 2 (มี key tasks ไม่มี pipeline และไม่ใช่ envMode loose) node_modules ถูกลบหลังแต่ละจ็อบ install จึงรัน จาก store บนดิสก์ turbo เล่นซ้ำ task เฉพาะเมื่อ hash ของ input เท่าเดิม commit จึงรันซ้ำเฉพาะส่วนที่มันแตะ

### ลองใช้มีค่าใช้จ่ายเท่าไร

ไม่เสียเลย ทดลองใช้ได้ 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร ย้ายจ็อบ build ของ monorepo ไปที่ runs-on: skipbox รันสองครั้ง แล้วเทียบขั้นตอน install และ turbo ของการรันครั้งที่สองกับของ GitHub

อัปเดต 2026-11-19 · https://skipbox.dev/th/guides/pnpm-turborepo-monorepo-github-actions
