# GitHub Actions를 빠르게 하는 방법: 25분짜리 파이프라인을 하나씩 줄이기

> 느린 GitHub Actions 파이프라인은 서로를 기다리는 작업, 돌 필요가 없던 일, 빈 VM에서 되풀이하는 준비, 2코어에서 도는 CPU 중심 단계예요. 이 순서로 고치세요. 마지막 둘은 머신의 문제예요. Skipbox는 작업 사이에도 캐시를 내 전용 머신에 남기고, 최대 16 vCPU를 월 $39 정액, 실행 시간 무제한으로 줘요.

25분짜리 GitHub Actions 파이프라인은 대개 지연 네 가지가 쌓인 거예요. 서로를 기다리는 작업, 돌 필요가 없던 일, 빈 VM이 작업마다 되풀이하는 준비, 2코어에 밀어 넣은 CPU 중심 단계(프라이빗 리포지토리의 `ubuntu-latest`는 CPU 2개와 8 GB)예요. 이 순서로 다루세요. 먼저 대기 시간을 따로 두고 임계 경로를 재세요. 그다음 돌 필요 없던 것을 건너뛰고, 독립된 작업을 한꺼번에 돌리고, 상태를 다시 만드는 걸 멈추고, 무거운 단계에 코어를 더 주고, 그래도 긴 것을 샤딩하세요. 처음 셋은 비용 없는 워크플로 수정이에요. 나머지는 머신이에요. 작업 사이에도 캐시를 남기고 코어가 더 많은 실행기예요.

Skipbox가 그 실행기예요. 작업은 내 계정 전용 머신에서 돌고, 그 머신은 작업 사이에도 Docker 레이어, 패키지 캐시, 도구, 빌드 결과를 남기며, 4~16 vCPU를 월 $39 정액, 실행 시간 무제한으로 써요. astro의 CI에서는 GitHub 528초, Skipbox 30초였어요. 옮기는 건 한 줄이에요: `runs-on: skipbox`.

- 순서대로: 재기, 건너뛰기, 병렬로 돌리기, 다시 만들기 멈추기, 코어 더하기, 샤딩
- 내 전용 머신이 작업 사이에도 캐시와 빌드 결과를 남겨요. astro의 CI가 528초에서 30초로
- 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-speed-up-github-actions-ko)

## 1. 임계 경로 재기

팀이 기다리는 시간은 모든 작업의 합이 아니라, 마지막에 끝나는 작업 사슬이에요. 대표적인 풀 리퀘스트의 실행을 여세요. 그래프는 어떤 작업이 어떤 작업을 기다리는지, 작업마다의 로그는 단계별 시간을 보여 줘요. 가장 느린 사슬에 대해 적어 두세요.

| 단계 | 확인할 것 |
|---|---|
| Queued | 작업이 실행기를 기다렸나요? 명령을 빠르게 해도 대기열은 줄지 않아요 |
| Set up job, 체크아웃 | 내려받은 컨테이너 이미지, 얕은 클론이면 될 곳의 전체 클론 |
| 툴체인과 설치 | 캐시가 적중했나요? 적중이 복원에 든 시간보다 더 아꼈나요? |
| 빌드 | 같은 결과물을 다른 작업에서도 빌드하나요? |
| 테스트 | 실행기의 CPU가 내내 바쁜가요, 아니면 워커 하나가 다 하나요? |
| 업로드 | 쓸모 있는 일이 끝난 뒤의 아티팩트와 캐시 저장 |

데워진 실행과 콜드 실행을 비교하세요. 반쯤 빗나가는 캐시는 평균으로는 괜찮아 보여요.

## 2. 돌 필요 없던 것 건너뛰기

- **대체된 실행을 취소하세요.** 첫 푸시 이후의 푸시마다 진행 중인 실행이 쓸모없어져요. `cancel-in-progress`를 준 [concurrency 그룹](https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency)이 그것을 멈춰요. 기본 브랜치로의 푸시가 배포를 취소하지 않도록 풀 리퀘스트로 범위를 좁히세요.

