marketplace

ObjectOS marketplace를 사용하면 실행 중인 런타임에 사전 빌드된 앱을 설치할 수 있습니다. 빌드 단계도, 재시작도, 소스 체크아웃도 필요하지 않습니다. 첫날부터 실제 소프트웨어를 사용자에게 선보이는 가장 빠른 방법입니다.

작동 방식

모든 ObjectOS 런타임에는 MarketplaceProxy와 MarketplaceInstallLocal 플러그인이 기본적으로 활성화되어 제공됩니다. Console(/_console/)을 열면 marketplace 탭이 구성된 앱 카탈로그를 조회하고 설치 가능한 앱을 표시합니다.

You ─→ Console ─→ Marketplace tab ─→ pick app ─→ Install
                                                  ↓
                                       Artifact merged into kernel
                                                  ↓
                                       Console re-renders with new
                                       objects / views / permissions
                                                  ↓
                                       Done — no restart

카탈로그

카탈로그 소스는 marketplace 플러그인 또는 환경 변수를 통해 구성됩니다. Runtime Configuration을 참조하세요.

기본 카탈로그에 포함된 내용

이 앱들은 Console에서 클릭 한 번으로 설치할 수 있습니다.

소스는 github.com/objectstack-ai/templates에 있습니다. 이들 중 아무거나 복제하여 커스텀 앱의 출발점으로 삼으세요.

설치 흐름

1. Console 열기 — http://localhost:3000/_console/
2. 로그인 — 아직 계정이 없다면 /_account/register에서 등록합니다
3. marketplace 탭으로 이동
4. 앱을 선택하고 Install 클릭
5. Console 새로고침 — 새 앱의 오브젝트, 뷰, 플로우가 나타납니다

내부적으로 marketplace는 앱의 컴파일된 아티팩트를 가져와 실행 중인 커널에 병합하고, 해당 오브젝트를 ObjectQL에 등록합니다. 시드 데이터는(앱이 정의한 경우) 최초 설치 시 삽입됩니다.

제거

Console → Marketplace → 설치된 앱 → Uninstall에서 제거합니다. 앱의 오브젝트는 커널에서 제거되고 해당 테이블은 정리 대상으로 표시됩니다(데이터는 기본적으로 유지되며, 테이블 삭제 여부는 사용자가 선택합니다).

직접 만든 앱 게시하기

os init으로 빌드한 모든 것은 marketplace 앱이 될 수 있습니다.

os init my-app -t app --install
cd my-app
# ... write objects, views, etc. ...
os compile                                    # → dist/objectstack.json
os package publish                            # publish to a catalog

공개 카탈로그에 게시하려면 레지스트리 계정(os login)이 필요합니다. 프라이빗 카탈로그에 게시하려면 OS_PACKAGE_REGISTRY를 직접 운영하는 레지스트리로 지정하세요.

버전 관리

게시된 모든 앱은 불변(immutable)입니다. 업데이트는 새 버전을 생성합니다. 런타임은 앱별로 설치된 버전과 사용 가능한 업데이트를 추적합니다. 추적 중인 카탈로그에 새 버전이 게시되면 사용자는 Console에서 "Update available" 배지를 보게 됩니다.

권한

앱 설치에는 manage_marketplace 시스템 권한이 필요합니다. 기본적으로 Setup Administrator 권한 집합의 구성원만 이 권한을 가집니다. 일반 사용자에게는 marketplace가 읽기 전용으로 표시됩니다.

에어갭 marketplace

인터넷 송신이 없는 배포 환경에서는 네트워크 내부에 로컬 카탈로그 서버를 실행하고 ObjectOS가 이를 가리키도록 합니다. 토폴로지는 Air-gapped를 참조하세요.

marketplace가 아닌 것

• 코드 배포 채널이 아닙니다. 게시된 앱은 컴파일된 아티팩트로, 데이터 + UI + 플로우를 선언적으로 기술합니다. 임의의 JavaScript를 제공하지 않습니다.
• 샌드박스가 아닙니다. 설치된 앱은 커널 내의 다른 무엇과 마찬가지로 데이터베이스에 동일하게 접근합니다. 신뢰할 수 없는 출처의 앱을 설치하기 전에는 아티팩트를 검토하세요.
• (아직은) 결제 플랫폼이 아닙니다. 공개 카탈로그의 앱은 무료 Apache-2.0 라이선스입니다. 상업적 / 유료 배포는 로드맵에 있습니다.