4.10. Pods (파드)

개요

Pods 페이지는 멀티클러스터 환경의 모든 파드를 통합적으로 조회하는 페이지입니다. 파드는 Kubernetes에서 가장 작은 배포 단위로, 하나 이상의 컨테이너를 포함하는 논리적 호스트입니다.

주요 목적:

• 멀티클러스터 파드 통합 조회
• 파드 상태 및 리소스 사용량 모니터링
• 컨테이너 로그 실시간 조회
• 파드 상태 조건(Conditions) 확인

파드 특징:

• Kubernetes의 가장 작은 배포 단위
• 하나 이상의 컨테이너 포함
• 공유 네트워크 및 스토리지
• 일시적(Ephemeral) 특성

화면 구성

Pods 페이지는 테이블 형태로 파드 목록을 표시합니다. 이 리소스는 Managed 타입으로, 멤버 클러스터에 존재하는 리소스를 조회합니다.

페이지 상단 요소

요소	설명
클러스터 필터	특정 클러스터의 파드만 표시
네임스페이스 필터	특정 네임스페이스의 파드만 표시
새로고침 버튼	파드 목록 갱신
검색창	파드 이름으로 검색

테이블 컬럼

컬럼	설명	정렬
이름	파드 이름	✅
네임스페이스	파드가 속한 네임스페이스	✅
클러스터	파드가 실행 중인 클러스터	✅
상태	파드 상태 (실행 중/대기 중/실패 등)	✅
준비됨	준비된 컨테이너 수 / 전체 컨테이너 수	✅
CPU	CPU 요청/제한 (예: 요청: 100m / 제한: 500m)	✅
메모리	메모리 요청/제한 (예: 요청: 128Mi / 제한: 256Mi)	✅
IP	파드 IP 주소	✅
노드	파드가 스케줄된 노드	✅
재시작 횟수	컨테이너 재시작 횟수	✅
경과시간	파드 생성 후 경과 시간	✅
작업	보기/삭제 버튼	-

상태 표시

상태 컬럼은 파드의 현재 상태를 표시합니다:

상태	설명	표시
실행 중 (Running)	파드가 정상 실행 중	녹색
대기 중 (Pending)	스케줄링 대기 또는 이미지 Pull 중	노란색
성공 (Succeeded)	모든 컨테이너가 성공적으로 종료	파란색
실패 (Failed)	하나 이상의 컨테이너가 실패	빨간색
알 수 없음 (Unknown)	파드 상태 확인 불가	회색

리소스 표시

CPU와 메모리 컬럼은 리소스 요청 및 제한을 표시합니다:

• 형식: 요청: [요청값] / 제한: [제한값]
• 예: 요청: 100m / 제한: 500m (CPU)
• 예: 요청: 128Mi / 제한: 256Mi (메모리)
• 리소스 설정이 없으면 - 표시

파드 상세 정보

파드 행을 클릭하면 상세 정보 패널이 열립니다.

상세 패널 헤더

요소	설명
파드 이름	선택한 파드 이름
Managed 배지	멤버 클러스터 리소스 표시
네임스페이스	파드가 속한 네임스페이스
클러스터	파드가 실행 중인 클러스터
상태	파드 상태 (실행 중/대기 중 등)

액션 버튼

버튼	기능
새로고침	파드 정보 갱신
보기	YAML 보기 모드
삭제	파드 삭제

탭 메뉴

개요 탭

파드의 기본 정보, 네트워크 정보, 스펙 정보, 컨테이너 정보를 표시합니다.

기본 정보:

항목	설명
이름	파드 이름
네임스페이스	파드가 속한 네임스페이스
클러스터	파드가 실행 중인 클러스터
상태	파드 상태
경과시간	생성 후 경과 시간
생성일	파드 생성 일시

네트워크 정보:

항목	설명
파드 IP	파드에 할당된 IP 주소
호스트 IP	파드가 실행 중인 노드의 IP
노드	파드가 스케줄된 노드 이름
QoS 클래스	Quality of Service 클래스 (Guaranteed/Burstable/BestEffort)

스펙 정보:

항목	설명
재시작 정책	컨테이너 재시작 정책 (Always/OnFailure/Never)
서비스 어카운트	파드가 사용하는 서비스 어카운트
재시작 횟수	전체 컨테이너 재시작 횟수

컨테이너:

파드에 포함된 컨테이너 목록을 표시합니다:

• 컨테이너 이름
• 상태 (준비됨/대기 중/실패)
• 재시작 횟수

컨테이너 이미지:

각 컨테이너의 이미지 정보를 표시합니다. 복사 버튼으로 이미지 URL을 클립보드에 복사할 수 있습니다.

레이블 탭

파드에 적용된 Kubernetes 레이블 목록을 표시합니다.

어노테이션 탭

파드에 적용된 어노테이션 목록을 표시합니다.

상태 탭

파드의 상태 조건(Conditions)을 표시합니다.

상태 조건:

조건	설명
Initialized	Init 컨테이너가 성공적으로 완료됨
PodScheduled	파드가 노드에 스케줄됨
ContainersReady	모든 컨테이너가 준비됨
Ready	파드가 요청을 처리할 준비됨
PodReadyToStartContainers	파드가 컨테이너 시작 준비 완료

각 조건은 다음 정보를 표시합니다:

• 조건 이름
• 상태 (True/False/Unknown)
• 마지막 전환 시간

정렬 옵션:

