# VM 분리

> Skipbox가 작업을 서로 떼어 놓는 방식: 작업마다 자격 증명을 지우는 조직 전용 머신, 쓰기 권한이 없는 사람의 코드와 ‘작업마다 새 VM’을 위한 새 VM, 작업 하나를 위한 실행기, 들어오는 연결 없음. 퍼블릭과 프라이빗 리포지토리 모두에서.

## 전용 머신

요금제마다, 그리고 무료 체험도, 조직에 전용 머신을 줘요. 요금제 크기의 VM으로, 조직의 작업만 한 번에 하나씩 돌려요. 작업 사이에도 유지되므로, 작업이 디스크에 남긴 것이 다음 작업을 위해 남아요. Docker 이미지와 빌드 캐시, 패키지 캐시, 설치한 도구예요.

작업마다 Skipbox는 실행기의 자격 증명을 지우고, 실행기 사용자의 모든 프로세스를 멈추고, 모든 컨테이너를 제거하고, 이 자격 증명 파일을 지워요. `~/.docker/config.json`, `~/.npmrc`, `~/.git-credentials`, `~/.config/gh`, `~/.aws/credentials`, `~/.kube/config`, `~/.ssh/id_*`. 2026년 11월 13일부터 작업의 체크아웃과 그 빌드 결과(Cargo의 `target/`, Next.js의 `.next/cache`)는 조직의 다음 작업을 위해 전용 머신에 남아요. 그래도 작업마다 Skipbox는 체크아웃과 홈 디렉터리 git 설정의 git 자격 증명, 체크아웃의 훅, 추적되지 않는 파일을 지워요. **작업마다 새 VM**을 켜면 모든 작업이 새 머신에서 돌아요. 그다음 머신을 점검해요. 디스크, 패키지, Docker, 실행기, DNS, 실행기 사용자의 남은 프로세스와 컨테이너예요. 점검에 실패한 머신은 초기화돼요. 디스크를 이미지로 덮어쓰고 다시 시작하므로, 캐시도 함께 사라져요. 조직 페이지에서 **머신 초기화**를 누를 때와, 이미지가 업데이트될 때(적어도 한 달에 한 번)도 초기화돼요.

직접 호스팅하는 실행기와 마찬가지로, 조직의 어느 작업이든 그 머신의 다음 작업이 읽거나 실행하는 파일을 남길 수 있어요. 리포지토리나 브랜치끼리 떼어 놓으려면 **작업마다 새 VM**을 켜세요. 전용 머신은 다른 조직의 작업을 절대 돌리지 않아요.

## 새 VM

이 작업들은 다른 작업을 돌린 적 없는 새 VM에서 돌고, 작업이 끝나면 VM은 디스크와 함께 삭제돼요.

- 전용 머신이 모두 바쁠 때 들어온 작업.
- 포크에서 온 풀 리퀘스트처럼 쓰기 권한이 없는 사람의 코드로 된 작업. 그런 작업이 그래도 전용 머신에 닿으면 단계가 돌기 전에 실패하고, 머신은 초기화돼요.
- 조직이 **작업마다 새 VM**을 켰을 때의 모든 작업.

VM을 받고 6시간이 지나도 돌고 있는 작업은 멈춰요.

## VM이 도는 곳

Skipbox가 일본에서 운영하는 서버와, 핀란드와 독일(EU)의 Hetzner Cloud 서버와, 캐나다와 EU의 프랑스·스페인·이탈리아의 Google Cloud 서버예요. Hetzner Cloud에서는 작업이 도는 서버, 그 네트워크, 그 디스크를 다른 조직의 작업이 쓰지 않아요. Google Cloud에서는 작업마다 새 VM과 새 디스크를 받고, 작업이 끝나면 둘 다 지워져요.

## 작업 하나를 위한 실행기

Skipbox는 실행기를 필요한 순간에, 작업 하나를 위해, 작업 자체의 레이블로 등록해요. 조직에서는 조직의 기본 실행기 그룹에 들어가고, 개인 계정에서는 작업의 리포지토리에 등록되므로 그 리포지토리의 작업만 돌릴 수 있어요. 작업 뒤에도 등록된 채 남은 실행기는 제거돼요.

## 들어오는 연결 없음

인터넷의 어떤 것도 작업의 VM에 연결할 수 없어요. [네트워크와 송신](https://docs.skipbox.dev/ko/network)을 보세요.

## 퍼블릭과 프라이빗 리포지토리

쓰기 권한이 없는 사람의 코드(포크에서 온 풀 리퀘스트 등)는 캐시를 읽을 수는 있지만 바꿀 수는 없는 새 VM에서 돌고, 전용 머신은 팀의 코드만 돌려요.

실행이 팀의 것이 되려면, 코드가 리포지토리 자체의 것이고, 실행을 시작한 사람이 GitHub가 보고하는 대로 리포지토리에 write, maintain, admin 권한을 가져야 해요. 그 밖의 것은 모두 쓰기 권한이 없는 사람의 코드로 쳐요. 포크에서 온 풀 리퀘스트, 포크의 코드로 시작된 `pull_request_target`이나 `workflow_run`, 쓰기 권한이 없는 사람의 `issue_comment`, 그리고 GitHub가 답하지 않는 실행이에요. 프라이빗 리포지토리에서도 규칙은 같아요.

GitHub는 기다리는 작업을 그 레이블을 가진 아무 유휴 실행기에나 넘겨요. 그래서 쓰기 권한이 없는 사람의 작업이 VM을 기다리는 동안 전용 머신은 새 실행기를 받지 않고, 팀의 다음 작업은 새 VM을 받기 전에 최대 1분 동안 전용 머신을 기다려요. 외부 작업이 VM을 받으면 전용 머신이 팀의 작업을 받아요. 그 훅은 어떤 단계보다도 먼저, Skipbox가 목록에 올린 실행만 통과시켜요.

## 작업이 읽을 수 있는 것

어느 실행기에서나 그렇듯, 작업의 VM에는 워크플로의 시크릿과 그 작업을 위한 GitHub의 토큰이 있고, 작업이 돌리는 코드는 그것을 읽을 수 있어요. Skipbox 실행기도 GitHub 호스팅 실행기처럼 다루세요. 작업에는 필요한 시크릿만 주세요.

2026-11-20 업데이트 · https://docs.skipbox.dev/ko/isolation
