# GitHub Actions exit code 137: 메모리 부족, 그리고 정액으로 쓰는 16 GB·32 GB 실행기

> exit code 137은 작업의 메모리가 바닥나 Linux가 작업을 강제로 끝냈다는 뜻이에요. 프라이빗 리포지토리의 ubuntu-latest는 8 GB예요. Skipbox는 runs-on 한 줄만 바꾸면 그 작업을 16 GB나 32 GB 머신에서 월 $39나 $149 정액, 실행 시간 무제한으로 돌려요.

빌드가 또 `exit code 137`로 죽었어요. 누군가 다시 실행하고, 테스트 워커를 줄이고, 스왑을 더하고, 파이프라인은 그때마다 느려져요. 그동안 계속 빌드를 죽이는 실행기의 메모리는 8 GB이고, GitHub의 더 큰 실행기는 1분마다 청구해요.

Skipbox는 작업에 16 GB나 32 GB 머신을 월 정액, 실행 시간 무제한으로 줘요. `runs-on: skipbox` 한 줄만 바꾸면 빌드가 `ubuntu-latest`의 2배인 메모리를 월 $39에 쓰고, `runs-on: skipbox-8x16`이면 코어도 두 배가 돼요.

- 16 GB가 월 $39, 32 GB가 $149, 몇 분을 돌리든 같아요
- 같은 메모리에서 GitHub 대형 실행기의 두 배 코어: 8 vCPU와 16 GB
- GitHub의 16 GB 실행기로 월 10,000분이면 $102. Skipbox S로는 $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-github-actions-exit-code-137-out-of-memory-ko)

## exit code 137의 뜻

137은 128 + 9예요. 프로세스가 시그널 9, SIGKILL로 강제 종료됐는데, 이 시그널은 잡을 수 없어서 오류도 출력하지 못해요. GitHub 호스팅 실행기에서 이 시그널은 작업의 프로세스들이 머신의 메모리보다 많이 썼을 때 Linux의 메모리 부족 킬러가 보내요.

| 로그에 나오는 것 | 일어난 일 |
|---|---|
| `Process completed with exit code 137.`(`Killed` 뒤에 나오는 경우가 많아요) | 커널이 메모리를 비우려고 프로세스를 강제로 끝냈어요 |
| `JavaScript heap out of memory` | Node가 자기 힙 한도에 닿았어요. 머신에는 아직 메모리가 있었어요 |
| `The runner has received a shutdown signal.` | 실행기 전체의 메모리가 바닥나 응답을 멈췄어요 |

프라이빗 리포지토리의 `ubuntu-latest`는 8 GB이고, 빌드보다 먼저 실행기 애플리케이션, Docker, 서비스 컨테이너가 자기 몫을 가져가요. 모노레포 빌드, 워커를 포크하는 Gradle 데몬, Rust 릴리스 빌드, 브라우저 몇 개를 띄운 Playwright 스위트는 평범한 날에도 그 한도를 넘을 수 있어요.

## 8 GB에 머무는 비용

우회책은 모두 속도를 내주고 메모리를 얻어요. 테스트 워커 줄이기, `CARGO_BUILD_JOBS=1`, 더 작은 `-Xmx`, 디스크 스왑. 하나같이 빌드를 느리게 해서 메모리에 맞추고, 팀은 푸시할 때마다 그 느린 빌드를 기다려요. 코드베이스가 다시 커지고 137이 돌아올 때까지요.

GitHub의 답은 대형 실행기인데, 1분마다 청구되고 GitHub Team이나 Enterprise Cloud 조직만 쓸 수 있어요. 같은 메모리의 Skipbox와 비교하면:

| 월 실행 시간 | GitHub 4코어, 16 GB | Skipbox S, 16 GB | GitHub 8코어, 32 GB | Skipbox L, 32 GB |
|---|---|---|---|---|
| 10,000분 | $102 | $39 | $202 | $149 |
| 20,000분 | $222 | $39 | $422 | $149 |
| 30,000분 | $342 | $39 | $642 | $149 |

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

필요한 메모리는 늘기만 해요. 코딩 에이전트는 사람보다 빠르게 코드와 의존성을 더하고, 테스트 스위트는 커지고, 툴체인 업데이트 하나로 같은 커밋이 쓰는 메모리가 두 배가 될 수 있어요. 게다가 더 큰 실행기의 분 단위 청구액은 푸시마다 늘어요.

## 직접 고치기

8 GB에 머문다면 할 일은 이래요.

- 어떤 프로세스가 종료됐는지 찾고(`if: failure()` 단계에서 `dmesg`), 그 한도를 조정하기: `--max-old-space-size`, `-Xmx`, `org.gradle.workers.max`, `--maxWorkers`
- `compose.yaml`에서 서비스 컨테이너마다 메모리에 상한 두기
- 무거운 단계 앞에 실행기의 14 GB 디스크에 맞춘 스왑 파일 더하기
- 어느 한 단계가 전부를 필요로 하지 않도록 작업 나누기

