Galpi
VM을 돌릴 곳
채팅마다 뜨는 VM을 Fly Sprites, E2B 노드, Sysbox 노드 가운데 어디서 돌릴지 정하고, 노드를 붙이고, VM 크기를 정해요.
VM을 돌릴 곳은 배포 전체에 하나예요. 위저드의 VM 단계나 시스템 관리 → 설정 → VM을 돌릴 곳에서 고르고, 환경 변수로는 VM_PROVIDER예요.
| 고르는 것 | VM_PROVIDER |
무엇인지 |
|---|---|---|
| Fly Sprites | sprites |
Fly.io가 VM을 돌려요. 따로 둘 서버가 없어요. SPRITES_TOKEN, SPRITES_ORG가 필요해요 |
| E2B 노드 | e2b |
KVM이 되는 서버를 노드로 붙여요. 시스템 관리 → 노드의 가입 명령 한 줄로 붙여요 |
| Sysbox 노드 | sysbox |
KVM이 없는 서버를 노드로 붙여요. VM은 Sysbox 컨테이너예요. 서로 믿는 사람끼리 쓰는 배포에만 맞아요 |
| 로컬 | local |
개발용. 이 컴퓨터의 폴더를 VM처럼 써요. 운영에서는 거부해요 |
| 아직 정하지 않음 | none(기본) |
채팅에 VM을 띄우지 않아요 |
노드 붙이기
- 시스템 관리 → 노드 → 노드 추가에서 가입 명령을 받아요. 한 번만 쓰는 가입 토큰이 들어 있어요.
- 노드로 쓸 서버에서 그 명령을 root로 실행해요. 서버가 갈피에서 노드 소프트웨어(
node-kit/)를 받아 스스로 설치하고 가입해요. 갈피는 root 비밀번호나 SSH 키를 받지 않아요. - 노드끼리, 그리고 갈피 서버와 노드는 WireGuard 사설망(10.77.0.0/24)으로 이어져요. 갈피가 노드로 먼저 연결해서 갈피 쪽에 UDP 포트를 열 필요가 없어요. NAT 뒤 노드는 공인 IP가 있는 노드를 거쳐요.
- 노드가 가입하면 주소로 위치를 찾아 지역을 제안해요. 지역은 미리보기 주소의 GeoDNS(가장 가까운 노드)에만 써요.
- E2B 업데이트는 한 번에 한 노드씩 그 노드가 돌려요(새 VM 막기 → 재우기 → 판 바꾸기 → 확인 → 실패하면 되돌리기).
- 노드마다 한도(메모리, 동시 VM)를 덮어쓸 수 있어요. 노드에 문제가 이어지면 시스템 관리자에게 메일과 웹훅으로 알려요(6시간에 한 번까지).
바꿀 때 일어나는 일
- 저장한 값은 다시 시작해야 적용돼요. E2B·Sysbox로 바꾸려면 그 종류의 노드를 먼저 붙여야 해요.
- VM이 있는 채팅이 있으면 확인 창이 먼저 떠요. 실행 중이던 프로그램은 사라져요(개발 서버, 미리보기는 다시 띄워야 해요).
- 옛 곳의 채팅은 다음 질문 때, 10분 넘게 쉬는 채팅은 1분마다 몇 개씩 사본을 떠서 새 곳에서 되살려요. 대화는 남아요. 다 옮길 때까지 옛 곳의 설정(Sprites 토큰, 노드 목록)은 지우지 말아 주세요.
VM 크기 (E2B 노드)
시스템 관리 → 설정 → VM 크기에서 정해요. 프로젝트 관리자는 프로젝트 관리 → 미리보기 → 작업 공간 크기에서 시스템 최대 안의 크기를 골라요. 사람이 채팅마다 고르지는 않아요.
| 크기 | 기본값 |
|---|---|
| S | vCPU 2, 2 GiB, 디스크 10 GiB |
| M | vCPU 4, 4 GiB, 디스크 10 GiB (기본) |
| L | vCPU 8, 8 GiB, 디스크 20 GiB (기본 최대) |
| XL | vCPU 8, 16 GiB, 디스크 40 GiB |
프로젝트 없는 채팅은 언제나 시스템 기본 크기로 떠요. Sprites는 크기가 정해져 있어서 이 설정이 보이지 않아요.
Sysbox 노드
Sysbox 노드의 VM은 커널을 노드와 같이 써요. E2B(Firecracker VM)보다 격리가 약해서, 고를 때 약한 점을 먼저 보여 주고 확인을 받아요. 서로 믿는 사람끼리 쓰는 배포에만 쓰세요.