Marketplace 제품 설치

Marketplace 설치 작업은 제품 선택, 입력 연결, 출력 검토와 실제 설치로 나뉩니다. 스토어를 볼 수 있어야 하고, 입력 리소스를 사용할 권한 및 설치할 공간, 프로젝트와 온톨로지의 설치 권한이 필요합니다.

설치 작업 만들기

스토어 오른쪽 위 Create new installations로 제품 선택 모드를 켜고 하나 이상을 선택합니다. 아래의 같은 버튼으로 설치 작업을 만듭니다.

제품 상세에서는 Install again을 사용할 수 있습니다. 접근 가능한 기존 설치본이 있으면 Open으로 그 설치본을 열고 갱신할 수 있으며, 다른 입력이나 위치가 필요하면 다시 설치합니다. 회수된 버전은 Install이 비활성화됩니다.

Create installation job에서 위치와 버전을 정합니다.

아래 New Installation에서 제품별 버전을 바꿀 수 있습니다. Create는 설치 작업 초안을 만듭니다.

General과 연결된 제품

General은 제품 의존 관계를 보여 줍니다. 왼쪽 Inputs에서는 입력을 연결하고 Outputs에서는 생성할 리소스를 확인합니다.

Add available linked products는 입력을 제공할 수 있는 제품을 보여 줍니다. 공간 필터로 같은 공간의 설치본을 보거나 스토어 필터로 다른 스토어의 제품을 찾을 수 있습니다.

제품 옆 +에서 다음 경로를 선택합니다.

• 기존 설치본을 외부 참조하여 이미 설치한 출력으로 입력을 충족합니다. 외부 참조는 스토어를 가로질러 연결할 수 있습니다.
• 새 버전이 있으면 기존 설치본을 업그레이드합니다.
• 연결 제품을 새로 설치하도록 초안에 포함합니다.

같은 작업에 설치나 업그레이드 대상으로 포함하는 설치본은 같은 스토어와 공간에 있어야 합니다. 외부 참조만 하는 설치본과 구분합니다.

추가하면 아래에 미적용 변경이 표시됩니다. Apply changes로 반영합니다.

그래프는 신규 설치, 외부 참조와 그 의존 관계를 구분합니다. 예를 들어 Supply Chain Core Ontology를 외부 참조하면 입력을 제공하되 이번 작업에서 갱신하지 않습니다. Inventory Timeline Starter Pack을 신규 설치로 추가하면 Inventory Management, Visibility and Simulation과 함께 설치합니다.

추가한 제품 노드를 선택하면 Include in draft나 Remove from draft로 포함 여부를 바꿀 수 있습니다.

입력 목록

Inputs는 필수와 선택 입력의 수 및 충족 상태를 보여 줍니다. 연결 제품이 채운 입력은 기본으로 숨깁니다. 데이터셋, Multipass 그룹, 온톨로지 스키마 이전과 설치 접두사 등 유형별로 구성됩니다.

Filters에서는 누락/오류/선택/충족 상태, 입력 유형과 소속 제품을 선택할 수 있습니다. 이름으로 검색하고 Group by에서 유형이나 제품별로 묶습니다.

입력을 선택한 뒤 Configuration에서 리소스를 검색하여 연결합니다.

Downstream은 그 입력을 필요로 하는 설치 리소스를 보여 줍니다.

같은 유형을 한꺼번에 설정

같은 유형의 입력들을 체크하면 오른쪽에 Bulk-set inputs가 나타납니다. 동일한 구성을 선택한 입력에 적용할 수 있습니다.

온톨로지 설치 접두사

Ontology install prefix는 객체 유형, 링크 유형과 액션 유형의 이름에 접두사를 붙입니다. Display name only 또는 Display name and API name을 선택합니다. 생성 SDK 등 제품별 API 이름 요구가 있으면 그 제약도 확인해야 합니다.

임시 데이터셋 입력

실제 입력 리소스가 아직 준비되지 않았을 때 임시 데이터셋을 만들어 설치를 준비할 수 있습니다. Placeholder inputs는 데이터셋 입력만 지원합니다.

Inputs의 Actions > Placeholder inputs 또는 개별 Configuration의 Generate placeholder를 선택합니다.

저장 폴더와 대상 입력을 선택하고 Generate placeholder inputs로 만듭니다. 이 입력은 실제 업무 데이터가 준비되었다는 뜻이 아닙니다. 실제 리소스가 생기면 설치본의 ... > Edit에서 다시 연결합니다.

Actions > Auto-select from folder는 지정 폴더의 리소스로 입력을 자동 연결하는 경로입니다.

입력 재정의

기본값이나 연결 제품이 제공할 값을 설치자가 수동으로 정하면 override입니다. Settings의 Show overrides를 켜면 입력 목록과 매핑 아이콘에 표시합니다.

매핑 아이콘을 선택하면 현재 값과 수동 지정이 없을 때 사용할 후보를 볼 수 있습니다.

분류 우선순위는 표의 아래쪽으로 갈수록 높습니다. 예의 Text Embedding 3 Small을 기본값과 같은 값으로 지정하면 Unnecessary override입니다.

불필요한 재정의나 연결 제품 재정의가 있으면 입력 수 아래에 Clean up이 나타납니다. Actions에서도 같은 기능을 엽니다.

Unnecessary overrides 또는 Linked installation candidates에서 수동 설정을 지우면 자동 후보가 입력을 채웁니다. 불필요한 재정의는 결과 값이 같지만 연결 제품 재정의는 값이 달라질 수 있으므로 확인해야 합니다.

출력 검토

Outputs는 생성할 액션 유형, 상태 검사, 데이터셋, 폴더와 Workshop 등을 유형별로 보여 줍니다. 검색, 필터와 묶기를 사용할 수 있으며 확인이 필요한 출력에는 경고가 표시됩니다.

Configuration은 생성할 내용을, Upstream은 해당 출력에 필요한 입력과 다른 리소스를 보여 줍니다.

설치 실행

필수 입력을 모두 충족하고 차단 오류를 해결한 뒤 오른쪽 위 Install을 선택합니다. 초안을 제출하면 리소스를 생성하는 작업이 시작되고 진행 페이지로 이동합니다.

경고는 설치를 막지는 않지만 진행 전에 표시를 열어 확인합니다. 유효성 검사 오류가 차단 상태이면 해결해야 설치할 수 있습니다. 완료 뒤에는 설치본 관리에서 리소스와 설정을 확인합니다.