본문으로 건너뛰기
버전: 1.0.4

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% 로 바꾸고 그림 전체를 화면 가운데에 둡니다.

우클릭으로 자원 만들기​

토폴로지 화면에서 바로 워크로드를 만들 수 있습니다. 빈 곳이나 네임스페이스 상자를 마우스 오른쪽 버튼으로 누르면 네임스페이스에 추가 메뉴가 열립니다.

네임스페이스에 추가 메뉴
메뉴 항목만드는 자원
배포Deployment (3.2 장)
상태 저장 세트StatefulSet (3.2 장)
데몬 세트DaemonSet (3.2 장)
빌드 설정빌드 설정 (4.2 장). 빌드 기능이 설치된 클러스터에서만 나옵니다

항목을 누르면 목록 화면의 + 와 같은 생성 창이 열립니다. 저장하면 새 카드가 나타나고 강조 표시가 붙습니다. 화면 위치와 크기는 바뀌지 않습니다.

생성 창의 네임스페이스 칸은 우클릭한 곳에 따라 채워집니다.

우클릭한 곳네임스페이스 칸
네임스페이스 상자, 또는 그 안에서 펼친 묶음그 네임스페이스
빈 곳 (화면 위쪽에서 네임스페이스를 하나만 고른 경우)고른 네임스페이스
빈 곳 (그 밖의 경우)비어 있습니다. 생성 창에서 고릅니다
  • 펼친 묶음 안쪽의 빈 곳을 우클릭해도 이 메뉴가 열립니다. 카드 위에서 우클릭하면 이 메뉴 대신 카드 메뉴가 열립니다(다음 절).
  • 만들 권한이 없는 항목은 흐리게 보이고 누를 수 없습니다. 마우스를 올리면 이 네임스페이스에 만들 권한이 없습니다. 가 나옵니다.
  • 키보드로 열려면 네임스페이스 상자에 포커스를 두고 메뉴 키나 Shift+F10 을 누릅니다. 메뉴는 상자 왼쪽 위에 열립니다.
  • 표시할 자원이 없으면 화면 가운데에 빈 곳을 우클릭하면 워크로드를 추가할 수 있습니다. 가 나옵니다. 그룹화 가 네임스페이스 이면 이 문구 대신 빈 네임스페이스 상자가 보입니다. 그 상자를 우클릭하십시오.

카드 우클릭 메뉴​

맵에서 본 자원을 그 자리에서 바로 다룹니다. 상세 화면을 열지 않아도 카드를 우클릭해 Pod 수를 바꾸거나, 재시작하거나, 환경 변수를 고칠 수 있습니다.

  1. 카드를 마우스 오른쪽 버튼으로 누릅니다. 메뉴 맨 위에 그 자원 이름이 보입니다.
  2. 할 일을 고릅니다. 상세 화면에서 같은 버튼을 눌렀을 때와 같은 창이 열립니다.
카드 우클릭 메뉴
카드메뉴에서 할 수 있는 일
배포Pod 수 편집, 재시작, 롤아웃 일시 중지·롤아웃 재개, 상태 검사 편집, 리소스 제한 편집, 라벨·주석 편집, 환경 변수 편집, 편집, 빌드 설정 편집, 삭제
상태 저장 세트Pod 수 편집, 재시작, 상태 검사 편집, 리소스 제한 편집, 라벨·주석 편집, 환경 변수 편집, 편집, 삭제
데몬 세트재시작, 상태 검사 편집, 리소스 제한 편집, 라벨·주석 편집, 환경 변수 편집, 편집, 삭제
서비스·인그레스편집, 삭제
빌드 설정빌드 시작, 재빌드, 빌드 취소, 배포, 편집, 삭제
  • 권한이 있는 항목만 보입니다. 편집 은 YAML 편집기를 엽니다. 편집 창 사용법은 3.2 장을 참고하십시오.
  • HPA(수평 자동 확장)·CronHPA 가 Pod 수를 관리하는 워크로드는 Pod 수 편집 이 흐리게 보이고 누를 수 없습니다.
  • 위 표에 없는 카드(Pod 등)를 우클릭하면 브라우저 기본 메뉴가 열립니다.

