# GitHub Actions의 "No space left on device": 디스크를 채운 것을 찾고, 비우고, 아니면 더 큰 디스크로

> GitHub가 표준 Linux 실행기에서 보장하는 빈 공간은 14 GB뿐이고, Docker 이미지, 캐시 복원, 빌드 트리가 그것을 채워요. 디스크를 채운 것을 보는 방법, 실행기 이미지에서 지울 것, 그리고 더 큰 디스크를 얻는 곳: Team과 Enterprise의 GitHub 대형 실행기, 또는 S 80 GB, M 160 GB, L 320 GB를 정액으로 쓰는 Skipbox 전용 머신.

GitHub Actions의 "No space left on device"는 작업이 실행기의 빈 공간보다 많이 썼다는 뜻이고, GitHub 표준 Linux 실행기에서 그 공간은 약 14 GB예요. runner-images 관리자는 GitHub가 프라이빗과 퍼블릭 리포지토리 모두 빈 공간 14 GB만 보장한다고 썼어요. 이미지에 미리 설치된 도구가 나머지를 차지하기 때문이에요(`ubuntu-latest`에 대한 한 사용자의 목록: Android SDK 12 GB, 호스팅 도구 캐시 8.5 GB, GHC 5.5 GB). Docker 이미지, 디스크에 풀린 복원 캐시, 빌드 트리는 14 GB를 금방 채워요. 고치는 순서는 이래요. 디스크를 채운 것을 보고(`df -h`, `df -i`, `du`, `docker system df`), 덜 쓰고, 작업이 쓰지 않는 미리 설치된 도구를 지우고, 그래도 안 들어가면 더 큰 디스크에서 작업을 돌리세요. GitHub의 대형 실행기는 75 GB부터이고, GitHub Team과 Enterprise Cloud에서만 쓸 수 있어요.

Skipbox는 작업을 내 계정 전용 머신에서 S 80 GB, M 160 GB, L 320 GB 디스크로, 정액에 실행 시간 무제한으로 돌려요. 작업 사이에 남기는 캐시가 그 디스크에 있고, 디스크가 차면 가장 오래된 것부터 정리하므로, 작업을 시작할 때 지울 것이 없어요.

- 디스크가 S 80 GB, M 160 GB, L 320 GB. GitHub 표준 실행기의 빈 공간은 약 14 GB
- Docker의 이미지와 레이어, 패키지 캐시가 작업 사이에도 그 디스크에 남아요
- 작업이 끝난 뒤 85%를 넘으면, 가장 오래 쓰지 않은 것부터 75%까지 정리해요

**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-no-space-left-on-device-ko)

## GitHub 실행기의 디스크

