# GitHub Actions 작업마다 docker compose가 이미지를 전부 받을 때: 같은 이미지를 그만 받는 방법

> GitHub Actions의 작업은 Docker 이미지가 하나도 없는 새 VM에서 시작하므로, docker compose up이 Postgres, Redis, 그 밖의 모든 서비스 이미지를 다시 받아요. docker save와 actions/cache는 GitHub의 10 GB 안에서 다운로드 위치만 옮길 뿐이에요. 디스크를 유지하는 실행기에는 이미지가 이미 있어요. Skipbox가 그런 실행기예요. 월 $39 정액이고, runs-on 한 줄만 바꾸면 돼요.

`docker compose up`이 GitHub Actions 작업마다 이미지를 전부 받는 건, GitHub 호스팅 실행기의 작업이 매번 새 VM에서 시작하기 때문이에요. Postgres, Redis, 메시지 브로커, 직접 만든 서비스 이미지까지 디스크에 하나도 없으니, Compose가 첫 테스트 전에 모두 받고 풀어요. 같은 이미지를 그만 받으려면 이미지를 아직 가진 머신에서 작업을 돌리면 돼요.

Skipbox가 그 머신이에요. 작업은 내 계정 전용 머신에서 돌고, 그 머신이 작업 사이에도 Docker 이미지, 레이어, 빌드 캐시를 남겨요. `docker compose up`은 지난번에 받은 것을 찾아 컨테이너를 시작해요. `runs-on: skipbox` 한 줄만 바꾸면 월 $39 정액에 실행 시간 무제한이에요.

- GitHub: 작업마다 새 VM이라서, compose 파일의 모든 이미지를 작업마다 다시 받아요
- Skipbox: 이미지가 내 머신의 디스크에 남고, 바뀐 레이어만 받아요
- 4 vCPU로 월 20,000분: GitHub에서 $222, Skipbox에서 $39

**GitHub Actions를 정액으로, 실행 시간 무제한** Skipbox는 GitHub Actions 작업을 나만 쓰는 전용 머신에서 돌려요. 몇 분을 돌리든 가격은 월 $39 그대로예요. Docker 레이어와 의존성 캐시가 작업 사이에도 남아서 다음 작업이 바로 시작돼요.

4 vCPU 실행기, 매달 20,000분: GitHub $222 → Skipbox $39. 매달 $183 절약.

옮기는 데는 한 줄이면 돼요: `runs-on: skipbox`.

