Features and Usages - MZC-CSC/mc-web-console GitHub Wiki

[MC-Web-Console 활용 개요]

MC-Web-Console은 여러 CSP의 자원을 하나의 Workspace/Project 단위로 묶어 생성하고 운영하는 웹 콘솔이다. 이 문서는 콘솔로 멀티 클라우드 서비스를 만드는 기본 흐름을 단계별로 설명한다. 각 단계 끝의 검증 TC는 그 기능을 자동화 테스트로 확인하는 케이스이고, 옆 기호는 최근 결과다 (Test Results 참조).

생성: 2026-09-28 · 결과 기준: 최근 실행 2026-09-16 · 대상 배포 버전: web:0.5.2 infra:0.12.9 conn:0.12.18 wf:0.5.1 app:0.5.2 data:0.5.3 cost:0.5.2 obs:0.5.0

콘솔 이용 흐름

Step 1. 로그인 · Workspace/Project 선택
  └─→ Step 2. 클라우드 연결 확인 (Credential · Connection)
        └─→ Step 3. Cloud Resources 준비 (VPC · Security Group · SSH Key)
              └─→ Step 4. Infra Workload 생성 · 운영
                    └─→ Step 5. K8s Workload 생성 · 운영
                          └─→ Step 6. 자원 삭제

• 모든 운영 화면은 상단의 Workspace와 Project를 먼저 선택해야 목록이 조회된다. 선택하지 않고 들어가면 선택 안내 모달이 뜬다.
• 화면에 보이는 메뉴는 로그인한 사용자의 역할(Role)에 따라 다르다. 메뉴가 보이지 않으면 관리자에게 역할 할당을 요청한다.

서비스 생성 Guide

Step 1. 로그인 · Workspace/Project 선택

(1) 로그인

1. 콘솔 주소로 접속해 ID와 Password를 입력하고 로그인한다.
2. 계정이 없으면 가입 신청 후 관리자 승인을 기다린다. 승인 전에는 로그인할 수 없다.

(2) Workspace/Project 선택

1. 화면 상단의 Workspace 선택 상자에서 작업할 Workspace를 고른다.
2. 이어서 Select Project에서 Project를 고른다. 이후 조회·생성하는 자원은 이 Project(네임스페이스)에 속한다.

(3) 관리자 — 사용자 승인과 권한 부여

1. Settings › Account & Access › Organizations › Approvals에서 가입 신청자를 확인하고 Approve 또는 Reject한다.
2. Users 화면에서 사용자에게 그룹을 배정하고, Menus/Roles 화면에서 역할별로 노출할 메뉴를 관리한다.

검증 TC: TC-IAM-SIGNUP-01 📝 · TC-IAM-APPROVE-01 📝 · TC-IAM-APV-APPROVE-01 ❌ · TC-IAM-MENU-VIS-01 ⬜

Step 2. 클라우드 연결 확인

(1) Credential 등록

1. Settings › Environment › Cloud SPs › Credentials로 이동한다.
2. Provider(AWS, Azure, GCP, Alibaba, Tencent, NCP, NHN Cloud, KT Cloud 등)를 선택하고 해당 CSP의 인증 키 값을 입력해 등록한다.

(2) Connection 확인

1. Connections 화면에서 Credential과 리전별로 만들어진 연결(Config Name, Region, Zone)을 확인한다.
2. 이후 단계에서 자원을 만들 때 이 Connection을 선택한다.

(3) 지원 CSP 확인

1. Cloud Drivers, CSP Definitions 화면에서 사용 가능한 드라이버와 CSP별 리전/존 정의를 확인한다.

검증 TC: TC-CONSOLE-CLOUDDRIVER-LIST-01 📝 · TC-CONSOLE-CSPDEF-LIST-01 📝 · TC-CONSOLE-CSPDEF-CREATE-01 📝

Step 3. Cloud Resources 준비

Infra Workload를 Express 모드로 만들면 네트워크 등 기본 자원을 자동으로 구성하므로 이 단계를 건너뛸 수 있다. Expert 모드로 네트워크 구성을 직접 지정하려면 먼저 자원을 만든다. 위치는 모두 Settings › Environment › Cloud Resources 아래다.

(1) Network(VPC) 생성

1. Networks 화면에서 Create를 누른다.
2. Connection을 선택하고 VPC 이름, CIDR Block, Subnet을 입력한 뒤 실행한다.
3. 목록에 새 VPC가 나타나는지 확인한다.

(2) Security Group 생성

1. Security Groups 화면에서 Create를 누른다.
2. 대상 VPC와 이름을 선택하고, Add Rule로 인바운드 규칙(예: TCP 22, 80)을 추가한 뒤 실행한다.

(3) SSH Key 생성

1. SSH Keys 화면에서 Create를 누르고 Connection과 이름을 입력해 실행한다.
2. 생성 직후 한 번만 표시되는 개인키를 안전한 곳에 저장한다.

(4) 기존 CSP 자원 가져오기

1. CSP에 이미 있는 자원은 Resource Sync 화면에서 조회해 콘솔로 가져올 수 있다.

검증 TC: TC-INFRA-VPC-CREATE-01 ✅ · TC-INFRA-SG-CREATE-01 ✅ · TC-INFRA-SSHKEY-CREATE-01 ✅ · TC-INFRA-DISK-CREATE-01 ✅

Step 4. Infra Workload 생성 · 운영

(1) Infra 생성 — Express 모드

