2.2. 토폴로지
어떨 때 보는가
- 배포한 애플리케이션이 어떤 자원으로 이루어졌는지 한눈에 볼 때
- Service 가 파드에 제대로 연결되었는지 확인할 때
- 자원 하나를 지우면 무엇이 영향을 받는지 볼 때
- 어느 워크로드와도 이어지지 않은 서비스·PVC·구성 맵·시크릿을 찾을 때
목록 화면은 자원 종류별로 나뉘어 있어 연결 관계를 보기 어렵습니다. 이 화면은 그 관계를 그림으로 보여 줍니다.
토폴로지 화면
왼쪽 메뉴에서 토폴로지 를 누릅니다.

각 카드가 자원 하나 또는 같은 종류 자원의 묶음입니다. 카드 사이의 선이 연결 관계입니다.
네임스페이스를 골라야 그림이 보입니다. 고른 네임스페이스가 없으면 그림 자리에
토폴로지를 보려면 네임스페이스를 선택하세요 가 나오고 자원을 불러오지 않습니다. 화면 오른쪽 위
네임스페이스 에서 하나 이상 고르십시오. 선택을 모두 지우면 그림이 사라지고 같은 안내가 나옵니다.
- 같은 브라우저 탭에서 마지막으로 고른 네임스페이스는 다시 들어올 때 그대로 선택됩니다.
- 접근할 수 있는 네임스페이스가 하나뿐인 사용자는 그 네임스페이스가 자동으로 선택됩니다.
- 안내가 보이는 동안에는 자원 종류·그룹화·상태 필터·이름으로 찾기를 누를 수 없습니다.
- 리스트 보기는 네임스페이스를 고르지 않아도 전체 목록을 보여 줍니다.
목록만 보면 알기 어려운 것을 그림에서 확인할 수 있습니다.
- 어떤 Service 가 어떤 파드로 트래픽을 보내는지
- 어떤 Deployment 가 몇 개의 파드를 띄우고 있는지
- 외부에서 들어오는 Ingress 가 어디까지 이어지는지
- 어떤 ConfigMap·Secret 을 어느 파드가 쓰는지
카드 읽는 법
| 표시 | 뜻 |
|---|---|
| 카드 제목 | 자원 이름. 길면 줄여 보입니다(아래 설명). 마우스를 올리면 전체 이름이 보입니다 |
| 왼쪽 아이콘 | 자원 종류. 파드 수를 0 으로 줄인 워크로드는 흐리게 보입니다 |
| 종류 옆 숫자 | 워크로드의 파드 수(준비된 수/원하는 수, 예: 1/1). 0 으로 줄였으면 회색 0 으로 보입니다 |
| 오른쪽 위 숫자 버튼 | 이 카드가 접고 있는 하위 자원 개수 |
| 오른쪽 위 원형 뱃지 | 오류·경고가 있는 자원 개수 |
| 테두리 색 | 상태. 초록=정상, 주황=경고, 빨강=오류 |
종류 옆 워크로드 N개가 사용 | 여러 묶음이 함께 쓰는 PersistentVolumeClaim(PVC). N 은 그 PVC 를 쓰는 묶음 수입니다 |
여러 자원이 하나로 묶여 있으면 카드 오른쪽 위에 개수가 표시됩니다. 파드가 10개면 카드 하나에
10 이 붙습니다.
긴 이름도 알아보기 쉽게 줄입니다. 이름이 카드에 다 들어가지 않으면 앞에 붙은 네임스페이스 이름부터 떼고,
그래도 길면 앞·가운데·끝을 남기고 사이를 … 로 줄입니다. 예를 들어 openmaru-observ 네임스페이스의
openmaru-observ-clickhouse-shard0-replica1-headless 는 clickhouse-shard0-replica1-headless 로, 더 좁으면
clickhou…ard0-rep…headless 로 보입니다. 맵의 카드는 모두 같은 폭이라 줄이 가지런합니다.
세 가지 조작
조작마다 결과가 다릅니다.
| 조작 | 결과 |
|---|---|
| 카드 본체 클릭 | 오른쪽에 상세 서랍이 열립니다 |
| 오른쪽 위 숫자 버튼 클릭 | 묶여 있던 하위 자원이 펼쳐집니다 |
| 빈 곳 클릭 | 선택을 해제합니다 |
묶음 카드의 본체를 누르면 그 묶음의 대표 자원 상세가 열립니다. 예를 들어 Deployment 카드를 누르면 Deployment 상세가 열리고, 그 안의 파드를 보려면 숫자 버튼으로 펼친 뒤 개별 파드 카드를 눌러야 합니다.
마지막으로 상세를 연 카드는 강조 표시가 남습니다. 여러 자원을 오가며 확인할 때 어디까지 봤는지 알 수 있습니다. 다른 카드에 마우스를 올리거나 빈 곳을 누르면 강조가 사라집니다.
그림 위에서 마우스 휠로 확대·축소하고, 빈 곳을 끌어 이동합니다.
빈 곳이나 네임스페이스 상자를 더블 클릭하면 100% 크기로 돌아갑니다. 더블 클릭한 지점은 화면에서 제자리에 남습니다. 카드를 더블 클릭하면 크기는 그대로이고 상세만 열립니다. 100% 버튼은 크기를 100% 로 바꾸고 그림 전체를 화면 가운데에 둡니다.