DolphinScheduler E2E 测试参与指南
E2E 测试的主要目的是通过模拟真实的用户场景,验证被测系统及其组件的集成性和数据完整性,从而可以扩展测试范围,确保系统的健康稳定,在一定程度上减少测试工作量和成本。简单来说,E2E 测试就是把程序当做黑盒子,以用户的视角对真实系统的访问行为进行仿真,对测试的输入(用户行为/模拟数据),看能否得到预期得到的结果。因此,社区决定为 DolphinScheduler 增加 E2E 自动化测试。
当前社区的 E2E 测试尚未达到完全覆盖,因此编写此文档,目的在于引导更多的同学参与进来。
如何寻找对应的 issue ?
当前社区把 E2E 需要测试的页面已经列出相关的 issue,主要分为 Project Management、Resource Center、DataSource、Security Center 四个页面。
贡献者可以通过 GitHub 然后搜索 apace/dolphinscheduler,然后在 issue 列表中搜索 e2e test cases
即可找到对应的任务。如下图:
在每个对应的 issue 中,我们都列出需要测试的内容和期望的结果,可以在 Description 中看见。进入当前页面之后,可以根据自身所感兴趣的选择对应的 issue,例如参与 Security Center 的测试,在对应的 issue 下留言自己所想测试的案例即可。
- Task status:若该测试已经完成,则视为 finish,作为贡献者需要寻找尚未完成的测试。
- number:测试案例的序号。
- function module:需要测试的功能模块,一个功能模块包含多个测试案例。
- test point:具体的需要测试的案例。例如页面中的按钮点击操作,页面跳转的功能。
- priority:测试案例的优先级,推荐寻找优先级高的案例。
- service:测试过程中所需要启动的服务。
- test steps:每个测试案例需要操作的测试步骤。
- expected results:所期望的测试结果。
- actual results:实际测试的结果。
- remarks:测试过程中需要的注意点。
如何编写测试代码?
在认领对应的任务之后,下一步就进入到编写代码的关键。很多同学可能对于 E2E 测试代码并不是很熟悉,因此可以参考该页面:e2e-test。
如何提交 Pull Request ?
参与开源社区的形式多种多样,其中不限于 issue、pull request 和翻译等等。在参与 E2E 测试的过程,首先要求贡献者了解简单的提交 pull request 的流程,可参考:Pull Request。