# แคช layer ของ Docker ใน GitHub Actions: ทำไมทุก build เริ่มแบบเย็น และวิธีเก็บ layer ไว้

> ทุกจ็อบ GitHub Actions เริ่มบน VM ใหม่ที่ไม่มี build cache ของ Docker และไม่มีอิมเมจที่ดึงไว้ และ builder เริ่มต้นของ setup-buildx-action ก็เริ่มว่างเปล่า cache-to และ cache-from ของ buildx (gha, registry, local) นำ layer กลับมาด้วยการดาวน์โหลด ภายใน 10 GB ของ GitHub รันเนอร์ที่เก็บ build cache ของ Docker ไว้บนดิสก์ไม่ต้องใช้สิ่งเหล่านั้นเลย ในราคาเหมาจ่าย $39 ต่อเดือน

แคช 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 ต่อเดือน ไม่จำกัดนาที

- GitHub: VM ใหม่ต่อจ็อบ จึงไม่มี layer ไม่มีอิมเมจ และได้ buildx builder ที่ว่างเปล่าทุกการรัน
- Skipbox: build cache และอิมเมจของ Docker อยู่บนดิสก์ของเครื่องคุณ layer ที่ไม่เปลี่ยนจึงไม่ต้อง build หรือดาวน์โหลดใหม่
- 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-docker-layer-cache-github-actions-th)

## ทำไมทุก build เริ่มแบบเย็น

- **VM ใหม่ต่อจ็อบ** [เอกสารอ้างอิงรันเนอร์](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)ของ GitHub (ภาษาอังกฤษ) บอกว่ารันเนอร์ที่ GitHub โฮสต์แต่ละตัวคือ virtual machine (VM) ใหม่ที่ GitHub โฮสต์ ไม่มีอะไรที่จ็อบก่อน build หรือดึงมาอยู่บนนั้น
- **builder ที่ว่างเปล่า** [docker/setup-buildx-action](https://github.com/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](https://docs.docker.com/build/cache/backends/) และ[การจัดการแคชกับ GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/) ของ 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`](https://docs.docker.com/build/cache/backends/local/) (Buildx 0.35.0 ขึ้นไป) นับรวมใน 10 GB |

ไม่ว่าเลือก backend ไหน ให้[เรียงลำดับ Dockerfile](https://docs.docker.com/build/cache/optimize/) (ภาษาอังกฤษ) ให้ layer ที่เปลี่ยนน้อยที่สุดมาก่อน: คัดลอก lockfile และติดตั้ง dependency ก่อนคัดลอกซอร์สโค้ด ไม่เช่นนั้นทุก commit จะทำให้ layer การติดตั้งใช้ไม่ได้ และไม่มีแคชไหนนำมันกลับมาได้

`mode=min` ซึ่งเป็นค่าเริ่มต้น เก็บเฉพาะ layer ของอิมเมจสุดท้าย `mode=max` เก็บ layer ของทุก stage multi-stage build จึง hit มากขึ้น และอัปโหลดมากขึ้นด้วย

การตั้งค่า `type=gha` ทั่วไป โดยให้แต่ละอิมเมจมี scope ของตัวเอง:

```yaml
- 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](https://github.com/reproducible-containers/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 ที่ใช้ครั้งล่าสุดนานที่สุด

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

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

1. เข้าสู่ระบบ Skipbox ด้วย GitHub
2. ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
3. เปลี่ยน `runs-on` แล้ว push

จ็อบแรก build ทุก layer จ็อบที่สองเจอมันบนเครื่องแล้ว

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

- เครื่องเป็นของบัญชีคุณเท่านั้น ไม่มีจ็อบของบริษัทอื่นรันบนเครื่องนี้
- หลังทุกจ็อบ ข้อมูลรับรองของรันเนอร์ โปรเซส และคอนเทนเนอร์จะถูกลบ รวมถึง `~/.docker/config.json` การล็อกอิน registry จึงไม่ส่งต่อไปยังจ็อบถัดไป การตั้งค่า **VM ใหม่ทุกจ็อบ** ให้แต่ละจ็อบได้เครื่องใหม่แทน
- โค้ดจากคนที่ไม่มีสิทธิ์เขียน (เช่น pull request จาก fork) รันบนเครื่องใหม่ที่ใช้แล้วทิ้ง ไม่เคยรันบนเครื่องของคุณ

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

## ลองกับ 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

อัปเดต 2026-11-19 · https://skipbox.dev/th/guides/docker-layer-cache-github-actions
