# KubeDoor
**Repository Path**: starsl/KubeDoor
## Basic Information
- **Project Name**: KubeDoor
- **Description**: 🌼花折 - KubeDoor 是一个使用Python + Vue开发，基于K8S准入控制机制的微服务资源管控平台，以及支持多K8S集群统一远程存储、监控、告警、通知、展示的一站式K8S监控平台，并且专注微服务每日高峰时段的资源视角，实现了微服务的资源分析统计与强管控，确保微服务资源的资源申请率和真实使用率一致。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 15
- **Forks**: 9
- **Created**: 2025-01-06
- **Last Updated**: 2025-11-10
## Categories & Tags
**Categories**: containers
**Tags**: Kubernetes, devops
## README
[](https://starsl.cn)
[](https://github.com/CassInfra/KubeDoor/commits/main)
[](https://github.com/CassInfra/KubeDoor/issues)
[](https://nodejs.org)
[](https://nodejs.org)
[](https://github.com/CassInfra/KubeDoor/blob/main/LICENSE)
[](https://www.murphysec.com/dr/Zoyt5g0huRavAtItj2)
# 花折 - KubeDoor
花开堪折直须折🌻莫待无花空折枝
#### 🎉新增K8S事件监控，Pod实时日志，K8S MCP支持！K8S统一管控，多K8S监控、告警、展示的最佳实践🎉
## 💎功能描述
### 0. 💥新版功能亮点
##### **💠KubeDoor K8S事件采集分析与监控告警！多K8S事件采集与查询分析，灵活的K8S事件告警规则配置。**
🔍点击展开 ...
|
|
|
| ------------------------------------| ----------------------------------- |
##### **💠KubeDoor WEB 新增Pod实时日志跟踪，自动多色标记各级别异常，支持关键字查询定位与过滤。支持日志自带颜色显示。**
🔍点击展开 ...
|
|
| ------------------------------------|
##### **💠KubeDoor 支持多K8S ISTIO VirtualService规则的管理与同步。**
🔍点击展开 ...
**🚸内部试用阶段，使用MySQL数据源，如需使用，请联系作者协助调试。**
|
| 
|
| ------------------------------------| ----------------------------------- |
| 
|
|
##### **💠KubeDoor MCP 体验版来啦！接入任意MCP客户端，即可与LLM对话方式：对您的所有K8S集群操作、资源异常故障分析。**
🔍点击展开 ...
- 使用任意MCP客户端, 新增MCP服务器, 选择sse类型,地址输入：`http://{nodeIP}:{kubedoor-mcp-NodePort}/sse`即可接入KubeDoor MCP.
- 基于KubeDoor的多K8S管理监控架构与已有的API接口，可以快速生成大量MCP工具来操作K8S与Grafana数据分析，敬请期待！
- **已接入的工具列表与操作演示**
| 
| 
|
| ------------------------------------| ----------------------------------- |
>由于大语言模型的不确定性，请尽量使用带工具确认的MCP客户端（Cline、Cursor）。
>
>目前为体验版，暂未做MCP WEB客户端以及工具调用鉴权，请勿将MCP服务端地址暴露到公网。
---
### 1. 📡微服务监控分析：多K8S集群统一监控最佳实践
- 🌊基于VictoriaMetrics全家桶实现**多K8S集群**统一远程存储、监控、告警、展示的一站式K8S监控方案。
- 🎨集成了K8S节点监控看板与K8S资源监控看板，均支持在单一看板中查看各个K8S集群的资源情况。
- 📐内置K8S资源，JVM资源与K8S节点的告警规则，支持统一告警规则管理，对接各IM告警及灵活的@机制。
|
|
|
|
| ------------------------------------| ----------------------------------- | ---------------------------------- |
|
|
|
|
| ------------------------------------| ----------------------------------- | ---------------------------------- |
|
|
|
|
| ------------------------------------| ----------------------------------- | ----------------------------------- |
|
|
|
|
|
|
| ------------------------------------|
🔍点击展开 ...
```
### 【下载helm包】
wget https://StarsL.cn/kubedoor/kubedoor-1.5.2.tgz
tar -zxvf kubedoor-1.5.2.tgz
cd kubedoor
### 【master端安装】
# 编辑values-master.yaml文件，请仔细阅读注释，根据描述修改配置内容。
# try
helm upgrade -i kubedoor . --namespace kubedoor --create-namespace --values values-master.yaml --dry-run --debug
# install
helm upgrade -i kubedoor . --namespace kubedoor --create-namespace --values values-master.yaml
### 【agent端安装】
# 编辑values-agent.yaml文件，请仔细阅读注释，根据描述修改配置内容。
helm upgrade -i kubedoor-agent . --namespace kubedoor --create-namespace --values values-agent.yaml --set tsdb.external_labels_value=xxxxxxxx
```
#### ♻更新指引【版本变更记录】
🔍点击展开 ...
```
# 下载安装包
wget https://StarsL.cn/kubedoor/kubedoor-1.5.2.tgz
tar -zxvf kubedoor-1.5.2.tgz
```
```
# 旧版本更新到1.3.0及以上版本需要新增2个数据库字段
ALTER TABLE kubedoor.k8s_agent_status ADD COLUMN nms_not_confirm Bool DEFAULT false AFTER admission_namespace;
ALTER TABLE kubedoor.k8s_agent_status ADD COLUMN scheduler Bool DEFAULT false AFTER nms_not_confirm;
```
**注意：**
- 请参考已经已经部署好的configmap: `kubedoor-info`中的`VictoriaMetrics`, `ClickHouse`等配置项修改`values-master.yaml`, `values-agent.yaml`的对应配置，确保使用的配置与旧版本一致。(因yaml配置有调整，不可直接替换文件。)
- 或者使用以下命令查看部署时候的values配置信息，并修改到`values-master.yaml`, `values-agent.yaml`的对应配置。
```
helm get values kubedoor -n kubedoor
helm get values kubedoor-agent -n kubedoor
```
#【master端更新】
helm upgrade -i kubedoor . --namespace kubedoor --create-namespace --values values-master.yaml
#【agent端更新】
helm upgrade -i kubedoor-agent . --namespace kubedoor --create-namespace --values values-agent.yaml --set tsdb.external_labels_value=xxxxxxxx
#### 🌐使用说明
🔍点击展开 ...
- **访问WebUI 并初始化数据：**
1. 使用K8S节点IP + kubedoor-web的NodePort访问，默认账号密码都是 **`kubedoor`**
2. 点击`agent管理`，先开启`自动采集`，设置好`高峰期时段`，再执行采集：输入需要采集的`历史数据时长`，点击`采集`，即可采集历史数据并更新高峰时段数据到管控表。
- **注意：**
- 开启自动采集后，每天凌晨1点会采集前一天的高峰期数据，并将10天内最大资源消耗日的数据写入到更新管控表。
- 重复执行`采集`不会导致重复写入数据，请放心使用；每次采集后都会自动将10天内最大资源消耗日的数据写入到管控表。如果耗时较长，请等待采集完成或缩短采集时长。
- 如果您是新安装的监控系统，并且已过了当天的高峰期时段，将会无法采集到数据；需要等第二天高峰期时段之后才能采集到数据。
---
## 🔔KubeDoor交流群与🧧赞赏
#### 如果觉得项目不错，麻烦动动小手点个⭐️Star⭐️ 如果你还有其他想法或者需求，欢迎在 issue 中交流
**加作者微信或关注公众号加入交流群**
|
|
|
|
|
