# Blacksmith 청구액과 캐시 한도: 청구 방식, 캐시가 남기는 것, 정액이 더 싸지는 지점

> Blacksmith는 실행기 크기별로 1분마다 청구하고, 매달 2 vCPU 기준 3,000분이 무료이며, Docker 레이어 캐시와 스티키 디스크에 GB당 월 $0.50를 받아요. 내 청구액을 추정하고 줄이는 방법, 그리고 월 $39 정액이 더 싸지는 계산을 정리했어요.

Blacksmith는 실행기 크기에 따라 1분마다 청구해요. 매달 무료 3,000분은 2 vCPU 기준이라서, 4 vCPU 실행기는 두 배 빨리 써요. Docker 레이어 캐시와 스티키 디스크는 그 위에 GB당 월 $0.50씩 따로 청구돼요. 그리고 병렬 작업은 저마다 실행 시간만큼 청구돼요. 예상 밖의 청구액은 대부분 이 세 가지로 설명돼요. Actions 캐시는 무료이고, 리포지토리당 일주일에 25 GB까지이며, 7일 동안 쓰지 않은 항목은 지워져요.

Skipbox는 1분이 아니라 머신에 가격을 매겨요. 4 vCPU에 월 $39이고, 실행 시간은 무제한이에요. 머신은 내 계정 전용이고, 작업 사이에도 Docker 레이어와 패키지 캐시를 디스크에 GB당 요금 없이 남겨요. `runs-on: skipbox` 한 줄만 바꾸세요. 4 vCPU로 월 약 6,400분을 넘으면 Blacksmith보다 싸요.

- Blacksmith 4 vCPU로 월 20,000분: 저장 비용 전에 $148. Skipbox S: $39
- GB당 요금이 없어요. Docker 레이어와 패키지 캐시는 내 머신의 디스크에 남아요
- 실행 시간이 얼마든 청구액은 같아요. 요금제를 더할수록 한 번에 도는 작업이 늘어나요

**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-blacksmith-bill-and-cache-limits-ko)

## Blacksmith의 청구 방식