[7일 무료 체험 시작하기](https://app.skipbox.dev/sign-in?ref=g-docker-compose-pull-slow-github-actions-ko)

## 작업마다 받는 이유

- **작업마다 새 VM.** GitHub의 [실행기 문서](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)(2026년 11월 14일 확인)에 따르면, GitHub 호스팅 실행기는 매번 GitHub가 호스팅하는 새 가상 머신(VM)이에요. 지난 작업이 받은 것은 하나도 없어요.
- **Compose는 없는 것을 받아요.** 기본 [`pull_policy`](https://docs.docker.com/reference/compose-file/services/)는 `missing`이에요. 플랫폼 캐시에 이미지가 없을 때만 받는다는 뜻이에요. 새 VM에서는 모든 이미지가 없어요.
- **받기는 다운로드와 풀기예요.** 레이어마다 받고, 압축을 풀고, VM의 디스크에 써요. 프라이빗 리포지토리의 `ubuntu-latest`는 이 일을 CPU 2개와 SSD 14 GB로 해요.

그래서 첫 테스트 전까지의 시간은 compose 파일의 크기만큼이고, 푸시할 때마다 그대로 치러요.

## GitHub 호스팅 실행기에서 할 수 있는 것

어떤 방법도 다운로드 위치만 옮길 뿐, 없애지는 못해요.

| 방법 | 작업마다 여전히 하는 일 | 한계 |
|---|---|---|
| `docker save` + actions/cache + `docker load` | 아카이브를 받고, 모든 이미지를 Docker에 불러와요 | 다른 모든 캐시와 함께 쓰는 GitHub의 리포지토리당 10 GB에 들어가요 |
| 더 작은 이미지(`-alpine`, `-slim`) | 모두 받되, 더 빨리 | 이미지마다 작은 변형이 있는 만큼만 |
| 작업당 서비스 줄이기 | 이미지를 덜 받아요 | 전체 스택이 필요한 테스트는 여전히 다 받아요 |

모두 잘 잊는 머신을 덜 잊게 하는 방법이에요. 받기는 머신이 기억할 때만 사라져요.

## Skipbox는 이미지를 내 머신에 남겨요

요금제마다 작업 사이에도 유지되는 내 계정 전용 머신이 따라와요.

- **이미지가 디스크에 남아요.** `docker compose up`이 지난번에 받은 이미지를 찾아 바로 컨테이너를 시작해요.
- **바뀐 것만 받아요.** `docker compose pull`은 바뀐 레이어만 받고 나머지는 다시 써요.
- **직접 만든 서비스 이미지는 캐시로 빌드돼요.** `docker compose build`가 `cache-from`이나 `cache-to` 없이 지난 빌드의 레이어를 다시 써요.
- **작업마다 깨끗한 시작.** 작업이 끝날 때마다 Skipbox가 모든 컨테이너를 지우고 레지스트리 로그인(`~/.docker/config.json`)을 삭제해요. 다음 작업은 디스크에 이미 있는 이미지로 서비스를 새로 시작해요.
- **담을 공간이 있어요.** 디스크는 S가 80 GB이고, GitHub 실행기는 14 GB예요. 작업이 끝난 뒤 디스크가 거의 찰 때까지는 아무것도 지우지 않고, 그때가 되면 dangling 이미지부터, 그다음 가장 오래전에 쓴 빌드 캐시를 지워요.

워크플로는 `runs-on` 말고는 바뀌지 않아요.

```yaml
jobs:
  integration:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: docker compose up -d --wait
      - run: npm ci && npm run test:integration
```

actions/cache와 `docker load`로 이미지를 저장하고 있었다면, 그 단계는 지우세요. Skipbox의 첫 작업이 모든 이미지를 한 번 받아요. 두 번째 작업은 머신에서 찾아요.

작업은 레이블로 크기를 골라요.

| 레이블 | 머신 | 디스크 | 요금제 |
|---|---|---|---|
| `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 |

## 같은 실행 시간, 정액

통합 테스트는 긴 작업이라서, 분 단위 청구액을 키우는 것도 바로 이 작업이에요. Skipbox에서는 실행 시간이 무제한이에요.

| 월 실행 시간(4 vCPU) | GitHub | Skipbox S | 매달 아끼는 금액 |
|---|---|---|---|
| 10,000분 | $102 | $39 | **$63** |
| 20,000분 | $222 | $39 | **$183** |
| 30,000분 | $342 | $39 | **$303** |

GitHub 쪽 금액은 GitHub Team에 포함된 사용량을 뺀 금액이에요. 내 실행 시간은 [홈 페이지의 계산기](https://skipbox.dev/?ref=g-docker-compose-pull-slow-github-actions-ko#cost)에 넣어 보세요.

## 옮기는 건 한 줄이에요

1. GitHub로 Skipbox에 로그인하세요.
2. Skipbox GitHub App을 설치하고 리포지토리를 고르세요.
3. 통합 테스트 작업의 `runs-on`을 바꾸고 푸시하세요.

같은 워크플로에서 이미지도 빌드하나요? `docker build`와 buildx는 [GitHub Actions의 Docker 레이어 캐시](https://skipbox.dev/ko/guides/docker-layer-cache-github-actions)에서 다뤄요.

## 보안

- 머신은 내 계정만 써요. 다른 회사의 작업은 그 머신에서 돌지 않아요.
- 작업이 끝날 때마다 실행기의 자격 증명, 프로세스, 컨테이너를 지우고, `~/.docker/config.json`도 지워서 레지스트리 로그인이 다음 작업으로 넘어가지 않아요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요.
- 쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 내 머신이 아니라 한 번 쓰고 버리는 새 머신에서 돌아요.

자세한 내용은 [작업을 분리하는 방식](https://docs.skipbox.dev/ko/isolation)에 있어요.

## 통합 테스트로 체험해 보세요

무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지 무료이고, 카드가 필요 없어요. 작업을 `runs-on: skipbox`로 옮기고 두 번 돌린 뒤, 두 번째 실행의 `docker compose up`을 GitHub와 나란히 놓아 보세요.

## 자주 묻는 질문

### GitHub Actions에서 docker compose 기반 통합 테스트가 대부분의 시간을 이미지 받는 데 써요. 작업마다 같은 이미지를 받지 않으려면 어떻게 하나요?

디스크를 유지하는 머신에서 작업을 돌리세요. GitHub 호스팅 실행기는 작업마다 새 VM이라서 어떤 이미지도 남지 않고, compose가 모두 다시 받아요. Skipbox에서는 작업이 내 계정 전용 머신에서 돌고, 그 머신이 작업 사이에도 Docker 이미지를 남겨요. docker compose up은 지난번에 받은 이미지를 찾아 컨테이너를 시작해요. 바꿀 건 runs-on: skipbox 한 줄이고, 월 $39 정액에 실행 시간 무제한이에요.

### GitHub Actions의 작업마다 docker compose가 왜 이미지를 다시 받나요?

Compose는 머신에 이미지가 없으면 받는데, GitHub 호스팅 실행기에는 늘 없기 때문이에요. GitHub의 실행기 문서에 따르면 GitHub 호스팅 실행기는 매번 새 가상 머신이고, 지난 작업이 받은 것은 하나도 없어요. 이미지가 있었다면 Compose의 기본 pull_policy인 missing이 받기를 건너뛰었을 거예요.

### actions/cache로 docker compose 이미지를 캐시할 수 있나요?

할 수 있지만 다운로드 위치만 옮길 뿐이에요. docker save가 이미지를 tar 파일로 쓰고, actions/cache가 저장하고, 다음 작업이 복원해서 docker load를 돌려요. 작업마다 아카이브 전체를 받고 Docker에 불러와야 하고, 아카이브는 의존성 캐시와 함께 쓰는 GitHub의 리포지토리당 10 GB 캐시에 들어가요. 디스크를 유지하는 머신에서는 저장하거나 불러올 것이 없어요.

### Skipbox는 작업 사이에 Docker 이미지를 남기나요?

네. 요금제마다 작업 사이에도 유지되는 내 계정 전용 머신이 따라오고, 그 디스크에 Docker 이미지, 레이어, 빌드 캐시가 남아요. 디스크는 S가 80 GB, M이 160 GB, L이 320 GB예요. 작업이 끝날 때마다 컨테이너를 지우고 레지스트리 로그인을 삭제해요. 이미지는 남아요.

### compose 파일의 이미지가 바뀌면 어떻게 되나요?

바뀐 레이어만 받아요. 작업마다 레지스트리를 확인하고 싶다면 docker compose up 앞에 docker compose pull을 넣으세요. Docker가 새 레이어를 받고, 머신의 디스크에 이미 있는 레이어는 다시 써요. docker compose build로 직접 빌드하는 이미지도 같은 방식으로 지난 빌드의 레이어를 다시 써요.

### 체험하는 데 비용이 얼마나 드나요?

들지 않아요. 무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지이고, 카드가 필요 없어요. 통합 테스트 작업을 runs-on: skipbox 레이블로 옮기고 두 번 돌린 뒤, 두 번째 실행의 docker compose up을 GitHub와 비교해 보세요.

2026-11-14 업데이트 · https://skipbox.dev/ko/guides/docker-compose-pull-slow-github-actions
