1.2. 공통 화면 사용법
어떨 때 읽는 장인가
Console 의 모든 자원 화면은 같은 구조를 씁니다. 파드든 Service 든 인증서든 목록 → 상세 → 편집 흐름이 동일합니다. 이 장을 먼저 읽으면 나머지 장에서는 그 자원에만 해당하는 내용만 보면 됩니다.
화면 맨 위 공지 띠
콘솔 맨 위에 색이 들어간 띠가 나타나는 경우가 있습니다.
이 띠는 운영 담당자가 등록한 공지입니다. 모든 화면 위에 걸리므로 어느 메뉴로 이동해도 계속 보입니다.
어떨 때 쓰는가
같은 화면의 여러 콘솔을 구분하는 것이 가장 흔한 쓰임입니다. 개발·검증·운영 클러스터의
콘솔은 화면이 똑같아 주소만으로는 구분하기 어렵습니다. 운영 콘솔에 붉은 띠를 걸어 두면 지금
어느 환경을 보고 있는지 한눈에 알 수 있고, 개발용이라고 착각해 운영 자원을 지우는 사고를
막습니다. 위 그림이 그 예로, 운영 콘솔에 [주의] 업무 운영서버 환경 을 붉은 띠로 걸었습니다.
그 밖에 다음과 같이 씁니다.
| 상황 | 예 |
|---|---|
| 환경 구분 | [운영환경] 주의하여 작업하세요 — 개발은 초록, 검증은 주황, 운영은 빨강 |
| 점검 예고 | 서버 점검: 3월 15일 02:00~04:00 — 점검 며칠 전부터 걸어 둡니다 |
| 새 버전 안내 | COP 1.0.4 가 배포되었습니다 — 릴리즈 노트 링크를 함께 넣습니다 |
| 정책 안내 | 4월부터 이미지 태그에 latest 를 쓸 수 없습니다 |
띠 읽는 법
| 요소 | 뜻 |
|---|---|
| 색 | 공지의 성격. 대개 파랑=안내, 주황=주의, 빨강=긴급·운 영 환경 |
| 글 | 공지 내용 |
| 링크 | 있으면 자세한 문서로 이동합니다. 새 창으로 열립니다 |
| 오른쪽 × | 있으면 눌러서 닫을 수 있습니다 |
× 가 없는 공지는 닫을 수 없습니다. 운영 환경 표시처럼 항상 보여야 하는 공지는 운영 담당자가 닫기를 막아 둡니다.
한 번 닫은 공지는 다시 나오지 않습니다. 닫았다는 기록이 사용하는 브라우저에 남기 때문에 다른 브라우저나 다른 PC 에서는 다시 보입니다. 반대로 운영 담당자가 내용을 바꾸면서 공지 번호도 함께 바꾸면 이전에 닫았더라도 새 공지로 다시 나타납니다.
공지가 보이지 않을 때
공지는 openmaru-cop-announcement 라는 구성 맵(ConfigMap)에 등록합니다(3.4 장).
등록·수정은 클러스터 운영 담당자가 하며, 일반 사용자가 콘솔 화면에서 바꿀 수 있는 항목이
아닙니다. 공지를 걸어야 하거나 잘못된 공지가 보이면 운영 담당자에게 요청하십시오.
운영 담당자가 공지를 등록했는데 화면에 나오지 않으면 다음을 확인하도록 알려 주십시오.
| 확인할 것 | 설명 |
|---|---|
| 표시 여부 설정 | enabled 가 꺼져 있으면 등록해도 나오지 않습니다 |
| 내용 형식 | 등록한 내용이 JSON 형식에 맞지 않으면 띠 전체가 나오지 않습니다. 아무 오류도 표시되지 않으므로 형식을 먼저 확인합니다 |
| 콘솔 재시작 | 구성 맵을 바꾼 뒤 콘솔을 다시 시작해야 반영됩니다 |
| 이미 닫음 | 닫을 수 있는 공지를 이전에 닫았을 수 있습니다. 다른 브라우저에서 확인합니다 |
목록 화면
왼쪽 메뉴에서 자원을 고르면 목록이 표로 나타납니다.
화면은 위에서 아래로 이렇게 구성됩니다.
| 위치 | 요소 | 하는 일 |
|---|---|---|
| 맨 위 | 자원 이름과 개수 | 지금 보고 있는 자원과 전체 개수 |
| 그 아래 | 상태 요약 칩 | 상태별 개수. 누르면 그 상태만 걸러 봅니다 |
| 오른쪽 위 | 검색·필터 도구 | 아래 "검색과 필터" 참고 |
| 가운데 | 표 | 자원 목록 |
상태 요약 칩 은 장애를 찾을 때 가장 빠른 길입니다. 예를 들어 파드 화면에서 Warnings 칩을
누르면 문제가 있는 파드만 남으므로, 수백 개 목록을 일일이 확인하지 않아도 됩니다.
표의 열 제목을 누르면 그 열 기준으로 정렬합니다. 한 번 더 누르면 반대 순서가 됩니다. "경과 시간" 으로 정렬하면 방금 만들어진 자원을 맨 위로 올릴 수 있습니다.
검색과 필터
표 오른쪽 위에 검색 상자와 아이콘이 있습니다.
| 요소 | 하는 일 | 쓰는 상황 |
|---|---|---|
| 검색 상자 | 입력한 글자가 들어간 항목만 표시 | 이름 일부만 아는 자원을 찾을 때 |
| 돋보기 아이콘 | 검색 조건을 자세히 지정 | 레이블이나 특정 열로 찾을 때 |
| 깔때기 아이콘 | 상태·유형 조건으로 거르기 | 실패한 것만 보고 싶을 때 |
| 기둥 세 개 아이콘 | 표시할 열 고르기 | 화면이 좁아 열이 잘릴 때 |
| 화살표 아이콘 | 목록 다시 불러오기 | 방금 배포한 것이 안 보일 때 |
네임스페이스 선택 상자 로 볼 범위를 좁힙니다. 비워 두면 전체 네임스페이스를 봅니다. 자기 팀 네임스페이스만 지정해 두면 목록이 훨씬 짧아집니다.
네임스페이스 선택은 화면을 새로 고치면 처음 상태로 돌아갑니다. 브라우저에 저장되지 않습니다.
통합 검색 은 상단 바 가운데에 있습니다. 자원 종류를 가리지 않고 이름으로 찾으므로,
어느 메뉴에 있는지 모를 때 씁니다. Ctrl + /(macOS 는 ⌘ + /)로 바로 입력할 수 있습니다.
뱃지와 칩 읽는 법
목록 화면에는 알약 모양 표시가 여러 자리에 나옵니다. 자리마다 뜻이 다릅니다.
| 자리 | 이름 | 하는 일 |
|---|---|---|
| 표 위쪽 | 요약 칩 | 상태별 개수를 보여 주고, 누르면 걸러 냅니다 |
| 표 안 상태 열 | 상태 뱃지 | 그 자원 하나의 상태 |
| 표 안 그 밖의 열 | 분류 칩 | 노드 이름, 유형처럼 값을 묶어 보여 줍니다 |
색이 뜻하는 것
색은 상태에만 씁니다. 이 규칙이 화면 전체에 일관되게 적용됩니다.
| 색 | 뜻 |
|---|---|
| 초록 | 정상 |
| 주황 | 경고. 아직 장애는 아니지만 확인이 필요합니다 |
| 빨강 | 오류 |
| 회색 | 판단할 수 없거나 해당 없음 |
화면에 따뜻한 색(주황·빨강)이 보이면 문제가 있다는 뜻입니다. 분류 칩은 색으로 뜻을 나타내지 않으므로, 색이 있는 곳만 보면 문제를 빠르게 찾을 수 있습니다.
요약 칩
표 위쪽에 상태별 개수가 나옵니다. 파드 화면을 예로 들면 이렇습니다.
| 칩 | 세는 대상 |
|---|---|
| Pods | 전체 개수 |
| Pending | 배치를 기다리는 파드 |
| Failed | 실행에 실패한 파드 |
| Not Ready | 떠 있지만 준비되지 않은 파드 |
| Succeeded | 작업을 마치고 끝난 파드 |
| Unknown | 상태를 알 수 없는 파드 |
개수가 0 이면 그 칩은 나오지 않습니다. 정상인 화면에 빨간 칩이 보이지 않게 하려는 것입니다. 반대로 보이는 칩이 있으면 그만큼 확인할 대상이 있다는 뜻입니다.
칩을 누르면 그 상태의 자원만 남습니다. 여러 개를 함께 누를 수 있고, 이때는 "둘 중 하나라도 해당하는 것" 이 남습니다. 누른 칩은 채워진 모양으로 바뀝니다. 다시 누르면 해제됩니다.
수백 개 목록에서 문제를 찾을 때 가장 빠른 방법입니다. 목록을 일일이 확인하지 말고 칩부터 누르십시오.
상태 뱃지
표의 상태 열에 있는 뱃지입니다. 자원 하나의 상태를 나타냅니다.
자원 종류마다 표시되는 낱말이 다릅니다.
| 자원 | 뱃지 예 |
|---|---|
| 파드 | 실행 중, 대기 중, 실패, CrashLoopBackOff |
| 빌드 | Complete, Running, Failed, Pending |
| Helm 릴리즈 | deployed, failed, pending-install |
| 인증서 | 준비 완료, 준비 안 됨 |
| 노드 | Ready, NotReady |
뱃지에 마우스를 올리면 자세한 사유가 나옵니다. 파드가 실행 중 인데 주황색이면 준비
상태가 아니라는 뜻인데, 그 이유는 마우스를 올려야 보입니다.
진행 중인 상태에는 회전하는 표시 가 붙습니다. 빌드가 도는 중이면 초록 뱃지에 회전 표시가 함께 나옵니다.
분류 칩
노드 이름, 인증서 유형처럼 상태가 아닌 값 을 담은 칩입니다.
이 칩들은 차분한 색(회색·파랑·청록)만 씁니다. 상태색(초록·주황·빨강)을 쓰지 않는 이유가 있습니다.
- 같은 화면에서 초록이 "정상" 과 "특정 유형" 두 가지를 뜻하면 읽는 사람이 매번 어느 쪽인지 판단해야 합니다.
- 목록의 여러 행에 같은 값이 반복되면(같은 노드의 인증서 20개) 그 색이 화면에서 가장 먼저 읽히는 요소가 되어, 정작 봐야 할 상태가 묻힙니다.
분류 칩은 색이 아니라 아이콘 모양과 글자로 구분합니다. 색은 목록을 읽을 때 줄을 따라가기 쉽게 하는 역할만 합니다.
개수 칩
CIS 벤치마크처럼 개수를 세어 보여 주는 화면에서는 숫자 칩이 나옵니다.
- 값이 0 이면 색이 붙지 않습니다. "실패: 0" 이 빨간색이면 정상인 노드가 문제 있는 노드로 보이기 때문입니다.
- 칩 폭이 일정해 행끼리 세로로 견줄 수 있습니다. 노드별 실패 수를 비교할 때 씁니다.
CogentAI 연동
Console 은 CogentAI 와 연동되어 화면에서 보고 있는 것을 그대로 인공지능에 물어볼 수 있습니다. 화면을 옮기거나 내용을 옮겨 적을 필요가 없습니다.
연동은 두 가지 형태로 나타납니다.
| 형태 | 어디에 | 하는 일 |
|---|---|---|
| AI 인사이트 버튼 | 이벤트 옆, 자원 상세 위 | 그 대상 하나를 분석해 달라고 바로 요청합니다 |
| CogentAI 위젯 | 화면 오른쪽 아래 | 자유롭게 대화합니다 |
이 기능은 설치할 때 켜야 나타납니다. 화면에 버튼과 위젯이 보이지 않으면 운영 담당자에게 CogentAI 연동 설정을 확인하십시오.
왜 인공지능에 물어보는가
Kubernetes 장애 조사는 대개 이런 식으로 진행됩니다. 파드가 CrashLoopBackOff 라는 것을
보고, 이벤트를 열어 보고, 로그를 뒤지고, 설정을 확인하고, 검색해서 비슷한 사례를 찾습니다.
화면을 여러 개 오가며 조각을 맞추는 일 이고, 익숙하지 않으면 어디부터 볼지 정하는 데만
시간이 걸립니다.
연동은 이 과정을 줄여 줍니다.
| 손으로 할 때 | 연동을 쓸 때 |
|---|---|
| 자원 상태·설정·이벤트를 화면마다 찾아 읽습니다 | 버튼 한 번에 다 모아 보냅니다 |
| 오류 메시지를 검색해 비슷한 사례를 찾습니다 | 그 자원의 실제 값을 근거로 답이 옵니다 |
| 어느 항목이 문제인지 판단해야 합니다 | 자원 종류에 맞는 관점으로 짚어 줍니다 |
| 조치할 명령어를 따로 찾습니다 | 명령어까지 함께 제시합니다 |
이런 점이 실제로 도움이 됩니다.
옮겨 적을 필요가 없습니다. 버튼을 누르면 자원 종류·이름·네임스페이스·현재 상태·설정 전문·관련 이벤트가 함께 전달됩니다. 오류 메시지만 복사해 검색하면 그 메시지가 나오게 된 설정과 상태를 답하는 쪽이 알 수 없지만, 여기서는 그 맥락이 함께 갑니다.
흩어진 정보를 한 번에 봅니다. 파드가 안 뜨는 원인이 자원 요청량인지, 프로브 설정인지, 볼륨인지, 이미지인지 — 사람은 하나씩 확인하지만 이 정보들이 함께 전달되므로 관계를 한꺼번에 따져 답합니다.
자원 종류마다 보는 관점이 정해져 있습니다. 파드는 컨테이너 상태와 재시작 횟수를, Service 는 선택 조건과 대상 파드의 일치를 먼저 봅니다(아래 표). 무엇을 물어야 할지 몰라도 그 자원에서 흔히 문제가 되는 지점을 짚어 줍니다.
답이 이 환경에서 쓸 수 있는 범위로 제한됩니다. 답변은 Kubernetes 자체 기능과 kubectl
명령어 안에서만 나옵니다. 별도 모니터링 제품이나 외부 도구를 설치하라는 답이 오지 않으므로,
폐쇄망 환경에서 쓸 수 없는 조치를 안내받는 일이 없습니다.
즉시 조치할 것을 앞에 놓습니다. 경고 수준 이벤트처럼 바로 손봐야 하는 것을 먼저 알려 주고, 그 다음에 개선하면 좋을 것을 이야기합니다.
배우면서 씁니다. 왜 그런 설정이 문제인지 함께 설명하므로, 조치만 받고 끝나는 것이 아니라 다음에 같은 증상을 만났을 때 스스로 판단할 근거가 남습니다. Kubernetes 를 익히는 중이라면 이 점이 큽니다.
이런 것은 못 합니다
기대를 정확히 잡아 두는 편이 좋습니다.
| 못 하는 것 | 이유 |
|---|---|
| 자원을 직접 고치기 | 분석과 안내만 합니다. 실행은 사용자가 합니다 |
| 볼 수 없는 자원 분석 | 로그인한 계정의 권한 범위 안에서만 답합니다(7.1 장) |
| 지난 기록 분석 | 화면에 지금 보이는 것을 봅니다. 과거 추이는 모니터링 화면에서 봅니다(9.2 장) |
| 애플리케이션 내부 코드 문제 | 클러스터 자원 관점에서 답합니다 |
| 확실한 정답 보장 | 참고 의견입니다. 아래 "답변을 다루는 법" 참고 |
AI 인사이트 버튼
이벤트 메시지 옆과 자원 상세 화면에 붉 은 AI 표시가 붙습니다.
버튼이 나타나는 자리는 이렇습니다.
| 자리 | 분석 대상 |
|---|---|
| 클러스터 개요의 이벤트 목록 | 그 이벤트 메시지 |
| 자원 상세의 이벤트 목록 | 그 이벤트와 대상 자원 |
| 자원 상세 화면 위쪽 | 그 자원 전체 |
버튼을 누르면 화면에 보이는 정보가 함께 전달됩니다. 자원 종류, 이름, 네임스페이스, 현재 상태, 설정, 관련 이벤트를 모아 보내므로 질문을 따로 쓰지 않아도 됩니다.
자원 종류에 맞춘 분석
분석 기준은 자원 종류마다 다릅니다. 예를 들어 파드는 이런 관점으로 봅니다.
| 자원 | 보는 관점 |
|---|---|
| 파드 | 컨테이너 상태, 자원 요청·제한의 적절성, 재시작 횟수, 곁 컨테이너 구성 |
| Deployment | 복제본과 가용 복제본 비교, 배포 전략, maxSurge·maxUnavailable |
| StatefulSet | 파드 순서 보장, 저장 공간 템플릿, 갱신 전략 |
| Service | 선택 조건과 대상 파드의 일치, 포트 설정의 일관성 |
| PVC | 용량, 접근 모드, 스토리지 클래스 적절성 |
이 밖 에 DaemonSet·ReplicaSet·Ingress·ConfigMap·Secret·PV·네임스페이스·노드·Job·CronJob· 서비스 어카운트·롤·롤 바인딩·네트워크 정책·HPA 등 22종 에 각각의 기준이 있습니다.
답변은 Kubernetes 자체 기능과 kubectl 명령어 범위 에서만 제시됩니다. 별도 모니터링
제품이나 외부 도구를 권하지 않습니다.
CogentAI 위젯
화면 오른쪽 아래의 버튼을 누르면 대화 창이 열립니다.
| 요소 | 설명 |
|---|---|
| 입력창 | 질문을 자유롭게 씁니다 |
| 가이드 | 자주 쓰는 질문을 골라 만듭니다 |
| 창 조절 | 끌어서 옮기고, 크기를 바꾸고, 최대화할 수 있습니다 |
| 고정 | 화면을 옮겨도 창이 닫히지 않게 합니다 |
창을 띄워 둔 채 Console 을 계속 쓸 수 있습니다. 목록을 보며 질문하고, 답을 보며 다시 자원을 확인하는 식으로 오갈 수 있습니다.
로그인한 계정으로 인증되므로 볼 수 있는 자원 범위 안에서만 답합니다(7.1 장).
이럴 때 씁니다
| 상황 | 물어볼 것 |
|---|---|
| 이벤트 메시지의 뜻을 모르겠다 | 그 이벤트 옆 AI 버튼 |
| 파드가 왜 안 뜨는지 모르겠다 | 파드 상세의 AI 버튼 |
| 설정값이 적절한지 판단이 안 선다 | 자원 상세의 AI 버튼 |
| 어떤 명령어를 써야 할지 모르겠다 | 위젯에 직접 질문 |
답변을 다루는 법
그대로 실행하기 전에 확인하십시오. 인공지능의 답은 참고이지 검증된 절차가 아닙니다.
| 답변 유형 | 다루는 법 |
|---|---|
| 원인 설명 | 화면에서 실제 값을 다시 확인합니다 |
조회 명령(get·describe·logs) | 바로 실행해도 안전합니다 |
변경 명령(apply·patch·scale) | 영향 범위를 먼저 확인합니다. 운영 환경이면 더 그렇습니다 |
삭제 명령(delete) | 되돌릴 수 있는지 먼저 확인합니다. PVC·Secret 은 지우면 복구가 어렵습니다 |
판단이 서지 않으면 검증 환경에서 먼저 해 보십시오. 공지 띠로 환경을 구분해 두었다면 지금 어느 환경인지 화면 위에서 확인할 수 있습니다(위 "화면 맨 위 공지 띠").
표시할 열 고르기
표에 열이 많아 화면이 좁으면 필요한 열만 남깁니다.
- 표 오른쪽 위의 기둥 세 개 아이콘을 누릅니다.
- 목록에서 열 이름을 눌러 표시 여부를 바꿉니다.
- 바깥을 눌러 닫습니다.
상세 화면
목록에서 이름을 누르면 상세 화면으로 들어갑니다.
상세 화면은 접었다 펼 수 있는 구역으로 나뉩니다. 구역 제목 왼쪽의 화살표를 눌러 접습니다.
| 구역 | 담는 내용 | 언제 보는가 |
|---|---|---|
| 메타데이터 | 이름, 네임스페이스, 만든 시각, 레이블, 주석, 상태 | 언제나 |
| 레이블 | 이 자원에 붙은 이름표 | Service 가 왜 이 파드를 못 찾는지 볼 때 |
| 주석 | 도구가 남긴 부가 정보 | 배포 도구가 남긴 이력을 볼 때 |
| 제어자 | 이 자원을 만든 상위 자원 | 파드를 누가 만들었는지 거슬러 올라갈 때 |
| 관련 자원 | 연결된 다른 자원 | 영향 범위를 볼 때 |
| 이벤트 | 최근에 일어난 일 | 문제가 생겼을 때 가장 먼저 |
파란 글씨는 링크입니다. 네임스페이스, 노 드, 제어자, 서비스 계정을 눌러 그 자원의 상세로 바로 이동할 수 있습니다. 장애를 따라갈 때 목록으로 돌아가지 않아도 됩니다.
상세 화면의 동작 버튼
상세 화면 오른쪽 위에 버튼이 모여 있습니다. 자원 종류와 권한에 따라 표시되는 버튼이 다릅니다.
| 버튼 | 하는 일 |
|---|---|
| 로그 | 컨테이너 로그를 봅니다 (파드 계열) |
| 터미널 | 컨테이너 안에서 명령어를 실행합니다 (파드 계열) |
| 편집(연필) | YAML 편집기를 엽니다 |
| 삭제(휴지통) | 자원을 지웁니다 |
| 새로 고침 | 지금 상태를 다시 읽습니다 |
| 닫기 | 목록으로 돌아갑니다 |
YAML 편집기
편집 버튼을 누르면 YAML 편집기가 열립니다.
- 왼쪽에 줄 번호가 있고, 문법이 틀리면 그 줄에 표시가 나타납니다.
- 저장 을 누르면 클러스터에 바로 반영됩니다.
- 취소 를 누르면 아무것도 바뀌지 않습니다.
저장하면 되돌리기 기능이 없습니다. 운영 중인 자원을 고치기 전에 현재 내용을 복사해 따로 보관하십시오.
일부 항목은 만든 뒤에 바꿀 수 없습니다. 예를 들어 파드의 컨테이너 이미지는 바꿀 수 있지만 파드 이름은 바꿀 수 없습니다. 바꿀 수 없는 항목을 고치면 저장할 때 거부됩니다.
자원 만들기
왼쪽 메뉴 아래의 생성 버튼을 누르면 새 자원을 만드는 화면이 열립니다. YAML 을 직접 붙여 넣거나, 자원 종류에 따라 제공되는 입력 서식을 채웁니다.
이미 있는 자원을 본떠 만들려면 그 자원의 상세 화면에서 YAML 을 복사해 이름만 바꾸는 편이
빠릅니다. 이때 metadata.uid, metadata.resourceVersion, status 는 지우고 넣습니다 —
클러스터가 스스로 채우는 값입니다.