Galpi
미리보기
채팅에서 고친 앱을 브라우저로 열어 봐요. 띄우는 법은 저장소의 .galpi/preview.yml이나 프로젝트 설정에 적어요.


띄우는 법 적기
앱마다 띄우는 법이 달라서 저장소의 .galpi/preview.yml에 적어 둬요. 기본 브랜치에 이 파일이 있으면 그걸 먼저 쓰고, 없으면 프로젝트 관리 → 미리보기의 같은 항목을 써요.
.galpi/preview.yml
label: 관리자 화면 # 채팅 위 막대에 "관리자 화면 열기". 없으면 "미리보기 열기"
setup: npm ci # 채팅이 준비되면 한 번(선택)
start: npm run dev -- --host 0.0.0.0 --port 8080
port: 8080 # VM이 사람에게 여는 포트 하나. 비우면 8080
ready: /healthz # 이 경로가 답하면 켜진 것(선택)
login: { user: demo, password: generate } # 막대에 보여 줄 로그인(선택)
show: # 막대에 더 띄울 값(선택, 6개까지)
- { label: 관리자 키, value: generate, env: ADMIN_KEY } # 채팅마다 만들고 다시 켜도 같아요
- { label: 테넌트, value: acme }
- { label: 로그인 코드, value: generate, digits: 6, env: LOGIN_CODE }
restart_after_pull: true # 새 버전을 받으면 다시 띄워요
env: { NODE_ENV: development }


앱이 받는 환경 변수는 PORT, HOST, GALPI_PREVIEW_USER, GALPI_PREVIEW_PASSWORD, show:의 env로 적은 변수, 그리고 미리보기 앱에도를 켠 프록시의 변수예요. 다른 비밀값은 받지 않아요.
데이터가 따라가게 하기
미리보기에서 쓴 데이터(시험용 DB, 올린 파일)를 채팅의 사본에 넣으려면 archive:를 적어요. 채팅이 다른 노드로 옮겨져도 데이터가 따라가요. 평소 재우고 깨우기는 VM을 통째로 남기니 이것과 상관없어요.
yaml
archive:
keep: [.env.local, uploads] # 그대로 복사할 파일
watch: [data/dev.db] # 바뀌면 사본을 다시 떠요
pack: | # $GALPI_ARCHIVE_DIR에 데이터를 남겨요 (저장소 폴더에서)
if [ -f data/dev.db ]; then sqlite3 data/dev.db ".backup '$GALPI_ARCHIVE_DIR/dev.db'"; fi
unpack: | # 새 VM에서 되돌려요 (미리보기가 뜨기 전)
if [ -f "$GALPI_ARCHIVE_DIR/dev.db" ]; then mkdir -p data && cp "$GALPI_ARCHIVE_DIR/dev.db" data/; fi
Postgres라면 pg_dump -Fc app > "$GALPI_ARCHIVE_DIR/db.dump"와 pg_restore --clean -d app "$GALPI_ARCHIVE_DIR/db.dump"처럼 써요.
볼 수 있는 사람
링크(미리보기와 따로 연 포트)마다 만든 사람이 골라요. 기본은 프로젝트 멤버예요.
| 범위 | 볼 수 있는 사람 |
|---|---|
| 나만 | 채팅을 만든 사람 |
| 프로젝트 멤버 | 그 프로젝트를 쓸 수 있는 사람(외부 사용자 빼고) |
| 로그인한 사람 | 갈피에 로그인한 사람(외부 사용자 빼고) |
| 링크가 있는 누구나 | 로그인 없이 |
- 프로젝트 관리자는 그 프로젝트의 가장 넓은 범위를 정하고, 시스템 관리자는 공개 범위를 끌 수 있어요.
- 링크는 채팅의 링크, 계정 메뉴의 미리보기 링크, 프로젝트 관리 → 미리보기, 시스템 관리 → 미리보기 링크에서 봐요. 다른 사람의 링크는 좁히거나 닫을 수만 있어요.
- 노드는 갈피가 서명한 토큰 없이는 열어 주지 않아요. 범위를 좁히면 그 전 토큰은 바로 무효예요. Sprites에서는 미리보기 주소를 가릴 수 없어 범위가 적용되지 않아요.
미리보기 주소 (E2B·Sysbox 노드)
- 모양은
<미리보기 ID>.<미리보기 도메인>, 따로 연 포트는<포트>-<미리보기 ID>.<미리보기 도메인>이에요. 미리보기 ID는 채팅마다 하나라서 채팅이 다른 노드로 옮겨도 주소가 그대로예요. - 열어 둔 포트만 열려요: 미리보기 자체와, 에이전트(
galpi-port open)나 만든 사람이 연 포트(채팅마다 5개까지). - 접속 방식은 시스템 관리 → 미리보기 주소에서 정해요: GeoDNS(
*.미리보기 도메인을 가장 가까운 노드로) 또는 CDN(원본 이름 하나를 CDN 뒤에). 인증서는 Let's Encrypt DNS-01(Bunny DNS, Route 53, 웹훅), HTTP-01, 직접 올리기, 노드의 파일, 없음(시험용) 중에서 골라요. - 미리보기를 보여 줄 수 없으면 노드가 안내 페이지를 보여 줘요: "이 미리보기 주소를 찾을 수 없어요"(404), "이 포트는 열려 있지 않아요"(403), "미리보기가 잠시 응답하지 않아요"(502, 504).
로컬 VM에서는 미리보기가 이 컴퓨터의 진짜 프로세스로 뜨고 주소는 http://localhost:<포트>/예요.
미리보기 · 화면 확인 · 실행해 보기 · 앱 띄우기