문서 목차
초기 설정 마법사
KosmosAI 를 설치한 직후 보안관리자와 운영 관리자가 각각 한 번씩 거치는 첫 설정 화면입니다.
QUANTUM C&S
KosmosAI 를 설치한 직후 보안관리자와 운영 관리자가 각각 한 번씩 거치는 첫 설정 화면입니다.
KosmosAI 에는 마법사가 두 개 있습니다. 보안관리자는 조직 · 권한의 뼈대를 정하는 초기 설정 을, 운영 관리자는 인프라 기본값을 확인하는 운영 초기 설정 을 진행합니다. 두 마법사는 서로 독립적으로 완료 처리되며, 마법사에서 정한 값은 모두 나중에 플랫폼 설정 · IGA(권한 관리)에서 다시 바꿀 수 있습니다.
두 마법사 비교
| 항목 | 초기 설정 | 운영 초기 설정 |
|---|---|---|
| 화면 제목 | KosmosAI 초기 설정 | KosmosAI 운영 초기 설정 |
| 주소 | /setup |
/ops-setup |
| 진행하는 사람 | 보안관리자 | 운영 관리자 |
| 자동으로 열리는 때 | 초기 설정이 끝나지 않은 상태에서 보안관리자가 로그인하면 다른 화면 대신 이 마법사로 이동합니다. | 운영 초기 설정을 끝내지 않은 운영 관리자가 로그인하면 이 마법사로 이동합니다. |
| 단계 | 업종 · 앱 → 직급 · 직책 · 보안등급 → 부서 → 운영 관리자 → 두 번째 보안관리자 → 완료 | 시작 → 쿠버네티스 → S3 스토리지 → 모델 레지스트리 → 추론 → AI Gateway → 완료 |
| 완료 버튼 | 초기 설정 완료 | 완료하고 시작 |
| 완료 후 | IGA 화면으로 이동하며, 다시 자동으로 열리지 않습니다. | 다시 자동으로 열리지 않습니다. |
참고 위쪽의 단계 이름(예: 1. 업종 · 앱)을 누르면 그 단계로 바로 이동할 수 있고, 아래 이전 / 다음 으로 차례대로 넘길 수 있습니다. 각 단계는 플랫폼 설정 화면과 같은 기능을 쓰므로, 마법사에서 저장한 값은 곧바로 설정 화면에도 반영됩니다.
초기 설정(보안관리자)
"보안관리자가 처음 한 번 정합니다. 모든 항목은 나중에 플랫폼 설정 · IGA 에서 다시 바꿀 수 있습니다." 라는 안내와 함께 열립니다.
1단계: 업종 · 앱
플랫폼 프로필 에서 KosmosAI 를 쓰는 업종과 켤 앱을 정하세요.
| 항목 | 설명 | 규칙 |
|---|---|---|
| 업종 | 제조 · 금융 · 공공 | 여러 개를 고를 수 있습니다. 고르지 않으면 공통 기능(LLMOps · MLOps)만 씁니다. |
| 앱(기능) | 자산(제조 AX 앱 — 자산 · 자산 타입 · 제조 · 시뮬레이션) | 제조를 새로 고르면 켜자고 제안하지만 끌 수 있습니다. 끄면 메뉴가 사라지고 자산 기능도 닫힙니다. |
값을 바꿨다면 저장 을 누르세요.
2단계: 직급 · 직책 · 보안등급
결재선의 기준이 되는 조직 체계를 정하세요.
| 항목 | 설명 |
|---|---|
| 직급 → 결재 서열 | 직급마다 서열 0~10 |
| 임원 기준 서열 | 이 서열 이상이면 임원(팀장 결재를 건너뛰고 임원 결재자가 됨) |
| 직책 | 팀장 · 본부장 등(서열과 별개) |
| 보안등급 | 정보 취급 인가 등급. 숫자가 클수록 높으며 IGA 정책 조건에 씁니다. |
3단계: 부서
결재선의 기준이 되는 부서를 만드세요. 부서 이름(예: 경영지원팀)을 넣고 추가 를 누르면 목록에 나타나고, 휴지통 아이콘으로 지울 수 있습니다. 같은 이름의 부서는 만들 수 없습니다.
4단계: 운영 관리자
플랫폼(GPU · 스토리지 · 모델 · 사용자 배치)을 운영할 사람을 임명하세요.
| 방식 | 입력 항목 | 규칙 |
|---|---|---|
| 기존 사용자 중에서 | 사용자 선택 | — |
| 새 계정 만들기 | 이메일, 성, 이름, 임시 비밀번호 | 임시 비밀번호는 8자 이상이며 첫 로그인 때 바꿉니다. |
운영 관리자로 임명 을 누르세요. 첫 임명은 승인할 운영 관리자가 아직 없으므로 결재 없이 바로 적용되며, 이후 임명은 결재를 거칩니다.
주의 운영 관리자가 한 명도 없으면 "운영 관리자를 한 명 임명해야 다음으로 갈 수 있습니다" 가 표시되고 다음 이 눌리지 않습니다. 이미 운영 관리자가 있으면 "운영 관리자가 N명 있습니다." 로 안내됩니다.
5단계: 두 번째 보안관리자(권장)
보안관리자가 한 명뿐이면 그 계정을 쓸 수 없을 때 권한 · 정책을 바꿀 사람이 없습니다. 팀(부서 · 프로젝트)에 소속되지 않은 사용자를 골라 요청 을 누르세요. 결재가 필요하면 "결재 요청을 올렸습니다 — 운영 관리자가 승인하면 적용됩니다" 로 안내되고, 진행은 내 프로필 · 접근 토큰의 결재함 에서 볼 수 있습니다.
이 단계는 건너뛰어도 됩니다. 나중에 사용자 상세에서 할 수 있습니다.
6단계: 완료
준비됐습니다 아래에 요약(업종 수 · 자산 기능 켜짐/꺼짐, 직급 수 · 임원 기준 서열, 운영 관리자 · 보안관리자 수)이 보입니다. 확인한 뒤 초기 설정 완료 를 누르세요. "초기 설정을 마쳤습니다" 알림과 함께 IGA 화면으로 이동합니다.
운영 초기 설정(운영 관리자)
플랫폼 운영에 필요한 기본값을 한 번 확인하는 마법사입니다. 대부분은 설치할 때 이미 채워져 있으므로, 그대로 두고 필요한 것만 바꾸세요.
1단계: 시작
이 마법사에서 확인할 항목(쿠버네티스, S3 스토리지, 모델 레지스트리 · 추론)이 안내됩니다.
2단계: 쿠버네티스
플랫폼이 잡 · 저장 볼륨 · 서빙을 만드는 클러스터입니다.
| 항목 | 설명 |
|---|---|
| 기본 | 현재 설치된 클러스터를 자동으로 사용합니다(입력 불필요). |
| 외부 클러스터 사용 | 다른 클러스터를 쓰려면 kubeconfig 내용, 컨텍스트(선택), 설명(선택)을 넣고 저장합니다. |
| 연결 테스트(서버측) | 서버에서 클러스터에 접속해 보고, 정상이면 노드 수와 함께 표시합니다. |
3단계: S3 스토리지
데이터셋 · 모델 · 지식기반 자료가 저장되는 객체 스토리지입니다. 설치 시 정한 백엔드(Ceph RGW · RustFS · MinIO)에 맞춰 보여집니다.
| 항목 | 설명 |
|---|---|
| 백엔드 (설치 지정) | 설치 때 정한 스토리지 종류 |
| 내부 Endpoint (서버측) | 플랫폼 서비스가 쓰는 주소 |
| 공인 Endpoint (presigned) | 브라우저가 파일을 직접 내려받을 때 쓰는 주소 |
| Region · 인증서 검증 · 상태 | 연결 설정과 현재 상태(자동 구성 또는 직접 설정) |
| 전용 키 자동 생성 | 스토리지 관리자 API 가 있는 백엔드면 그룹 · 개인 스토리지마다 전용 키 · 버킷 정책 · 쿼터를 자동으로 만듭니다. 없으면 공용 키로 접근합니다. |
외부 S3 를 쓰려면 외부 주소로 수정 에서 백엔드 타입, 주소(예: https://s3.example.com), Access Key, Secret Key, https 사용 여부, 인증서 검증 여부를 넣으세요. 연결 테스트는 서버에서 수행됩니다. 아래에서 플랫폼 공용 버킷을 확인 · 관리할 수 있습니다.
4단계: 모델 레지스트리
| 항목 | 설명 |
|---|---|
| 내장 레지스트리 | S3 기반 기본 레지스트리와 업로드 모델 버킷 |
| MLflow | MLflow 서버 주소와 아티팩트 S3 루트(선택), 연결 테스트 |
| HuggingFace 토큰 | 비공개 모델을 받을 때 필요합니다. 공개 모델만 쓰면 비워도 됩니다. 연결 테스트 는 저장 전에도 입력한 토큰을 바로 검증합니다. |
5단계: 추론
추론(서빙) 기능이 클러스터에 설치되어 있는지 확인하고 기본값을 정합니다.
| 항목 | 설명 |
|---|---|
| 설치 상태 | 서빙 컨트롤러와 게이트웨이 설치 여부 |
| 네임스페이스 | 서빙 구성요소가 기본 배포되는 작업 공간 |
| 게이트웨이 네임스페이스 · 게이트웨이 이름 | 추론 요청이 들어오는 게이트웨이. 클러스터에서 발견된 게이트웨이가 함께 표시됩니다. |
런타임 · 배포 템플릿 세부는 플랫폼 설정의 Inference 에서 조정합니다.
6단계: AI Gateway
모든 LLM 호출을 모으는 게이트웨이의 상태(정상 · 모델 수)를 확인하고, 필요하면 외부 모델 추가 로 외부 프로바이더 모델을 등록하세요. 지금 추가하지 않고 나중에 플랫폼 설정에서 추가해도 됩니다. 누가 어떤 모델을 쓸 수 있는지는 IGA(권한 관리)에서 관리합니다.
7단계: 완료
준비 완료 를 확인하고 완료하고 시작 을 누르세요. "운영 초기 설정을 마쳤습니다" 알림이 뜹니다.
끝낸 뒤 값 바꾸기
| 마법사 단계 | 바꾸는 곳 |
|---|---|
| 업종 · 앱 | 플랫폼 설정 → 플랫폼 프로필(보안관리자) |
| 직급 · 직책 · 보안등급 | 플랫폼 설정 → 직급 · 직책 · 보안등급(보안관리자) |
| 부서 | 그룹 관리 → 부서 탭(보안관리자) |
| 운영 관리자 · 보안관리자 임명 | 사용자 관리 사용자 상세 → 역할, IGA(권한 관리) → 주체(결재 필요) |
| 쿠버네티스 | 플랫폼 설정 → Kubernetes |
| S3 스토리지 | 플랫폼 설정 → S3 스토리지 |
| 모델 레지스트리 | 플랫폼 설정 → Model Registry |
| 추론 | 플랫폼 설정 → Inference |
| AI Gateway | 플랫폼 설정 → AI Gateway |
참고 마법사를 완료한 뒤에도 해당 권한이 있으면 주소(
/setup,/ops-setup)로 마법사 화면을 다시 열어 볼 수 있습니다. 다만 값 변경은 위 표의 설정 화면에서 하는 것을 권장합니다.