Forráskód Böngészése

docs(kb): 91 新增 §4.4 worker 分发与日志链路查证

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
tianyu.chu 2 hete
szülő
commit
ce57498360
1 módosított fájl, 36 hozzáadás és 1 törlés
  1. 36 1
      kb/91-重构备忘.md

+ 36 - 1
kb/91-重构备忘.md

@@ -241,4 +241,39 @@ python3 bin/datax-gc-generator.py --from hdfs --to elasticsearch \
 
 
  已查证:whoami 分流 + env.sh 外配 2026-04-21 完成(kb/92 L175);{module}/{dt}/{file}.log 统一结构
-  仍目标态(日志模块统一 kb/92 L617 待启动)
+  仍目标态(日志模块统一 kb/92 L617 待启动)
+
+---
+
+### 4.4 Worker 分发与日志链路(2026-04-23 查证)
+
+#### 4.4.1 分发位置
+
+分发在 `bin/datax-single-job-starter.sh` 这层;`multiple-*-starter.sh` 只是 for 循环调 `single`,每个 `single` 独立调 `select_worker()` 掷骰子(参数 `-random` 触发;缺省回退本机)。
+
+单次 single-job-starter 执行 **两次 ssh**:
+
+1. `generate_job_config()`(L67):`ssh <worker> python3 ${BASE_DIR}/bin/datax-job-config-generator.py ...` —— 在被选 worker 上生成 json,读的是**该 worker 本地**的 ini + `datasource/<db_type>/<env>-<实例>.ini`
+2. `run_single_datax_job()`(L267):`ssh <worker> python3 /opt/datax/bin/datax.py <json>` —— 在被选 worker 上跑 DataX JVM
+
+**含义**:所有 worker 节点必须**同路径**具备 项目代码 + `datasource/` + `/opt/datax` + Python 解释器。本项目部署的 base_dir = `/home/bigdata/release/poyee-data-warehouse/`、datasource 路径 = `/home/bigdata/release/datasource/`(项目同级)。
+
+#### 4.4.2 串行模式日志链路(默认,不加 `-parallel`)
+
+```
+idea 控制台 ← ssh ← m2 bash ← ssh ← <worker> datax.py stdout
+                      │
+                      └─ tee → ${LOG_ROOT_DIR}/datax/.../<job>.log(m2 本地文件)
+```
+
+【查证 multiple-job-starter.sh:231】`single-job-starter ... | tee "${LOG_FILE}"`:ssh 回传的 stdout 经 tee 同时写入 m2 本地日志文件 + 沿发起方 ssh 通道回到 idea 控制台。远端 DataX 日志在 idea 控制台完整可见,顺序打印。
+
+#### 4.4.3 并行模式(加 `-parallel`)
+
+【查证 multiple-job-starter.sh:240】`single-job-starter ... > "${LOG_FILE}" 2>&1 &`:每个 single 后台跑 + stdout 重定向到独立文件,**不经 tee、不回当前 shell**。
+
+- idea 控制台只看到 "所有 DataX 作业都已启动(共启动 N 个)" 一行
+- 每个任务日志落 **m2 本地** `${LOG_ROOT_DIR}/datax/.../<START_DATE>/<START_DATE>-<JOB_NAME>.log`(不分散在各 worker)
+- 进度要 `tail -f` 独立日志文件
+
+并行模式触发三连:USER=bigdata + CURRENT_HOST=RELEASE_HOST + 显式 `-parallel`,任一缺失退串行。