Blacksmith의 [가격 페이지](https://www.blacksmith.sh/pricing)와 [인스턴스 종류](https://docs.blacksmith.sh/blacksmith-runners/overview) 문서(둘 다 2026년 11월 13일 확인)에 따르면:

| 실행기 | 1분당 |
|---|---|
| Ubuntu x64, 2 vCPU | $0.004 |
| Ubuntu x64, 4 vCPU | $0.008 |
| Ubuntu x64, 8 vCPU | $0.016 |
| Ubuntu x64, 16 vCPU | $0.032 |
| Ubuntu x64, 32 vCPU | $0.064 |

- **무료 실행 시간:** 조직마다 매달 x64 2 vCPU 기준 3,000분이 무료예요. 더 큰 실행기는 비례해서 써요. Blacksmith의 예로, 4 vCPU 실행기에서 10분 걸린 작업은 2 vCPU 기준 20분을 써요. 그래서 무료 몫은 어떤 크기에서든 $12어치이고, 4 vCPU로는 1,500분이에요.
- **저장 공간 추가 요금:** Docker 레이어 캐시와 스티키 디스크는 GB당 월 $0.50가 더해져요. CLI는 시간 단위 저장 공간 청구 원장에서 저장량을 읽으므로, 캐시는 존재하는 시간만큼 청구돼요. 고정 IP는 IP당 월 $100가 더해져요.
- **무료:** Actions 캐시(Blacksmith는 캐시 사용에 추가 비용이 없다고 적어요)와 Docker 컨테이너 캐시(받아 온 이미지. 컨테이너 캐시가 쓰는 저장 공간은 청구하지 않는다고 적어요).

## 청구액이 계획보다 커지는 이유

- **무료 실행 시간이 실행기 크기만큼 줄어요.** 3,000분이면 작은 팀의 한 달처럼 들려요. 4 vCPU로는 1,500분, 8 vCPU로는 750분이에요.
- **저장 공간은 따로 청구돼요.** Docker `cache-key`마다 스티키 디스크가 하나씩 생기고([Docker 빌드](https://docs.blacksmith.sh/blacksmith-caching/docker-builds)), 스티키 디스크마다 GB당 청구돼요. 이미지 10개가 각각 20 GB의 레이어 캐시를 가지면 200 GB, 실행 시간 1분을 쓰기도 전에 월 $100예요.
- **병렬 작업은 모두 청구돼요.** 32개로 나눈 샤드는 실행기 32대가 한꺼번에 청구된다는 뜻이고, 청구액에는 상한이 없어요. 샤드, 행렬의 갈래, 다시 실행, 에이전트의 푸시가 모두 실행 시간이에요.
- **알림은 이메일이에요.** Blacksmith의 [설정](https://docs.blacksmith.sh/introduction/settings) 문서에는 Spending Alerts가 나와요. 지출이 기준을 넘으면 Blacksmith가 이메일로 알려 줘요. 문서에 멈춤은 나오지 않아요.

## 내 청구액 추정하기

실행기 크기별, 그리고 합계로 본 그달의 청구액:

```text
bill = Σ (minutes × that size's rate) − $12 (the free minutes) + GB-months of storage × $0.50
```

Blacksmith의 CLI가 각 부분을 보여 줘요([사용량과 비용 보고](https://docs.blacksmith.sh/blacksmith-cli/usage)).

```bash
blacksmith usage --since 30d --breakdown-by runner_type,repo   # billable minutes and estimated cost
blacksmith usage storage --since 30d --breakdown-by repo,type   # GB, GB-hours and storage cost
```

대시보드의 **Usage & Billing** 페이지에도 같은 내역이 나와요. 4 vCPU 실행기의 실행 시간만 보면:

| 월 실행 시간(4 vCPU) | Blacksmith, 저장 비용 전 | Skipbox S |
|---|---|---|
| 10,000분 | $68 | $39 |
| 20,000분 | $148 | $39 |
| 30,000분 | $228 | $39 |
| 늘 바쁠 때 | $333.60 | $39 |

[홈 페이지의 계산기](https://skipbox.dev/?vs=blacksmith&ref=g-blacksmith-bill-and-cache-limits-ko#cost)로 내 실행 시간과 크기에서 둘을 비교할 수 있어요.

## Blacksmith의 캐시 한도

[Actions 캐시](https://docs.blacksmith.sh/blacksmith-caching/dependencies-actions), [Docker 빌드](https://docs.blacksmith.sh/blacksmith-caching/docker-builds), [스티키 디스크](https://docs.blacksmith.sh/blacksmith-caching/dependencies-sticky-disks) 문서(2026년 11월 13일 확인)에 따르면:

| 캐시 | 크기 | 지우는 기준 | 비용 |
|---|---|---|---|
| Actions 캐시(`actions/cache`, `setup-*`) | 리포지토리당 일주일에 25 GB | 마지막으로 읽은 지 7일이 넘은 항목부터, 가장 오래 안 쓴 순서로 | 무료 |
| Docker 레이어 캐시(`useblacksmith/setup-docker-builder`) | 문서에 상한 없음 | 7일 동안 빌드가 없는 cache-key의 디스크. BuildKit은 8일 동안 안 쓴 레이어를 지워요 | GB당 월 $0.50 |
| 스티키 디스크(`useblacksmith/stickydisk`) | 작업당 5개까지 | 7일 동안 어떤 작업도 마운트하지 않으면 | GB당 월 $0.50 |

Blacksmith에서도 캐시가 빗나가는 이유:

- **이 캐시를 쓰지 않는 캐시가 있어요.** Blacksmith 문서에 따르면 Rust의 `sccache`와 `docker/build-push-action`의 GitHub Actions 캐시 옵션은 여전히 GitHub의 백엔드로 가고, 거기는 리포지토리당 10 GB예요.
- **항목은 기본적으로 브랜치 범위예요.** GitHub와 같아요. 브랜치는 형제 브랜치의 항목을 읽지 못해요. 대시보드의 설정으로 끌 수 있어요.
- **드물게 도는 작업은 캐시를 잃어요.** 일주일에 한 번도 안 도는 워크플로는 항목과 디스크가 지워진 상태에서 처음부터 시작해요.
- **한 cache-key에 서로 관계없는 이미지를 두면 서로를 밀어내요.** Blacksmith 문서는 이것이 캐시를 아예 안 쓰는 것보다 느릴 수 있다고 해요. Dockerfile마다 키를 따로 주세요.

## Blacksmith 청구액을 줄이는 방법

가장 크게 줄이는 방법은 분 단위로 내는 것을 그만두는 거예요. 다음 절의 손익분기점을 넘으면 정액 머신이 더 싸고, 청구액도 더는 움직이지 않아요. Blacksmith 안에서라면:

1. **대체된 실행을 취소하세요.** 풀 리퀘스트를 키로 한 `concurrency`와 `cancel-in-progress: true`를 쓰면, 새 푸시가 대신한 실행에 돈을 내지 않아요.
2. **오래된 저장 공간을 지우세요.** `blacksmith stickydisk list`나 **Storage → Sticky Disks**에서 스티키 디스크 목록을 보고, 어떤 작업도 쓰지 않는 것을 지우세요.
3. **Dockerfile마다 cache-key 하나.** 캐시끼리 밀어내서 다시 빌드하는 비용이 들지 않게요.

## 정액이 더 싸지는 지점

Skipbox는 머신에 월 단위로 가격을 매기고, Blacksmith는 1분에 가격을 매겨요. 두 선이 만나는 곳을 각자의 가격으로 계산하면:

```text
break-even minutes = (flat price + $12 of free minutes) ÷ Blacksmith's per-minute rate
```

| Skipbox 요금제 | 월 가격 | 비교하는 Blacksmith | 이보다 많으면 Blacksmith보다 쌈 |
|---|---|---|---|
| S, 4 vCPU | $39 | 4 vCPU, $0.008 | 월 약 6,400분 |
| M, 8 vCPU | $79 | 8 vCPU, $0.016 | 월 약 5,700분 |
| L, 16 vCPU | $149 | 16 vCPU, $0.032 | 월 약 5,100분 |

저장 공간은 이 선을 더 낮춰요. Blacksmith에서는 Docker 레이어 캐시 10 GB마다 월 $5가 더해지고, Skipbox에서는 머신의 디스크(S는 80 GB)에 있어요.

손익분기점을 넘으면 정액이 더 싸고, 청구액은 더 움직이지 않아요. 요금제는 더할 수 있어요. 동시에 돌리고 싶은 4 vCPU 작업마다 S을 하나씩 두세요.

## 옮기는 건 한 줄이에요

```yaml
jobs:
  build:
    runs-on: skipbox # was blacksmith-4vcpu-ubuntu-2404
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-buildx-action@v4 # was useblacksmith/setup-docker-builder
      - uses: docker/build-push-action@v7 # was useblacksmith/build-push-action
        with:
          push: true
          tags: user/app:latest
```

1. GitHub로 Skipbox에 로그인하세요.
2. Skipbox GitHub 앱을 설치하고 리포지토리를 고르세요. 퍼블릭이든 프라이빗이든 돼요.
3. `runs-on`을 바꾸고 푸시하세요.

8 vCPU 작업은 `skipbox-8x16`, 16 vCPU 작업은 `skipbox-16x32`로 가요. `actions/cache`와 `setup-*`는 그대로 돌아요. `useblacksmith/stickydisk`에 담던 것, 예를 들어 `~/.npm`이나 `node_modules`는 지난 작업에서 디스크에 그대로 남아 있어요. 자세한 내용은 [Docker 레이어 캐시 가이드](https://skipbox.dev/ko/guides/docker-layer-cache-github-actions)에 있고, [Blacksmith 대안](https://skipbox.dev/ko/compare/blacksmith-alternatives) 페이지에서 서비스들을 나란히 비교해요.

## 보안

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

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

## Blacksmith 작업으로 체험해 보세요

무료 체험은 카드가 필요 없고, 7일 또는 작업 시간 3,000분 동안 쓸 수 있어요. Blacksmith 작업 하나를 `runs-on: skipbox`로 옮기고 두 번 돌린 뒤, 두 번째 실행과 그달의 청구액을 Blacksmith의 사용량 보고와 비교해 보세요.

## 자주 묻는 질문

### CI를 빠르게 하려고 Blacksmith로 옮겼는데 월 청구액이 예상보다 훨씬 커요. 왜 그런가요?

대개 세 가지예요. 무료 3,000분은 2 vCPU 기준이라서, 4 vCPU 실행기에서는 1,500분, 8 vCPU에서는 750분이면 끝나요. Docker 레이어 캐시와 스티키 디스크는 실행 시간과 별도로 저장 용량에 따라 GB당 월 $0.50씩 청구돼요. 그리고 샤딩한 스위트, 행렬 빌드, 에이전트의 푸시가 저마다 실행 시간만큼 청구돼요. blacksmith usage --since 30d --breakdown-by runner_type,repo와 blacksmith usage storage를 돌려 보면 어느 쪽인지 알 수 있어요.

### Blacksmith는 어떻게 청구하나요?

실행기 크기에 따라 1분마다 청구해요. 가격 페이지(2026년 11월 13일 확인)에 따르면 Ubuntu x64는 2 vCPU가 1분에 $0.004, 4가 $0.008, 8이 $0.016, 16이 $0.032, 32가 $0.064이고, 조직마다 매달 2 vCPU 기준 3,000분이 무료예요. Docker 레이어 캐시와 스티키 디스크는 GB당 월 $0.50, 고정 IP는 IP당 월 $100예요. Actions 캐시는 추가 비용이 없어요.

### Blacksmith의 캐시 한도는 어떻게 되나요?

Actions 캐시는 리포지토리당 일주일에 25 GB의 무료 저장 공간을 주고, 마지막으로 읽은 지 7일이 넘은 항목을 지워요. 항목은 기본적으로 브랜치 범위로 묶여요. Rust의 sccache와 docker/build-push-action의 GitHub Actions 캐시는 여전히 GitHub의 백엔드로 가요. Docker 레이어 캐시와 스티키 디스크는 문서에 크기 상한이 없지만, GB당 청구되고 7일 동안 쓰지 않으면 지워져요.

### Blacksmith 캐시가 충분히 크지 않고 여전히 캐시가 빗나가요. 어떻게 해야 하나요?

디스크를 유지하는 머신에서 작업을 돌리세요. Skipbox에서는 Docker 레이어와 패키지 캐시가 작업 사이에도 내 계정 전용 머신에 GB당 요금 없이 남고, 다음 작업은 그것이 이미 있는 상태로 시작해요.

### 정액이 Blacksmith보다 싸지는 건 언제인가요?

월 실행 시간이 손익분기점을 넘으면요. Skipbox의 S 요금제(4 vCPU)는 월 $39이고, Blacksmith의 4 vCPU 실행기는 저장 비용을 빼고도 월 약 6,400분에서 그 금액에 닿아요. 8 vCPU와 비교한 M은 약 5,700분, 16 vCPU와 비교한 L은 약 5,100분에서 손익이 같아져요. 요금제는 더할 수 있어요. 동시에 돌리고 싶은 작업마다 하나씩 두세요.

### Blacksmith에 확실한 지출 상한을 둘 수 있나요?

설정 문서에는 Spending Alerts가 나와요. 월 기준 금액을 정하면, 지출이 그것을 넘을 때 Blacksmith가 계정의 기본 주소로 이메일을 보내요. 문서에 적힌 건 이메일이지, 멈춤이 아니에요. 움직이지 않는 가격이 필요하다면 머신 단위로 가격을 매기는 요금제가 필요해요. Skipbox에서는 실행 시간이 얼마든 청구액이 요금제 가격 그대로이고, 요금제를 더할수록 한 번에 도는 작업이 늘어나요.

### Blacksmith의 작업을 Skipbox로 옮기려면 어떻게 하나요?

Skipbox GitHub 앱을 설치하고, runs-on을 blacksmith-4vcpu-ubuntu-2404 같은 레이블에서 skipbox 레이블로 바꾸고, 푸시하세요. Blacksmith 전용 액션(useblacksmith/setup-docker-builder, build-push-action, stickydisk)을 쓰는 단계는 docker/setup-buildx-action과 docker/build-push-action으로 그대로 돌려놓으세요. 내 머신이 작업 사이에도 레이어를 남겨요.

2026-11-19 업데이트 · https://skipbox.dev/ko/guides/blacksmith-bill-and-cache-limits
