Mothership

앱 올리기와 배포

빌드한 ZIP을 후보 버전으로 올리고, 공동 검증에서 검토하고, 승인된 후보만 운영에 반영해 카탈로그에 게시해요.

흐름

앱 추가ZIP → 후보 버전 검토 후보 접수대기열 공동 검증테스트 데이터 · 승인 운영 반영실제 업무 데이터 카탈로그 게시직원에게 보여요

갈피 없이도 이 흐름 전체가 돼요. 갈피를 이으면 갈피가 보낸 소스를 Mothership이 빌드해 후보를 만들어요(소스 빌드 실행기가 필요해요). → 제품 잇기

1. 앱 추가

업무 앱 → 카탈로그 관리 → 앱 추가에 Golden Image가 만든 dist/<release>.zip을 끌어다 놓아요. 새 앱이 되거나, 같은 앱이면 새 후보 버전이 돼요. Mothership은 manifest schema, agents.sha256 증거, 안전한 asset 경로, 그리고 entry 파일이 release.artifact_hash와 맞는지 확인한 뒤 asset을 직접 저장하고 내줘요. 따로 호스팅할 것이 없어요.

카탈로그 관리. 앱 추가와 회사 앱 목록.카탈로그 관리. 앱 추가와 회사 앱 목록.
카탈로그 관리. 앱 추가와 회사 앱 목록.
업로드는 환경을 바꾸지 않아요

올린 ZIP은 바뀌지 않는 후보예요. 공동 검증이나 운영은 아래 단계를 거쳐야 바뀌어요.

  • 소스에서 빌드할 빈 앱 만들기: 소스 빌드 실행기가 설정된 Mothership에서, 갈피 프로젝트를 이어 소스로 버전을 만들 때 써요.
  • 외부 백엔드 연결 · 고급: 백엔드 worker(Python/Node)를 URL과 미리 나눈 서명 키로 연결해요. 등록이 /health와 /v1/handshake로 키를 확인한 뒤 게시해요. 프런트엔드 URL 등록은 지원하지 않아요(frontend_url_unsupported).

2. 버전·환경

앱을 열면 개요, 카탈로그 정보, 접근 권한, 버전·환경, 비밀값, 미리보기 탭이 있어요.

앱 → 개요. 이 앱이 하는 일, 요청하는 접근, 환경마다의 버전.앱 → 개요. 이 앱이 하는 일, 요청하는 접근, 환경마다의 버전.
앱 → 개요. 이 앱이 하는 일, 요청하는 접근, 환경마다의 버전.
  1. 검토 후보로 접수 — 검토받을 버전과 바뀐 점(검토자에게 보여요)을 적어 접수해요. 이 버전이 요청하는 접근(데이터, 플랫폼 기능)이 함께 보여요.
  2. 공동 검증에 올리기 — 대기열 순서가 되면 올려요. 공동 검증은 한 번에 후보 하나이고, 지금 검토를 끝내거나 닫기 전에는 다음 후보가 바꾸지 못해요. 준비가 끝나면 공동 검증에서 열기로 앱을 열어 확인해요.
  3. 검토 결정 — 검토자가 승인 · 운영에 반영해도 돼요 또는 수정 요청과 의견을 기록해요. 결정은 지금 공동 검증에 올라간 상태에만 적용돼요.
  4. 운영에 반영 — 승인된 후보와, 운영 앱 설정도 같이 바꿀지 확인하고 반영해요. 반영 요청은 순서대로 처리되고, 이미 시작된 작업이 끝날 때까지 기다려요. 저장된 업무 데이터는 되돌아가지 않아요.
버전·환경. 공동 검증에서 검토 중인 후보와 결정 기록.버전·환경. 공동 검증에서 검토 중인 후보와 결정 기록.
버전·환경. 공동 검증에서 검토 중인 후보와 결정 기록.
  • 되돌리기: 운영 이전 버전으로 되돌리기로 명시적으로 요청해요. 저장소 schema 서명이 다르면 저절로 되돌리지 않고, 데이터 migration을 추측해 되돌리지 않아요.
  • 검토자는 일반 구성원이어도 돼요. 그 앱의 candidate.review와 공동 검증의 environment.run을 받으면 검토할 수 있어요.

3. 카탈로그 게시

카탈로그 정보에서 직원에게 보일 이름, 설명, 아이콘, 분류를 정하고 운영 카탈로그에 게시를 켜요. 게시 여부는 카탈로그에 보이는지만 바꿔요. 게시를 해제해도 앱 실행은 멈추지 않아요.

접근 권한과 비밀값

  • 접근 권한: 앱을 열 수 있는 대상(구성원, 팀 공간)과 앱이 선언한 claim을 정해요.
  • 비밀값: 앱 실행에 필요한 비밀값을 환경마다 넣어요. 앱 설정 JSON에는 비밀값을 두지 않아요(앱 코드가 읽을 수 있어서요).
앱 → 접근 권한.앱 → 접근 권한.
앱 → 접근 권한.

미리보기와 환경 격리

미리보기 탭은 서버가 발급한 pv_ 키로 만든 짧은 환경이에요. TTL, 소유자, 공유 대상이 기록되고, Mothership의 새 탭에서 열려요. 공동 검증·미리보기·운영의 레코드, 파일, 지식, 작업, 실행은 서로 다른 환경 범위예요. 공동 검증과 미리보기의 커넥터는 운영 비밀값으로 넘어가지 않고, 환경마다 따로 연결해요.

Esc