换成单集群模式

deploy/多平台打包手册.md

@@ -0,0 +1,163 @@
+# CloudWAF 多平台打包手册
+
+本手册介绍如何使用自动化脚本完成 **Ubuntu (amd64)** + **Amazon Linux 2023 (amzn2023)** 双平台打包，最终生成包含 6 个节点包的 admin 发布包。
+
+---
+
+## 概述
+
+### 背景
+
+admin 发布包中需要包含两套节点安装包：
+- **amd64**：适用于标准 Ubuntu/Debian 服务器
+- **amzn2023**：适用于 Amazon Linux 2023 服务器
+
+### 脚本说明
+
+| 脚本 | 位置 | 用途 |
+|------|------|------|
+| `build-amzn2023.sh` | `deploy/` | 在 AWS Docker 中一键构建 3 个 amzn2023 节点包 |
+| `merge-release.sh` | `deploy/` | 将 amzn2023 包自动注入 admin zip，生成最终发布包 |
+
+### 最终产物
+
+`EdgeAdmin/dist/edge-admin-linux-amd64-v{版本号}.zip`，内含 6 个节点包：
+
+| 包名 | 平台 |
+|------|------|
+| `edge-node-linux-amd64-v{ver}.zip` | Ubuntu/Debian |
+| `edge-node-linux-amd64-amzn2023-v{ver}.zip` | Amazon Linux 2023 |
+| `edge-dns-linux-amd64-v{ver}.zip` | Ubuntu/Debian |
+| `edge-dns-linux-amd64-amzn2023-v{ver}.zip` | Amazon Linux 2023 |
+| `edge-httpdns-linux-amd64-v{ver}.zip` | Ubuntu/Debian |
+| `edge-httpdns-linux-amd64-amzn2023-v{ver}.zip` | Amazon Linux 2023 |
+
+---
+
+## 前置条件
+
+1. **两个 Docker 容器**已准备好：
+   - **Ubuntu 容器**：用于构建 admin 及标准 amd64 节点包
+   - **AWS (Amazon Linux 2023) 容器**：用于构建 amzn2023 节点包
+2. 两个容器均已挂载项目源码目录
+3. Go 编译环境已就绪（两个容器中均已配置）
+
+---
+
+## 打包流程（3 步）
+
+### 第 1 步：构建 amzn2023 节点包
+
+**在 AWS Docker 容器中执行：**
+
+```bash
+cd /项目挂载路径/deploy
+chmod +x build-amzn2023.sh
+./build-amzn2023.sh
+```
+
+脚本会自动：
+1. 构建 `edge-node`（linux/amd64/plus）
+2. 构建 `edge-dns`（linux/amd64）
+3. 构建 `edge-httpdns`（linux/amd64）
+4. 将每个包复制一份并加上 `amzn2023` 后缀
+
+**产出文件：**
+```
+EdgeNode/dist/edge-node-linux-amd64-amzn2023-v{ver}.zip
+EdgeDNS/dist/edge-dns-linux-amd64-amzn2023-v{ver}.zip
+EdgeHttpDNS/dist/edge-httpdns-linux-amd64-amzn2023-v{ver}.zip
+```
+
+### 第 2 步：构建 admin 包（含标准 amd64 节点包）
+
+**在 Ubuntu Docker 容器中执行：**
+
+```bash
+cd /项目挂载路径/EdgeAdmin/build
+./build.sh linux amd64 plus
+```
+
+此步骤与原有流程完全一致，无需任何改动。
+
+**产出文件：**
+```
+EdgeAdmin/dist/edge-admin-linux-amd64-v{ver}.zip
+```
+
+> 注意：此 zip 中已包含 3 个标准 amd64 节点包。
+
+### 第 3 步：合并生成最终发布包
+
+**在任意终端（能访问项目目录即可）中执行：**
+
+```bash
+cd /项目路径/deploy
+chmod +x merge-release.sh
+./merge-release.sh
+```
+
+脚本会自动：
+1. 检查 admin zip 和 3 个 amzn2023 zip 是否都存在
+2. 解压 admin zip
+3. 将 3 个 amzn2023 包复制到 `edge-admin/edge-api/deploy/` 目录
+4. 重新打包为最终 zip
+5. 清理临时文件
+
+**最终产出：**
+```
+EdgeAdmin/dist/edge-admin-linux-amd64-v{ver}.zip
+```
+
+---
+
+## 验证
+
+打包完成后，可以用以下命令验证最终 zip 中包含 6 个节点包：
+
+```bash
+unzip -l EdgeAdmin/dist/edge-admin-linux-amd64-v*.zip | grep "deploy/edge-"
+```
+
+预期输出（6 行）：
+```
+  ...  edge-admin/edge-api/deploy/edge-node-linux-amd64-v{ver}.zip
+  ...  edge-admin/edge-api/deploy/edge-node-linux-amd64-amzn2023-v{ver}.zip
+  ...  edge-admin/edge-api/deploy/edge-dns-linux-amd64-v{ver}.zip
+  ...  edge-admin/edge-api/deploy/edge-dns-linux-amd64-amzn2023-v{ver}.zip
+  ...  edge-admin/edge-api/deploy/edge-httpdns-linux-amd64-v{ver}.zip
+  ...  edge-admin/edge-api/deploy/edge-httpdns-linux-amd64-amzn2023-v{ver}.zip
+```
+
+---
+
+## 常见问题
+
+### Q: merge-release.sh 报 MISSING 怎么办？
+
+说明某个构建产物不存在。请确认：
+- 第 1 步（amzn2023）和第 2 步（admin）都已执行成功
+- 两个 Docker 容器挂载的是同一份项目源码目录
+
+### Q: 版本号从哪里读取？
+
+脚本自动从各组件的 `internal/const/const.go` 文件中提取 `Version` 常量，无需手动指定。
+
+### Q: 第 1 步和第 2 步的执行顺序可以换吗？
+
+可以。两步互相独立，先后顺序不影响结果。只需确保第 3 步在前两步都完成后执行。
+
+### Q: Windows 上能执行 merge-release.sh 吗？
+
+可以，需要在 Git Bash 或 WSL 中执行，并确保系统已安装 `zip` 和 `unzip` 命令。
+
+---
+
+## 流程对比
+
+| | 旧流程（手动 6+ 步） | 新流程（3 条命令） |
+|---|---|---|
+| AWS 构建 | 分别 3 次 cd + build | `./build-amzn2023.sh` |
+| Ubuntu 构建 | 不变 | 不变 |
+| 合并 | 手动解压 → 改名 → 复制 → 重新 zip | `./merge-release.sh` |
+| 出错风险 | 高（文件名易写错） | 低（版本号自动提取） |