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을 띄우지 않아요

노드 붙이기

  1. 시스템 관리 → 노드 → 노드 추가에서 가입 명령을 받아요. 한 번만 쓰는 가입 토큰이 들어 있어요.
  2. 노드로 쓸 서버에서 그 명령을 root로 실행해요. 서버가 갈피에서 노드 소프트웨어(node-kit/)를 받아 스스로 설치하고 가입해요. 갈피는 root 비밀번호나 SSH 키를 받지 않아요.
  3. 노드끼리, 그리고 갈피 서버와 노드는 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)보다 격리가 약해서, 고를 때 약한 점을 먼저 보여 주고 확인을 받아요. 서로 믿는 사람끼리 쓰는 배포에만 쓰세요.

Esc