묶음 펼치기·접기​

네임스페이스는 처음부터 펼쳐져 있어 그 안의 Deployment 같은 묶음 카드가 바로 보입니다. 카드는 종류별로 모여 있습니다 (Deployment, StatefulSet 등 워크로드 → 빌드 설정 → 파드 → Service 등 순서). 같은 종류 안에서는 이름순 이라, 롤아웃이나 Pod 수 변경으로 자원 수가 바뀌어도 카드 자리가 그대로입니다. Service 는 선택 조건이 파드 라벨과 맞는 워크로드(Deployment·StatefulSet·DaemonSet)에 이어지고, 그 묶음을 펼치면 ReplicaSet 옆 가지로 보입니다. 파드 수와 상관없이 같은 모양이며, Service 앞의 Ingress 와 Endpoints 는 Service 다음 열에 보입니다.

어느 워크로드와도 이어지지 않은 서비스·인그레스·PVC·빌드 설정은 그룹화 가 네임스페이스 일 때 맵에 그리지 않고 네임스페이스 상자의 목록에 모아 보여 줍니다(아래 "네임스페이스 상자의 자원 목록"). 노드·인스턴스 로 그룹화하면 점선 테두리 카드로 그립니다. 종류 이름 앞의 연결 끊김 아이콘에 마우스를 올리면 이유가 보입니다.

묶음 카드의 숫자 버튼을 누르면 그 카드가 제자리에서 펼쳐지고 딸린 자원이 나옵니다. 다른 카드와 네임스페이스는 화면에 그대로 남습니다. 화면은 펼친 묶음으로 이동하고, 화면 위쪽에 홈 / Namespace <이름> / <자원 이름> 경로가 표시됩니다. 카드 본체를 누르면 오른쪽에 상세가 열립니다.

펼친 묶음에서 맨 왼쪽 열에 있고 테두리가 굵은 카드가 그 묶음의 대표 자원입니다. 접힌 카드를 눌렀을 때 상세가 열리는 자원이 이 대표 자원입니다.

토폴로지 자원 상세

위 그림은 Deployment 하나를 펼친 것으로, 다음이 한 화면에 나옵니다.

  • 현재 ReplicaSet 과, 그 밑의 이전 ReplicaSet N개 버튼 (이전 ReplicaSet 은 배포할 때마다 하나씩 생깁니다. 3.2 장)
  • 현재 실행 중인 파드
  • 그 파드가 쓰는 PersistentVolumeClaim (6.1 장)
  • 파드 앞단의 Service 와 Endpoints, 그 앞의 Ingress (5.1 장)

파드가 많아도 맵이 길어지지 않습니다. 파드가 6개 이상인 카드는 이름순 앞 3개와 경고·오류 상태인 파드, 지금 상세를 연 파드만 보이고, 나머지는 Pod N개 더 카드 하나로 접힙니다. 문제가 있는 파드는 접히지 않으므로 바로 눈에 띕니다.

Pod N개 더 카드
  1. Pod N개 더 를 누릅니다. 숨겨 둔 파드가 모두 보입니다.
  2. 다시 접으려면 Pod 접기 를 누릅니다.

오른쪽 상세에서는 해당 자원의 메타데이터, 복제본 수와 실행 상태, 파드 목록, 조건(Condition)을 확인합니다. 목록 화면의 상세와 같은 내용이므로 여기서 바로 편집·재시작·삭제도 할 수 있습니다.

이전 ReplicaSet 이 남아 있는 것은 정상입니다. Deployment 는 새로 배포할 때마다 ReplicaSet 을 새로 만들고 이전 것을 파드 0개 상태로 남겨 둡니다. 되돌리기(롤백)에 쓰기 위해서입니다(3.2 장). 그림에는 현재 ReplicaSet 만 바로 보이고, 이전 것이 있으면 그 카드 밑에 이전 ReplicaSet N개 버튼이 붙습니다. 빌드도 같아서 빌드 설정마다 최근 빌드만 바로 보이고, 그 카드 밑에 이전 빌드 N개 버튼이 붙습니다. 버튼을 누르면 이전 항목이 각각 카드로 나타나고, 버튼이 이전 ReplicaSet 접기 / 이전 빌드 접기 로 바뀝니다. 이전 빌드가 실패했더라도 접혀 있는 동안에는 오류 표시가 없습니다.

