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:<포트>/예요.

Esc