```yaml
concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
```

- **변경이 건드린 것만 돌리세요.** `paths:` 필터는 문서만 바뀐 변경에서 워크플로를 건너뛰고, 모노레포에서는 `turbo run test --affected`나 Nx의 affected 명령이 바뀐 패키지만 돌려요. 트리거 수준의 필터는 필수 검사가 결과를 보고하지 않게 만드므로, 필수 검사라면 작업 안에서 거르세요.

## 3. 독립된 작업을 한꺼번에 돌리기

GitHub는 `needs:`로 이어지지 않는 한 작업을 병렬로 돌려요. 린트, 타입 검사, 단위 테스트, 빌드는 서로가 필요한 경우가 드물어요. 함께 시작하고, 패키징이나 배포만 그것들을 모두 기다리게 하세요. 두 작업이 같은 것을 빌드한다면 한 번만 빌드해 `actions/upload-artifact`로 넘기고, 업로드와 다운로드 시간을 재세요.

## 4. 같은 상태를 다시 만드는 걸 멈추기

긴 파이프라인의 대부분이 여기에 들어가요. GitHub 호스팅 실행기의 작업은 매번 새 VM에서 시작하므로, 툴체인을 내려받고, 의존성을 설치하고, Docker 레이어를 다시 빌드하고, 처음부터 컴파일해요. 매번이요.