펼친 묶음 오른쪽 위의 접기 를 누르면 그 묶음과 안쪽이 다시 접힙니다. 네임스페이스 안의 Deployment 까지 펼쳤다면 네임스페이스의 접기 한 번으로 둘 다 접히고 처음 그림으로 돌아갑니다.

네임스페이스 안의 묶음을 한 번에 펼치거나 접으려면 네임스페이스 상자 제목줄 오른쪽의 버튼을 누릅니다. 누른 뒤 화면은 그 네임스페이스 상자로 이동합니다.

버튼결과보이는 때
모두 확장그 네임스페이스 안의 접힌 카드를 모두 펼칩니다접힌 카드가 하나라도 있을 때
모두 접기그 네임스페이스 안에서 펼친 묶음을 모두 접습니다펼친 묶음이 하나라도 있을 때

두 버튼 모두 다른 네임스페이스의 펼침은 바꾸지 않습니다. 모두 확장 는 이전 ReplicaSet N개·이전 빌드 N개 버튼 뒤의 항목은 펼치지 않습니다.

  • 여러 묶음을 함께 펼쳐 둘 수 있습니다. 다른 묶음을 펼쳐도 앞에서 펼친 묶음은 그대로 있습니다.
  • 리스트 보기나 다른 메뉴를 다녀와도 같은 브라우저 탭에서는 펼쳐 둔 묶음이 그대로 있습니다. 새 탭에서 열면 처음 화면으로 시작합니다.
  • 묶음 위쪽의 이름을 누르면 상세만 열리고, 펼친 상태는 바뀌지 않습니다.
  • 한 네임스페이스만 크게 보려면 화면 위쪽 네임스페이스 선택에서 그 네임스페이스만 고르십시오.

빌드 작업은 빌드 설정 아래에 모이고, 빌드 설정은 배포 대상과 한 묶음이 됩니다. 빌드 메뉴로 빌드할 때마다 작업(Job)이 하나씩 생기지만, 그림에서는 그 빌드 설정 아래에 모입니다. 빌드 설정이 배포하는 Deployment 가 있으면 둘이 선으로 이어지고 Deployment 카드 하나로 묶입니다. 펼치면 빌드 설정 → 작업 → 파드와 빌드 설정 → Deployment 가 함께 보입니다. 배포 대상이 없는 빌드 설정은 네임스페이스 그룹화에서는 네임스페이스 상자의 빌드 설정 목록에서, 노드·인스턴스 그룹화에서는 점선 테두리 카드로 확인합니다.

카드의 빨간 표시는 빌드 설정마다 가장 최근 빌드의 결과만 반영합니다. 예전에 실패한 빌드가 이력에 남아 있어도 최근 빌드가 성공했으면 빨간 표시가 없습니다.

스케일링 자원은 대상 워크로드와 한 묶음이 됩니다. 스케일링 자원은 HPA(수평 자동 확장)·CronHPA(시간 예약 확장)· VPA(수직 자동 확장)·PDB(PodDisruptionBudget, 동시에 중단할 수 있는 파드 수 제한)입니다. HPA·CronHPA·VPA 는 설정에 적힌 대상 워크로드 카드 안에 들어갑니다. PDB 는 선택 조건에 맞는 워크로드가 하나뿐일 때만 그 카드 안에 들어갑니다. 묶음을 펼치면 Service·Ingress 다음, PersistentVolumeClaim·ConfigMap·Secret 앞에 보입니다.

