M1 自拆解简报 · 入口级交付

[JIAQIA]

M1 自拆解简报 · data-foundation（数据底座 / Connector SPI）

粗粒度里程碑简报。只读本简报 + 本仓代码即可自拆子任务并自验收，无需问人。
上位总纲：主仓 docs/milestones/M1-单命名空间端到端贯通.md。

0. 一句话目标

保持 Connector SPI / ConnectorController 可用、改正端口冲突、可容器化入单 ns。

1. 起点 · 代码现状

• 栈：Java17 / Spring Boot 3.3.5 / Maven 多模块（connector-spi / jdbc / dialects / ingest / app）。
• 已有（真实脚手架）：Connector SPI + ConnectorController（列连接器/方言）在 app/；/actuator/health；契约 TCK（SPI 内部概念）。本地 docker-compose.local.yml（PG + MinIO + app，需 GH_PACKAGES_USER/TOKEN 拉 libs）。
• ⚠️ 端口冲突源：app/src/main/resources/application.yml 硬编码 server.port: 8080；compose 映射 app 8080:8080、MinIO 9000:9000（与 privacy node-mock 旧 9000 冲突，node-mock 已让位）。

2. 范围边界

• ✅ M1：ConnectorController 绿 + 端口改 8084 + 容器化 + 镜像。
• ⛔ 不做：真实 SeaTunnel/Flink-CDC/Paimon 接入、信创方言全量(达梦/金仓经 SPI)的生产化。

3. 工作项 & 拆分指引

WP1 端口规整（消除 8080 冲突）

• 要达成：app/.../application.yml server.port: 8080 → ${SERVER_PORT:8084}，加 management.server.port: ${MANAGEMENT_SERVER_PORT:9084}；compose 改 8084:8084。

WP2 入口级达标

• ConnectorController 在单 ns 返回 200（列出已注册连接器/方言）；readiness 绿；CI 推 ghcr.io/hashmatrixdata/data-foundation:<semver>。
• 可拆：- [ ] 端口 env 化 - [ ] compose/Dockerfile 对齐 8084 - [ ] CI 镜像。

4. 关键参考

• 架构：docs/architecture/03-技术选型.md（信创双轨/Connector SPI）；现有 ConnectorController。

5. 依赖 & 约束

• 依赖：PG（共享）、MinIO（9000/9001）、libs-java（GH Packages PAT）；Doris 与 tools-bi 共享。端口 8084/9084。受 D5 约束。

6. 完成判据

• server.port 改 8084、management 9084，冲突消除
• ConnectorController + actuator 绿；镜像入 ghcr；红线自检过

[JIAQIA]

拆分 roll-up（#3 → 子项映射）

本 Story 拆为 3 个 sub-issue（内部草稿编号 ST1/ST2/ST3 → 真实 issue 号，正文已统一改用 #N 互指）：

子项	标题	LOC	可独立 ship	依赖
#4	端口基线 + 容器对齐（8084/9084）	~15–20	✅	blocks #6
#5	CI 镜像发布到 ghcr（semver + push）	~20–25	✅	与 #4 正交，可并行
#6	入口级 HTTP 集成测试（末端守护）	~40–50	❌	blocked-by #4

依赖图

#4 (端口+容器对齐) ──→ #6 (HTTP 入口级集成测试 · 末端守护)

#5 (CI 镜像发布) ──────   // 正交 CI 交付，与 #4 并行，自验证

父级完成判据 ← 子项映射（§6）

• 「server.port 改 8084、management 9084、冲突消除」→ 端口基线 + 容器对齐（8084/9084） #4
• 「ConnectorController + actuator 绿」→ 端口基线 + 容器对齐（8084/9084） #4（docker compose 冒烟）+ 入口级 HTTP 集成测试（末端守护 · 8084 业务口 / 9084 管理口） #6（HTTP/端口分离自动化守护）
• 「镜像入 ghcr」→ CI 镜像发布到 ghcr（semver + push） #5（受 D5 约束：子仓交付 image）
• 「红线自检过」→ 各子项 PR 自检（横切）

关键切刀依据

设 management.server.port: 9084 后 /actuator/** 从 8084 迁到 9084，故 application.yml + compose + Dockerfile + README 为运行时耦合原子单元（必要打包为 #4），分刀会留「actuator 已搬 9084 但探针仍打 8080 → 容器 unhealthy」破损中间态。#6 补的是当前缺失的 HTTP / 管理端口分离层自动化守护（现有 ConnectorControllerTest 仅直调方法、不走 HTTP）。

并行建议：#4 与 #5 可并行起跑，二者落地后再驱动 #6。

[JIAQIA]

✅ 入口级交付完成 —— 三个子项全部 merge 到 main，sub-issue 进度 3/3（100%）

子项	交付	commit
#4 端口基线 + 容器对齐	server.port=8084 / management.server.port=9084，actuator 独立管理口，Dockerfile/compose 探针对齐	1548683
#5 CI 镜像发布到 ghcr	build job 解析 project.version → image job 提权 packages:write、tag :<版本>+:<short-sha>、仅 main push；并把构建期 token 加固为 BuildKit secret	551a073
#6 入口级 HTTP 集成测试	EntryPointHttpTest 真起容器走 HTTP，守护「业务口 8084 出 API / 管理口 9084 出 actuator readiness、二者分离」	c11151f

验证：main 上 CI 全绿；ghcr.io/hashmatrixdata/data-foundation:<版本>+:<short-sha> 已发布（image job success）；mvn -s ci/settings.xml verify 全模块测试通过；每项均经隔离 code-reviewer 子代理 APPROVE。

遗留（不阻塞，已登记，到点再做）：

• ghcr package 默认 private —— M1 单 namespace 内消费需把 package 设 public 或配 imagePullSecret（read:packages）。
• [W3] fork PR 跨仓拉 parent 鉴权（PACKAGES_READ_TOKEN 对 fork 不可见）。
• [W5] 项目脱离 SNAPSHOT 转 release 后，:<版本> 不应再作可覆盖浮动 tag。
• 下游：主仓 Helm chart 消费镜像钉不可变 :<short-sha>（D5：主仓 owns charts）。

本 tracking issue 完结。