AlexStocks opened a new issue, #1633:
URL: https://github.com/apache/dubbo-admin/issues/1633

   ## 目标、已有资产与分层
   
   实现 [Dubbo-Go #3742 模块 5](https://github.com/apache/dubbo-go/issues/3742) 
的首批真实 Go Provider 验证,并补齐 #3792 A4/F4 的可重放 HTTP 使用指南。此任务拥有测试设施和文档,**不拥有产品修复权限**。
   
   基线:Admin `0db71b07b9d94b2f57e3ffd22af5e55e6083e63f`;Go Provider 使用正式 v3.3.0 
/ `012a247993ba63a9e9033761c85ac9ccc950c594`,不能换成 develop 后仍标称 v3.3.0。
   
   [PR #1605](https://github.com/apache/dubbo-admin/pull/1605) 已有 opt-in Java 
Dubbo/Triple 测试,使用 `RUN_DUBBO_E2E=1`。其中 Service/Handler 测试在内存中注入 
metadata、Instance 和 RPCInstance;它们能验证真实 RPC,不能证明注册中心发现。本任务复用其调用断言思路,必须明确以下三层:
   
   | 层级 | 可使用的测试替身 | 可以证明什么 |
   |---|---|---|
   | L1:Service/Handler 边界测试 | 最终 RPC 边界可替换 | 参数/错误本地契约;不得称真实 RPC |
   | L2:真实 Provider RPC | 可显式注入内存 metadata/实例 | 真实 HTTP/Service 到 Provider 
的网络调用;不得称真实发现 |
   | L3:真实发现全链路 | 不得注入 metadata/实例、替换 discovery 或 RPC | Provider → 
registry/metadata → Admin 标准认证路由 → RPC |
   
   ## 允许修改的路径
   
   - 新增 `testdata/generic-invoke/go-v330/`:**独立 Go module 和独立进程**的最小 
Provider、固定版本的 Docker/registry 配置、启动/等待/停止脚本及配置。
   - 新增 `pkg/console/service/service_generic_invoke_go_provider_e2e_test.go` 和 
`pkg/console/handler/service_generic_invoke_go_provider_e2e_test.go`,必要时提取仅供测试使用的小助手;不得修改现有
 Java 测试的通过条件。
   - 新增 `docs/generic-invoke.md` 和该 fixture 的 README;入口文档可加一条链接。
   - 新增 `testdata/generic-invoke/run-discovery-e2e.sh` 作为 L3 
的标准入口,以及同目录下的样例请求和结果记录格式;README 提供 Windows PowerShell 
等价步骤,避免只能手改脚本才能运行。运行产物写入临时目录,不提交机器日志、token 或动态结果。
   
   ## 首批工作内容
   
   1. Provider 独立 module 固定 SDK v3.3.0;Admin 使用自己实际依赖的 SDK。不同 API 
世代通过**进程边界和网络协议**交互,不在 Admin 进程内替换 SDK。
   2. 首批 registry 固定一种真实、隔离的 ZooKeeper,复用仓库已有环境惯例;明确镜像版本、metadata 配置、注册模式、Admin 
discovery/engine/store 配置和健康等待条件。普通 `go test` 不启动 Docker。
   3. 首批覆盖 Dubbo 与 Triple unary 在当前 Admin 实际暴露的默认模式下的行为;不自动扩展为所有 generic mode / 
Registry 的笛卡尔积。若某组合在这个真实 Provider 版本中不支持,记录明确错误、版本依据和阻塞项,不伪造另一协议的成功结果。
   4. Provider 方法最少提供:字符串/整数回显、声明为整数的嵌套对象回显、attachments 
回显、可受控延迟。回显必须能独立验证值和类型;测试内部允许附带请求计数,不能靠 Admin 自己发出的参数日志证明 Provider 实际收到。
   5. L2 保留字符串成功对照,测试真实 Provider 的 Dubbo/Triple 行为;L3 从标准认证入口发现实例和方法,取得真实 
signature 后构造 HTTP 请求。不能把任意 IP 填入 `instanceName` 或新增测试调用路由。
   6. Task B 的精度及 Task C 的错误分类单元断言可先开发;其未合入时标清实际 SHA/依赖。Java 业务异常跨网络路径复用 #1605 
的固定 Java 资产,若无可运行资产则记录未执行,不用 Go 的普通 error 冒充 Java GenericException。
   7. 使用指南从环境启动、认证、实例发现、方法/signature 获取写到 HTTP 请求、返回/错误解释和清理。覆盖无参、单参、单数组参数 
`args=[[1,2]]`、attachments、timeout,并只描述该实际版本已经实现的能力。
   
   ## 明确禁止
   
   - 不改 Admin 根 `go.mod` / `go.sum`,不添加全局 replace,不把 Admin SDK 降到 v3.3.0,不升级 
Provider 到 develop,不复制 SDK 源码。
   - 不修改生产 handler/service/decoder、metadata 发布/发现、认证、SDK 协议或配置中心 
governor;发现问题只做最小复现并关联原任务/独立缺陷。
   - 不把 UI Mock、手工缓存/metadata 注入、固定 signature、直接调用 SDK 或 `/test/invoke` 当成 L3 
的替代。
   - 不开启接口级发现或特殊路径适配后隐瞒实际配置;若需要显式兼容配置,作为独立的 configured 场景记录,不能覆盖 default 场景。
   - 不抓取任意业务 registry、不清空整棵 ZooKeeper 树、不复用生产服务名;只使用本次生成的 namespace/service 
key,并清理本次创建的资源。
   - 不让开关已启用但服务不可用的 E2E 静默 Skip;未启用可 Skip,但结果必须为 NOT_RUN。
   - 不用取消/timeout 的客户端观察证明 Provider 已中止工作。取消传播作为独立 observation,不能自行改 context 模型。
   
   ## 运行与证据契约
   
   新增 opt-in Go 用例统一使用 `RUN_DUBBO_GO_E2E=1`,与 Java 开关分开;用例名包含 `GenericInvoke` 和 
`GoProvider`。
   
   ```sh
   RUN_DUBBO_GO_E2E=1 go test ./pkg/console/service ./pkg/console/handler   
-run 'GenericInvoke.*GoProvider' -v -count=1 -timeout 180s
   ```
   
   PowerShell 等价命令及 **L3 启动、认证、发现和 HTTP 请求脚本的真实文件路径**必须写入交付 
README;不得只交付上面的包测试命令冒充完整发现验证。
   
   每个场景记录:Admin SHA/SDK 版本、Provider SHA/SDK 版本、registry 镜像/注册模式、协议、实际 generic 
mode/serialization、L1/L2/L3、default/configured、实际 
metadata/signature、请求、Provider 观察、断言、退出码和 PASS/FAIL/BLOCKED/NOT_RUN。token 
等凭据不进入产物。
   
   验证要求:
   
   - 整数包含 `2^53 ± 1`、int64 上下界及越界;值用无损文本比对,同时检查 Provider 所观察的目标类型。
   - 错误 signature/越界输入必须在 RPC 前失败,Provider 计数不增加;不能只检查 HTTP 文本。
   - timeout 与业务异常分别给出网络层结果;错误分类的期望依赖 Task C,不能通过放宽断言匹配任意错误。
   - 强制关闭一个 fixture 服务进行负向自检:已启用场景必须非零退出,不得报告 PASS。
   - 核查没有注入资源的 L3 能否发现真实 metadata。若命中已有 metadata revision / discovery 缺陷,关联例如 
[Dubbo-Go #3577](https://github.com/apache/dubbo-go/issues/3577) 的实际适用证据,不猜测归因。
   
   ## 完成标准与依赖
   
   - harness PR 可独立评审:可重放、失败不被吞掉、fixture 与根模块隔离、文档能由另一人执行。
   - **完整任务的成功项必须真实执行**:L2 的成功对照、L3 真实发现调用、选定协议场景均给实际结果。产品缺陷导致 
L3/某组合失败时,保留非零退出及阻塞清单,该兼容性验收项保持未完成;可先交 harness PR,不能关闭总单对应的互操作待办。
   - 前置为 #1605;最终数值/错误验收分别依赖 Task B / C,harness 搭建和基线取证可以并行。
   - 负责人:测试/集成 1 人。不得与 Task B/C 同时修改生产代码。
   
   ## 接手与提交约束
   
   - 本任务从审计总单 [Dubbo-Go #3792](https://github.com/apache/dubbo-go/issues/3792) 
拆出。首次修改前,记录目标仓库实际 Base/Head SHA,重读总单及本任务关联 PR 的当前状态;以下固定源码用于定位,不能假定接手时的 develop 
未变化。
   - 生产代码与测试 harness 的权限以本 Issue 
为准。发现超出允许范围的问题,提交最小复现和关联阻塞项;不得通过改依赖、改协议、改测试期望或隐式降级扩大范围。
   - 使用独立分支/工作区,保留其他人的修改。PR 仅关闭本子任务,不能使用 `Fixes apache/dubbo-go#3792` 或关闭 [功能总单 
#3742](https://github.com/apache/dubbo-go/issues/3742)。
   - 交付记录必须包含:实际改动路径、Base/Head SHA、完整命令、退出码、断言结果、跳过项和阻塞项。测试 PASS、产品 FAIL、环境 
BLOCKED、未执行 NOT_RUN 分开记录;不能用“命令退出 0”替代实际断言。
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to