[GitHub 호스팅 실행기](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)는 표준 Linux 실행기의 SSD를 프라이빗과 퍼블릭 리포지토리 모두 14 GB로 적고 있어요. [runner-images 토론 #9329](https://github.com/actions/runner-images/discussions/9329)에서, 이미지 변경으로 Ubuntu 실행기의 빈 공간이 31 GB 이상에서 17 GB 이상으로 줄어든 뒤, 관리자는 프라이빗과 퍼블릭 리포지토리 모두 빈 공간은 실제로 14 GB만 보장한다고 답했어요. 14 GB로 계획하세요.

디스크의 나머지는 이미지예요. [이슈 #10386](https://github.com/actions/runner-images/issues/10386)("Free space left: 72 MB")에서 한 사용자가 `ubuntu-latest`에서 돌린 `du`는 이랬어요.

| 디렉터리 | 크기 |
|---|---|
| `/usr/local/lib/android` | 12 GB |
| `/opt/hostedtoolcache` | 8.5 GB(CodeQL만 5 GB) |
| `/usr/local/.ghcup` | 5.5 GB |

## 1. 디스크를 채운 것 보기

실패하는 단계 뒤에 `if: always()`로 단계를 하나 더하세요.

```yaml
- name: Disk usage
  if: always()
  run: |
    df -h
    df -i /
    sudo du -xh --max-depth=1 / 2>/dev/null | sort -rh | head -15
    docker system df || true
```

- `df -h`는 파일 시스템마다 얼마나 찼는지 보여 줘요. 작업이 어디에 쓰는지 확인하세요. 작업 공간, `/var/lib/docker` 아래의 Docker 데이터, 또는 임시 디렉터리예요.
- `df -i`는 아이노드를 보여 줘요. 바이트가 남아 있어도 디스크의 아이노드(파일마다 하나)가 바닥날 수 있고, 오류는 같아요.
- `du`는 가장 큰 디렉터리를 보여 줘요.
- [`docker system df`](https://docs.docker.com/reference/cli/docker/system/df/)는 Docker의 이미지, 컨테이너, 볼륨, 빌드 캐시가 얼마나 차지하는지 보여 줘요.

## 2. 덜 쓰기

- **빌드 사이에 Docker를 정리하세요.** [`docker system prune`](https://docs.docker.com/reference/cli/docker/system/prune/)은 멈춘 컨테이너, 쓰지 않는 네트워크, 댕글링 이미지, 쓰지 않는 빌드 캐시를 지워요. `-a`는 쓰지 않는 이미지를 모두, `--volumes`는 익명 볼륨까지 지워요.
- **효과 있는 것만 캐시하세요.** 복원한 캐시는 실행기의 디스크에 풀리므로, 큰 캐시 아카이브는 다운로드 크기보다 더 많은 공간을 차지해요. 작업마다 나누거나, 다시 가져오는 게 빠른 것은 빼세요.
- **빌드 트리를 정리하세요.** 뒤의 단계에 필요 없는 것을, 공간이 필요한 단계 앞에서요.

## 3. 작업이 쓰지 않는 미리 설치된 도구 지우기

[이슈 #2875](https://github.com/actions/runner-images/issues/2875)와 #10386에서:

```yaml
- name: Free disk space
  run: |
    sudo rm -rf /usr/local/lib/android /usr/local/.ghcup /opt/hostedtoolcache/CodeQL
    sudo rm -rf /usr/share/dotnet /usr/local/share/boost
    df -h /
```

비용이 두 가지 있어요. 다음 작업의 VM에는 그것들이 다시 있으므로, 기가바이트를 지우는 데 실행마다 시간이 들어요. 그리고 `$AGENT_TOOLSDIRECTORY`(호스팅 도구 캐시 전체)를 지우면 더 많이 비지만, #2875의 작성자가 알게 된 것처럼 단계가 있으리라 여기는 도구가 깨져요. [free-disk-space](https://github.com/marketplace/actions/free-disk-space-ubuntu) 액션이 이 삭제들을 묶어 주고, 그 작성자는 스레드 뒤에 도구 캐시 옵션을 더하며 6 GB를 더 비운다고 했어요.

## 4. 더 큰 디스크에서 작업 돌리기

| 실행기 | 디스크 | 쓸 수 있는 곳 |
|---|---|---|
| GitHub 표준 Linux 실행기 | SSD 14 GB, 빈 공간 약 14 GB | 누구나 |
| GitHub 대형 실행기, 2~96 vCPU | 2 vCPU 75 GB, 4는 150 GB, 8은 300 GB, 최대 2,040 GB([대형 실행기](https://docs.github.com/en/actions/reference/runners/larger-runners)) | GitHub Team과 Enterprise Cloud 조직, 분 단위([대형 실행기 소개](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| 자체 호스팅 실행기 | 준 만큼. 작업 사이에 유지되는 실행기는 무언가가 정리하지 않으면 이미지와 지난 작업 공간으로 가득 차요 | 누구나, 직접 운영 |
| Skipbox 전용 머신 | S 80 GB, M 160 GB, L 320 GB, 차면 정리 | 조직과 개인 계정, 정액 |

## Skipbox가 디스크로 하는 일

요금제마다 작업 사이에도 유지되는 내 계정 전용 머신이 따라오고, 디스크는 그 크기에 맞아요.

- **디스크는 S 80 GB, M 160 GB, L 320 GB예요.**
- **그 위에 남는 건 내 상태예요.** Docker의 이미지, 레이어, 빌드 캐시, `~/.npm`, pnpm 스토어, `~/.cache`, Go, Gradle, Maven, Cargo의 캐시, `setup-*`이 설치한 도구. `actions/cache`가 저장한 것은 디스크의 절반까지 머신 옆에 남아요.
- **가득 차지 않아요.** 작업이 끝난 뒤 디스크가 85%를 넘기 전에는 아무것도 지우지 않아요. 넘으면 가장 오래 쓰지 않은 것부터 75%까지 정리해요. 댕글링 이미지, 그다음 Docker의 빌드 캐시, 그다음 패키지 캐시와 남겨 둔 빌드 통째로. 그래도 85%를 넘을 때만 머신을 초기화해요.
- **디스크가 더 필요하면 요금제를 한 단계 올려요.** 큰 이미지나 큰 빌드 트리처럼 수십 기가바이트를 직접 쓰는 작업은 M에서 160 GB, L에서 320 GB를 써요.

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

실행 시간은 무제한이에요. 4 vCPU로 월 20,000분이면 GitHub는 $222를 청구하고, Skipbox S는 $39예요.

## 옮기는 건 한 줄이에요

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # the "Free disk space" step can go
      - run: docker build -t app .
```

`skipbox-8x16`은 M 요금제에서 돌고, `runs-on: skipbox`는 S와 무료 체험에서 돌아요.

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

## 보안

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

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

## 디스크가 바닥나는 작업으로 체험해 보세요

무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지 무료이고, 카드가 필요 없어요. `runs-on: skipbox`를 80 GB인 S의 머신에서 돌려요. 작업을 옮기고, 미리 설치된 도구를 지우는 단계를 빼고, 돌려 보세요.

## 자주 묻는 질문

### GitHub Actions 실행기의 디스크 공간은 얼마인가요?

GitHub 문서는 표준 Linux 실행기의 SSD를 프라이빗과 퍼블릭 리포지토리 모두 14 GB로 적고 있고, runner-images 관리자는 GitHub가 둘 다 빈 공간 14 GB만 보장한다고 썼어요. 디스크 자체는 더 크지만 실행기 이미지에 미리 설치된 도구가 나머지를 채우므로, 14 GB로 계획하세요.

### GitHub Actions의 No space left on device는 어떻게 고치나요?

먼저 무엇이 채웠는지 보세요. 파일 시스템마다 df -h, 아이노드는 df -i, 가장 큰 디렉터리는 sudo du -xh --max-depth=1 /, Docker의 이미지와 빌드 캐시는 docker system df예요. 그다음 덜 쓰고(빌드 사이에 Docker를 정리하고, 효과 있는 것만 캐시하기), 작업이 쓰지 않는 미리 설치된 도구(Android SDK, GHC, CodeQL, .NET)를 지우고, 그래도 부족하면 디스크가 더 큰 실행기에서 작업을 돌리세요.

### 디스크 공간을 비우려면 ubuntu-latest에서 무엇을 지울 수 있나요?

작업이 쓰지 않는 도구예요. GitHub runner-images 이슈의 사용자들은 /usr/local/lib/android(한 사용자의 목록에서 12 GB), /usr/local/.ghcup, /opt/hostedtoolcache/CodeQL, /usr/share/dotnet, /usr/local/share/boost를 지워요. $AGENT_TOOLSDIRECTORY를 지우면 호스팅 도구 캐시도 비지만, 그곳에 도구가 있다고 여기는 설정 단계가 깨져요. 기가바이트를 지우는 데는 실행마다 시간이 들어요.

### GitHub의 대형 실행기는 디스크가 더 큰가요?

네. 2 vCPU는 75 GB, 4는 150 GB, 8은 300 GB이고, 64와 96 vCPU에서 최대 2,040 GB예요. GitHub Team이나 GitHub Enterprise Cloud의 조직만 쓸 수 있고, 1분마다 청구돼요.

### Skipbox는 작업에 디스크를 얼마나 주나요?

내 계정 전용 머신은 S가 80 GB, M이 160 GB, L이 320 GB예요. 작업 사이에 남기는 캐시가 그 디스크를 함께 써요. 작업이 끝난 뒤 85%를 넘으면, 가장 오래 쓰지 않은 것부터 75%까지 정리하므로, 자체 호스팅 실행기의 디스크처럼 가득 차지 않아요. 수십 기가바이트를 직접 쓰는 작업에는 M과 L이 넉넉한 공간을 줘요.

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

들지 않아요. 무료 체험은 7일 또는 작업 시간 3,000분 중 먼저 끝나는 쪽까지이고, 카드가 필요 없으며, S의 머신에서 돌아요. 디스크가 바닥나는 작업을 runs-on: skipbox 레이블로 옮기고, 미리 설치된 도구를 지우는 단계를 빼세요.

2026-11-16 업데이트 · https://skipbox.dev/ko/guides/github-actions-no-space-left-on-device
