3.0 KiB
3.0 KiB
Argus Metric 客户端发布说明（FTP）
本说明面向“发布人员”，讲清楚如何把客户端离线包发布到 FTP，供各节点通过 curl 自动安装。
目录结构（构建后）
client-YYYYMMDD/argus-metric_YYYYMMDD.tar.gz客户端离线包setup.sh客户端安装入口脚本（提供给节点用 curl 下载）publish.sh发布脚本（将上述两项与LATEST_VERSION上传到 FTP）LATEST_VERSION文本（内容为YYYYMMDD，或YYYYMMDD-rN）INSTALL_CLIENT_zh.md本地安装指南（给使用者看，不会上载到 FTP）PUBLISH_CLIENT_zh.md本说明
注意：
publish.sh/setup.sh为可执行脚本；构建脚本已保证二者具有执行权限。
前置条件
- FTP 服务已运行（默认容器：
argus-ftp），并打开端口：21、20、21100–21110（被动模式）。 - FTP 账号：默认
ftpuser / ZGClab1234!（如有更改，以实际为准）。
发布步骤（在 server 机器或能直连 FTP 的任意机器上）
- 进入发布目录：
cd client-YYYYMMDD
- 执行发布：
./publish.sh --server <FTP_HOST> --user <USER> --password '<PASS>' [--port 21]- 例如在服务端本机：
./publish.sh --server localhost --user ftpuser --password 'ZGClab1234!' --port 21
脚本会上传三类文件到 FTP 根：
setup.shargus-metric_YYYYMMDD[ -rN ].tar.gzLATEST_VERSION（内容为当前版本号）
- 发布后验证：
curl -u ftpuser:****** -I ftp://<FTP_HOST>:21/LATEST_VERSION应返回 200curl -u ftpuser:****** -fsSL ftp://<FTP_HOST>:21/LATEST_VERSION内容为版本号（如20251104）curl -u ftpuser:****** -I ftp://<FTP_HOST>:21/argus-metric_YYYYMMDD.tar.gz返回 200
节点侧使用方式（摘要）
- 首次下载用 FTP 的“IP 地址”：
curl -u ftpuser:****** -fsSL ftp://<FTP_IP>:21/setup.sh -o /tmp/setup.sh && chmod +x /tmp/setup.sh
- 执行安装：
- 必需元数据：
AGENT_ENV/AGENT_USER/AGENT_INSTANCE，以及MASTER_ENDPOINT=http://master.argus.com:3000 sudo /tmp/setup.sh --server <FTP_IP> --user ftpuser --password '******' --port 21
- 必需元数据：
- overlay 容器场景：
- 先将容器内 DNS 指向 Bind9 的 overlay IP：
echo "nameserver <BIND_OVERLAY_IP>" > /etc/resolv.conf - 然后再执行上述安装；安装后约 1–2 分钟内 DNS 即可解析
*.argus.com域名。
- 先将容器内 DNS 指向 Bind9 的 overlay IP：
常见问题
530 Access denied：用户名/密码错误或 FTP 目录无权限；请核对账号与 FTP 容器状态。Permission denied执行publish.sh：为脚本权限问题；chmod +x publish.sh。构建脚本已修复默认权限。- 被动端口不通导致失败：请开放 21100–21110。
- 客户端安装后短时
curl http://master.argus.com:3000为 000：服务冷启动或 DNS 同步延迟，等待 1–2 分钟再试。
版本与回滚
LATEST_VERSION决定客户端默认安装的版本号。- 如需回滚：将旧版本号写回
LATEST_VERSION并重新发布（或手动指定--version安装）。