- 新增 frontend/public/favicon.ico (4 size: 16/32/48/64) - index.html .ico 引用调整到 .svg 前面(兼容旧浏览器) - README.md 全量更新:Kubernetes 完整命令列表 + K8s 管理亮点 - run.sh 主入口添加 k8s 别名(向后兼容) - aiops-development skill 更新部署命令和 favicon 文档
175 lines
6.7 KiB
Markdown
175 lines
6.7 KiB
Markdown
# AIOps 智能运维平台
|
||
|
||
> 企业级云原生智能运维解决方案,集成资产管理、Kubernetes 管理、应用发布、监控告警、自动化运维和 AI 智能分析。
|
||
|
||
## 技术栈
|
||
|
||
### 前端
|
||
- React 19 + TypeScript + Vite
|
||
- Tailwind CSS + shadcn/ui
|
||
- Zustand (状态管理) / TanStack Query (数据获取)
|
||
- Recharts (图表) / Lucide React (图标)
|
||
- CodeMirror 6 (YAML 编辑器) / xterm.js (WebSocket 终端)
|
||
|
||
### 后端
|
||
- Go 1.24 / Gin Web Framework
|
||
- GORM (ORM) / MySQL 8.0 / Redis 7
|
||
- JWT 认证 / Zap 日志 / Viper 配置
|
||
- WebSocket (Gorilla) / PTY 终端 (creack/pty)
|
||
- 自研轻量 Kubernetes HTTP 客户端(channel.k8s.io WebSocket 协议)
|
||
|
||
### Agent
|
||
- Go 1.24 静态编译 (CGO_ENABLED=0)
|
||
- /proc 指标采集 + 远程任务双通道
|
||
- 支持 linux-amd64 / linux-arm64 / darwin-arm64
|
||
|
||
## 三种部署方式
|
||
|
||
| 方式 | 命令 | 架构 | 适用场景 |
|
||
|------|------|------|----------|
|
||
| **① 独立二进制** | `./run.sh build` → `./run.sh binary` | 单文件,前后端一体 | 无 Docker/K8s 环境 |
|
||
| **② Kubernetes** | `./run.sh kubernetes deploy` | Embed 单容器 + MySQL/Redis StatefulSet | 生产集群,devops 命名空间 |
|
||
| **③ Docker Compose** | `./run.sh docker up` | 4 容器 (MySQL+Redis+Backend+Nginx) | 单机生产,开发/测试 |
|
||
|
||
统一入口 `./run.sh`,详见 `./run.sh help`。
|
||
|
||
## 快速开始
|
||
|
||
### Docker Compose 部署
|
||
|
||
```bash
|
||
# 一键启动全部服务 (MySQL + Redis + 后端 + Nginx 前端)
|
||
./run.sh docker up
|
||
|
||
# 访问
|
||
# 前端: http://localhost:80
|
||
# 后端: http://localhost:8080
|
||
# 健康检查: http://localhost:8080/health
|
||
|
||
# 管理
|
||
./run.sh docker logs # 查看日志
|
||
./run.sh docker ps # 容器状态
|
||
./run.sh docker down # 停止
|
||
```
|
||
|
||
### Kubernetes 部署
|
||
|
||
```bash
|
||
# 一键部署到 devops 命名空间
|
||
./run.sh kubernetes deploy
|
||
|
||
# 访问: http://<NODE_IP>:30080
|
||
|
||
# 运维
|
||
./run.sh kubernetes status # 资源状态
|
||
./run.sh kubernetes logs # 应用日志
|
||
./run.sh kubernetes upgrade # 重新构建 + 滚动更新
|
||
./run.sh kubernetes exec # 进入容器 Shell
|
||
./run.sh kubernetes mysql # 进入 MySQL CLI
|
||
./run.sh kubernetes redis # 进入 Redis CLI
|
||
./run.sh kubernetes scale 3 # 扩缩容
|
||
./run.sh kubernetes port-forward # 端口转发到本机
|
||
./run.sh kubernetes delete # 删除所有 K8s 资源(保留 PVC)
|
||
./run.sh kubernetes build # 仅构建 embed 镜像
|
||
```
|
||
|
||
### 独立二进制部署
|
||
|
||
```bash
|
||
# 编译(前端自动嵌入)
|
||
./run.sh build
|
||
|
||
# 启动
|
||
./backend/aiops # 默认 SQLite, 端口 8080
|
||
./backend/aiops --port 9090 # 自定义端口
|
||
./backend/aiops --db-driver mysql --db-host ... # MySQL 模式
|
||
```
|
||
|
||
### 本地开发
|
||
|
||
```bash
|
||
./run.sh dev # 前端 :5173 + 后端 :8080 (热重载)
|
||
|
||
# 单独启动
|
||
cd frontend && npm run dev
|
||
cd backend && go run ./cmd/
|
||
```
|
||
|
||
### Agent 构建
|
||
|
||
```bash
|
||
./run.sh build agent # 交叉编译 Agent (amd64+arm64)
|
||
|
||
# 验证
|
||
./agent/bin/aiops-agent-linux-amd64 version
|
||
./agent/bin/aiops-agent-linux-amd64 output -top-n 3 # Zabbix 风格指标输出
|
||
```
|
||
|
||
### 默认账号
|
||
|
||
- 用户名: `admin`
|
||
- 密码: `123456`
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
aiops/
|
||
├── frontend/ # 前端 (React + TypeScript)
|
||
│ ├── src/components/ # dashboard/server/kubernetes/monitor/deploy/aiops...
|
||
│ ├── src/services/ # API + HTTP 封装
|
||
│ ├── src/store/ # Zustand 状态管理
|
||
│ └── Dockerfile # nginx:alpine 镜像
|
||
│
|
||
├── backend/ # 后端 (Go + Gin)
|
||
│ ├── cmd/ # 入口 (main + embed + seed + static/)
|
||
│ ├── internal/api/ # handlers / middleware / routes
|
||
│ ├── internal/models/ # GORM 数据模型
|
||
│ ├── pkg/ # 公共包 (database/kubernetesclient/remoteexec/toolinstaller)
|
||
│ └── Dockerfile # 3 阶段构建 (Go build → Agent → Alpine Runtime)
|
||
│
|
||
├── agent/ # 监控 Agent
|
||
│ ├── collector/ # /proc 指标采集
|
||
│ ├── task/ # 远程任务执行
|
||
│ └── reporter/ # HTTP 上报
|
||
│
|
||
├── deploy/kubernetes/ # Kubernetes 部署清单
|
||
│ ├── namespace.yaml # devops 命名空间
|
||
│ ├── secret.yaml # 密钥
|
||
│ ├── configmap.yaml # 配置
|
||
│ ├── mysql.yaml # MySQL StatefulSet
|
||
│ ├── redis.yaml # Redis StatefulSet
|
||
│ ├── deployment.yaml # AIOps Deployment + NodePort Service
|
||
│ └── ingress.yaml # Ingress 路由
|
||
│
|
||
├── docker-compose.yml # Docker Compose 4 容器编排
|
||
├── Dockerfile.embed # Embed 单容器镜像 (前端→后端→Agent→Runtime)
|
||
├── run.sh # 统一入口脚本
|
||
└── Makefile # 快捷命令
|
||
```
|
||
|
||
## 核心功能
|
||
|
||
| 模块 | 说明 |
|
||
|------|------|
|
||
| 仪表盘 | 成本统计、告警聚合、Top 资源、SSL 提醒、趋势图表 |
|
||
| 资产管理 | 服务器 CRUD、批量导入、WebShell、云账号/域名/账单 |
|
||
| Kubernetes 管理 | 多集群管理、Deployment 三模式编辑器(查看/可视化编辑/YAML)、Node/Pod/Service/Ingress、kubectl 终端、事件聚合、多集群对比、Namespace 管理 |
|
||
| 应用发布 | CI/CD 流水线(GitLab CI 风格可视化)、发布配置、SSH 主机 + Kubernetes 双路径部署 |
|
||
| 监控中心 | 监控大屏、主机指标(CPU/内存/磁盘/网络/进程/端口/FD)、告警规则引擎、飞书/钉钉通知 |
|
||
| 自动化运维 | 定时任务、脚本库(Shell/Python)、远程执行(Go-native SSH)、Ansible |
|
||
| AIOps 智能 | AI 智能助手(6 种 LLM)、告警分析、容量预测 |
|
||
| 资源申请 | 云服务器/应用部署申请审批 |
|
||
| 系统管理 | 用户管理、角色权限、操作审计、终端审计、凭证配置、系统设置 |
|
||
|
||
### Kubernetes 管理亮点
|
||
|
||
- **Deployment 三模式编辑器**: 查看模式 / 可视化编辑(5 Tab: 基本信息·容器信息·存储挂载·高级设置·服务路由)/ YAML 编辑(CodeMirror 6 语法高亮)
|
||
- **StatefulSet/DaemonSet**: 完整详情页(更新策略/选择器/PVC 模板/Init Containers)
|
||
- **Pod 交互**: 文件浏览器(上传/下载)、exec 终端(WebSocket channel.k8s.io)、日志流
|
||
- **集群运维**: 事件聚合看板、多集群对比(雷达图/柱状图)、Node 详情(资源分配率/污点/容器运行时)、Namespace CRUD(资源配额)
|
||
- **自研轻量客户端**: 不依赖 client-go,net/http + WebSocket 直连 K8s API
|
||
|
||
## License
|
||
|
||
MIT
|