เร่งความเร็ว monorepo แบบ pnpm และ Turborepo ใน GitHub Actions (astro: 528 วินาที เหลือ 30 วินาที)
ใน 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 ต่อเดือน ไม่จำกัดนาที
จ็อบของ 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 (ภาษาอังกฤษ): turbo run build --affected รัน task เฉพาะในแพ็กเกจที่เปลี่ยนเทียบกับ base branch ใน GitHub Actions มันอ่าน GITHUB_BASE_REF บน pull request และ GITHUB_EVENT_PATH บน push ถ้าเป็น shallow clone ทุกแพ็กเกจจะนับว่าเปลี่ยน จึงต้อง checkout ประวัติ:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web บอกจ็อบว่าควรรันหรือไม่ จ็อบของแอปที่ไม่ถูกแตะจึงข้าม install ได้
2. ให้แคชแก่ turbo ที่อยู่ได้นานกว่าจ็อบ
Turborepo เก็บผลลัพธ์ของ task ไว้ใน .turbo/cache บนเครื่อง (ภาษาอังกฤษ) เครื่องของจ็อบบนรันเนอร์ที่ GitHub โฮสต์ถูกลบเมื่อจ็อบจบ ใน CI แคชนั้นจึงเริ่มว่างทุกครั้ง มีสองทางเลี่ยง จากคู่มือ GitHub Actions ของ Turborepo (ภาษาอังกฤษ):
- 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 (ภาษาอังกฤษ) บอกไว้ตรงๆ ว่าการแคช 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 เอง โดยไม่แก้เวิร์กโฟลว์ จากการรันโปรเจกต์จริงของเรา:
| GitHub (รีโพสิทอรีสาธารณะ 4 vCPU 16 GB) | เครื่องเฉพาะของตัวเองใน Skipbox (4 vCPU) | |
|---|---|---|
| จ็อบ | 528 วินาที | 30 วินาที (31 วินาที, 28 วินาที) |
| 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 installlink จากดิสก์แทนการดาวน์โหลด - แคชของ turbo อยู่ต่อ
.turboระดับบนสุดในโค้ดที่ checkout ไว้ถูกเก็บระหว่างจ็อบเมื่อturbo.jsonเป็นของ turbo 2: มี keytasksไม่มี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
ย้ายมาแค่บรรทัดเดียว
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
- เข้าสู่ระบบ Skipbox ด้วย GitHub
- ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
- เปลี่ยน
runs-onแล้ว push
คงขั้นตอนแคชไว้ตามเดิม สิ่งที่มันบันทึกอยู่ข้างเครื่อง
ความปลอดภัย
- เครื่องเป็นของบัญชีคุณเท่านั้น ไม่มีจ็อบของบริษัทอื่นรันบนเครื่องนี้
- หลังทุกจ็อบ ข้อมูลรับรองของรันเนอร์ โปรเซส และคอนเทนเนอร์จะถูกลบ รวมถึงข้อมูลรับรองของ git, hook และไฟล์ที่ไม่ถูก track ในโค้ดที่ checkout เก็บไว้ การตั้งค่า VM ใหม่ทุกจ็อบ ให้แต่ละจ็อบได้เครื่องใหม่แทน
- โค้ดจากคนที่ไม่มีสิทธิ์เขียน (เช่น pull request จาก fork) รันบน VM ใหม่ที่อ่านแคชของคุณได้แต่แก้ไขไม่ได้
รายละเอียดอยู่ในวิธีแยกจ็อบออกจากกัน
ลองกับ 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
อัปเดต 19 พฤศจิกายน 2026