# 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` |
| 出错风险 | 高（文件名易写错） | 低（版本号自动提取） |