lulianqi opened a new issue, #14: URL: https://github.com/apache/dubbo-net/issues/14
### 背景 目前 DubboClientIntegrationTests 和 QueryDemo 需要预先准备的 Java Dubbo Provider、注册中心及元数据环境,才能验证客户端是否真正完成 RPC 调用。 现有 CI 已包含构建、单元测试和测试程序的容器构建,但容器运行步骤仅执行 --print-config,没有启动服务端,也没有执行真实 RPC 验证。 此前依赖个人远程环境的方式不适合作为长期 CI 基础(需要迁移该私有环境至git hub): - 环境不受每次测试控制,服务下线或网络变化会导致测试失败。 - 其他贡献者难以复现相同环境。 - 无法稳定区分环境故障与客户端回归。 ### 目标 新增独立的 GitHub Actions 集成测试 workflow,在每次任务中通过容器构建并启动两个工程需要的服务端环境,执行真实请求及结果验证,结束后自动清理。 同时提供可在本地使用、可供后续真实 RPC 测试复用的环境配置和启动入口。 不再依赖个人公网服务或预先运行的私有测试集群。 ### 实现范围 **1. 提供可重建的服务端测试环境** 环境应包含: - ZooKeeper。 - Nacos Naming / Config,以及所需元数据。 - 真正的 Java Dubbo Provider,支持对应版本的经典 Dubbo/Hessian2 和 Triple HTTP/JSON 调用。 - 两个工程依赖的测试接口,例如 EchoService、DataTypeService、OrderService、UserService。 Provider 的接口签名、返回数据、version/group、注册目录和元数据,应与现有测试契约一致。 测试 Provider 应提供可维护的源码和镜像构建方式,不能仅依赖无法重建的个人镜像或私有 JAR。Java 服务端仅用于测试,不作为客户端 NuGet 包的运行依赖。 **2. 执行两个现有工程** - 在 ZooKeeper、Nacos 两种模式下运行 DubboClientIntegrationTests。 - 在两种模式下运行 QueryDemo,验证其 QueryAsync 示例及 Native/Triple 直连调用。 - 环境地址通过参数或环境变量注入,不写死个人地址。 - 覆盖现有版本矩阵;若分阶段实施,应提供显式的版本选择,并清楚列出实际覆盖范围,不能静默跳过缺失环境。 当前 QueryDemo 使用固定的 Dubbo 3.3.6 服务配置,环境中需要提供对应 Provider。 **3. 完善成功与失败判定** - 正常请求必须断言预期返回值,不能只判断进程启动成功。 - QueryDemo 增加适合 CI 的自动验证方式;请求失败或结果不符合预期时返回非零退出码。 - 业务异常用例必须验证 Provider 返回的预期异常信息,不能将网络断开、超时等任意失败视为通过。 - 环境启动失败、元数据未就绪或无法调用 Provider 时,集成任务应明确失败,而不是跳过后报告成功。 **4. 提供可复用的环境生命周期管理** 可以使用 Docker Compose 或等效方案,统一提供: - 环境启动和初始化。 - 有超时上限的健康检查及就绪等待。 - 测试运行和结果汇总。 - 失败日志收集。 - 无论测试是否成功都执行的资源清理。 需要保证注册中心返回的 Provider 地址对测试程序可达,并处理好容器网络及端口配置。 每个 CI 任务使用隔离环境,同一任务中的测试工程可以复用该环境。后续需要发送真实请求的测试应能复用这些配置、测试服务和启动脚本。 **5. 接入独立 workflow** 建议新增 .github/workflows/integration.yml,与快速单元测试工作流分开: - 支持手动触发。 - PR 执行明确的基准组合。 - 完整版本矩阵可按成本安排到 main、定时或手动任务。 - 固定关键镜像和依赖版本。 - 不依赖个人服务器凭据或私有环境 secrets。 - 失败时上传 Provider、注册中心和客户端日志。 这里“不依赖公网测试环境”不代表构建完全离线;正常下载依赖和公共基础镜像仍可保留。 ### 验收标准 - [ ] 全新 CI runner 无需预置服务端环境即可运行。 - [ ] 开发者能使用同一套配置在本地复现测试。 - [ ] ZooKeeper/Nacos 服务发现、元数据读取和真实 RPC 调用均有验证。 - [ ] 两个工程均实际执行,而非仅构建或打印配置。 - [ ] QueryDemo 的失败能够使 CI 失败。 - [ ] 业务异常与传输故障不会混淆计为通过。 - [ ] 环境故障有明确错误、日志和超时边界。 - [ ] 测试结束后可靠清理容器及临时资源。 - [ ] 后续新增真实 RPC 测试可以复用环境。 - [ ] README 说明启动方式、覆盖矩阵及扩展测试的方法。 ### 关联事项 - Related to #4:在通用构建与单元测试之外补充真实集成测试。 - Related to #6:消除对个人公网默认环境的依赖。 - Related to #10:为端到端验证提供稳定、可复现的环境。 本任务负责长期测试基础设施,不代表既有公网调用失败的原因已经定位。建议与 #6、#10 的认领者确认分工。 -- 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]
