From aac15122e51da8250d1079ed21fff11364db8cb9 Mon Sep 17 00:00:00 2001 From: "Logan.Li" Date: Fri, 26 Jun 2026 19:08:10 +0800 Subject: [PATCH] =?UTF-8?q?chore(deploy):=20=E5=88=A0=E9=99=A4=E5=BA=9F?= =?UTF-8?q?=E5=BC=83=20nginx=20=E9=85=8D=E7=BD=AE=E5=B9=B6=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=E9=83=A8=E7=BD=B2=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移除 deploy/nginx/（旧前后端分离方案已无引用） - 重写 deploy/README.md 对齐 embed 三种部署方式 - 更新 deploy/kubernetes/README.md（lghost/aiops 镜像与 release 命令） --- deploy/README.md | 143 +++++++++++++++++++----------------- deploy/kubernetes/README.md | 31 ++++---- deploy/nginx/default.conf | 57 -------------- 3 files changed, 92 insertions(+), 139 deletions(-) delete mode 100644 deploy/nginx/default.conf diff --git a/deploy/README.md b/deploy/README.md index d16d968..23b0a70 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -1,107 +1,114 @@ -# AIOps 三种部署方式 +# AIOps 部署资源 + +本目录存放**运维部署清单**（与 `frontend/src/components/deploy/` 应用发布模块无关）。 + +## 目录结构 + +``` +deploy/ +├── kubernetes/ # K8s 清单（./run.sh kubernetes 使用） +│ ├── namespace.yaml +│ ├── secret.yaml +│ ├── configmap.yaml +│ ├── mysql.yaml / redis.yaml +│ ├── deployment.yaml # embed 单容器，镜像 lghost/aiops: +│ ├── ingress.yaml +│ └── README.md +└── binary/ + └── install.sh # 裸机 systemd 安装脚本（可选） +``` + +> 已移除 `deploy/nginx/`：旧版前后端分离 Nginx 容器方案已废弃，统一 embed 单端口 8080。 + +--- ## 部署方式对比 -| 方式 | 适用场景 | 优点 | 缺点 | -|------|---------|------|------| -| **Docker Compose（双容器）** | 生产环境 | 前后端分离，nginx 高性能 | 需要 4 个容器 | -| **Docker Compose（embed 单容器）** | 快速部署 | 1 个容器搞定，无需 nginx | 静态文件性能稍弱 | -| **二进制部署** | 无 Docker 环境 | 一个文件 + systemd | 需要自行管理 MySQL/Redis | -| **Kubernetes** | K8s 集群 | 标准化编排，弹性伸缩 | 需要 K8s 集群 | +| 方式 | 命令 | 架构 | +|------|------|------| +| **Docker Compose** | `./run.sh docker up` | MySQL + Redis + AIOps embed（3 容器，:8080） | +| **独立二进制** | `./run.sh build` → `./aiops` | 单文件 embed，项目根目录 | +| **Kubernetes** | `./run.sh kubernetes deploy` | embed 单 Pod + MySQL/Redis StatefulSet | +| **发版推送** | `./run.sh release v1.5.0` | 二进制 + `lghost/aiops:v1.5.0` 镜像 | + +详见 [docs/deployment.md](../docs/deployment.md)。 --- -## 方式一：Docker Compose（双容器，当前默认） +## 一、Docker Compose（推荐单机） ```bash -# 开发机（75） -cd /srv/aiops -make docker-up # 构建并启动 +./run.sh docker up +./run.sh docker up v1.5.0 # 指定版本 -# 生产机（150） -cd /srv/aiops && git pull -make docker-up +# 访问 +http://localhost:8080 +http://localhost:8080/version ``` -架构：nginx(:80) → backend(:8080) + MySQL + Redis +连接外部 MySQL/Redis 时使用根目录 `docker-compose.k8s.yml`。 --- -## 方式二：Docker Compose embed 单容器 +## 二、独立二进制（无 Docker） -前端通过 Go `//go:embed` 嵌入后端二进制，不需要 nginx 容器。 +### 本机构建 ```bash -cd /srv/aiops -docker-compose -f docker-compose.embed.yml up -d --build -# 或 -make docker-embed +./run.sh build tag v1.5.0 +./aiops version +./run.sh binary upgrade # 本机后台启动 ``` -架构：aiops-app(:80→:8080) + MySQL + Redis（3 个容器） - ---- - -## 方式三：二进制部署（无 Docker） - -### 在开发机构建 +### 远程 Linux 服务器（systemd） ```bash -cd /srv/aiops -make build-binary -# 生成 ./aiops 单二进制（~30MB，前端已嵌入） -``` +# 1. 在 Linux 上构建，或从 CI 拷贝 linux/amd64 二进制 +scp ./aiops deploy/binary/install.sh root@:/tmp/ -### 在目标服务器部署 +# 2. 安装 +ssh root@ 'cd /tmp && bash install.sh install' -```bash -# 传两个文件到目标服务器 -scp aiops deploy/binary/install.sh root@:/tmp/ - -# 安装（自动创建 systemd 服务 + 默认配置） -ssh root@ -cd /tmp && bash install.sh install - -# 修改数据库配置 +# 3. 配置并启动 vim /opt/aiops/config.yaml - -# 启动 systemctl start aiops +systemctl status aiops ``` -### 管理 - -```bash -systemctl start aiops # 启动 -systemctl stop aiops # 停止 -systemctl restart aiops # 重启 -systemctl status aiops # 状态 -journalctl -u aiops -f # 日志 -``` - -架构：aiops 二进制 + systemd（端口 8080 同时服务 API 和前端） - -> 前提：目标服务器需已安装 MySQL 8.0 + Redis 7 +> Mac 上 `./run.sh build` 产出 darwin 二进制，不能直接在 Linux 运行。Linux 部署请用 Docker 镜像或在 Linux 上编译。 --- -## 方式四：Kubernetes 部署 +## 三、Kubernetes ```bash -cd /srv/aiops -kubectl apply -f deploy/kubernetes/ +# 一键部署（构建镜像 + apply 全部清单） +./run.sh kubernetes deploy +./run.sh kubernetes deploy v1.5.0 + +# 滚动更新 + 推送 Docker Hub +./run.sh release v1.5.0 +./run.sh kubernetes upgrade v1.5.0 + +# 运维 +./run.sh kubernetes status +./run.sh kubernetes logs +./run.sh kubernetes delete ``` -详见 [deploy/kubernetes/README.md](../kubernetes/README.md) +清单目录：`deploy/kubernetes/` +默认镜像：`lghost/aiops:`，NodePort `30080`。 + +详见 [kubernetes/README.md](./kubernetes/README.md)。 --- ## 快速选择 -| 环境 | 推荐方式 | -|------|---------| -| 开发测试（75） | 方式一 docker-compose | -| 生产环境（150） | 方式一 docker-compose | -| 客户现场快速演示 | 方式二 embed 单容器 | -| 内网无 Docker 服务器 | 方式三 二进制部署 | -| K8s 集群 | 方式四 Kubernetes | +| 环境 | 推荐 | +|------|------| +| 本地开发 | `./run.sh dev` | +| 单机演示/测试 | `./run.sh docker up` | +| 无 Docker 的 Linux | `./aiops` + `deploy/binary/install.sh` | +| K8s 集群 | `./run.sh kubernetes deploy` | +| 版本发布 | `./run.sh release v1.x` | \ No newline at end of file diff --git a/deploy/kubernetes/README.md b/deploy/kubernetes/README.md index 676ec0f..bb9830f 100644 --- a/deploy/kubernetes/README.md +++ b/deploy/kubernetes/README.md @@ -54,46 +54,48 @@ AIOps 平台在 Kubernetes 上的部署清单（Go/Gin 后端 + go:embed 前端 # 查看日志 ./run.sh kubernetes logs -# 更新（重新构建镜像 + 滚动更新） -./run.sh kubernetes upgrade +# 指定版本滚动更新 +./run.sh kubernetes upgrade v1.5.0 + +# 构建并推送 Docker Hub +./run.sh kubernetes push v1.5.0 # 清理 ./run.sh kubernetes delete ``` +镜像仓库：`lghost/aiops:`（由 `./run.sh release` 或 `kubernetes build` 构建注入版本号）。 + ### 方式二：手动 kubectl ```bash cd deploy/kubernetes -# 1. 全量部署（文件按序: namespace → secret → configmap → mysql → redis → deployment） 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 -# 2. 等待数据库就绪 kubectl -n devops rollout status statefulset/mysql kubectl -n devops rollout status statefulset/redis -# 3. 构建镜像（在本地） +# 构建镜像（Mac/Linux 均可，按 TARGETARCH 自动选架构） cd ../.. -docker build -f Dockerfile.embed -t aiops:embed . +./run.sh kubernetes build v1.5.0 -# 4. 部署应用 -kubectl apply -f deployment.yaml +kubectl apply -f deploy/kubernetes/deployment.yaml kubectl -n devops rollout status deployment/aiops -# 5. Ingress（按需修改 host） -kubectl apply -f ingress.yaml +kubectl apply -f deploy/kubernetes/ingress.yaml # 可选 ``` ## 访问 ```bash -# NodePort 方式 -curl http://:30080/health +# NodePort 方式（推荐 /version，无 DB 强依赖） +curl http://:30080/version # 或配置 Ingress host echo " aiops.local" | sudo tee -a /etc/hosts @@ -115,8 +117,9 @@ kubectl -n devops exec -it deployment/aiops -- bash # 进入 MySQL kubectl -n devops exec -it mysql-0 -- mysql -uaiops -paiops_pass_2026 aiops -# 滚动更新（重新构建镜像后） -kubectl -n devops rollout restart deployment/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 diff --git a/deploy/nginx/default.conf b/deploy/nginx/default.conf deleted file mode 100644 index aab52fa..0000000 --- a/deploy/nginx/default.conf +++ /dev/null @@ -1,57 +0,0 @@ -server { - listen 80; - server_name _; - - root /usr/share/nginx/html; - index index.html; - - gzip on; - gzip_vary on; - gzip_min_length 1024; - gzip_types text/plain text/css application/json application/javascript text/xml application/xml image/svg+xml; - - # HTML 不缓存 — 确保每次加载最新 JS bundle - location ~* \.html$ { - add_header Cache-Control "no-cache, no-store, must-revalidate"; - add_header Pragma "no-cache"; - add_header Expires "0"; - try_files $uri =404; - } - - # SPA 前端路由 - location / { - try_files $uri $uri/ /index.html; - } - - # 静态资源长缓存（Vite 已做 content hash） - location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { - expires 1y; - add_header Cache-Control "public, immutable"; - } - - # API 反向代理 - location /api/ { - proxy_pass http://backend:8080; - proxy_http_version 1.1; - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection "upgrade"; - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; - proxy_read_timeout 86400; - } - - # WebSocket 反向代理 - location /ws { - proxy_pass http://backend:8080; - proxy_http_version 1.1; - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection "upgrade"; - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; - proxy_read_timeout 86400; - } -}