Foundry DevOps에서 제품 만들기
제품 제작은 출력 리소스를 선택하고, 설치자가 제공할 입력과 설치 설정을 정한 뒤 버전을 게시하는 과정입니다. 게시한 제품은 Marketplace에서 설치할 수 있습니다.
스토어 선택
오른쪽 위 Change Store로 기존 스토어를 선택하거나 새 스토어를 만듭니다. 새 스토어는 프로젝트에 저장하며 그 권한을 상속합니다. 프로젝트 편집자는 기본적으로 제품을 만들고 편집할 수 있고, 보기 또는 편집 권한이 있는 사용자는 설치 경로에 접근할 수 있습니다. 대상과 입력의 추가 권한은 스토어 권한을 따릅니다.
New product 또는 Create new group으로 시작합니다.
초안과 출력
왼쪽 위 Set product title...에 이름을 입력합니다. Add resources는 출력을 직접 고르는 방식이고 Track a folder는 원천 폴더 추적으로 새 버전마다 출력 변경을 반영하는 방식입니다. 수동 구성도 나중에 폴더 추적으로 이전할 수 있습니다.
Add output에서 Compass 파일은 Add files로, 파일시스템에 없는 유형은 Add ontology resources 같은 전용 선택기로 추가합니다.
DevOps는 의존 관계를 찾으므로 가장 하위 리소스부터 추가합니다. Workshop이 객체 유형 4개에 의존한다면 먼저 Workshop을 추가하여 관련 의존 관계를 확인하는 방식입니다.
Add all files from folder는 한 번에 폴더의 파일을 추가합니다. Add from Data Lineage와 Add from Workflow Lineage는 그래프에서 추가합니다. 새 버전마다 폴더의 변경을 추적하는 기능과는 구분합니다.
출력을 선택하면 오른쪽 Details에서 설정을 보고 Dependencies에서 필요한 의존 관계를 확인합니다.
데이터셋의 Include with static data는 실제 파일을 읽으므로 Download 작업인 foundry-data-proxy:get-files가 필요합니다. 다운로드 통제 환경에서는 Owner라도 별도 Exporter 역할 등이 필요할 수 있습니다. 데이터 정의나 변환만 포함하는 방식과의 차이는 패키징 권한을 따릅니다.
입력과 출력의 경계
출력의 의존 관계는 Inputs로 표시됩니다. 설치자가 자신의 데이터셋이나 객체 유형을 제공해야 한다면 입력으로 남깁니다. 제품이 그 리소스를 제공해야 한다면 입력의 ... > Move to output으로 옮깁니다.
여러 입력을 선택하고 아래 Move {N} to outputs로 한꺼번에 옮길 수도 있습니다.
필요한 모든 입력을 출력으로 충족하는 제품은 설치 때 별도 매핑이 필요하지 않을 수 있습니다. 다만 매개변수나 그룹처럼 설치자의 구성이 필요한 입력 유형은 출력으로 옮길 수 없습니다.
입력의 Details와 Dependents에서 그 입력을 사용하는 출력을 확인합니다. 프리셋과 기본값으로 선택 범위와 초기값을 정할 수도 있습니다.
큰 제품 관리
입력과 출력의 필터로 오류가 있는 항목이나 특정 유형을 찾습니다. Folder structure를 사용한다면 Outputs의 Group by Folder로 설치 시 폴더 배치를 볼 수 있습니다.
입력과 출력의 합계 한도는 15,000개입니다. 데이터셋 열과 객체 속성 등 내부 항목도 포함하므로 선택한 최상위 리소스의 개수만 세면 안 됩니다.
한도의 75% 이상이면 왼쪽 아래 Product limits와 Draft status 경고가 나타납니다. 100%에서는 차단 오류로 바뀌므로 출력을 줄이거나 제품을 나누어야 합니다.
View details로 유형별 입력과 출력 개수를 확인합니다.
데이터셋 열을 추가하는 변경만으로도 다음 버전이 한도를 넘을 수 있습니다. 큰 제품은 여러 제품으로 나누어 함께 패키징하는 방식을 검토합니다.
연결 제품과 문서
Linked products에서 입력을 제공할 제품과 매핑을 확인합니다.
Inputs의 Group by linked products로 상위 제품별 입력을 묶을 수 있습니다.
Documentation에는 짧은 Description과 Thumbnail, 추가 미리보기 Images를 넣습니다. 긴 Product description에는 Markdown으로 사용 방법을 작성할 수 있습니다.
제품 설정
Settings에서 폴더 구조, 설치 모드와 빌드를 정합니다.
폴더 구조
Folder structure를 켜면 원래 리소스의 폴더 구성을 설치 때 재현합니다. 가장 낮은 공통 상위 폴더까지 묶으며, 설치 시 그 공통 상위 위치를 설치 프로젝트로 대체합니다.
설치 모드
설치 모드는 설치본의 기본 설정을 정합니다. 자동 업그레이드나 프로젝트 잠금 같은 설정은 설치본별로 바꿀 수 있습니다.
| 모드 | 목적과 기본 동작 |
|---|---|
| Production | 설치본을 중앙 관리하고 자동 업그레이드 등을 사용할 때 권장합니다. 자동 업그레이드는 기본으로 꺼져 있고 설치자가 프로젝트 잠금을 선택할 수 있습니다. |
| Singleton | Production과 같은 설정이며, 공간과 온톨로지 조합마다 설치본을 하나만 허용합니다. |
| Bootstrap | 설치자가 자신의 업무로 확장할 시작점에 적합합니다. 자동 업그레이드는 기본으로 꺼져 있고 편집 권한이 있는 위치에 설치할 수 있습니다. |
빌드
Build settings는 설치 작업 중 데이터셋과 모델을 자동 빌드할지 정합니다. 새 리소스에 데이터를 채우는 단계의 설정이며 실제 입력과 실행 권한도 충족해야 합니다.
검토와 게시
Publish로 Review Changes and Publish를 열어 변경과 버전 증가 및 유효성 상태를 검토하고 Changelog description을 작성합니다. 스토어가 승인을 요구한다면 승인 조건을 충족해야 합니다. 제품 크기에 따라 게시에 몇 분이 걸릴 수 있습니다.