Skipbox

ขีดจำกัดขนาดแคชของ GitHub Actions: ทำไมแคชถูกลบ กู้คืนช้า หรือ miss

GitHub Actions ให้แคช 10 GB ต่อรีโพสิทอรี เมื่อรีโพสิทอรีเกินขนาดนั้น GitHub ยังบันทึกรายการใหม่ และลบรายการที่อ่านครั้งล่าสุดนานที่สุดจนกลับมาต่ำกว่าขีดจำกัด และลบทุกรายการที่ไม่มีจ็อบไหนอ่านมา 7 วัน branch หนึ่งอ่านได้เฉพาะแคชของตัวเองและของ default branch การรันแรกของ branch ใหม่จึงมัก miss และการ hit ก็ยังเป็นการดาวน์โหลด: ทุกจ็อบบนรันเนอร์ที่ GitHub โฮสต์เริ่มบน VM ใหม่ มันจึงดาวน์โหลดและแตกไฟล์ archive ใหม่ คุณเพิ่มขีดจำกัดได้ ที่ $0.07 ต่อ GB ต่อเดือนส่วนที่เกิน 10 GB และปรับ key ได้ แต่การดาวน์โหลดยังอยู่

Skipbox เอาการดาวน์โหลดออกไป จ็อบของคุณรันบนเครื่องที่โฮสต์ให้บัญชีของคุณเท่านั้น ซึ่งเก็บไว้ระหว่างจ็อบ แคชของ npm, pnpm, Gradle, Go และ Cargo และ layer ของ Docker จึงยังอยู่บนดิสก์จากจ็อบที่แล้ว (80 GB บน S เทียบกับ 14 GB บนรันเนอร์ของ GitHub) สิ่งที่ actions/cache บันทึกอยู่ข้างเครื่อง การกู้คืนจึงเป็นการอ่านในเครื่อง เปลี่ยนบรรทัดเดียวเป็น runs-on: skipbox ในราคาเหมาจ่าย $39 ต่อเดือน ไม่จำกัดนาที

กฎแคชของ GitHub

จากเอกสารอ้างอิง dependency caching, การคิดเงิน Actions และ changelog ของ GitHub เรื่องแคชที่เกิน 10 GB (ภาษาอังกฤษ):

ทำไมแคชถูกลบ

10 GB เดียวเก็บทุกอย่างที่รีโพสิทอรีบันทึก ทุก branch และทุก pull request บันทึกรายการของตัวเอง matrix ของ Node สามเวอร์ชันบนสองระบบปฏิบัติการบันทึกหกรายการ build cache type=gha ของ Docker ก็ไปอยู่ใน 10 GB เดียวกัน เมื่อการบันทึกในหนึ่งวันรวมกันเกินขีดจำกัด ทุกการบันทึกใหม่จะลบรายการที่เก่ากว่า ซึ่งบ่อยครั้งคือตัวที่จ็อบถัดไปต้องการ GitHub เรียกสิ่งนี้ว่า cache thrashing

เพื่อดูว่าอะไรทำให้เต็ม ให้แสดงรายการตามขนาด:

gh cache list --sort size_in_bytes --limit 20

หน้า Actions › Caches ของรีโพสิทอรีแสดงข้อมูลเดียวกัน พร้อม branch และการใช้ครั้งล่าสุดของแต่ละรายการ

ทำไมการกู้คืนช้า

cache hit บนรันเนอร์ที่ GitHub โฮสต์คือการดาวน์โหลดลง VM ใหม่ แล้วแตกไฟล์ เวลาของมันโตตาม archive แคชที่โตจนหลาย GB จึงอาจใช้เวลาพอๆ กับการติดตั้งที่มันควรช่วยข้าม การดาวน์โหลดที่ค้างจะถูกตัดด้วย segment timeout ของ actions/cache ซึ่งเป็น 10 นาทีโดยค่าเริ่มต้น (SEGMENT_DOWNLOAD_TIMEOUT_MINS)

การตั้งค่าส่วนใหญ่ยังกู้คืนได้น้อยกว่าที่คนคิด input cache: ของ setup-node บันทึกแคชการดาวน์โหลดของ package manager ไม่ใช่ node_modules: หลังกู้คืน npm ci ยังติดตั้งทุกแพ็กเกจ แคช pip ของ setup-python ก็เหมือนกัน: ไฟล์ที่ดาวน์โหลดกลับมา แต่ environment ถูกติดตั้งใหม่