하나같이 빌드를 더 느리거나 더 위태롭게 만들고, 어느 것도 다음 성장을 견디지 못해요. 더 큰 머신이면 끝나요.

## Skipbox가 작업에 주는 것

**정액으로 쓰는 메모리.** 작업은 레이블로 크기를 요청해요.

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

S 요금제는 월 $39, L 요금제는 $149이고, 실행 시간은 무제한이에요. 워커를 원래대로 돌려놓으세요. 빌드가 메모리와 코어를 함께 얻어요.

**덤으로 더 빠른 빌드.** 내 계정의 머신이 작업 사이에도 유지되므로, 다음 작업이 시작될 때 Docker 레이어, 패키지 캐시, 도구가 이미 디스크에 있어요.

**예산 때문에 멈추지 않아요.** Skipbox 작업은 GitHub 실행 시간을 쓰지 않으므로 GitHub 예산이 멈출 일이 없고, 분 단위로 청구되는 것도 없어요.

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

## 옮기는 건 한 줄이에요

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
```

1. GitHub로 Skipbox에 로그인하세요.
2. Skipbox GitHub App을 설치하고 리포지토리를 고르세요.
3. `runs-on`을 바꾸고 푸시하세요. S 요금제($39)는 16 GB예요. 32 GB가 필요하면 L을 고르세요.

머신은 비밀번호 없는 `sudo`, Docker, Node.js, Python이 있는 Ubuntu 24.04라서, 단계는 그대로 돌아요.

## 보안

- 머신은 내 계정만 써요. 다른 회사의 작업은 그 머신에서 돌지 않아요.
- 작업이 끝날 때마다 실행기의 자격 증명, 프로세스, 컨테이너를 지워요. 2026년 11월 13일부터 체크아웃과 그 빌드 결과(Cargo의 `target/`)는 다음 작업을 위해 내 전용 머신에 남아요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요.
- 쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 한 번 쓰고 버리는 새 머신에서 돌아요.

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

## 체험해 보세요

무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지 무료이고, 카드가 필요 없어요. `runs-on: skipbox`를 4 vCPU와 16 GB로 돌리니, 프라이빗 리포지토리 `ubuntu-latest`의 2배 메모리예요. 계속 137에 걸리는 작업을 옮겨서 돌려 보세요. 같은 메모리에 코어가 더 필요하면 M 요금제를 고르고 레이블을 `skipbox-8x16`로, 메모리가 더 필요하면 L 요금제와 `skipbox-16x32`(32 GB)을 쓰세요.

## 자주 묻는 질문

### GitHub Actions에서 exit code 137은 무슨 뜻인가요?

프로세스가 시그널 9, SIGKILL로 강제 종료됐다는 뜻이에요(128 + 9 = 137). GitHub 호스팅 실행기에서는 거의 언제나 Linux의 메모리 부족 킬러예요. 작업이 실행기가 가진 것보다 많은 메모리를 썼어요. 확실한 해결책은 더 많은 메모리를 가진 머신이에요. 예를 들어 월 정액으로 쓰는 Skipbox의 16 GB나 32 GB 실행기예요.

### GitHub Actions 실행기의 메모리는 얼마인가요?

프라이빗 리포지토리의 ubuntu-latest는 8 GB와 CPU 2개예요. GitHub의 대형 실행기는 4코어가 16 GB, 8코어가 32 GB이고, 분 단위로 청구되며 GitHub Team이나 Enterprise Cloud 조직만 쓸 수 있어요. Skipbox는 S 요금제(월 $39)가 16 GB, L 요금제가 32 GB이고, 실행 시간은 무제한이에요.

### "JavaScript heap out of memory"는 exit code 137과 같은 건가요?

아니요. 힙 오류는 Node가 자기 한도에서 멈춘 것이고, --max-old-space-size로 올릴 수 있어요. exit code 137은 머신 전체의 메모리가 바닥나 커널이 프로세스를 강제로 끝낸 것이고, Node의 한도를 올리면 더 나빠져요. 빌드가 정말 그만큼의 메모리가 필요하다면 더 큰 머신에서 돌리세요. runs-on: skipbox 레이블이면 16 GB를 줘요.

### 작업이 왜 "The runner has received a shutdown signal"로 끝나나요?

흔한 원인은 실행기의 메모리가 완전히 바닥나서, 메모리 부족 메시지가 로그에 닿기도 전에 응답을 멈추는 거예요. exit code 137처럼 다루세요. 작업에 실행기가 가진 것보다 많은 메모리가 필요해요.

### Skipbox 무료 체험으로 메모리 부족 작업이 해결되나요?

작업에 2배의 메모리를 줘요. 무료 체험은 runs-on: skipbox을 4 vCPU와 16 GB로 돌려요. 프라이빗 리포지토리의 ubuntu-latest는 8 GB이고, GitHub의 4코어 대형 실행기와는 같아요. 그래도 바닥나는 작업은 runs-on: skipbox-16x32(32 GB)을 위한 L 요금제가 필요해요.

2026-11-16 업데이트 · https://skipbox.dev/ko/guides/github-actions-exit-code-137-out-of-memory
