README
¶
🚀 AI+CloudOps
🌟 智能化云原生运维管理平台 🌟
融合人工智能与云原生技术，重新定义企业运维管理体验
🌈 项目介绍 (Introduction)
💡 为什么选择 AI+CloudOps？
AI+CloudOps 不仅仅是一个运维平台，它是您数字化转型路上的智能伙伴。我们深度融合人工智能与云原生技术，为企业提供前所未有的运维管理体验。
🎯 核心优势
|
🏢 适用场景
|
🔗 项目生态 (Project Ecosystem)
| 仓库 | 描述 | 技术栈 | 状态 |
|---|---|---|---|
| 🔧 AI-CloudOps | 核心后端服务 | Go + Gin + GORM |  |
| 🎨 AI-CloudOps-web | 前端用户界面 | Vue + TypeScript + Ant Design vue | |
| 🧠 AI-CloudOps-aiops | AI 智能运维模块 | Python + FastAPI + scikit-learn | |
✨ 核心功能特性 (Core Features)
🎨 功能架构图
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 🎯 前端界面 │ ──▶ │ 🔧 核心后端 │ ──▶ │ 🧠 AI 分析 │
│ React + TS │ │ Go + Gin │ │ Python + ML │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
└───────────────────────┼───────────────────────┘
▼
┌─────────────────────────┐
│ ☁️ 云原生基础设施 │
│ K8s + Prometheus + 🗄️ │
└─────────────────────────┘
🤖 智能运维 (AIOps)
|
🔐 权限管理 (RBAC)
|
🌲 资源管理 (CMDB)
|
📋 工单系统 (Workflow)
|
📡 监控告警 (Monitoring)
|
☸️ Kubernetes 管理
|
🌐 在线体验 (Live Demo)
🎯 立即体验我们的平台
演示地址: http://68.64.177.180 登录凭据:
👤 用户名: ⚠️ 演示环境仅供测试，请勿上传敏感信息 |
🔥 快速导览
🎨 仪表板: 查看系统整体运行状态 ☸️ K8s 管理: 体验 Kubernetes 集群管理 📊 监控面板: 感受实时监控能力 🤖 AI 分析: 尝试智能故障分析 📋 工单系统: 体验完整工单流程
🏆 核心贡献者 (Core Contributors)
💪 感谢这些优秀的贡献者让项目变得更加出色！
 🔧 GoSimplicity 项目发起人 & 核心贡献者 
|
 ⚡ Penge666 资深开发者 
|
 🌟 shixiaocaia 资深贡献者 
|
 💼 daihao4371 功能开发者 
|
 🚴 骑自行车追狗 活跃贡献者 