• 최신순: 마지막 전환 시간 기준 최신순
• 오래된순: 마지막 전환 시간 기준 오래된순
• 타입순: 조건 타입 알파벳순

로그 탭

컨테이너의 실시간 로그를 표시합니다.

주요 기능:

• 컨테이너 로그 실시간 조회
• 멀티 컨테이너 파드의 경우 컨테이너 선택 가능
• 로그 스크롤 및 검색

참고: 로그는 파드가 실행 중인 멤버 클러스터에서 직접 조회됩니다.

이벤트 탭

파드 관련 Kubernetes 이벤트를 표시합니다.

파드 작업

파드 YAML 보기

1. 파드 선택
2. 상세 패널에서 "보기" 버튼 클릭
3. YAML 뷰어에서 파드 정의 확인

파드 삭제

⚠️ 주의: 파드를 삭제하면 컨테이너가 즉시 종료됩니다. Deployment가 관리하는 파드는 자동으로 재생성됩니다.

1. 삭제할 파드 선택
2. 상세 패널에서 "삭제" 버튼 클릭
3. 확인 다이얼로그에서 파드 이름 입력
4. "삭제" 버튼 클릭

사용 예시

시나리오 1: 파드 상태 확인

1. Pods 페이지에서 확인할 파드 클릭
2. 개요 탭에서 기본 정보 확인:
   • 파드 상태 (실행 중/대기 중 등)
   • 컨테이너 준비 상태
3. 상태 탭에서 상세 조건 확인:
   • 각 조건의 True/False 상태
   • 마지막 전환 시간
4. 문제가 있으면 이벤트 탭에서 원인 파악

시나리오 2: 컨테이너 로그 확인

1. 로그를 확인할 파드 클릭
2. 로그 탭 선택
3. 컨테이너 로그 실시간 확인
4. 멀티 컨테이너 파드의 경우 컨테이너 선택
5. 필요시 로그 검색 및 스크롤

시나리오 3: 클러스터별 파드 조회

1. 클러스터 필터 드롭다운 클릭
2. 확인할 클러스터 선택
3. 해당 클러스터의 파드만 표시됨
4. 필요시 네임스페이스 필터 추가 적용

시나리오 4: 문제 파드 디버깅

1. 상태 컬럼에서 "대기 중" 또는 "실패" 파드 확인
2. 파드 클릭하여 상세 정보 확인
3. 상태 탭에서 어떤 조건이 False인지 확인
4. 이벤트 탭에서 오류 메시지 확인
5. 로그 탭에서 컨테이너 로그 확인
6. 문제 원인 파악 후 조치

시나리오 5: 리소스 사용량 확인

1. 파드 목록에서 CPU/메모리 컬럼 확인
2. 리소스 요청 및 제한 값 확인
3. 상세 패널에서 QoS 클래스 확인
4. 리소스 조정이 필요한 경우 Deployment 수정

관련 개념

파드 생명주기

파드는 다음 단계를 거칩니다:

1. Pending: 스케줄링 대기 또는 이미지 Pull 중
2. Running: 하나 이상의 컨테이너 실행 중
3. Succeeded: 모든 컨테이너가 성공적으로 종료
4. Failed: 하나 이상의 컨테이너가 실패로 종료
5. Unknown: 파드 상태 확인 불가

파드 상태 조건

조건	설명
PodScheduled	파드가 노드에 스케줄됨
Initialized	모든 Init 컨테이너가 완료됨
ContainersReady	모든 컨테이너가 준비됨
Ready	파드가 트래픽을 받을 준비됨

QoS (Quality of Service) 클래스

클래스	조건	우선순위
Guaranteed	모든 컨테이너에 동일한 요청/제한 설정	최고
Burstable	요청 또는 제한이 부분적으로 설정	중간
BestEffort	요청/제한 없음	최저

리소스 부족 시 BestEffort 파드가 먼저 축출됩니다.

재시작 정책

정책	설명	사용 사례
Always	항상 재시작 (기본값)	Deployment, StatefulSet
OnFailure	실패 시에만 재시작	Job
Never	재시작하지 않음	일회성 작업

컨테이너 상태

상태	설명
Waiting	컨테이너 시작 대기 중
Running	컨테이너 실행 중
Terminated	컨테이너 종료됨

Managed 리소스

파드는 Managed 리소스입니다:

• 멤버 클러스터에 직접 존재하는 리소스
• MCM 컨트롤 플레인에서 조회만 가능
• 클러스터 필터로 특정 클러스터 리소스 조회
• 로그 및 상태는 멤버 클러스터에서 직접 조회

문제 해결

파드가 Pending 상태인 경우:

• 리소스 부족: 노드에 충분한 CPU/메모리가 없음
• 이미지 Pull 실패: 이미지 이름 또는 레지스트리 인증 확인
• 노드 셀렉터: 조건에 맞는 노드가 없음
• PVC 바인딩 대기: PersistentVolume 확인

파드가 CrashLoopBackOff인 경우:

• 컨테이너가 반복적으로 실패
• 로그 탭에서 오류 메시지 확인
• 애플리케이션 설정 또는 종속성 문제

파드가 ImagePullBackOff인 경우:

• 이미지 이름 오류
• 레지스트리 접근 불가
• 이미지 Pull Secret 누락

---

다음 단계

• Services (서비스) - 멀티클러스터 서비스 관리
• Deployments (배포) - 파드를 관리하는 Deployment
• ReplicaSets (복제 세트) - ReplicaSet 관리

---