Kubernetes 클러스터의 문제를 찾아내고 LLM으로 알기 쉽게 설명하는 CLI 도구입니다.
k8sgpt-ai/k8sgpt-operator
AI 백엔드를 사용해 클러스터 문제를 진단하고, 선택적으로 이미지 풀 실패를 자동으로 복구하도록 K8sGPT를 배포하고 관리하는 Kubernetes operator입니다.
- 스타
- 489
- 포크
- 148
- 열린 이슈
- 29
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
K8sGPT Operator는 Kubernetes 클러스터 안에서 K8sGPT를 실행합니다. AI 백엔드, 모델, 분석 범위, 결과 연동 대상을 지정하는 K8sGPT custom resource를 선언하면, operator가 클러스터를 스캔하고 감지된 문제와 권장 해결 방법을 담은 Result 객체를 생성하는 K8sGPT 워크로드를 만들고 유지합니다.
지원하는 AI 백엔드에는 OpenAI, Azure OpenAI, Amazon Bedrock, LocalAI가 있으며, 인증 정보는 Kubernetes Secrets에서 읽습니다. kubeconfig를 참조해 여러 클러스터를 모니터링할 수 있고, Azure Blob Storage 또는 S3를 원격 캐시로 사용할 수 있습니다. 분석 필터를 사용하면 분석할 리소스 유형을 선택할 수 있으며, sink를 통해 결과를 Slack, Mattermost 또는 CloudEvents 엔드포인트로 전달할 수 있습니다.
알파 단계의 선택적 자동 복구 기능은 ImagePullBackOff와 같은 일부 워크로드 이미지 오류를 해결할 수 있습니다. operator가 승인된 이미지 경로에 대한 JSON patch를 직접 계산하고 dry-run하므로, LLM이 클러스터에 직접 쓰기 작업을 수행하지 않습니다.
핵심 기능
- 01K8sGPT custom resource를 통해 K8sGPT 워크로드를 선언적으로 관리합니다.
- 02OpenAI, Azure OpenAI, Amazon Bedrock, LocalAI 백엔드에 연결합니다.
- 03Cluster API 클러스터 등 kubeconfig 참조를 통해 원격 클러스터를 모니터링합니다.
- 04Azure Blob Storage 또는 S3를 사용한 원격 결과 캐싱을 지원합니다.
- 05분석 결과를 Slack, Mattermost 또는 CloudEvents sink로 전달합니다.
- 06선택적으로 활성화할 수 있는 알파 단계의 이미지 풀 오류 자동 복구 기능을 제공합니다.
활용 사례
- SRE 팀이 Kubernetes 클러스터 전반에서 AI 기반 진단을 지속적으로 실행합니다.
- 단일 관리 클러스터에서 Cluster API로 관리되는 클러스터 여러 개를 모니터링합니다.
- 클러스터 문제 보고서를 Slack 또는 Mattermost 채널로 보내 온콜 담당자가 대응하도록 합니다.
- 자체 호스팅 LocalAI 모델을 사용해 클러스터 데이터가 환경 외부로 나가지 않도록 합니다.
빠른 시작
- 1
Helm 저장소 추가
helm repo add k8sgpt https://charts.k8sgpt.ai/ - 2
Helm 저장소 업데이트
helm repo update - 3
클러스터에 오퍼레이터 설치
helm install release k8sgpt/k8sgpt-operator -n k8sgpt-operator-system --create-namespace
사용 전 알아둘 점
- 자동 복구 기능은 알파 단계이며 옵트인 방식입니다. 변경될 수 있으므로 프로덕션 환경에서 사용하기에 안전하지 않을 수 있습니다.
- 예제를 실행하려면 OpenAI 또는 다른 AI 백엔드의 API 키가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- k8sgpt-operator은(는) 무엇인가요?
- AI 백엔드를 사용해 클러스터 문제를 진단하고, 선택적으로 이미지 풀 실패를 자동으로 복구하도록 K8sGPT를 배포하고 관리하는 Kubernetes operator입니다. K8sGPT Operator는 Kubernetes 클러스터 안에서 K8sGPT를 실행합니다. AI 백엔드, 모델, 분석 범위, 결과 연동 대상을 지정하는 K8sGPT custom resource를 선언하면, operator가 클러스터를 스캔하고 감지된 문제와 권장 해결 방법을 담은 Result 객체를 생성하는 K8sGPT 워크로드를 만들고 유지합니다.
- k8sgpt-operator은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- k8sgpt-operator은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- k8sgpt-operator은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. k8sgpt-operator의 마지막 커밋은 2026년 11월 6일입니다.
- k8sgpt-operator은(는) 어디에 사용할 수 있나요?
- SRE 팀이 Kubernetes 클러스터 전반에서 AI 기반 진단을 지속적으로 실행합니다. 단일 관리 클러스터에서 Cluster API로 관리되는 클러스터 여러 개를 모니터링합니다. 클러스터 문제 보고서를 Slack 또는 Mattermost 채널로 보내 온콜 담당자가 대응하도록 합니다. 자체 호스팅 LocalAI 모델을 사용해 클러스터 데이터가 환경 외부로 나가지 않도록 합니다.
- k8sgpt-operator는 어떻게 설치하나요?
- Helm 저장소 추가: helm repo add k8sgpt https://charts.k8sgpt.ai/ Helm 저장소 업데이트: helm repo update 클러스터에 오퍼레이터 설치: helm install release k8sgpt/k8sgpt-operator -n k8sgpt-operator-system --create-namespace
- k8sgpt-operator은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/k8sgpt-ai/k8sgpt-operator
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
자체 로그, 메트릭, 트레이스, 배포 정보를 바탕으로 프로덕션 인시던트를 조사하는 AI SRE 에이전트를 구축하기 위한 오픈소스 프레임워크입니다.
프로세스, 포트, 컨테이너 또는 파일의 시작 경로를 추적하는 CLI 및 TUI입니다.
단일 바이너리로 실행되며 AI 에이전트가 클러스터 상태를 읽을 수 있는 내장 MCP 서버를 포함한 무료 오픈소스 Kubernetes UI입니다.
eBPF로 클러스터 트래픽을 캡처하고 인덱싱하며, TLS를 복호화해 MCP를 통해 AI 에이전트에 데이터를 제공하는 Kubernetes 네트워크 관측 도구입니다.
자연어와 에이전트를 활용해 클라우드와 인프라를 관리하고 서비스를 배포·문제 해결·자동화하는 오픈소스 AI 네이티브 터미널입니다.