이 섹션에서는 Kubernetes 운영 중 마주치는 특정 문제를 해결하기 위한 단계별 가이드를 제공합니다. 각 가이드는 명확한 목표와 함께 구체적인 해결 방법을 제시합니다.
문제 상황별 가이드 선택#
어떤 가이드를 봐야 할지 모르겠다면, 아래 플로차트를 따라가세요.
flowchart TD
START[문제 발생] --> Q1{Pod 상태가<br>정상인가?}
Q1 -->|Pending/Error/CrashLoop| A[Pod 트러블슈팅]
Q1 -->|Running| Q2{어떤 문제인가?}
Q2 -->|성능 문제| B[리소스 최적화]
Q2 -->|연결 실패| C[네트워크 트러블슈팅]
Q2 -->|로그 확인 필요| D[로그 수집 및 분석]
A --> A1["상태별 원인 파악<br>이벤트/로그 분석"]
B --> B1["사용량 측정<br>requests/limits 조정"]
C --> C1["연결 흐름 진단<br>Service/DNS/Ingress"]
D --> D1["kubectl logs 활용<br>패턴 분석"]| 증상 | 추천 가이드 |
|---|---|
| Pod가 시작 안 됨, CrashLoopBackOff | Pod 트러블슈팅 |
| 느린 응답, OOMKilled, CPU 스로틀링 | 리소스 최적화 |
| Service/Ingress 연결 실패, DNS 오류 | 네트워크 트러블슈팅 |
| 오류 원인 파악, 로그 분석 | 로그 수집 및 분석 |
가이드 목록#
| 가이드 | 상황 | 예상 시간 |
|---|---|---|
| Pod 트러블슈팅 | Pod가 시작되지 않거나 비정상 종료될 때 | 30분 |
| 리소스 최적화 | 적절한 CPU/메모리 설정을 찾고 싶을 때 | 45분 |
| 네트워크 트러블슈팅 | Service나 Ingress가 연결되지 않을 때 | 30분 |
| 로그 수집 및 분석 | 효과적으로 로그를 수집하고 분석할 때 | 25분 |
How-To Guide 사용법#
- 현재 겪고 있는 문제와 일치하는 가이드를 선택하세요
- 시작하기 전에 섹션에서 전제 조건을 확인하세요
- 단계별 지침을 순서대로 따라가세요
- 각 단계의 성공 확인 항목으로 진행 상황을 확인하세요
- 문제가 해결되지 않으면 자주 발생하는 오류 섹션을 참조하세요