k8sgpt-ai/k8sgpt

어떤 프로젝트인가요?

핵심 기능

• 01내장 분석기로 Pod, Service, Deployment, Ingress, PVC 등의 Kubernetes 리소스를 스캔합니다.
• 02선택한 LLM 백엔드를 사용해 탐지한 문제를 알기 쉽게 설명합니다.
• 03OpenAI, Azure, Bedrock, Gemini, Ollama, LiteLLM 등 다양한 공급자를 지원합니다.
• 04AI 백엔드로 데이터를 보내기 전에 객체 이름을 익명화합니다.
• 05리소스 유형과 네임스페이스별로 결과를 필터링하고 JSON으로 출력합니다.
• 06AI 어시스턴트와 연동할 수 있도록 serve 모드와 MCP 서버를 제공합니다.

활용 사례

• 수많은 kubectl 출력을 일일이 살펴보지 않고 클러스터에서 실패한 워크로드의 원인을 파악합니다.
• 클러스터를 주기적으로 스캔하고 다른 도구에서 활용할 수 있도록 결과를 JSON으로 수집합니다.
• MCP를 통해 Claude Desktop 같은 AI 어시스턴트에 클러스터 상태 정보를 제공합니다.
• 클러스터 데이터를 네트워크 외부로 보내면 안 되는 경우 로컬 모델로 분석합니다.

빠른 시작

1. 1

   Homebrew로 k8sgpt 설치하기

   brew install k8sgpt
2. 2

   OpenAI API 키 생성하기(브라우저에서 링크가 열립니다)

   k8sgpt generate
3. 3

   k8sgpt에 API 키 추가하기

   k8sgpt auth add
4. 4

   클러스터를 스캔하고 문제 설명 확인하기

   k8sgpt analyze --explain

사용 전 알아둘 점

• !기본 AI 백엔드는 OpenAI이므로 다른 제공자를 설정하지 않는 한 OpenAI API 키가 필요합니다.
• !분석하려면 연결 가능한 Kubernetes 클러스터와 설명을 위한 AI 백엔드 설정이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

k8sgpt은(는) 무엇인가요?

Kubernetes 클러스터의 문제를 찾아내고 LLM으로 알기 쉽게 설명하는 CLI 도구입니다. k8sgpt는 Kubernetes 클러스터를 스캔하고, 일반적인 SRE 점검 항목을 담은 내장 분석기를 실행해 발견한 문제를 보고합니다. Pod, Service, Deployment, Ingress, PVC, Node, 웹훅 등의 리소스를 확인하며, HPA, 네트워크 정책, Gateway API, OLM 오퍼레이터 객체 같은 선택 항목도 검사할 수 있습니다.

k8sgpt은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

k8sgpt은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

k8sgpt은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. k8sgpt의 마지막 커밋은 2026년 10월 24일입니다.

k8sgpt은(는) 어디에 사용할 수 있나요?

수많은 kubectl 출력을 일일이 살펴보지 않고 클러스터에서 실패한 워크로드의 원인을 파악합니다. 클러스터를 주기적으로 스캔하고 다른 도구에서 활용할 수 있도록 결과를 JSON으로 수집합니다. MCP를 통해 Claude Desktop 같은 AI 어시스턴트에 클러스터 상태 정보를 제공합니다. 클러스터 데이터를 네트워크 외부로 보내면 안 되는 경우 로컬 모델로 분석합니다.

k8sgpt는 어떻게 설치하나요?

Homebrew로 k8sgpt 설치하기: brew install k8sgpt OpenAI API 키 생성하기(브라우저에서 링크가 열립니다): k8sgpt generate k8sgpt에 API 키 추가하기: k8sgpt auth add 클러스터를 스캔하고 문제 설명 확인하기: k8sgpt analyze --explain

k8sgpt은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/k8sgpt-ai/k8sgpt