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: 앱 올리기와 배포


로컬 미리보기
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)로 업로드·검색·인용 답·검토·내보내기·복구까지 실제로 돌려 봐요. 운영 공급자로는 절대 쓰지 않아요.