|
🌟 贡献统计
📊 项目统计
|
🎯 贡献指南
|
🚀 快速开始 (Quick Start)
⚡ 三步快速部署，五分钟上线体验
🛠️ 环境准备 (Prerequisites)
🔧 必需环境
|
🔍 环境检查命令 |
Go 1.21+
Node.js 21.x
pnpm latest
Docker & Docker Compose
Python 3.11+📦 获取源码 (Clone Repositories)
🔄 一键克隆所有项目
🔧 后端服务
|
🎨 前端应用
|
🧠 AI 模块
|
📋 批量克隆脚本
#!/bin/bash
# 一键克隆所有项目
echo "🚀 开始克隆 AI-CloudOps 项目组..."
repositories=(
"https://github.com/GoSimplicity/AI-CloudOps.git"
"https://github.com/GoSimplicity/AI-CloudOps-web.git"
"https://github.com/GoSimplicity/AI-CloudOps-aiops.git"
)
for repo in "${repositories[@]}"; do
echo "📦 克隆 $repo"
git clone "$repo"
done
echo "✅ 所有项目克隆完成！"
🔥 开发模式 (Development Mode)
🚀 四步启动完整开发环境
1️⃣ 启动基础设施
|
2️⃣ 启动前端
|
3️⃣ 启动后端
|
4️⃣ 启动 AI 服务
|
🏗️ 步骤一：启动基础设施
|
🔧 启动的服务:
|
MySQL 8.0
Redis 7.0
Prometheus
Grafana🎨 步骤二：启动前端服务
|
🌐 访问地址:
|
🔧 步骤三：启动后端服务
|
🔗 服务地址:
|
🧠 步骤四：启动 AI 服务 (可选)
|
🤖 AI 能力:
|
🚀 生产部署 (Production Deployment)
🏭 企业级生产环境部署方案
🏗️ 传统部署
手动构建和部署 |
🐳 容器化部署
推荐方案 |
☸️ K8s 部署
云原生生产级 |
🏗️ 方案一：传统构建部署
📦 前端构建
# 进入前端项目目录
cd AI-CloudOps-web
# 📦 安装依赖
pnpm install
# 🔨 构建生产版本
pnpm run build
# 📊 查看构建结果
ls -la dist/
🌐 Nginx 配置示例:
server {
listen 80;
server_name your-domain.com;
location / {
root /var/www/ai-cloudops/dist;
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://localhost:8000/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
🔧 后端构建
# 回到后端项目目录
cd AI-CloudOps
# 🔨 构建生产二进制
go build -o bin/ai-cloudops main.go
# ⚙️ 配置生产环境变量
cp config/config.production.yaml config.yaml
# 🚀 启动生产服务
./bin/ai-cloudops
🔧 Systemd 服务配置:
[Unit]
Description=AI-CloudOps Backend Service
After=network.target
[Service]
Type=simple
User=cloudops
WorkingDirectory=/opt/ai-cloudops
ExecStart=/opt/ai-cloudops/bin/ai-cloudops
Restart=always
[Install]
WantedBy=multi-user.target
🐳 方案二：Docker Compose 部署 (推荐)
# 📁 在 AI-CloudOps 项目根目录
cd AI-CloudOps
# 🚀 一键启动所有服务
docker-compose up -d
# 🔍 查看服务状态
docker-compose ps
# 📊 查看服务日志
docker-compose logs -f
🔧 高级配置选项:
# 🔄 仅更新某个服务
docker-compose up -d backend
# 📊 监控资源使用
docker-compose top
# 🧹 清理和重启
docker-compose down && docker-compose up -d
☸️ 方案三：Kubernetes 部署
🚀 云原生生产级部署
# 📁 进入 Kubernetes 部署目录
cd deploy/kubernetes/
# ⚙️ 配置环境变量
cp config.example config
# 🚀 部署到 Kubernetes
kubectl apply -f .
# 🔍 查看部署状态
kubectl get pods,svc,ingress -l app=ai-cloudops
📊 部署架构:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 📱 前端 Pod │───▶│ 🔧 后端 Pod │───▶│ 🧠 AI Pod │
│ React App │ │ Go Service │ │ Python ML │
│ (多副本) │ │ (多副本) │ │ (多副本) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
└───────────────────────┼───────────────────────┘
▼
┌─────────────────────────┐
│ 🗄️ 数据层 Pod │
│ MySQL + Redis + 监控 │
└─────────────────────────┘
🏗️ 项目架构 (Project Architecture)
🎯 微服务架构设计
📁 后端结构 (Backend Structure)
🔧 AI-CloudOps 后端架构
AI-CloudOps/
├── 📁 cmd/ # 命令行入口
│ └── webhook/ # Webhook 服务
├── 📁 config/ # 配置文件
│ ├── config.development.yaml
│ ├── config.production.yaml
│ └── webhook.yaml
├── 📁 deploy/ # 部署配置
│ ├── kubernetes/ # K8s 部署文件
│ ├── mysql/ # 数据库初始化
│ ├── nginx/ # 反向代理配置
│ └── prometheus/ # 监控配置
├── 📁 internal/ # 核心业务逻辑
│ ├── 🔐 middleware/ # 中间件 (认证、日志等)
│ ├── 📊 model/ # 数据模型
│ ├── 🏭 k8s/ # K8s 管理模块
│ ├── 👥 user/ # 用户管理
│ ├── 📈 prometheus/ # 监控指标
│ ├── 📋 workorder/ # 工单系统
│ ├── 🌲 tree/ # 服务树 CMDB
│ └── 🔧 system/ # 系统管理
├── 📁 pkg/ # 公共工具包
│ ├── di/ # 依赖注入
│ ├── utils/ # 工具函数
│ ├── ssh/ # SSH 连接
│ └── websocket/ # WebSocket 支持
├── 📁 docs/ # API 文档
│ ├── swagger.json
│ └── swagger.yaml
├── main.go # 程序入口
├── Dockerfile # 容器构建
├── docker-compose.yaml # 本地开发环境
└── go.mod # Go 模块管理
🏛️ 架构层级:
- 🌐 API Layer: RESTful API 接口层
- 🔄 Service Layer: 业务逻辑服务层
- 💾 Repository Layer: 数据访问层
- 🗄️ Infrastructure Layer: 基础设施层
🎨 前端结构 (Frontend Structure)
⚡ AI-CloudOps-web 前端架构
AI-CloudOps-web/
├── 📁 apps/ # 应用程序目录
│ └── web-antd/ # 主应用 (Ant Design + Vue)
│ ├── src/
│ │ ├── 📁 api/ # API 接口层
│ │ ├── app.vue # 根组件
│ │ ├── bootstrap.ts # 应用启动配置
│ │ ├── 📁 composables/ # Vue Composables
│ │ ├── 📁 layouts/ # 布局组件
│ │ ├── 📁 locales/ # 国际化文件
│ │ ├── main.ts # 应用入口
│ │ ├── preferences.ts # 用户偏好设置
│ │ ├── 📁 router/ # 路由配置
│ │ ├── 📁 store/ # 状态管理
│ │ ├── 📁 types/ # TypeScript 类型
│ │ └── 📁 views/ # 页面视图组件
│ ├── dist/ # 构建输出
│ ├── public/ # 静态资源
│ ├── index.html # 入口 HTML
│ ├── package.json # 项目依赖
│ ├── tailwind.config.mjs # Tailwind 配置
│ ├── tsconfig.json # TypeScript 配置
│ └── vite.config.mts # Vite 构建配置
├── 📁 packages/ # 共享包 (Monorepo)
├── 📁 internal/ # 内部工具包
├── 📁 docs/ # 文档目录
├── 📁 scripts/ # 构建脚本
├── cspell.json # 拼写检查配置
├── eslint.config.mjs # ESLint 配置
├── stylelint.config.mjs # 样式检查配置
├── vitest.config.ts # 单元测试配置
├── vitest.workspace.ts # 测试工作空间
├── turbo.json # Turborepo 配置
├── pnpm-workspace.yaml # PNPM 工作空间
├── pnpm-lock.yaml # 锁定文件
├── package.json # 根项目依赖
└── README.md # 项目说明
🎯 技术特性:
- ⚡ Vite: 极速构建工具
- 🎨 Ant Design: 企业级 UI 组件
- 📱 响应式: 适配多端设备
- 🔄 状态管理: Zustand/Redux
- 📊 可视化: ECharts/D3.js
- 🧪 测试: Vitest + Testing Library
🧠 AI 模块结构 (AI Module Structure)
🤖 AI-CloudOps-aiops 智能模块
AI-CloudOps-aiops/
├── 📁 app/ # 应用主代码
│ ├── __init__.py # 包初始化文件
│ ├── main.py # FastAPI 入口
│ ├── 📁 api/ # API 路由层
│ ├── 📁 common/ # 通用模块
│ ├── 📁 config/ # 应用配置
│ ├── 📁 core/ # 核心业务逻辑
│ ├── 📁 mcp/ # MCP 协议实现
│ ├── 📁 models/ # 数据模型定义
│ ├── 📁 services/ # 业务服务层
│ └── 📁 utils/ # 工具函数
├── 📁 config/ # 全局配置文件
├── 📁 data/ # 数据存储
├── 📁 deploy/ # 部署配置
├── 📁 docs/ # 文档目录
├── 📁 logs/ # 日志文件
├── 📁 scripts/ # 脚本工具
├── 📁 tests/ # 测试用例
├── 📁 tools/ # 开发工具
├── Dockerfile # 容器构建文件
├── Dockerfile.mcp # MCP 服务容器
├── docker-compose.yml # 本地开发环境
├── env.example # 环境变量模板
├── LICENSE # 开源许可证
├── pyproject.toml # Python 项目配置
├── pytest.ini # 测试配置
├── README.md # 项目说明
└── requirements.txt # Python 依赖
🧠 AI 能力:
- 📊 时间序列分析: LSTM, ARIMA, Prophet
- 🔍 异常检测: Isolation Forest, LOF
- 🎯 分类预测: Random Forest, XGBoost
- 📈 回归分析: Linear, Polynomial, SVR
- 🕸️ 知识图谱: Neo4j, NetworkX
- 📝 NLP 处理: BERT, Word2Vec
🤝 贡献指南 (Contributing Guide)
🌟 我们欢迎所有形式的贡献！
🚀 快速开始贡献
📝 代码贡献流程 |
🎯 贡献类型
|
📋 贡献规范
💻 代码规范
Go 后端代码规范
// ✅ 推荐的代码风格
func (s *UserService) CreateUser(ctx context.Context, req *CreateUserRequest) (*User, error) {
// 参数验证
if err := req.Validate(); err != nil {
return nil, fmt.Errorf("invalid request: %w", err)
}
// 业务逻辑
user := &User{
Name: req.Name,
Email: req.Email,
}
return s.repo.Create(ctx, user)
}
TypeScript 前端代码规范
// ✅ 推荐的代码风格
interface UserCreateRequest {
name: string;
email: string;
}
const createUser = async (request: UserCreateRequest): Promise<User> => {
const response = await api.post('/users', request);
return response.data;
};
📝 提交信息规范
使用 Conventional Commits 规范:
<type>(<scope>): <description>
[optional body]
[optional footer]
提交类型:
feat: 新功能fix: Bug 修复docs: 文档更新style: 代码格式调整refactor: 重构代码perf: 性能优化test: 测试相关ci: CI/CD 配置
示例:
git commit -m "feat(k8s): add pod auto-scaling feature"
git commit -m "fix(auth): resolve login timeout issue"
git commit -m "docs(readme): update installation guide"
📄 开源许可 (License)
本项目基于 MIT License 开源
这意味着您可以自由使用、修改、分发此项目，包括商业用途
📋 许可证要点
✅ 允许的操作
✨ 商业使用: 可用于商业项目 🔄 修改: 可以修改源代码 📦 分发: 可以分发原版或修改版 🔒 私人使用: 可以私人使用 📄 专利使用: 获得专利使用权
❗ 必须遵循的条件
📝 许可证声明: 必须包含许可证副本 ©️ 版权声明: 必须保留版权声明
⚠️ 免责声明
🚫 无责任: 作者不承担任何责任 🛡️ 无保证: 软件按"现状"提供，无任何保证
📞 联系与支持 (Contact & Support)
🌐 多渠道联系方式
📧 邮件联系
🕒 24小时内回复 |
💬 微信交流
微信号: GoSimplicity ⚠️ 添加请备注 "AI-CloudOps" |
🐛 问题反馈
🚀 快速响应技术问题 |
📱 微信群二维码
加入我们的技术交流群，与更多开发者一起讨论
🌟 Star History
📈 项目增长轨迹
感谢每一位给我们点 Star 的开发者！
🙏 致谢 (Acknowledgements)
💖 特别感谢
感谢所有为 AI-CloudOps 做出贡献的开发者和用户！
正是因为你们的支持和贡献，这个项目才能不断进步和完善。
🔧 技术支持Go 生态系统 Vue 生态系统 Kubernetes 社区 开源社区 |
📚 灵感来源Grafana Prometheus Istio ArgoCD |
🛠️ 基础设施GitHub Actions Docker Hub DigitalOcean Cloudflare |
🎨 设计资源Ant Design Vue Heroicons Unsplash Figma |
🎯 让我们一起
共同构建更智能的云原生运维未来！
🎉 感谢您阅读到这里！如果觉得项目有用，请给我们一个 Star ⭐
Documentation
¶
Overview ¶
Package main provides code generation directives for AI-CloudOps project.
This file contains all go:generate directives for the project. Run `go generate` in the project root to execute all generation tasks.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.