Skipbox

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

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

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

작업마다 받는 이유

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

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

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

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

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

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 말고는 바뀌지 않아요.

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에서는 실행 시간이 무제한이에요.

GitHub 쪽 금액은 GitHub Team에 포함된 사용량을 뺀 금액이에요. 내 실행 시간은 홈 페이지의 계산기에 넣어 보세요.

옮기는 건 한 줄이에요

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

같은 워크플로에서 이미지도 빌드하나요? docker build와 buildx는 GitHub Actions의 Docker 레이어 캐시에서 다뤄요.

보안

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

자세한 내용은 작업을 분리하는 방식에 있어요.

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

무료 체험은 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일 업데이트

캐시가 늘 살아 있는 더 빠른 CI/CD

캐시가 남는 전용 실행기를 정액으로

머신은 Skipbox가 준비해요. 바꿀 건 한 줄뿐이에요. 최대로 쓰면 비용은 GitHub의 1/12. 정액이라 하루 종일 돌려도 돼요. 캐시 용량은 GitHub의 7배.

  • 카드 불필요
  • GitHub로 로그인
  • 언제든 해지