Wuhr-AI-ops：智能运维管理平台

Wuhr-AI-ops 是一个开源的智能运维管理平台，集成多模态AI助手、实时监控、日志分析和CI/CD管理功能。它通过人工智能技术简化复杂的运维任务，帮助运维团队高效管理IT系统。平台支持自然语言操作，结合主流AI模型如GPT-4o和Gemini，提供一站式解决方案。用户可以监控系统性能、分析日志、管理权限，并通过自动化部署提升效率。Wuhr-AI-ops 适合需要统一管理本地和远程主机的企业或团队，代码托管在GitHub，方便开发者贡献和定制。

功能列表

• 智能AI助手：支持自然语言输入，调用GPT-4o、Gemini等模型，执行运维任务。
• 多模式命令执行：支持Kubernetes集群和Linux系统命令，智能切换执行环境。
• 实时监控：集成ELK日志分析和Grafana性能监控，实时查看系统状态。
• CI/CD管理：支持自动化部署流水线，集成Jenkins实现高效开发流程。
• 权限管理：基于角色的访问控制，设置审批流程，确保系统安全。
• 多环境支持：统一管理本地和远程主机，简化多环境运维。

使用帮助

安装流程

要使用Wuhr-AI-ops，需要在支持Node.js和Docker的环境中安装。以下是详细的安装步骤：

1. 克隆项目：

   git clone https://github.com/st-lzh/wuhr-ai-ops.git
   cd wuhr-ai-ops

这会将项目代码下载到本地，并进入项目目录。

2. 配置环境变量：
   复制示例环境变量文件并编辑：

   cp .env.example .env
   

   使用文本编辑器打开 .env 文件，配置数据库连接信息和AI模型的API密钥。例如：

   DATABASE_URL=postgresql://user:password@localhost:5432/wuhrai
   OPENAI_API_KEY=sk-xxx
   

   确保填写正确的数据库地址和有效的API密钥。

3. 设置npm镜像（国内用户）：
   为加速依赖安装，配置npm镜像源：

   npm config set registry https://registry.npmmirror.com/
   

4. 下载kubelet-wuhrai工具：
   下载并设置执行权限：

   wget -O kubelet-wuhrai https://wuhrai-wordpress.oss-cn-hangzhou.aliyuncs.com/kubelet-wuhrai
   chmod +x kubelet-wuhrai
   

5. 启动数据库服务：
   使用Docker Compose启动PostgreSQL、Redis和pgAdmin：

   docker-compose up -d postgres redis pgadmin
   sleep 30
   

   等待30秒，确保服务完全启动。

6. 安装依赖：
   运行以下命令安装项目依赖：

   npm install
   

7. 数据库初始化：
   初始化数据库结构和数据：

   npx prisma migrate reset --force
   npx prisma generate
   npx prisma db push
   

8. 初始化用户和权限：
   运行以下脚本设置管理员用户和权限：

   node scripts/ensure-admin-user.js
   node scripts/init-permissions.js
   node scripts/init-super-admin.ts
   

9. 初始化预设模型和ELK模板：
   配置AI模型和日志分析模板：

   node scripts/init-preset-models.js
   node scripts/init-elk-templates.js
   

10. 启动开发服务器：
    运行开发环境：

    npm run dev
    

    项目启动后，可通过浏览器访问本地服务（默认端口根据配置而定）。

11. 运行测试（可选）：
    验证项目功能是否正常：

    npm test
    

使用主要功能

智能AI助手

Wuhr-AI-ops 的核心功能是智能AI助手。用户可以通过自然语言输入运维指令，例如“检查生产环境的日志”或“部署最新代码到测试服务器”。AI助手会解析指令，调用GPT-4o或Gemini模型，生成相应的命令并执行。操作步骤如下：

• 登录Wuhr-AI-ops Web界面。
• 在AI助手输入框中输入自然语言指令。
• 系统自动解析并显示执行结果，例如日志分析报告或部署状态。
• 如果需要调整AI模型，可在 .env 文件中更换API密钥。

实时监控

平台集成了ELK和Grafana，用于实时监控系统性能和日志：

• ELK日志分析：在Web界面选择“日志分析”模块，查看系统日志。用户可筛选时间范围或关键词，快速定位错误日志。例如，输入“error”可显示所有错误日志。
• Grafana性能监控：访问Grafana仪表板，查看CPU、内存、网络等指标。用户可自定义仪表板，添加特定监控项，如Kubernetes Pod状态。

CI/CD管理

Wuhr-AI-ops 支持自动化部署流水线，集成Jenkins：

• 在Web界面选择“CI/CD管理”模块。
• 配置Jenkins任务，例如设置代码仓库地址和部署目标。
• 通过自然语言指令触发部署，例如“部署main分支到生产环境”。
• 系统会自动执行Jenkins流水线，并返回部署结果。

权限管理

平台支持基于角色的访问控制：

• 管理员可通过“权限管理”模块添加用户和角色。
• 设置审批流程，例如要求高级管理员批准高危操作。
• 用户登录后只能访问其角色权限内的功能，确保系统安全。

注意事项

• 确保Docker和Node.js版本与项目要求兼容（参考GitHub文档）。
• 国内用户建议使用中文安装脚本 ./install-zh.sh，国外用户使用 ./install-en.sh。
• 定期检查GitHub仓库更新，以获取最新功能和修复。

应用场景

1. 企业IT运维
   Wuhr-AI-ops 适合管理复杂的企业IT系统。运维团队可通过自然语言快速排查问题，例如分析服务器日志或监控Kubernetes集群性能，减少手动操作时间。
2. 开发团队协作
   开发团队可利用CI/CD管理功能，自动化代码部署到测试或生产环境。结合权限管理，确保只有授权人员能执行敏感操作。
3. 多环境管理
   对于需要同时管理本地和云端主机的企业，平台提供统一界面，简化跨环境运维任务，例如同步配置或监控远程服务器。

QA

1. Wuhr-AI-ops 支持哪些AI模型？
   平台支持GPT-4o、Gemini等多种主流多模态AI模型。用户可在 .env 文件中配置API密钥以切换模型。
2. 如何确保系统安全？
   平台通过基于角色的访问控制和审批流程确保安全。敏感操作需管理员批准，日志和权限变更可追溯。
3. 是否适合小型团队使用？
   是的，Wuhr-AI-ops 开源且易于部署，适合小型团队。它的自然语言操作降低了技术门槛。
4. 如何处理安装中的依赖错误？
   检查Node.js和npm版本是否符合要求，使用国内镜像源加速下载。如果问题持续，查看GitHub Issues页面或提交问题。