k8m 是一款AI驱动的 Mini Kubernetes AI Dashboard 轻量级控制台工具，专为简化集群管理设计。它基于 AMIS 构建，并通过 kom 作为 Kubernetes API 客户端，k8m 内置了 Qwen2.5-Coder-7B 模型交互能力，同时支持接入您自己的私有化大模型。
- 迷你化设计：所有功能整合在一个单一的可执行文件中，部署便捷，使用简单。
- 简便易用：友好的用户界面和直观的操作流程，让 Kubernetes 管理更加轻松。
- 高效性能：后端采用 Golang 构建，前端基于百度 AMIS，保证资源利用率高、响应速度快。
- Pod 文件管理：支持 Pod 内文件的浏览、编辑、上传、下载、删除，简化日常操作。
- Pod 运行管理：支持实时查看 Pod 日志，下载日志，并在 Pod 内直接执行 Shell 命令。
- CRD 管理：可自动发现并管理 CRD 资源，提高工作效率。
- 智能翻译与问诊：基于ChatGPT实现YAML属性自动翻译、Describe信息解读、日志AI问诊、运行命令推荐等，为管理k8s提供智能化支持。
- 跨平台支持：兼容 Linux、macOS 和 Windows，并支持 x86、ARM 等多种架构，确保多平台无缝运行。
k8m 的设计理念是“AI驱动，轻便高效，化繁为简”，它帮助开发者和运维人员快速上手，轻松管理 Kubernetes 集群。
- 下载：从 GitHub 下载最新版本。
- 运行：使用
./k8m命令启动,访问http://127.0.0.1:3618。 - 参数：
./k8m -h
--add_dir_header If true, adds the file directory to the header of the log messages
--alsologtostderr log to standard error as well as files (no effect when -logtostderr=true)
-k, --chatgpt-key string API Key for ChatGPT (default "sk-XXXX")
-u, --chatgpt-url string API URL for ChatGPT (default "https://api.siliconflow.cn/v1")
-d, --debug Debug mode,same as GIN_MODE
-c, --kubeconfig string Absolute path to the kubeConfig file (default "/Users/xxx/.kube/config")
--log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0)
--log_dir string If non-empty, write log files in this directory (no effect when -logtostderr=true)
--log_file string If non-empty, use this log file (no effect when -logtostderr=true)
--log_file_max_size uint Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
--logtostderr log to standard error instead of files (default true)
--one_output If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
-p, --port int Port for the server to listen on (default 3618)
--skip_headers If true, avoid header prefixes in the log messages
--skip_log_headers If true, avoid headers when opening log files (no effect when -logtostderr=true)
--stderrthreshold severity logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)
-v, --v Level number for the log level verbosity (default 0)
--vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging从v0.0.8版本开始，将内置GPT，无需配置。 如果您需要使用自己的GPT，请参考以下步骤。
需要设置环境变量，以启用ChatGPT。
export OPENAI_API_KEY="sk-XXXXX"
export OPENAI_API_URL="https://api.siliconflow.cn/v1"如果设置参数后，依然没有效果，请尝试使用./k8m -v 6获取更多的调试信息。
会输出以下信息，通过查看日志，确认是否启用ChatGPT。
ChatGPT 开启状态:true
ChatGPT 启用 key:sk-hl**********************************************,url:https://api.siliconflow.cn/v1本项目集成了github.com/sashabaranov/go-openaiSDK。 国内访问推荐使用硅基流动的服务。 登录后，在https://cloud.siliconflow.cn/account/ak创建API_KEY
- 创建 KinD Kubernetes 集群
brew install kind
- 创建新的 Kubernetes 集群：
kind create cluster --name k8sgpt-demo
kubectl apply -f https://raw.githubusercontent.com/weibaohui/k8m/refs/heads/main/deploy/k8m.yaml
- 访问： 默认使用了nodePort开放，请访问31999端口。或自行配置Ingress http://NodePortIP:31999
本项目中的 Makefile 用于自动化常见任务，如构建、测试和清理项目。以下是详细的使用说明，帮助你了解如何使用 Makefile 中定义的各个目标。
在使用 Makefile 之前，请确保你的系统上已安装以下工具：
- Go（Golang） - 下载并安装 Go
- Make - 通常预装在 Linux 和 macOS 系统中。对于 Windows 用户，可以考虑使用 GNU Make for Windows 或 WSL（Windows Subsystem for Linux）
- Git - 用于获取当前提交哈希
- 描述：默认目标，构建当前平台的可执行文件。
- 使用方法：
make
- 描述：根据当前系统的操作系统和架构，为当前平台构建可执行文件。
- 使用方法：
make build- 描述：为所有指定的平台和架构进行交叉编译，生成相应的可执行文件。
- 使用方法：
make build-all
- 输出：不同平台的可执行文件将位于
bin/目录中，命名格式为k8m-<GOOS>-<GOARCH>（例如k8m-linux-amd64、k8m-windows-amd64.exe）。
- 描述：删除
bin/目录及其中的所有编译生成的可执行文件。 - 使用方法：
make clean
- 输出：
bin/目录及其内容将被删除。
- 描述：构建并运行当前平台的可执行文件。注意：此目标仅适用于 Unix 系统（Linux 和 macOS）。
- 使用方法：
make run
- 输出：应用程序将在本地启动运行。
- 描述：显示所有可用的 Makefile 目标及其简要描述。
- 使用方法：
make help
build-all 目标支持以下操作系统和架构组合的交叉编译：
- Linux:
amd64arm64ppc64les390xmips64leriscv64
- Darwin（macOS）:
amd64arm64
- Windows:
amd64arm64
构建适用于当前操作系统和架构的 k8m 可执行文件：
make build交叉编译 k8m 为所有指定的平台和架构：
make build-all在 Unix 系统上构建并运行 k8m：
make run删除所有编译生成的可执行文件和 bin/ 目录：
make clean显示所有可用的 Makefile 目标及其描述：
make help- 版本控制：你可以在构建时通过传递
VERSION变量来指定自定义版本：make build VERSION=v2.0.0
- 可执行文件扩展名：对于 Windows 构建，Makefile 会自动为可执行文件添加
.exe扩展名。 - 依赖性：确保 Git 已安装并且项目已初始化为 Git 仓库，以便正确获取
GIT_COMMIT哈希值。
- 缺少依赖：如果遇到与缺少命令相关的错误（如
make、go等），请确保所有先决条件已安装并正确配置在系统的PATH中。 - 权限问题：如果在运行
make run时收到权限被拒绝的错误，请确保bin/目录和编译后的二进制文件具有必要的执行权限：chmod +x bin/k8m
- 文件浏览权限问题：依赖容器内的ls命令，请在容器内安装shell、tar、cat等命令 。
k8m 提供集成的 YAML 浏览、编辑和文档查看功能，支持自动翻译 YAML 属性。无论是查找字段含义还是确认配置细节，您都无需再费时费力地搜索，极大提高了工作效率。
在 Event 页面，k8m 内置了 AI 问诊功能，可智能分析异常事件，并提供详细的解释。点击事件前的“AI大脑”按钮，稍等片刻即可查看诊断结果，快速定位问题原因。
日志分析是定位问题的重要环节，但面对大量报错信息，如何高效排查？k8m 支持 AI 日志诊断，帮助快速识别关键错误并生成解决建议。只需选中相关日志，点击 AI 问诊按钮，即可获得诊断报告。
日常运维中，Pod 内命令操作不可避免。借助 AI，您只需输入需求描述，k8m 即可自动生成合适的命令供参考，减少查找时间，提高效率。
如果你有任何进一步的问题或需要额外的帮助，请随时与我联系！
微信（大罗马的太阳） 搜索ID：daluomadetaiyang,备注k8m。
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}