> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt > Use this file to discover all available pages before exploring further. # Kai > Kai와 함께 Kubernetes 클러스터를 관리하고, 컨테이너 워크로드를 최적화하며, EKS, GKE, AKS 문제를 해결하세요. Kai는 CloudThinker의 컨테이너 오케스트레이션 전문가로, EKS, GKE, AKS 및 자체 관리 클러스터 전반에 걸쳐 Kubernetes 클러스터 관리, 워크로드 최적화, 자동 스케일링, 그리고 운영 문제 해결을 전문으로 합니다. *** ## Kai가 해결하는 문제 Kubernetes는 강력하지만 매우 복잡합니다. 대부분의 팀은 리소스 요청과 제한을 한 번 설정하거나 템플릿에서 복사한 후 다시 검토하지 않습니다. 제한이 너무 낮아 파드가 OOMKilled되고, 요청이 너무 높아 노드가 활용도 미달로 방치됩니다. Cluster Autoscaler는 워크로드를 적절한 크기로 조정하는 대신 노드를 추가합니다. 서비스 어카운트에 권한이 누적되면서 RBAC 구성이 최소 권한 원칙에서 벗어납니다. Kubernetes를 잘 운영하려면 깊은 전문성을 가진 사람의 매일 같은 주의가 필요합니다: * 여러 네임스페이스에 걸쳐 수백 개의 파드 리소스 사용률 모니터링 * 로그, 이벤트, 리소스 제약을 읽어 크래시 루프 진단 * HPA 임계값, VPA 권장사항, Cluster Autoscaler 동작 튜닝 * 보안 취약점에 대한 RBAC 구성 및 네트워크 정책 감사 대부분의 팀에는 한두 명의 Kubernetes 엔지니어가 있는데, 이들은 이미 인프라 변경 관리로 과부하 상태입니다. 사전 최적화는 거의 이루어지지 않습니다. *** ## 다른 도구들의 한계 | 도구 | 기능 | 부족한 점 | | ---------------------------------- | --------------------- | -------------------------------- | | **kubectl** | 클러스터 API 직접 접근 | 원시 도구로, 깊은 전문성 필요, 분석 또는 권장사항 없음 | | **Lens / k9s** | Kubernetes 대시보드 및 CLI | 시각화 전용, AI 분석 없음, 권장사항 없음 | | **Kubecost** | Kubernetes 비용 할당 및 보고 | 비용 가시성만 제공, 문제 해결 또는 최적화 지침 없음 | | **Datadog / Prometheus + Grafana** | Kubernetes 메트릭 및 알림 | 모니터링 전용, 조치를 위한 전문가 해석이 여전히 필요 | | **KEDA / VPA** | 자동 스케일링 자동화 | 단일 목적 도구, 전체적인 클러스터 분석 없음 | Kai는 일반적으로 kubectl 전문성, 모니터링 대시보드, 비용 도구, 보안 스캐너가 따로 필요했던 기능들을 단일 대화형 인터페이스에서 결합하여 문제를 설명하고 구체적인 수정 사항을 권장합니다. *** ## Kai의 작동 방식 1. **Kubernetes API에 연결** — 모든 네임스페이스에 걸쳐 파드, 노드, 디플로이먼트, 서비스, 이벤트, RBAC 구성을 읽습니다 2. **메트릭 수집** — metrics-server 데이터(CPU/메모리 실제값 vs 요청값)와 Kubernetes API 상태를 상관 분석합니다 3. **비효율 패턴 식별** — OOMKill 이력, 보류 중인 파드, 활용도 미달 노드, 잘못 구성된 자동 스케일링 정책 4. **정밀한 권장사항 생성** — 실제 P95 사용률을 기반으로 한 정확한 리소스 요청/제한 값, HPA 임계값 조정, RBAC 정책 변경 5. **맥락 기반 문제 해결** — 파드 장애 시 Kai는 로그, 이벤트, 리소스 상태를 동시에 읽어 수동 상관 분석 대신 근본 원인을 식별합니다 *** ## 주요 기능 | 영역 | 기능 | | ------------ | --------------------------------------- | | **클러스터 관리** | 상태 모니터링, 노드 관리, 리소스 할당, 업그레이드 | | **워크로드 최적화** | 파드 적정 크기 조정, 리소스 요청/제한, 스케줄링 효율화 | | **자동 스케일링** | HPA/VPA/Cluster Autoscaler 최적화, 스케일링 정책 | | **보안** | RBAC 감사, 네트워크 정책, 파드 보안, 시크릿 관리 | | **문제 해결** | 크래시 루프, OOMKill, 스케줄링 실패, 네트워킹 문제 | *** ## 지원 플랫폼 | 플랫폼 | 지원 수준 | | -------------- | ------------------------------------- | | **Amazon EKS** | AWS 통합을 포함한 완전 지원 | | **Google GKE** | GCP 통합을 포함한 완전 지원 | | **Azure AKS** | Azure 통합을 포함한 완전 지원 | | **자체 관리** | metrics-server가 있는 Kubernetes 1.24 이상 | *** ## 프롬프트 패턴 ### 클러스터 상태 확인 ```text theme={null} # 상태 점검 @kai check EKS cluster health and pod distribution # 리소스 사용률 @kai analyze cluster resource utilization and identify bottlenecks # 노드 분석 @kai identify nodes with <30% CPU utilization for consolidation # 멀티클러스터 뷰 @kai provide health summary across all Kubernetes clusters ``` ### 워크로드 최적화 ```text theme={null} # 파드 적정 크기 조정 @kai analyze pod resource requests/limits and recommend right-sizing # 스케줄링 효율화 @kai identify pods with resource requests far exceeding actual usage # 비용 최적화 @kai identify underutilized nodes and recommend consolidation strategy # 네임스페이스 분석 @kai analyze resource allocation across namespaces ``` ### 자동 스케일링 ```text theme={null} # HPA 검토 @kai review Horizontal Pod Autoscaler policies and recommend improvements # 스케일링 분석 @kai analyze scaling patterns and recommend threshold adjustments # VPA 평가 @kai evaluate whether Vertical Pod Autoscaler would benefit our workloads # 클러스터 자동 스케일링 @kai review Cluster Autoscaler configuration for cost efficiency ``` ### 문제 해결 ```text theme={null} # 크래시 조사 @kai investigate pod crash loops in payment namespace # OOM 분석 @kai identify pods experiencing OOMKilled events and recommend fixes # 스케줄링 문제 @kai analyze pending pods and identify scheduling constraints # 네트워크 문제 @kai investigate network connectivity issues between services ``` ### 보안 ```text theme={null} # RBAC 감사 @kai audit RBAC configuration against least-privilege principles # 네트워크 정책 @kai analyze network policies and recommend security improvements # 파드 보안 @kai identify pods running with excessive privileges # 시크릿 감사 @kai audit secrets management and recommend rotation strategy ``` *** ## 도구 사용 | 도구 | Kai 활용 사례 | | ------------ | ------------------------------- | | `#dashboard` | 클러스터 상태, 노드 현황, 리소스 사용률, 파드 메트릭 | | `#report` | 최적화 분석, 보안 감사, 용량 계획 | | `#recommend` | 적정 크기 조정, 스케일링 정책, 통합 조치 | | `#alert` | OOMKill, 노드 압박, 파드 장애, 리소스 임계값 | | `#chart` | 리소스 추이, 스케일링 패턴, 시간별 사용률 | ### 도구 활용 예시 ```text theme={null} @kai #dashboard EKS cluster health with node and pod metrics @kai #report cluster optimization opportunities with implementation plan @kai #recommend HPA policies for variable workloads @kai #alert on pod OOMKilled events or node pressure conditions ``` *** ## 효과적인 프롬프트 작성 **팁: 클러스터 맥락을 포함하세요** ```text theme={null} # 좋은 예 @kai analyze production EKS cluster in us-west-2 for pod resource optimization # 피해야 할 예 @kai check our containers ``` **팁: 성공 메트릭을 정의하세요** ```text theme={null} # 좋은 예 @kai improve cluster utilization while maintaining <30s pod startup and 99.9% availability # 피해야 할 예 @kai make cluster better ``` *** ## 연결 요구사항 Kai는 모니터링 기능이 포함된 Kubernetes 클러스터 접근 권한이 필요합니다: | 구성 요소 | 필요한 접근 권한 | | ------------------ | ----------------------------- | | **Kubernetes API** | 파드, 노드, 디플로이먼트, 서비스에 대한 읽기 접근 | | **Metrics Server** | 파드 및 노드의 리소스 메트릭 | | **Events** | 문제 해결을 위한 클러스터 이벤트 | | **Logs** | 디버깅을 위한 컨테이너 로그 | *** ## 일반적인 워크플로우 ### 클러스터 최적화 ```text theme={null} # 1단계: 평가 @kai analyze cluster resource utilization # 2단계: 낭비 식별 @kai identify pods with >50% overprovisioned resources # 3단계: 계획 @kai #recommend right-sizing with zero-downtime approach # 4단계: 모니터링 @kai #dashboard track resource utilization after changes ``` ### 인시던트 대응 ```text theme={null} # 1단계: 식별 @kai identify unhealthy pods and failing deployments # 2단계: 조사 @kai analyze logs and events for root cause # 3단계: 해결 @kai #recommend immediate actions to restore service # 4단계: 재발 방지 @kai #recommend changes to prevent recurrence ``` ### 용량 계획 ```text theme={null} # 1단계: 기준선 설정 @kai analyze current resource consumption patterns # 2단계: 예측 @kai forecast resource needs for 2x growth # 3단계: 계획 @kai #recommend node pool configuration for projected growth # 4단계: 자동화 @kai #recommend autoscaling policies for demand variations ``` *** ## 다음 단계 Kai를 EKS, GKE, AKS 또는 자체 관리 클러스터에 연결 [RCA](/ko/guide/incident/root-cause-analysis)를 위한 Kubernetes 서비스 의존성 시각화 Kai가 Kubernetes 인시던트를 자동으로 조사하는 방식 클러스터 비용 + 성능 최적화를 위해 Kai와 [Alex](/ko/guide/agents/alex)를 조율