경우그림
HPA·CronHPA·VPA 의 대상 워크로드가 없음따로 카드로 나옵니다. 맵에서 빠지지 않고, 점선 테두리도 붙지 않습니다
PDB 조건에 맞는 워크로드가 둘 이상이거나 조건이 비어 있음따로 카드로 나옵니다. 대상은 PDB 상세에서 확인합니다
클러스터에 VPA·CronHPA 가 설치되지 않음해당 카드가 나오지 않습니다. 오류는 표시하지 않습니다

여러 워크로드가 함께 쓰는 PVC 는 묶음마다 따로 보입니다. 서로 다른 묶음의 워크로드가 PVC 하나를 함께 쓰면 묶음마다 그 PVC 카드를 하나씩 그립니다. 워크로드 묶음은 PVC 때문에 하나로 합쳐지지 않습니다. 이 PVC 카드에는 종류 이름 옆에 워크로드 N개가 사용 이 붙습니다.

경우그림
PVC 를 쓰는 워크로드가 하나뿐이거나, 쓰는 워크로드들이 이미 한 묶음임(예: CronJob 과 그 Job)PVC 카드는 하나입니다. 사용 수는 붙지 않습니다
PVC 를 쓰는 워크로드가 없음네임스페이스 그룹화에서는 네임스페이스 상자의 PVC 목록에 나옵니다. 노드·인스턴스 그룹화에서는 점선 테두리 카드로 따로 나옵니다
  • N 은 그 PVC 를 쓰는 묶음 수입니다. 한 묶음 안에서 워크로드 여러 개가 써도 하나로 셉니다.
  • 어느 PVC 카드를 눌러도 같은 PVC 의 상세가 열립니다. 마지막으로 상세를 연 강조 표시는 그 PVC 카드 모두에 나타납니다.
  • 이름으로 찾기 에 그 PVC 이름을 넣으면 그 PVC 를 가진 묶음이 모두 일치합니다.

네임스페이스 상자의 자원 목록​

맵을 복잡하게 만들지 않고 서비스·구성 맵·시크릿 같은 자원을 바로 찾습니다. 네임스페이스 상자 제목 줄에는 자원 종류별 버튼이 있고, 버튼마다 그 네임스페이스의 자원 수가 보입니다(예: S 3). 어느 워크로드와도 이어지지 않아 맵에 그리지 않은 자원도 여기서 확인합니다.

버튼여는 목록
S서비스
I인그레스
PVCPVC
CM구성 맵
SEC시크릿
BC빌드 설정
  1. 네임스페이스 상자 제목 줄에서 버튼을 누릅니다. 버튼 아래에 이름순 목록이 열립니다.
  2. 항목이 많으면 목록 위의 이름으로 찾기 에 이름 일부를 넣습니다.
  3. 이름을 누르면 상세가 열리고, 편집 아이콘을 누르면 YAML 편집기가 열립니다.
  4. 같은 버튼을 다시 누르면 목록이 닫힙니다.

이어진 워크로드가 없는 자원은 주황색으로 알려 줍니다. 서비스·인그레스·PVC·빌드 설정 버튼 오른쪽 위의 주황 숫자는 이어진 대상이 없는 항목 수입니다. 목록에서는 그 항목 이름 앞에 주황색 연결 끊김 아이콘이 붙습니다. 아이콘에 마우스를 올리면 연결된 워크로드 없음 같은 이유가 보입니다. 정리할 자원을 찾거나 설정이 빠진 곳을 확인할 때 씁니다.

네임스페이스 상자의 서비스 목록

펼친 워크로드 상자에서는 그 워크로드가 쓰는 구성 맵·시크릿만 봅니다. 배포·상태 저장 세트·데몬 세트 묶음을 펼치면 상자 제목 줄의 접기 뒤에 CM·SEC 버튼이 보입니다. 누르면 그 워크로드가 쓰는 것만 걸러 목록이 열리고, 목록 제목 아래에 <워크로드 이름> 에서 사용 이 보입니다. 어느 설정값이 어느 애플리케이션에 들어가는지 확인할 때 편리합니다.