ทำไมแคช miss

  • key เปลี่ยน key ที่มี hashFiles('**/package-lock.json') จะ miss ทุกครั้งที่ lockfile เปลี่ยน restore-keys ให้การตรงกันบางส่วน และ cache-hit จะอ่านได้ false
  • branch ใหม่ มันอ่านแคชของ default branch ได้ แต่อ่านของ feature branch อื่นไม่ได้ ถ้า default branch ไม่เคยรันเวิร์กโฟลว์ ก็ไม่มีอะไรให้อ่าน
  • ถูกลบ ขีดจำกัดหรือ 7 วันเอามันไป
  • ไม่เคยถูกบันทึก รายการแก้ไขไม่ได้ key ที่มีอยู่จึงไม่ถูกบันทึกอีก และเนื้อหาในแคชก็เก่าเท่ากับการบันทึกครั้งแรก pull request จาก fork อาจไม่ได้รับอนุญาตให้บันทึกเลย

การส่งไฟล์ไปยังจ็อบถัดไปของการรันเดียวกัน เป็นเครื่องมืออีกตัว แคชมีไว้สำหรับการรันครั้งถัดไป ผลลัพธ์ build ที่จ็อบหลังในเวิร์กโฟลว์เดียวกันต้องใช้ ส่งผ่าน actions/upload-artifact และ actions/download-artifact artifact มีพื้นที่เก็บของตัวเอง แยกจาก 10 GB และก็เป็นการดาวน์โหลดลง VM ใหม่เช่นกัน

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

  • เพิ่มขีดจำกัด ถูกลบน้อยลง ที่ $0.07 ต่อ GB ต่อเดือนส่วนที่เกิน 10 GB (ตัวอย่างของ GitHub เอง: ใช้เต็ม 200 GB คือ $13.30 ต่อเดือน) บนบัญชี Pro, Team หรือ Enterprise การกู้คืนยังเป็นการดาวน์โหลด และแคชที่ใหญ่ขึ้นก็ดาวน์โหลดนานขึ้น
  • บันทึกให้น้อยลง แคช ~/.npm หรือ pnpm store ไม่ใช่ node_modules หรือผลลัพธ์ build บันทึกเฉพาะบน default branch โดยใช้ actions/cache/restore ในทุกจ็อบ และ actions/cache/save ในจ็อบเดียว มันกินเวลาของคุณ และแคชที่เล็กลงก็กู้คืนได้น้อยลง
  • แก้ key ใช้ lockfile เป็น key เพิ่ม restore-keys และรันเวิร์กโฟลว์ใน push ไปยัง default branch เพื่อให้ branch ใหม่มีอะไรให้อ่าน
  • รันเนอร์แบบ self-hosted ที่เก็บดิสก์ไว้ ไม่มีการดาวน์โหลด ไม่มี 10 GB คุณต้องดูแลเครื่อง: อัปเดต OS เก็บกวาดระหว่างจ็อบโดยไม่ลบแคช และซ่อมเมื่อพัง

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

แคชมีอยู่เพราะเครื่องลืม รันเนอร์ที่ GitHub โฮสต์คือ VM ใหม่ทุกจ็อบ จ็อบจึงบันทึกสถานะไปที่พื้นที่เก็บของ GitHub แล้วดึงกลับมาครั้งหน้า บนเครื่องที่อยู่ต่อ สถานะนั้นอยู่บนดิสก์อยู่แล้ว: แคชของ package manager, tool cache, อิมเมจและ build cache ของ Docker และแม้แต่ผลลัพธ์ build

ความต่างเห็นได้ใน CI ของโปรเจกต์จริง จากการรันจ็อบของพวกเขาเองของเรา:

  • astro (Node.js, Turborepo): 528 s บน GitHub 30 s บนเครื่องเฉพาะของคุณบน Skipbox ซึ่งเก็บแคชของ turbo ไว้ การรันแบบ warm จึง replay งาน build 40 งานแทนที่จะรันใหม่
  • helix (Rust): ขั้นตอน toolchain และแคชใช้ 9-10 s บนเครื่องเฉพาะของคุณ เทียบกับ 41-46 s บน GitHub
  • tauri (Rust): 246 s บน GitHub 53 s บนเครื่องเฉพาะของคุณ โดยเก็บ target/ ไว้ระหว่างจ็อบ