1. Operations › Manage › Workloads › Infra Workloads에서 Create Infra를 누른다.
2. Infra 이름과 설명을 입력한다.
3. Node Configuration에서 Provider/Region, Spec, Image, NodeGroup Size를 정하고 Done을 누른다. 콘솔이 조합 가능 여부를 사전 검토해 폼에 반영한다.
4. 필요한 만큼 NodeGroup을 추가한 뒤 Deploy를 누른다.
5. 목록에서 상태가 Creating → Running으로 바뀌고 node에 Public IP가 부여되는지 확인한다.

(2) Infra 생성 — Expert 모드 · 템플릿

1. Expert 모드에서는 Step 3에서 만든 VPC/Subnet, Security Group, SSH Key를 직접 선택한다.
2. 자주 쓰는 구성은 Save as Template로 저장해 두고 Deploy from Infra Template으로 다시 배포한다. JSON 파일로 가져오기(Import from JSON)도 지원한다.

(3) 운영

1. 목록에서 Infra를 선택하면 상세 패널에 NodeGroup과 node 목록이 표시된다.
2. Action 메뉴로 Infra 전체 또는 개별 node를 Suspend / Resume / Reboot 한다.
3. NodeGroup 크기를 늘리거나(Scale Out) NodeGroup을 추가한다.
4. 원격 명령(Command)과 파일 전송으로 전체·NodeGroup·단일 node에 작업을 실행한다.
5. 상세 탭에서 Label, Policy(autoscale), NLB 연결, 디스크 attach/detach를 관리한다.

검증 TC: TC-INFRA-WORKLOAD-CREATE-03 📝 · TC-INFRA-WORKLOAD-CREATE-01 📝 · TC-INFRA-CREATE-EXPERT-01 📝 · TC-INFRA-TEMPLATE-DEPLOY-01 📝 · TC-INFRA-LIFECYCLE-01 📝 · TC-INFRA-NODE-REBOOT-01 ⬜ · TC-INFRA-NODEGROUP-SCALEOUT-01 ⬜ · TC-INFRA-CMD-02 📝 · TC-INFRA-NLB-CREATE-01 ⬜

Step 5. K8s Workload 생성 · 운영

(1) 클러스터 생성

1. Operations › Manage › Workloads › K8s Workloads에서 Create Cluster를 누른다.
2. Cloud Connection을 선택하면 Provider/Region이 정해진다. Cluster Name과 Cluster Version을 입력한다.
3. NodeGroup Configuration에서 Spec, Image, Desired/Min/Max Node Size를 정한다. 추천 패널로 Spec·Image를 고를 수 있다.
4. 생성 후 상태가 Creating → Active가 되는지 확인한다.
5. VPC·Subnet·Security Group을 직접 지정하려면 **Create Cluster (Expert Mode)**를 사용한다.

(2) 운영

1. 클러스터를 선택해 NodeGroup·node 수와 kubeconfig를 확인한다.
2. NodeGroup을 추가·삭제하고, AutoScaling On/Off와 Autoscale Size(desired/min/max)를 변경한다.

(3) Workflow로 생성

1. Infra/K8s 생성 폼에서 정의 방식을 workflow로 고르면 Workflows에 등록된 파이프라인대로 자원을 구성한다.

검증 TC: TC-K8S-CREATE-DYN-01 📝 · TC-K8S-WORKLOAD-CREATE-01 ⬜ · TC-K8S-CREATE-EXPERT-01 📝 · TC-K8S-DETAIL-02 📝 · TC-K8S-NODEGROUP-ADD-03 📝 · TC-K8S-AUTOSCALESIZE-01 📝 · TC-INFRA-CREATE-WF-01 📝

Step 6. 자원 삭제

자원은 만든 순서의 역순으로 삭제한다. 다른 자원이 사용 중인 VPC·Security Group·SSH Key는 삭제되지 않는다.

1. K8s Workloads에서 클러스터를 선택해 삭제한다.
2. Infra Workloads에서 Infra를 선택해 삭제한다. 확인 모달에서 승인하면 목록에서 사라진다.
3. Cloud Resources의 Disk, SSH Key, Security Group, Network 순으로 행 체크 → Delete selected로 삭제한다.

검증 TC: TC-K8S-DELETE-01 📝 · TC-INFRA-DELETE-01 📝 · TC-INFRA-DISK-DELETE-01 ✅ · TC-INFRA-SG-DELETE-01 ✅ · TC-INFRA-VPC-DELETE-01 ✅

프레임워크 통합 화면

아래 메뉴는 각 프레임워크의 UI를 콘솔 안에 띄운다(iframe). 콘솔 로그인 정보와 선택한 Workspace/Project가 자동으로 전달된다.

메뉴	프레임워크	용도
Workflows / Event Listeners	mc-workflow-manager	프로비저닝 파이프라인 작성·실행
SW Catalogs / App Status / Repository	mc-application-manager	애플리케이션 카탈로그·배포
Data Migrations (Generate / Migration / Back Up / Restore / Log Management)	mc-data-manager	데이터 생성·이관·백업·복구
Cost Analysis (Dash Board / Billing Report / Cost Alarm / Budget)	mc-cost-optimizer	비용 분석·알림·예산
Monitorings (Monitoring / Logs / Config / Insight / Alert / Tracing)	mc-observability	모니터링·로그·트레이싱

각 화면의 목록은 MC-Web-Console Features, 설치 후 연동 검증 흐름은 Test Scenarios — 설치검증을 참조한다.