[#2] agent端到端测试使用域名完成

src/master/README.md

@@ -60,6 +60,12 @@ cd src/master/tests
 
 镜像构建阶段会安装 `supervisor`/`net-tools`/`inetutils-ping`/`vim` 等基础工具，并在运行前把 apt 源切换到内网镜像，方便容器内进一步运维。
 
+## 域名注册与 DNS 联动
+
+- Master 容器启动时会主动执行 `/private/argus/etc/update-dns.sh`（若存在），把自身 `/etc/resolv.conf` 指向 bind 服务提供的 DNS；随后解析 `eth0` 的 IPv4 地址并写入 `/private/argus/etc/master.argus.com`。该文件会被 bind 模块的 `argus_dns_sync.sh` 监控，用于生成 `master.argus.com` → 当前容器 IP 的 A 记录。
+- 测试与生产都需要将 bind 下发的 `update-dns.sh`、`dns.conf` 等文件挂载到 `/private/argus/etc/`。在 E2E 场景中，`tests/private/argus/etc` 会由脚本自动准备。
+- 其他模块（如 agent）在启动脚本中只需执行同一份 `update-dns.sh`，即可使用域名访问 master；若域名注册异常，agent 将无法成功上报，可据此快速定位问题。
+
 ## REST API 详解
 
 基础路径：`/api/v1/master`，全部返回 JSON。

src/master/build/start-master.sh

@@ -1,6 +1,30 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# 中文提示：确保共享目录与 DNS 相关脚本存在
+DNS_DIR="/private/argus/etc"
+DNS_SCRIPT="${DNS_DIR}/update-dns.sh"
+MASTER_DOMAIN_FILE="${DNS_DIR}/master.argus.com"
+
+mkdir -p "$DNS_DIR"
+
+if [[ -x "$DNS_SCRIPT" ]]; then
+  echo "[INFO] Running update-dns.sh before master starts"
+  # 中文提示：若脚本存在则执行，保证容器使用 bind 作为 DNS
+  "$DNS_SCRIPT" || echo "[WARN] update-dns.sh execution failed"
+else
+  echo "[WARN] DNS update script not found or not executable: $DNS_SCRIPT"
+fi
+
+# 中文提示：记录 master 当前 IP，供 bind 服务同步
+MASTER_IP=$(ifconfig | grep -A 1 eth0 | grep inet | awk '{print $2}' || true)
+if [[ -n "${MASTER_IP}" ]]; then
+  echo "current IP: ${MASTER_IP}"
+  echo "${MASTER_IP}" > "$MASTER_DOMAIN_FILE"
+else
+  echo "[WARN] Failed to detect master IP via ifconfig"
+fi
+
 WORKERS=${GUNICORN_WORKERS:-4}
 BIND_ADDR=${GUNICORN_BIND:-0.0.0.0:3000}
 EXTRA_OPTS=${GUNICORN_EXTRA_ARGS:-}

src/master/tests/docker-compose.yml

@@ -11,6 +11,7 @@ services:
     volumes:
       - ./private/argus/master:/private/argus/master
       - ./private/argus/metric/prometheus:/private/argus/metric/prometheus
+      - ./private/argus/etc:/private/argus/etc
     restart: unless-stopped
 
 networks:

src/master/tests/scripts/01_up_master.sh

@@ -6,10 +6,14 @@ TEST_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 MODULE_ROOT="$(cd "$TEST_ROOT/.." && pwd)"
 PRIVATE_ROOT="$TEST_ROOT/private"
 TMP_ROOT="$TEST_ROOT/tmp"
+DNS_ROOT="$PRIVATE_ROOT/argus/etc"
+BIND_UPDATE_SCRIPT_SRC="$(cd "$MODULE_ROOT/../bind" && pwd)/build/update-dns.sh"
+BIND_UPDATE_SCRIPT_DEST="$DNS_ROOT/update-dns.sh"
 
 mkdir -p "$PRIVATE_ROOT/argus/master"
 mkdir -p "$PRIVATE_ROOT/argus/metric/prometheus"
 mkdir -p "$TMP_ROOT"
+mkdir -p "$DNS_ROOT"
 
 # 确保上一次运行留下的容器/数据被清理
 compose() {
@@ -28,6 +32,15 @@ rm -rf "$TMP_ROOT" "$PRIVATE_ROOT"
 mkdir -p "$PRIVATE_ROOT/argus/master"
 mkdir -p "$PRIVATE_ROOT/argus/metric/prometheus"
 mkdir -p "$TMP_ROOT"
+mkdir -p "$DNS_ROOT"
+
+# 中文提示：将 bind 模块自带的 update-dns.sh 下发到共享目录，模拟实际环境
+if [[ -f "$BIND_UPDATE_SCRIPT_SRC" ]]; then
+  cp "$BIND_UPDATE_SCRIPT_SRC" "$BIND_UPDATE_SCRIPT_DEST"
+  chmod +x "$BIND_UPDATE_SCRIPT_DEST"
+else
+  echo "[WARN] bind update script missing at $BIND_UPDATE_SCRIPT_SRC"
+fi
 
 pushd "$TEST_ROOT" >/dev/null
 compose down --remove-orphans || true

src/master/tests/scripts/02_verify_ready_and_nodes_json.sh

@@ -6,6 +6,7 @@ TEST_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 PRIVATE_ROOT="$TEST_ROOT/private"
 API_BASE="http://localhost:31300"
 NODES_JSON_PATH="$PRIVATE_ROOT/argus/metric/prometheus/nodes.json"
+MASTER_DOMAIN_FILE="$PRIVATE_ROOT/argus/etc/master.argus.com"
 
 # 等待 readyz 返回 200，确保数据库初始化完成
 for _ in {1..30}; do
@@ -49,3 +50,11 @@ then
 fi
 
 echo "[INFO] nodes.json 初始状态校验通过"
+
+# 中文提示：输出 master 写入的域名文件，失败不影响测试
+if [[ -f "$MASTER_DOMAIN_FILE" ]]; then
+  MASTER_IP=$(<"$MASTER_DOMAIN_FILE")
+  echo "[INFO] master.argus.com 记录: $MASTER_IP"
+else
+  echo "[WARN] 未找到 master.argus.com 记录文件，目录=$MASTER_DOMAIN_FILE"
+fi