펼친 워크로드 상자의 시크릿 목록
  • 버튼은 그룹화 가 네임스페이스 일 때만 보입니다.
  • 목록을 볼 권한이 없는 종류는 버튼이 보이지 않습니다. 빌드 기능이 설치되지 않은 클러스터에는 BC 버튼이 없습니다.
  • 구성 맵·시크릿 버튼에는 주황 숫자가 붙지 않습니다. 목록의 아이콘으로 확인하십시오.

보기 범위 좁히기​

자원이 많으면 그림이 복잡해집니다. 화면 위쪽에서 범위를 좁힙니다.

조절 항목설명
네임스페이스특정 네임스페이스만 표시
자원 종류파드만, 또는 Service 까지 등 표시할 종류 선택. 스케일링 그룹(HPA·CronHPA·VPA·PDB)은 워크로드 바로 아래에 있고 처음부터 켜져 있습니다
그룹화자원을 네임스페이스·인스턴스·노드 중 무엇으로 묶어 상자로 그릴지 선택. 처음에는 네임스페이스 입니다
이름으로 찾기이름이 맞는 카드를 강조하고 나머지 카드를 흐리게 표시

네임스페이스는 필요한 것만 고르십시오. 여러 네임스페이스를 한 번에 고르면 카드가 수백 개가 되어 연결 관계를 읽을 수 없습니다.

이름으로 찾기 에 입력하면 바로 결과가 보입니다. 이름이 맞는 카드는 굵은 주황 테두리로 표시되고, 나머지 카드는 흐려집니다. 흐린 카드도 누를 수 있습니다. 입력 옆에는 일치 개수(예: 3개 일치)가 보입니다.

  • 대소문자는 구분하지 않습니다. 이름에 검색어가 그대로 들어 있으면 일치합니다. 예: sp1 은 test-sp1-api 와 일치하고 spring1 과는 일치하지 않습니다. 로그에서 복사한 파드 이름으로도 찾을 수 있습니다.
  • 묶음 카드는 안쪽 자원 중 하나라도 이름이 맞으면 일치합니다. 묶음을 펼치면 안쪽 카드를 하나씩 비교합니다.
  • Pod N개 더 로 접어 둔 파드도 찾습니다. 접힌 파드가 맞으면 Pod N개 더 카드가 일치로 표시됩니다.
  • 네임스페이스 상자의 목록에 이름이 맞는 자원이 있으면 그 버튼에 주황 테두리가 붙습니다. 버튼을 누르면 맞는 줄이 같은 테두리로 표시됩니다.
  • 찾아도 화면 위치와 크기는 바뀌지 않습니다.
  • 입력 오른쪽의 ✕ 나 Esc 키로 검색어를 지웁니다. 네임스페이스를 바꾸거나 묶음을 펼쳐도 검색어는 남고, 토폴로지 화면을 벗어나면 지워집니다.

리스트 보기​

같은 내용을 표로도 볼 수 있습니다. 화면 위쪽의 리스트 보기 로 전환합니다.

그림에서는 연결이 잘 보이고, 목록에서는 개수와 상태를 세기 쉽습니다. 장애 자원을 세어야 할 때는 목록이 편합니다.

작업 표 위에는 작업 목록과 같은 빌드 작업 버튼(숨김·빌드만·전체)이 있습니다. 빌드 작업은 기본으로 숨겨지며, 고른 값은 작업 목록과 함께 씁니다(3.3 장).

연결이 안 보일 때​

Service 에서 파드로 이어지는 선이 없으면 선택 조건(selector)이 파드 라벨과 맞지 않는 것입니다. Service 상세에서 선택 조건을, 파드 상세에서 라벨을 각각 확인해 비교하십시오 (5.1 장, 3.1 장).

Ingress 에서 Service 로 선이 없으면 Ingress 규칙에 적힌 Service 이름이 실제와 다르거나 그 Service 가 다른 네임스페이스에 있는 것입니다.

그룹화 가 네임스페이스 이면 어느 워크로드와도 이어지지 않은 Service·Ingress 는 맵에 나오지 않습니다. 네임스페이스 상자의 S·I 버튼을 눌러 목록에서 연결 끊김 아이콘이 붙은 항목을 찾으십시오.