ZCP Console 에서는 Kubernetes 리소스를 유형별로 분류하여 조회/수정 할 수 있는 기능을 제공합니다.

리소스 개요

리소스 는 Kubernetes 에서 정의한 인프라/기능 명세(Spec)으로, 사용자가 등록한 리소스 조건를 만족하도록 Kubernetes 가 인프라를 관리하게 됩니다.

리소스 는 그 유형에 따라 Workloads, Network, Storage/Config 등으로 그룹화 되며 각 리소스에 대한 자세한 내용은 공식문서 를 참고하시기 바랍니다.

아래는 ZCP Console 에서 확인 가능한 리소스의 목록입니다.

리소스 조회

선택된 네임스페이스에 존재하는 리소스 목록을 조회 할 수 있습니다.

각 리소스 그룹 메뉴에서는 동일한 그룹의 리소스 유형만 조회가 가능합니다.

리소스 유형에 상관없이 조회하는 방법은 동일합니다.

리소스 유형 선택

리소스의 유형을 선택하는 방법은 아래와 같습니다.

1. 메뉴에서
   1. 조회하고자 하는 리소스 그룹을 선택합니다. (App, Network, Resource, Storage)
   2. 하위에 표시된 리소스 유형을 선택합니다.
   3. 전환된 화면에 리소스 목록이 표시됩니다.
      
2. 목록에서
   1. 좌측 상단의 Kind 를 클릭하면 변경 가능한 리소스 유형이 표시됩니다. (같은 그룹 내)
   2. 리소스 유형을 선택하면 화면이 새로고침 됩니다.
      

리소스 검색 및 새로고침

리소스 목록은 Search 필드를 통해 검색이 가능합니다. 목록에 표시되는 모든 필드가 검색 대상이 됩니다.

Kind 필드 우측의  (새로고침) 버튼을 클릭하면 현재의 검색조건을 기준으로 목록이 새로고침 됩니다.

리소스 액션

리소스 목록의 마지막 컬럼에는 해당 리소스에서 수행할 수 있는 액션 버튼이 표시됩니다.

Kubernetes 권한과의 관계

Kubernetes 에는 리소스의 생성/조회/수정/삭제 에 대한 권한설정 기능이 존재하며, 이 권한에 따라 리소스 접근, kubectl 사용에 제약이 있을 수 있습니다.
ZCP 에서는 Console 의 사용자/네임스페이스 관리 기능을 통해  Kubernetes 권한을 부여/해제 할 수 있으며,
관련 기능 사용중에 권한 오류가 발생할 수 있습니다.

권한 문제가 발생할 경우 사용자/네임스페이스 의 권한 설정을 확인하거나 Cluster Admin 에게 문의하시기 바랍니다.

YAML 편집

액션 컬럼에서  (편집) 버튼을 클릭하면 리소스의 YAML 을 편집 가능한 팝업이 표시됩니다.

우측 상단의 버튼을 클릭하면 팝업을 전체화면으로 표시할 수 있습니다.

팝업을 닫을 때는 하단의 CLOSE 버튼을 클릭하거나, 변경사항이 있는 경우 SAVE 버튼을 클릭합니다.

YAML 문법/Kubernetes Validation 오류가 발생한 경우에는 편집창 상단에 오류 메시지가 표시됩니다.

이 기능은 kubectl edit <kind> <resource-name> 명령어와 동일하며, 아래와 같은 제약사항이 있을 수 있습니다.

• 대상 리소스 변경에 필요한 권한이 충분하지 않은 경우, 수정할 수 없습니다.

SSH 접속 (only Pod)

Pod 리소스에 한하여, Pod 내부의 컨테이너에 SSH 접속이 가능합니다.

연결을 생성하려면:

1. 액션 컬럼에서  (SSH) 버튼을 클릭합니다.
2. 표시된 팝업에서 Container 를 선택합니다.
3. Shell 유형을 선택하고, Connect 버튼을 클릭합니다.
4. 연결이 완료되면 아래의 메시지와 함께 프롬프트가 표시됩니다.

우측 상단의 버튼을 클릭하면 팝업을 전체화면으로 표시할 수 있습니다.

사용이 끝나면 CLOSE 버튼을 클릭하여 연결을 종료합니다.

이 기능은 kubectl exec <pod-name> -it – sh 명령어와 동일하며, 아래와 같은 제약사항이 있을 수 있습니다.

• 컨테이너에 SSH 연결을 위한 커맨드(sh/bash 등)가 존재하지 않는 경우, 접속할 수 없습니다.
• 대상 Pod 에 접속에 필요한 권한이 충분하지 않은 경우, 접속할 수 없습니다.

실시간 로그 조회 (only Pod)

Pod 리소스에 한하여, Pod 내부의 컨테이너에서 발생되는 로그 조회가 가능합니다.

로그를 조회하려면:

1. 액션 컬럼에서  (Log) 버튼을 클릭합니다.
2. 표시된 팝업에서 Container 를 선택합니다.
3. 표시할 로그의 라인 수를 입력하고, (Show 이미지) 버튼을 클릭합니다.
4. 연결이 완료되면 아래의 메시지와 함께 로그가 표시됩니다.

Follow 옵션을 체크하면 입력된 라인수 만큼 로그가 표시되고, 이후 컨테이너에서 발생되는 로그를 지속적으로 표시합니다.

우측 상단의 버튼을 클릭하면 팝업을 전체화면으로 표시할 수 있습니다.

사용이 끝나면 CLOSE 버튼을 클릭하여 연결을 종료합니다.

이 기능은 kubectl logs <pod-name> 명령어와 동일하며, 아래와 같은 제약사항이 있을 수 있습니다.

• 컨테이너 상태가 비정상 적인 경우, 로그가 표시되지 않습니다.
• 대상 Pod 에 접속에 필요한 권한이 충분하지 않은 경우, 로그가 표시되지 않습니다.

리소스 상세

조회된 목록에서 리소스의 상세정보를 확인 할 수 있습니다. 리소스 유형에 상관없이 조회하는 방법은 동일합니다.

상세화면 이동

리소스 목록의 Name 컬럼은 상세화면 이동을 위한 링크가 연결되어 있습니다. 대상 링크를 클릭하면 상세정보 화면으로 이동합니다.

상세정보 조회

이동된 화면에는 리소스의 YAML 구조에 따라 상세정보가 표시됩니다.

표시방식

YAML 은 들여쓰기를 기준으로 데이터를 Tree 형태로 표시할 수 있습니다. 상세화면은 YAML 을 JSON으로 변환하고, 깊이(Depth)에 따라 아래와 같이 내용을 표시합니다.

고유의 형태로 표시되지 않는 String 의 경우, 축약되어 표시됩니다.

Show all.. (-- lines) 버튼을 클릭해 전체 내용을 확인하거나, Hide... 버튼을 클릭해 내용을 다시 축약 할 수 있습니다.

네비게이션

우측 상단의  (목록으로 돌아가기) 버튼을 클릭하거나  (뒤로가기) 버튼을 클릭해 목록으로 돌아갈 수 있습니다.

 (새로고침) 버튼을 클릭하면 변경된 최신 리소스로 페이지를 새로고침 할 수 있습니다.