Skipbox เก็บแคชไว้บนเครื่องของคุณ

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

  • แคชแพ็กเกจอยู่บนดิสก์: ~/.npm, pnpm store, ~/.cache ของแต่ละเครื่องมือ และแคชของ Go, Gradle, Cargo และ Maven พร้อมเครื่องมือที่ setup-* ติดตั้ง ไม่มีอะไรต้องกู้คืน
  • อิมเมจ layer และ build cache ของ Docker ก็อยู่ต่อ docker build ใช้ layer ของ build ครั้งก่อนซ้ำ (แคช layer ของ Docker)
  • **actions/cache, setup-* และ rust-cache ไม่ต้องแก้** สิ่งที่มันบันทึกอยู่ข้างเครื่องแทนที่จะอยู่ในพื้นที่เก็บของ GitHub มีที่มากกว่า 10 GB ต่อรีโพสิทอรีของ GitHub และการกู้คืนอ่านจากในเครื่อง
  • ไม่มีการหมดอายุ 7 วันบนดิสก์ ไม่มีอะไรถูกลบจนกว่าดิสก์จะเกือบเต็มหลังจบจ็อบ แล้วสิ่งที่ใช้ครั้งล่าสุดนานที่สุดจะถูกลบก่อน

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

ubuntu-latest ของรีโพสิทอรีส่วนตัวมี 2 CPU, 8 GB และ SSD 14 GB บน Skipbox ไม่จำกัดนาที ที่ 20,000 นาทีต่อเดือนบน 4 vCPU GitHub คิด $222 Skipbox S คือ $39 ถูกกว่า $183

ย้ายมาแค่บรรทัดเดียว

jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
  1. เข้าสู่ระบบ Skipbox ด้วย GitHub
  2. ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
  3. เปลี่ยน runs-on แล้ว push

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

ความปลอดภัย

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

รายละเอียดอยู่ในวิธีแยกจ็อบออกจากกัน

ลองกับจ็อบที่แคช miss

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

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

ขีดจำกัดขนาดแคชของ GitHub Actions คือเท่าไร

10 GB ต่อรีโพสิทอรีเป็นค่าเริ่มต้น รวมทุก branch และทุกเวิร์กโฟลว์ เมื่อเกิน GitHub ยังบันทึกรายการใหม่ และลบรายการตามลำดับการเข้าถึงครั้งล่าสุด เก่าสุดก่อน จนรีโพสิทอรีกลับมาต่ำกว่าขีดจำกัด รายการที่ไม่มีจ็อบไหนอ่านมา 7 วันถูกลบไม่ว่าขนาดเท่าไร บนบัญชี Pro, Team หรือ Enterprise ผู้ดูแลเพิ่มขีดจำกัดและจำนวนวันได้ พื้นที่ที่เกิน 10 GB คิดเงิน $0.07 ต่อ GB ต่อเดือน วัดจากค่าสูงสุดของแต่ละชั่วโมง และเมื่อถึงงบประมาณ แคชจะกลายเป็นอ่านอย่างเดียวจนถึงรอบบิลถัดไป

ทำไมแคชของ GitHub Actions ถูกลบบ่อยนัก

เพราะทุกอย่างในรีโพสิทอรีใช้ 10 GB เดียวกัน: ทุก branch ทุก pull request ทุกจ็อบใน matrix และทุก OS บันทึกรายการของตัวเอง และแคช type=gha ของ Docker ก็ไปอยู่ที่เดียวกัน เมื่อการบันทึกในหนึ่งวันรวมกันเกินขีดจำกัด ทุกการบันทึกจะลบรายการที่เก่ากว่า และจ็อบถัดไปก็ miss ตัวที่มันต้องการ GitHub เรียกสิ่งนี้ว่า cache thrashing ดูรายการตามขนาด (gh cache list --sort size_in_bytes) เพื่อดูว่าอะไรทำให้เต็ม