- **정말 적중하는 캐시.** `actions/setup-node`의 `cache: npm`(pnpm과 yarn 형태도)은 잠금 파일을 키로 패키지 매니저의 다운로드를 저장해요. `node_modules`는 저장하지 않으므로 설치는 여전히 돌아요. GitHub는 리포지토리당 10 GB를 두고, 7일 동안 쓰지 않은 항목을 지우며, 적중해도 새 VM으로의 다운로드예요([캐시 용량 한도](https://skipbox.dev/ko/guides/github-actions-cache-size-limit)).
- **도구 캐시.** `eslint --cache`, `tsc --incremental`, Jest의 캐시 디렉터리, turbo의 `.turbo/cache`는 다운로드가 아니라 일 자체를 저장해요. 새 VM에서는 그것도 복원하지 않으면 비어 있어요.
- **Docker 레이어.** 새 VM의 `docker build`는 레이어 없이 시작해요. buildx `cache-to`로 내보내고 실행마다 불러오는 게 우회책이에요([Docker 레이어 캐시](https://skipbox.dev/ko/guides/docker-layer-cache-github-actions)).

디스크를 유지하는 머신은 이 모두를 저절로 해요. 캐시, 도구 캐시, 레이어, 빌드 결과가 지난 작업에서부터 거기 있어요.

## 5. 무거운 단계에 코어를 더 주기

컴파일러, 번들러, 테스트 러너는 코어마다 워커를 하나씩 띄우므로, CPU 2개에서는 둘씩 돌아요. 테스트 러너가 실제로 무엇을 쓰는지 확인하세요. [Jest](https://jestjs.io/docs/cli#--maxworkersnumstring)는 기본으로 코어 수 빼기 하나(CPU 2개에서 워커 하나), pytest는 `-n auto`까지 직렬로 돌고, [Playwright](https://playwright.dev/docs/ci#workers)는 기본으로 코어의 절반이며, 문서는 CI에서 워커 하나를 권해요. 코어를 더해도 실행기에 쓰라고 알려 줘야만 도움이 되고, CPU를 바쁘게 하는 단계에서만 그래요. 다운로드나 데이터베이스 시작은 빨라지지 않아요.

GitHub에서 코어를 늘린다는 건 [대형 실행기](https://docs.github.com/en/actions/concepts/runners/larger-runners)예요. 4~96코어이고, GitHub Team이나 Enterprise Cloud 조직만 쓸 수 있으며, 코어당 더 높은 요금으로 분 단위로 청구돼요.

## 6. 그래도 긴 것을 샤딩하기

샤드 행렬은 긴 스위트를 작업들로 나눠요. 걸리는 시간은 줄지만 실행 시간은 줄지 않아요. 샤드마다 다시 체크아웃하고, 설치하고, 빌드하므로, 샤드 넷이면 준비를 네 번 내요. 파일 수가 아니라 잰 시간으로 샤드를 나누고, 준비가 각 샤드의 대부분이 되면 더하는 걸 멈추세요.

## 느린 채로 두는 비용

하루 40번 도는 15분짜리 파이프라인은, 맥락 전환을 세기도 전에 매일 팀 전체에 흩어진 10시간의 기다림이에요. 분 단위 청구에서는 준비 시간도 테스트 시간처럼 청구돼요.

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

GitHub에서는 코어가 많을수록 1분당 비싸지므로, 머신이 커질수록 차이가 벌어져요.

| 월 20,000분 | GitHub | Skipbox | 매달 아끼는 금액 |
|---|---|---|---|
| 8 vCPU | $422 | $79 (M) | **$343** |
| 16 vCPU | $822 | $149 (L) | **$673** |

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

## 해결책이 머신일 때

실제 프로젝트의 CI 작업을, 단계는 바꾸지 않고, GitHub의 퍼블릭 리포지토리 실행기(4 vCPU, 16 GB)와 같은 vCPU의 Skipbox 전용 머신에서 돌렸어요. [그 워크플로를 돌린 우리 실행](https://skipbox.dev/ko/guides/rust-cache-slow-rust-ci)에서:

| 프로젝트 | GitHub | Skipbox, 전용 머신 | 머신이 남긴 것 |
|---|---|---|---|
| astro(Node.js, Turborepo) | 528초 | **30초** | turbo의 캐시: 빌드 작업 40개를 재생 |
| tauri(Rust) | 246초 | **53초** | Cargo의 `target/`: 다시 컴파일한 크레이트 없음 |
| ripgrep(Rust) | 200초 | **40초** | cross의 `target/`과 Docker 이미지 |
| vite(Node.js) | 141초 | 100초 | 패키지 캐시. 나머지는 테스트가 도는 시간 |

프라이빗 리포지토리의 `ubuntu-latest`는 위 GitHub 실행의 절반 코어예요.

## Skipbox가 파이프라인에 해 주는 것

**머신을 남겨요.** 요금제마다 작업 사이에도 유지되는 내 계정 전용 머신이 따라와요. Docker 이미지, 레이어, 빌드 캐시, 패키지 캐시, 도구 캐시, 그리고 Cargo의 `target/`과 turbo의 캐시가 든 체크아웃이 디스크에 남아요. GitHub 캐시 공간의 7배 이상이고, 키도, 7일 뒤의 만료도, 브랜치 규칙도 없어요.

**정액으로 코어를 더해요.** 작업은 레이블로 크기를 골라요.

| 레이블 | 머신 | 요금제 |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, 월 $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, 월 $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, 월 $149 |

실행 시간은 무제한이라, 샤드, 다시 실행, 더 큰 행렬도 청구액을 올리지 않아요. Skipbox 작업은 GitHub 실행 시간을 쓰지 않으므로, GitHub 예산이 멈출 일이 없어요.

**스스로 관리해요.** 머신 준비, 이미지 업데이트, 작업마다의 정리, 상태 점검에 실패한 머신의 재구성은 Skipbox가 해요.

## 옮기는 건 한 줄이에요

```yaml
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. GitHub로 Skipbox에 로그인하세요.
2. Skipbox GitHub App을 설치하고 리포지토리를 고르세요.
3. `runs-on`을 바꾸고 푸시하세요.

단계와 액션은 Docker, Node.js, Python이 있는 Ubuntu 24.04에서 그대로 돌아요.

## 보안

- 머신은 내 계정만 써요. 다른 회사의 작업은 그 머신에서 돌지 않아요.
- 작업이 끝날 때마다 실행기의 자격 증명, 프로세스, 컨테이너를 지우고, 남겨 둔 체크아웃의 git 자격 증명과 추적되지 않는 파일도 지워요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요.
- 쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 새 VM에서 돌고, 그 VM은 캐시를 읽을 수만 있고 바꿀 수는 없어요.

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

## 가장 느린 작업으로 체험해 보세요

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

## 자주 묻는 질문

### GitHub Actions 파이프라인이 25분 걸려요. 가장 빨리 빠르게 하는 방법은 무엇인가요?

차례대로 하세요. 실행의 그래프와 단계별 시간을 읽어, 대기 시간을 따로 두고 시간을 정하는 작업 사슬을 찾으세요. 대체된 실행을 취소하고, 파일이 바뀌지 않은 작업은 건너뛰세요. 습관으로만 붙인 needs:를 빼서, 독립된 작업을 한꺼번에 돌리세요. 작업마다 상태를 다시 만드는 걸 멈추세요. 정말 적중하는 캐시, 또는 디스크를 유지하는 실행기예요. CPU 중심 단계에 코어를 더 주고, 테스트 러너가 그것을 쓰게 하세요. 그래도 긴 것만 샤딩하세요. 프라이빗 리포지토리의 ubuntu-latest(CPU 2개, 8 GB)에서는 마지막 셋이 25분의 대부분인 경우가 많고, 그건 머신의 몫이에요. Skipbox는 작업 사이에도 캐시를 남기는 전용 머신을 4~16 vCPU로 작업에 줘요.

### 워크플로를 최적화하는 것보다 더 빠른 실행기로 바꾸는 게 나은가요?

무료인 워크플로 수정을 먼저 하세요. 대체된 실행 취소, 경로 필터, 불필요한 needs: 빼기는 비용이 없고, 어떤 실행기도 대신 해 주지 않아요. 그다음 남은 시간이 어디에 쓰이는지 보세요. 작업마다 되풀이하는 준비(툴체인, 의존성 설치, Docker 빌드)와 모든 코어를 바쁘게 하는 단계는 머신의 문제이고, 캐시를 남기고 코어가 더 많은 실행기가 runs-on 한 줄로 그것을 없애요. 네트워크 대기와 직렬 단계는 큰 머신으로도 빨라지지 않아요.

### GitHub Actions는 왜 내 노트북보다 느린가요?

노트북은 패키지, 도구, Docker 레이어, 빌드 결과를 디스크에 남기고, 대개 8코어 이상이에요. 프라이빗 리포지토리의 ubuntu-latest 작업은 그 어느 것도 없는 새 VM에서 CPU 2개와 8 GB를 받아요. Skipbox는 노트북처럼 움직여요. 머신이 작업 사이에도 남아 있고, 4 vCPU 이상이에요.

### 테스트를 샤딩하면 GitHub Actions가 빨라지나요?

걸리는 시간은 줄지만, 실행 시간은 줄지 않아요. 샤드마다 새 작업이라 다시 체크아웃하고, 설치하고, 빌드하므로, 샤드 넷이면 준비를 네 번 내고, 분 단위 청구는 그 하나하나를 세요. 준비가 싸지고 실행기의 코어를 다 쓴 다음에 샤딩하세요. Skipbox에서는 준비가 디스크에 남고 실행 시간이 무제한이라, 샤드에 추가 비용이 없어요.

### GitHub Actions 작업에 4코어보다 많은 코어를 쓰려면 어떻게 하나요?

GitHub에서는 대형 실행기가 4~96코어이고, GitHub Team이나 Enterprise Cloud 조직만 쓸 수 있으며, 분 단위로 청구돼요. Skipbox에서는 runs-on을 skipbox-8x16로 바꾸면 8 vCPU, skipbox-16x32로 바꾸면 16 vCPU를 월 정액으로 쓰고, 조직과 개인 계정 모두 돼요.

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

들지 않아요. 무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지이고, 카드가 필요 없어요. 가장 느린 작업의 runs-on을 skipbox 레이블로 바꾸고, 두 번 돌린 뒤, 단계별 시간을 비교해 보세요.

2026-11-13 업데이트 · https://skipbox.dev/ko/guides/speed-up-github-actions
