3.1. Topology (토폴로지 뷰)
개요
토폴로지 맵은 MCM 컨트롤 플레인과 멤버 클러스터, 그리고 배포된 리소스들 간의 관계를 그래프 형태로 시각화합니다. 복잡한 멀티클러스터 환경에서 리소스 배포 현황과 의존 관계를 한눈에 파악할 수 있습니다.
주요 목적:
- 멀티클러스터 리소스 관계 시각화
- 워크로드 배포 현황 파악
- 정책(Policy) 적용 범위 확인
- 리소스 간 의존성 분석
화면 구성
토폴로지 맵 페이지는 다음과 같이 구성됩니다.
1. 필터 영역
페이지 상단에 위치한 필터를 통해 표시할 리소스를 선택할 수 있습니다.
| 필터 | 설명 |
|---|---|
| 리소스 유형 | 표시할 리소스 종류 선택 (워크로드, 네트워킹, 설정, 스토리지) |
| 네임스페이스 | 특정 네임스페이스의 리소스만 표시 |
| 새로고침 | 토폴로지 데이터 갱신 |
리소스 유형 필터
| 카테고리 | 리소스 유형 |
|---|---|
| 워크로드 | 배포(Deployment), 상태저장 세트(StatefulSet), 데몬 세트(DaemonSet), 작업(Job), Cron 작업(CronJob), 오토스케일러(HPA) |
| 네트워킹 | 서비스(Service), 인그레스(Ingress) |
| 설정 | 구성 맵(ConfigMap), 시크릿(Secret) |
| 스토리지 | 영구 볼륨 클레임(PVC) |
2. 토폴로지 그래프
중앙 영역에 노드와 엣지로 구성된 그래프가 표시됩니다.
노드 유형
| 노드 | 약어 | 설명 | 아이콘 색상 |
|---|---|---|---|
| MCM 컨트롤 플레인 | M | 멀티클러스터 컨트롤 플레인 | 빨간색 |
| Cluster | CL | 멤버 클러스터 | 녹색 |
| Deployment | D | 배포 | 녹색 |
| StatefulSet | SS | 상태저장 세트 | 녹색 |
| DaemonSet | DS | 데몬 세트 | 녹색 |
| Job | J | 작업 | 녹색 |
| CronJob | CJ | Cron 작업 | 녹색 |
| Service | S | 서비스 | 보라색 |
| Ingress | I | 인그레스 | 보라색 |
| ConfigMap | CM | 구성 맵 | 파란색 |
| Secret | SEC | 시크릿 | 파란색 |
| PVC | PVC | 영구 볼륨 클레임 | 파란색 |
| HPA | HPA | 오토스케일러 | 노란색 |
| PropagationPolicy | PP | 전파 정책 | 빨간색 |
| ClusterPropagationPolicy | CPP | 클러스터 전파 정책 | 빨간색 |
| OverridePolicy | OP | 오버라이드 정책 | 빨간색 |
| ClusterOverridePolicy | COP | 클러스터 오버라이드 정책 | 빨간색 |
엣지 (연결선)
노드 간 연결선은 리소스 간의 관계를 나타냅니다:
- 컨트롤 플레인 → Cluster: 클러스터 등록 관계
- 컨트롤 플레인 → Policy: 정책 소유 관계
- Policy → Cluster: 정책 적용 대상 클러스터
- Cluster → Workload: 워크로드 배포 위치
- Workload → Service/ConfigMap/Secret/PVC: 리소스 참조 관계
- Ingress → Service: 인그레스 라우팅 대상
- HPA → Workload: 오토스케일링 대상
MCM 컨트롤 플레인 노드
중앙 상단의 MCM 컨트롤 플레인 노드는 전체 멀티클러스터 환경의 요약 정보를 표시합니다:
- Clusters: 등록된 클러스터 수
- Policies: 적용된 정책 수
- Workloads: 배포된 워크로드 수
- HPAs: 오토스케일러 수
- Ingresses: 인그레스 수
- Services: 서비스 수
- Configs: 설정 리소스 수 (ConfigMap + Secret)
- Storage: 스토리지 리소스 수
클러스터 노드
각 클러스터 노드는 다음 정보를 표시합니다:
- 클러스터 이름
- 노드 상태 (정상/전체)
- CPU 사용률
- 메모리 사용률
- 파드 사용률
3. 줌 컨트롤
화면 좌측 하단에 위치한 줌 컨트롤을 사용하여 그래프를 확대/축소할 수 있습니다.
| 버튼 | 기능 |
|---|---|
| + | 확대 |
| - | 축소 |
| 1:1 | 원본 크기로 복원 |
| 화면에 맞춤 | 전체 그래프가 화면에 맞도록 조정 |
상세 정보 패널
토폴로지 그래프에서 노드를 클릭하면 우측에 상세 정보 패널이 열립니다.
패널 구성
| 영역 | 설명 |
|---|---|
| 헤더 | 리소스 이름, 상태, 빠른 액션 버튼 |
| 탭 메뉴 | 개요, 레이블, 어노테이션, 상태, 이벤트 등 |
| 상세 정보 | 선택한 탭에 따른 상세 내용 |
클러스터 상세 정보
클러스터 노드 클릭 시 표시되는 정보:
| 탭 | 내용 |
|---|---|
| 개요 | 기본 정보, 노드 요약, 리소스 요약 |
| 레이블 | 클러스터에 적용된 레이블 |
| 어노테이션 | 클러스터 어노테이션 |
| 테인트 | 클러스터 테인트 설정 |
| 상태 | 클러스터 상태 조건 |
| 노드 | 클러스터 내 노드 목록 |
| 네임스페이스 | 클러스터 내 네임스페이스 목록 |
| 이벤트 | 관련 Kubernetes 이벤트 |
패널 액션 버튼
| 버튼 | 기능 |
|---|---|
| 새로고침 | 리소스 정보 갱신 |
| 편집 | YAML 편집 모드 |
| 클러스터 편집 | 클러스터 설정 편집 (클러스터만) |
| 삭제 | 리소스 삭제 |
| 클러스터 콘솔 | 해당 클러스터의 관리 콘솔 열기 (클러스터만) |
주요 기능
인터랙티브 탐색
- 드래그: 그래프 영역을 드래그하여 이동
- 스크롤: 마우스 휠로 확대/축소
- 클릭: 노드 클릭으로 상세 정보 확인
- 호버: 노드 위에 마우스를 올리면 하이라이트
리소스 관계 추적
토폴로지 맵을 통해 다음을 확인할 수 있습니다:
- 특정 워크로드가 어떤 클러스터에 배포되어 있는지
- 어떤 정책이 어떤 클러스터에 적용되는지
- 워크로드가 참조하는 ConfigMap, Secret, PVC
- 서비스와 인그레스의 라우팅 관계
필터를 통한 집중 분석
필터를 사용하여 특정 유형의 리소스만 표시하면 복잡한 환경에서도 원하는 정보에 집중할 수 있습니다.
사용 예시
시나리오 1: 워크로드 배포 위치 확인
- 토폴로지 맵에서 원하는 워크로드 노드 찾기
- 해당 노드에서 클러스터로 연결된 엣지 확인
- 연결된 클러스터들이 워크로드가 배포된 위치
시나리오 2: 정책 적용 범위 확인
- 정책 노드(PP, CPP, OP, COP) 찾기
- 정책에서 클러스터로 연결된 엣지 확인
- 연결된 클러스터들이 정책 적용 대상
시나리오 3: 서비스 의존성 분석
- 리소스 유형 필터에서 "서비스", "인그레스" 선택
- 서비스와 연결된 워크로드 확인
- 인그레스에서 서비스로의 라우팅 경로 확인
시나리오 4: 클러스터 상태 빠른 확인
- 클러스터 노드에서 CPU/메모리/파드 사용률 확인
- 비정상 노드가 있는 클러스터 식별 (노드 상태 표시)
- 클러스터 노드 클릭하여 상세 정보 확인
다음 단계
- Clusters (클러스터 관리) - 클러스터 상세 관 리
- Namespaces (네임스페이스) - 네임스페이스 관리