แคช layer ของ Docker ใน GitHub Actions: ทำไมทุก build เริ่มแบบเย็น และวิธีเก็บ layer ไว้
แคช layer ของ Docker หายไปในทุกการรัน GitHub Actions เพราะแต่ละจ็อบบนรันเนอร์ที่ GitHub โฮสต์เริ่มบน VM ใหม่: ไม่มี build cache ไม่มีอิมเมจที่ดึงไว้ builder เริ่มต้นของ docker/setup-buildx-action (docker-container) ก็เริ่มว่างเปล่าในทุกจ็อบและถูกลบตอนจบเช่นกัน วิธีแก้ที่ใช้กันคือ export แคชด้วย buildx cache-to: type=gha,mode=max และ cache-from: type=gha เก็บ layer ไว้ใน Actions cache ของ GitHub ซึ่งมี 10 GB ต่อรีโพสิทอรีและใช้ร่วมกับแคชอื่นทั้งหมด type=registry เก็บไว้ใน registry ของคุณ type=local เก็บในไดเรกทอรีที่คุณบันทึกด้วย actions/cache แต่ละวิธีเปลี่ยนการ build ใหม่ให้เป็นการอัปโหลดและดาวน์โหลดในทุกการรัน
Skipbox เก็บ layer ไว้ตรงที่ build รัน จ็อบของคุณรันบนเครื่องที่โฮสต์ให้บัญชีของคุณเท่านั้น ซึ่งเก็บอิมเมจ layer และ build cache ของ Docker ไว้ระหว่างจ็อบ บนดิสก์ 80 GB บน S เทียบกับ 14 GB บนรันเนอร์ของ GitHub docker build และ docker compose build ใช้ layer ของ build ครั้งก่อนซ้ำ และอิมเมจที่ compose ดึงไว้ก็อยู่บนดิสก์แล้ว setup-buildx-action ใช้ได้ตามเดิมโดยไม่ต้องแก้ และ builder ของมันก็เจอ layer เหล่านี้เช่นกัน เปลี่ยนบรรทัดเดียวเป็น runs-on: skipbox ในราคาเหมาจ่าย $39 ต่อเดือน ไม่จำกัดนาที
ทำไมทุก build เริ่มแบบเย็น
- VM ใหม่ต่อจ็อบ เอกสารอ้างอิงรันเนอร์ของ GitHub (ภาษาอังกฤษ) บอกว่ารันเนอร์ที่ GitHub โฮสต์แต่ละตัวคือ virtual machine (VM) ใหม่ที่ GitHub โฮสต์ ไม่มีอะไรที่จ็อบก่อน build หรือดึงมาอยู่บนนั้น
- builder ที่ว่างเปล่า docker/setup-buildx-action สร้างและบูต builder ด้วย driver
docker-containerเป็นค่าเริ่มต้น และcleanupของมัน (เปิดเป็นค่าเริ่มต้น) ลบ builder ตอนจบจ็อบ - ดิสก์ 14 GB
ubuntu-latestของรีโพสิทอรีส่วนตัวมี 2 CPU, 8 GB และ SSD 14 GB อิมเมจขนาดใหญ่ build cache ของมัน และ archive แคชที่ต้องแตกไฟล์ อาจทำให้พื้นที่หมดได้ ("no space left on device")
backend แคชของ buildx และต้นทุนของแต่ละตัว
จากcache backends และการจัดการแคชกับ GitHub Actions ของ Docker (ภาษาอังกฤษ):
| backend | layer ไปอยู่ที่ไหน | แต่ละการรันต้องจ่ายอะไร | ขีดจำกัด |
|---|---|---|---|
type=gha | Actions cache ของ GitHub | อัปโหลด layer ใหม่ ดาวน์โหลด layer ที่ต้องใช้ | 10 GB ต่อรีโพสิทอรีร่วมกับแคชอื่นทั้งหมด ลบตัวเก่าสุดก่อน scope เริ่มต้น buildkit ถูกเขียนทับทุก build และ cache API ของ GitHub จำกัดอัตรา |
type=registry | อิมเมจแคชแยกใน registry ของคุณ | ดึงแคชจาก registry แล้ว push ตัวใหม่ | การล็อกอิน registry ที่มีสิทธิ์ push และพื้นที่กับทราฟฟิกของ registry |
type=inline | อยู่ในตัวอิมเมจเอง | ดึงอิมเมจมาเพื่ออ่านแคช | ใช้ได้เฉพาะ mode=min: layer ของ stage ระหว่างทางไม่ถูกเก็บ |
type=local + actions/cache | ไดเรกทอรีที่บันทึกด้วย actions/cache | ดาวน์โหลดและแตกไฟล์ทั้งไดเรกทอรี แล้วอัปโหลดกลับ | โตขึ้นทุกการรัน เว้นแต่ใช้ reset=true (Buildx 0.35.0 ขึ้นไป) นับรวมใน 10 GB |
ไม่ว่าเลือก backend ไหน ให้เรียงลำดับ Dockerfile (ภาษาอังกฤษ) ให้ layer ที่เปลี่ยนน้อยที่สุดมาก่อน: คัดลอก lockfile และติดตั้ง dependency ก่อนคัดลอกซอร์สโค้ด ไม่เช่นนั้นทุก commit จะทำให้ layer การติดตั้งใช้ไม่ได้ และไม่มีแคชไหนนำมันกลับมาได้
mode=min ซึ่งเป็นค่าเริ่มต้น เก็บเฉพาะ layer ของอิมเมจสุดท้าย mode=max เก็บ layer ของทุก stage multi-stage build จึง hit มากขึ้น และอัปโหลดมากขึ้นด้วย
การตั้งค่า type=gha ทั่วไป โดยให้แต่ละอิมเมจมี scope ของตัวเอง:
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
with:
context: .
tags: app:ci
load: true
cache-from: type=gha,scope=app
cache-to: type=gha,scope=app,mode=max
cache mount ไม่อยู่รอด RUN --mount=type=cache (แคชของ package manager ภายใน build) ไม่ถูกเก็บใน GitHub Actions cache เป็นค่าเริ่มต้น เอกสารของ Docker ชี้ไปที่ buildkit-cache-dance เพื่อย้ายมันเข้าออก actions/cache ซึ่งคือการดาวน์โหลดและอัปโหลดเพิ่มอีกรอบต่อการรัน
docker compose ดึงทุกอิมเมจ ทุกจ็อบ
integration test ที่เริ่ม Postgres, Redis และ service อีกไม่กี่ตัวด้วย docker compose up จะดึงทุกอิมเมจในทุกจ็อบ เพราะ VM เป็นเครื่องใหม่ บนรันเนอร์ที่ GitHub โฮสต์ ตัวเลือกต่างๆ แค่ย้ายการดาวน์โหลด:
docker saveอิมเมจเป็นไฟล์ tar แคชด้วย actions/cache แล้วdocker loadในจ็อบถัดไป มันนับรวมใน 10 GB และการโหลดก็ใช้เวลาของมันเอง- build อิมเมจของ service ด้วย buildx และ backend แคชข้างต้น ซึ่งยังต้องดึงอิมเมจฐานอยู่ดี
เมื่อวิธีแก้คือเครื่องที่เก็บแคชของ Docker ไว้
ทุก backend ข้างต้นมีอยู่เพราะ builder ลืม Docker daemon ที่อยู่ต่อระหว่างจ็อบมี layer ของ build ครั้งก่อน cache mount ของมัน และทุกอิมเมจที่มันดึงมา อยู่บนดิสก์ของตัวเองแล้ว ไม่มีอะไรต้อง export ไม่มีอะไรต้อง import และไม่มี 10 GB ให้ต้องแบ่งกันใช้
Skipbox เก็บแคชของ Docker ไว้บนเครื่องของคุณ
ทุกแพ็กเกจมาพร้อมเครื่องเฉพาะของบัญชีคุณ ที่เก็บไว้ระหว่างจ็อบ:
docker buildและdocker compose buildใช้ layer ของ build ครั้งก่อนซ้ำ โดยไม่ต้องแก้เวิร์กโฟลว์- อิมเมจอยู่บนดิสก์
docker compose upเจออิมเมจที่ดึงไว้ครั้งก่อนdocker compose pullดึงเฉพาะ layer ที่เปลี่ยน - cache mount อยู่ต่อ ไปกับ build cache ของ Docker
RUN --mount=type=cacheจึงเก็บแคชของ package manager ไว้โดยไม่ต้องมีขั้นตอนเพิ่ม - docker/setup-buildx-action ใช้ได้ตามเดิมโดยไม่ต้องแก้ builder ของมันเริ่มจาก layer ที่ build ครั้งก่อนของรีโพสิทอรีคุณทิ้งไว้บนเครื่อง และคุณเอา
cache-fromและcache-toออกได้ เรารัน CI ของโปรเจกต์สาธารณะโปรเจกต์หนึ่งเองบนเครื่อง 4 vCPU (19 พฤศจิกายน 2026 อย่างละ 1 ครั้ง): ขั้นตอน build อิมเมจใช้ 177 วินาทีในการรันครั้งแรก และ 4 วินาทีเมื่อรันซ้ำ โดยมี 31 ขั้นตอนเป็น CACHED - ดิสก์: ไม่มีอะไรถูกลบจนกว่าดิสก์จะเกือบเต็มหลังจบจ็อบ แล้วอิมเมจที่ไม่มี tag ถูกลบก่อน ตามด้วย build cache ที่ใช้ครั้งล่าสุดนานที่สุด
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
with:
context: .
tags: app:ci
load: true
จ็อบเลือกขนาดด้วยเลเบล:
| เลเบล | เครื่อง | ดิสก์ | แพ็กเกจ |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 ต่อเดือน |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 ต่อเดือน |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 ต่อเดือน |
ไม่จำกัดนาที ที่ 20,000 นาทีต่อเดือนบน 4 vCPU GitHub คิด $222 Skipbox S คือ $39 ถูกกว่า $183
ย้ายมาแค่บรรทัดเดียว
- เข้าสู่ระบบ Skipbox ด้วย GitHub
- ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
- เปลี่ยน
runs-onแล้ว push
จ็อบแรก build ทุก layer จ็อบที่สองเจอมันบนเครื่องแล้ว
ความปลอดภัย
- เครื่องเป็นของบัญชีคุณเท่านั้น ไม่มีจ็อบของบริษัทอื่นรันบนเครื่องนี้
- หลังทุกจ็อบ ข้อมูลรับรองของรันเนอร์ โปรเซส และคอนเทนเนอร์จะถูกลบ รวมถึง
~/.docker/config.jsonการล็อกอิน registry จึงไม่ส่งต่อไปยังจ็อบถัดไป การตั้งค่า VM ใหม่ทุกจ็อบ ให้แต่ละจ็อบได้เครื่องใหม่แทน - โค้ดจากคนที่ไม่มีสิทธิ์เขียน (เช่น pull request จาก fork) รันบนเครื่องใหม่ที่ใช้แล้วทิ้ง ไม่เคยรันบนเครื่องของคุณ
รายละเอียดอยู่ในวิธีแยกจ็อบออกจากกัน
ลองกับ Docker build ของคุณ
ทดลองใช้ฟรี 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร ย้าย Docker build ของคุณไปที่ runs-on: skipbox รันสองครั้ง แล้ววางขั้นตอน build ของการรันครั้งที่สองไว้ข้างของ GitHub
คำถามที่พบบ่อย
ทำไมแคช layer ของ Docker หายไปในทุกการรัน GitHub Actions
เพราะแต่ละจ็อบบนรันเนอร์ที่ GitHub โฮสต์เริ่มบน VM ใหม่ ไม่มี build cache และไม่มีอิมเมจจากการรันครั้งก่อน docker/setup-buildx-action ซ้ำเติมอีก: เป็นค่าเริ่มต้นว่ามันสร้าง builder แบบ docker-container ที่เริ่มว่างเปล่าและถูกลบตอนจบจ็อบ ทุก layer จึงถูก build ใหม่ เว้นแต่คุณจะ export แคชด้วย cache-to และ import ด้วย cache-from หรือรันบนเครื่องที่เก็บ build cache ของ Docker ไว้
จะแคช layer ของ Docker ใน GitHub Actions อย่างไร
บนรันเนอร์ที่ GitHub โฮสต์ ใช้ cache exporter ของ buildx: cache-from: type=gha และ cache-to: type=gha,mode=max ใน docker/build-push-action เก็บ layer ไว้ใน Actions cache ของ GitHub (10 GB ต่อรีโพสิทอรี ใช้ร่วมกับแคชอื่นทั้งหมด) type=registry เก็บเป็นอิมเมจแยกใน registry ของคุณ และ type=local เก็บในไดเรกทอรีที่คุณบันทึกด้วย actions/cache ให้แต่ละอิมเมจมี scope ของตัวเองเมื่อใช้ type=gha เพราะ scope เริ่มต้นถูกเขียนทับทุก build บนเครื่องที่เก็บดิสก์ไว้ docker build ใช้ layer ซ้ำได้โดยไม่ต้องมี exporter
ทำไม buildx ที่ใช้ cache-to type=gha ยังช้าอยู่
เพราะ layer ยังต้องเดินทาง เมื่อใช้ mode=max ทุกการรันอัปโหลดทุก layer ใหม่ของทุก stage และการรันครั้งหลังดาวน์โหลด layer ที่ต้องใช้ แคชใช้ 10 GB ต่อรีโพสิทอรีของ GitHub ร่วมกับทุกอย่าง จึงถูกลบออก และ cache API ของ GitHub จำกัดอัตรา build ที่ส่งคำขอมากเกินไป builder ที่มี layer อยู่บนดิสก์แล้วข้ามได้ทั้งสองทิศทาง
จะหยุด docker compose ไม่ให้ดึงอิมเมจเดิมในทุกจ็อบได้อย่างไร
บนรันเนอร์ที่ GitHub โฮสต์ทำไม่ได้ ได้แค่ย้ายการดาวน์โหลด: docker save อิมเมจเป็นไฟล์ tar แคชด้วย actions/cache แล้ว docker load ในจ็อบถัดไป ซึ่งนับรวมใน 10 GB เดียวกัน และเป็นการดาวน์โหลดกับการโหลดทุกการรัน บนเครื่องที่เก็บดิสก์ไว้ อิมเมจที่ compose ดึงไว้ครั้งก่อนอยู่ที่นั่นแล้ว และ docker compose pull ดึงเฉพาะ layer ที่เปลี่ยน
ต้องแก้เวิร์กโฟลว์เพื่อเก็บแคชของ Docker บน Skipbox ไหม
แก้แค่ runs-on: เครื่องของบัญชีคุณเก็บอิมเมจ layer และ build cache ของ Docker ไว้ระหว่างจ็อบ docker build และ docker compose build ใช้สิ่งเหล่านี้ซ้ำ และ docker/setup-buildx-action ใช้ได้ตามเดิมโดยไม่ต้องแก้: builder ของมันเริ่มจาก layer ที่ build ครั้งก่อนของรีโพสิทอรีคุณทิ้งไว้บนเครื่อง คุณเอา cache-from และ cache-to ออกได้
ลองใช้เสียเท่าไร
ไม่เสียเลย ทดลองใช้ได้ 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร ย้าย Docker build ของคุณไปที่ runs-on: skipbox รันสองครั้ง แล้วเทียบขั้นตอน build ของการรันครั้งที่สองกับของ GitHub
อัปเดต 19 พฤศจิกายน 2026