ทำไมการกู้คืนแคชใช้เวลาพอๆ กับการติดตั้งใหม่ตั้งแต่ต้น

เพราะการ hit ยังเป็นการดาวน์โหลด ทุกจ็อบบนรันเนอร์ที่ GitHub โฮสต์เริ่มบน VM ใหม่ actions/cache จึงดาวน์โหลด archive และแตกไฟล์ทุกครั้ง และแคชยิ่งใหญ่ก็ยิ่งใช้เวลานาน แคชของ setup-node นำแคชการดาวน์โหลดของ package manager กลับมา ไม่ใช่ node_modules npm ci จึงยังติดตั้งทุกแพ็กเกจหลังกู้คืน บนรันเนอร์ที่เก็บดิสก์ไว้ แคชอยู่ที่นั่นแล้วและไม่มีอะไรต้องดาวน์โหลด

ทำไม actions/cache ถึง miss บน branch ใหม่

การรันกู้คืนแคชได้จาก branch ของตัวเองและจาก default branch และการรันของ pull request ยังกู้คืนจาก base branch ได้ด้วย แต่อ่านแคชของ branch ข้างเคียงไม่ได้ การรันแรกของ feature branch จึง hit ก็ต่อเมื่อ default branch บันทึก key นั้นไว้ รันเวิร์กโฟลว์ใน push ไปยัง default branch เพื่อให้มันบันทึก และเพิ่ม restore-keys สำหรับการตรงกันบางส่วน cache-hit เป็น true เฉพาะเมื่อ key ตรงกันทุกตัวอักษร

Skipbox เก็บ Actions cache ได้เท่าไร

มากกว่า 10 GB ต่อรีโพสิทอรีของ GitHub และอยู่ข้างเครื่องของคุณแทนที่จะอยู่ในพื้นที่เก็บของ GitHub บนเครื่องคลาวด์ สิ่งที่จ็อบบันทึกด้วย actions/cache, setup-* และ rust-cache อยู่บนดิสก์ของเครื่องเอง ได้สูงสุดครึ่งหนึ่งของดิสก์นั้น (80 GB บน S, 160 GB บน M, 320 GB บน L) บนโฮสต์ของ Skipbox แคชของโฮสต์เก็บได้ 20 GB ต่อรีโพสิทอรี ไม่ว่าแบบไหน รายการถูกเก็บไว้ 7 วันหลังใช้ครั้งล่าสุด ด้วยกฎ branch แบบเดียวกับ GitHub แคชแพ็กเกจและ layer ของ Docker ไม่ผ่านตรงนั้น: มันอยู่บนดิสก์โดยตรง

อะไรล้างแคชบนเครื่อง Skipbox

ไม่มีอะไรถูกลบระหว่างจ็อบ: แคชอยู่บนเครื่องต่อ และเฉพาะเมื่อจ็อบทำให้ดิสก์เกือบเต็ม สิ่งที่ใช้ครั้งล่าสุดนานที่สุดจึงถูกลบก่อน เครื่องเริ่มใหม่แบบสะอาดเมื่อรีเซ็ต: เมื่อคุณกด รีเซ็ตเครื่อง เมื่ออิมเมจของมันถูกอัปเดต (อย่างน้อยเดือนละครั้ง) เมื่อเครื่องตรวจสุขภาพไม่ผ่านหลังจบจ็อบ และเมื่อจ็อบถึงขีดจำกัด 6 ชั่วโมง เมื่อแพ็กเกจสิ้นสุด เครื่องถูกลบพร้อมดิสก์

ลองใช้เสียเท่าไร

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

อัปเดต 19 พฤศจิกายน 2026

CI/CD ที่เร็วขึ้นด้วยแคชที่พร้อมเสมอ

รันเนอร์ที่พร้อมทำงานเสมอ ในราคาเหมาจ่าย

เราโฮสต์ให้ คุณแก้แค่บรรทัดเดียว ค่าใช้จ่ายเพียง 1/12 ของ GitHub เมื่อใช้เต็มที่ ราคาเหมาจ่าย จึงรันได้ทั้งวัน พื้นที่แคช 7 เท่าของ GitHub

  • ไม่ต้องใช้บัตร
  • เข้าสู่ระบบด้วย GitHub
  • ยกเลิกได้ทุกเมื่อ