Golden Image

빠른 시작

의존성을 준비하고, 빌드·검사·시험하고, 로컬에서 미리 보고, 만든 ZIP을 Mothership에 올려요.

필요한 것

  • Node.js 22.13 이상(Mothership과 같은 개발 환경)
  • Python 3.11 이상과 venv/pip
  • GNU Make

project.json의 parts를 먼저 정하고, 바꾼 뒤에는 make setup을 다시 해요. 새로 켠 worker의 의존성이 설치돼요.

만들기

bash
make setup      # .env와 미리 나눈 키(백엔드가 있을 때), npm ci, 백엔드 venv
make build      # 켜진 parts를 빌드하고 schema·등록 규칙·짝 검사까지
make test

프런트엔드만 쓰더라도 make setup은 한 번 해요. make build와 make check가 jsonschema를 쓰기 때문이에요.

빌드가 끝나면 이렇게 나와요.

Check OK — parts=['frontend'] (my-project)
To register: upload frontend/dist/<release>.zip as a candidate in catalog management, then apply it to shared validation or production from the app's Versions & environments tab.

Mothership에 올리기

frontend/dist/<release>.zip을 회사의 업무 앱 → 카탈로그 관리 → 앱 추가에 올려요. 업로드는 후보 버전을 만들 뿐이고, 공동 검증과 운영은 앱의 버전·환경 탭에서 따로 반영해요. → Mothership: 앱 올리기와 배포

Mothership 카탈로그 관리. 올린 앱이 후보로 나타나요.Mothership 카탈로그 관리. 올린 앱이 후보로 나타나요.
Mothership 카탈로그 관리. 올린 앱이 후보로 나타나요.

로컬 미리보기

bash
make serve        # 빌드한 프런트엔드를 로컬에서
make preview      # localhost에만 묶어요. 공개 터널을 만들지 않아요
bash scripts/preview.sh --host <내부 호스트>   # Mothership이 닿는 주소로 백엔드를 열 때
bash scripts/preview.sh --tunnel               # 공개 임시 터널을 고를 때만 (cloudflared)
  • 로컬 미리보기 주소는 Mothership의 미리보기가 아니에요.
  • 백엔드가 있으면 .preview/registration.json(소유자만 읽기)에 백엔드 URL과 서명 키가 써져요. 비공개로 둬요.

기본 구성 세 가지 검사

project.json을 고치지 않고 세 기본 구성을 차례로 확인할 수 있어요. 빌드 출력을 같이 써서 차례로 돌려요.

bash
MOTHERSHIP_PROJECT_FILE=scripts/fixtures/projects/frontend-only.json make build check test
MOTHERSHIP_PROJECT_FILE=scripts/fixtures/projects/python.json make build check test
MOTHERSHIP_PROJECT_FILE=scripts/fixtures/projects/node.json make build check test
모델 없이 브라우저 수락 검사

scripts/fixtures/review_provider.py는 localhost 전용의 정해진 답을 주는 AI 대역(8777번)이에요. 버리는 Mothership DB에 이 앱을 올리고 scripts/browser-review.mjs(Playwright)로 업로드·검색·인용 답·검토·내보내기·복구까지 실제로 돌려 봐요. 운영 공급자로는 절대 쓰지 않아요.

Esc