aiops/deploy/kubernetes/README.md

AIOps Kubernetes 部署

AIOps 平台在 Kubernetes 上的部署清单（Go/Gin 后端 + go:embed 前端 + MySQL 8.0 + Redis 7）。

单容器架构：前端通过 go:embed 嵌入后端二进制，一个容器同时服务 API + WebSocket + SPA 静态资源，端口统一 8080。

所有资源部署在 devops 命名空间。

目录结构

文件	说明
namespace.yaml	devops 命名空间
secret.yaml	MySQL/JWT 密码（Secret）
configmap.yaml	后端 config.yaml（ConfigMap）
mysql.yaml	MySQL 8.0 StatefulSet + Headless Service + 10Gi 持久卷
redis.yaml	Redis 7 StatefulSet + Headless Service + 2Gi 持久卷
deployment.yaml	AIOps Deployment（embed 单端口 8080）+ NodePort Service (30080)
pvc-aiops-data.yaml	local 模式 PVC：sqlite3.db / redka.db 与 /app/aiops 同级
ingress.yaml	Ingress：所有流量 → aiops:8080（含 WebSocket 支持）

架构

                        NodePort:30080 / Ingress
                              │
                              ▼
                    ┌─── aiops (Deployment) ───┐
                    │  单端口 8080:              │
                    │  • API (/api/*)           │
                    │  • WebSocket (/ws/*)      │
                    │  • 前端 SPA (go:embed)    │
                    └───────────┬───────────────┘
                                │
                 ┌──────────────┼──────────────┐
                 ▼                             ▼
           MySQL 8.0                    Redis 7
         (StatefulSet)               (StatefulSet)
         mysql:3306                  redis:6379
         10Gi PV                     2Gi PV

快速部署

方式一：run.sh 一键部署（推荐）

# 构建镜像 + 部署全部资源
./run.sh kubernetes deploy

# 查看状态
./run.sh kubernetes status

# 查看日志
./run.sh kubernetes logs

# 指定版本滚动更新
./run.sh kubernetes upgrade v1.5.0

# 构建并推送 Docker Hub
./run.sh kubernetes push v1.5.0

# 清理
./run.sh kubernetes delete

镜像仓库：lghost/aiops:<tag>（由 ./run.sh release 或 kubernetes build 构建注入版本号）。

方式二：手动 kubectl

cd deploy/kubernetes

kubectl apply -f namespace.yaml
kubectl apply -f secret.yaml
kubectl apply -f configmap.yaml
kubectl apply -f pvc-aiops-data.yaml
kubectl apply -f mysql.yaml
kubectl apply -f redis.yaml

kubectl -n devops rollout status statefulset/mysql
kubectl -n devops rollout status statefulset/redis

# 构建镜像（Mac/Linux 均可，按 TARGETARCH 自动选架构）
cd ../..
./run.sh kubernetes build v1.5.0

kubectl apply -f deploy/kubernetes/deployment.yaml
kubectl -n devops rollout status deployment/aiops

kubectl apply -f deploy/kubernetes/ingress.yaml   # 可选

访问

# NodePort 方式（推荐 /version，无 DB 强依赖）
curl http://<NODE_IP>:30080/version

# 或配置 Ingress host
echo "<INGRESS_IP>  aiops.local" | sudo tee -a /etc/hosts
# 浏览器: http://aiops.local

常用运维命令

# 查看所有资源
kubectl -n devops get all,pvc,configmap,secret

# 查看应用日志
kubectl -n devops logs -f deployment/aiops

# 进入应用容器
kubectl -n devops exec -it deployment/aiops -- bash

# 进入 MySQL
kubectl -n devops exec -it mysql-0 -- mysql -uaiops -paiops_pass_2026 aiops

# 滚动更新（换镜像 tag 后）
kubectl -n devops set image deployment/aiops aiops=lghost/aiops:v1.5.0 --record
kubectl -n devops rollout status deployment/aiops

# 查看 PVC
kubectl -n devops get pvc

配置说明

local 模式（默认 MODE=local）

• 容器内工作目录 /app，数据文件与二进制同级：
  • /app/aiops — 应用二进制（镜像内）
  • /app/sqlite3.db — SQLite（PVC 持久化）
  • /app/redka.db — 本地缓存（PVC 持久化）
• replicas 必须为 1（SQLite 不支持多副本共享）；./run.sh kubernetes scale 扩到 >1 时会自动切 MODE=release + MySQL/Redis
• 旧版 PVC 若存有 data/sqlite3.db，init 容器会自动迁移到根路径

集群凭据

项目	来源	值
MySQL 业务账号	Secret aiops-secret	用户 aiops / 密码 aiops_pass_2026 / 库 aiops
MySQL root	Secret aiops-secret	aiops_root_2026
JWT	Secret aiops-secret	aiops-jwt-secret-key-2026
Redis	无密码	db 0

⚠️ 生产环境请修改 secret.yaml 和 configmap.yaml 中的默认密码。

资源限额

组件	CPU 请求/上限	内存请求/上限
aiops	100m / 1	256Mi / 1Gi
mysql	250m / 1	512Mi / 2Gi
redis	50m / 250m	128Mi / 256Mi

清理

./run.sh kubernetes delete

# 或手动（持久卷需单独删）
kubectl delete -f deploy/kubernetes/
kubectl -n devops delete pvc --all