引言:在“DevOps能力之屋(Capabilities House of DevOps)”中,华为云DevCloud提出(工程方法+最佳实践+生态)×工具平台=DevOps能力。华为云DevCloud将推出“DevOps on DevCloud”系列,针对DevOps领域场景,阐述该场景在华为云DevCloud上的实施方法与实践。
目前越来越多不同行业的企业开启了数字化转型,以提升业务敏捷性与开放合作能力,为客户或合作伙伴提供更好的体验。微服务架构(Microservices Architecture)和敏捷与DevOps成为诸多企业在数字化转型中对于应用架构和工程方法的不二选择。随着微服务架构的广泛流程,RESTful风格API也成为大势所趋。因而,对API进行持续测试成为DevOps的关注点之一。随着微服务数量规模增加、DTAP环境配置变化、软件交付周期缩短,持续测试自动化成为更为亟需解决的问题。毫不夸张地讲,没有测试自动化,微服务架构的实施对于企业更会成为一场灾难。
一谈到测试自动化,大多数团队通常将其视为纯粹的技术挑战,例如选择测试框架、确定测试工具等等。实际上,测试自动化成功的核心原则之一是测试设计(Test Design)。团队应该从一开始在测试设计上进行足够多的投入。测试设计过程始于分析测试需求。为了提升测试覆盖率,团队可以使用“业务流(Business Flow)”方法来分析需求。团队需要在业务层级(Business Level)与交互层级(Interaction Level)上对操作(Action)或数据(Data)进行抽象。因此,业界提出了关键字驱动测试(KDT,Keyword Driven Testing)或者数据驱动测试(DDT,Data Driven Testing)等方法来进行测试设计,提升测试自动化效率。
对于KDT和DDT,从其定义来讲,存在一定的区别,即什么因素对测试结果起决定性作用就是什么驱动测试。当然KDT与DDT也有联系。例如:以登录为例,首先登录由不同的Action组成(按钮点击、文本框输入等),其次将登录的用户名、密码作为变化的数据(参数化),可以只关注数据。因此,为提升复用性,在实际项目中,一般会采用混合驱动测试的方法,即融合关键字驱动测试与数据驱动测试。总而言之,测试设计需要对操作与数据进行抽象、分组等。
华为云DevCloud云测服务提供了接口测试功能,支持HTTP和HTTPS协议,并可通过参数化、自定义环境、关键字等特性支持混合驱动测试,同时将将接口测试纳入流水线进行管理,支持产品团队践行DevOps理念,为微服务架构的API保驾护航。
1 准备工作
1.1 示例应用接口
华为云DevCloud对外提供了开放API,供第三方平台进行集成。本接口测试将以华为云DevCloud项目管理服务相关API示例。华为云DevCloud的API列表请参考https://support.huaweicloud.com/devg-devcloud/devcloud_api_1000.html,接口调用方法请参考https://support.huaweicloud.com/devg-devcloud/devcloud_api_0001.html,获取Token认证的方式请参考https://support.huaweicloud.com/devg-devcloud/zh-cn_topic_0107684989.html。
1.2 创建项目
开发者可以访问华为云DevCloud(https://www.huaweicloud.com/devcloud/),登录后在首页新建项目,选择“空白项目”的Scrum或者看板之一,输入项目名称(例如:Prj4ApiHDT)即可创建项目。
在访问Prj4ApiHDT项目,并进入“测试”-“接口测试”后,就可以开展接口测试相关工作了。
2 API测试
本次API测试将覆盖一个业务流(Business Flow):获取授权令牌->创建项目->查询项目当前工作项列表->在项目中新建工作项->查询项目当前工作项列表->删除项目。
2.1 创建关键字getAuthToken
调用华为云DevCloud的开放API首先需要获取授权令牌(token),详细情况请参考“获取用户token”( https://support.huaweicloud.com/api-iam/zh-cn_topic_0057845583.html)。为了测试API的所有用例方便获取token,将创建关键字getAuthToken。
在进入“接口测试”页面后,点击“新建”,在“新建用例”页面输入名称“manageProject”等信息,并点击“确定”,用例创建成功并进入编辑用例脚本页面。
在用例“manageProject”的编辑用例脚本页面,进入“测试步骤”,新建“URL请求”,名称设置为“getAuthToken”,并输入以下信息:
-
请求:如图1所示,请求信息的方法选为“POST”,URL填为“iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens”;请求体选择“JSON”,并填写如下信息:
{
"auth": {
"identity": {
"methods": [
"password"
],
"password": {
"user": {
"name": "$${userName}",
"password": "$${password}",
"domain": {
"name": "$${domainName}"
}
}
}
},
"scope": {
"domain": {
"name": "$${domainName}"
}
}
}
}
-
检查点:来源为“响应码”,比较符为“等于(数字)”,目标值为“201”。参见图2。
-
响应提取:出参为“X-Auth-Token”,来源为“响应头”,属性为“X-Subject-Token”。参见图3。
在JSON格式的请求中,大家会发现$${domainName}、$${userName}、$${password}等3个参数。这些均为项目管理的环境参数,可以用于整个项目。如图4所示,创建了alpha、Prod等2个环境,在Prod环境中增加了3个参数,如下:
-
domainName:可以填写为账号名;
-
userNanme:可以填写IAM用户用户名;
-
password:可以填写为密码,并设置为敏感参数。
在用例“manageProject”的编辑用例脚本页面,点击“存为关键字”图标,输入关键字名称“getAuthToken”,并选择测试步骤中的“getAuthToken”。如下图所示:
进入“测试”-“接口测试”页面,我们将在测试用例的列表中看到刚才创建的关键字。
2.2 测试项目管理相关API
在用例“manageProject”的编辑用例脚本页面,可以在“测试步骤”中,将getAuthToken步骤删除,然后在“前置步骤”中,添加关键字getAuthToken。
2.2.1 “创建项目”步骤
在用例“manageProject”的编辑用例脚本页面的“测试步骤”中,新建“URL请求”, 名称设置为“createProject”,并输入以下信息:
-
请求:请求信息的方法选为“POST”,URL填为“api.devcloud.huaweicloud.com/pcedge/v1/projects”;请求头名称为“X-Auth-Token”,值为“${X-Auth-Token}”,此值为关键字getAuthToken的响应提取中的出参名称“X-Auth-Token”。请求体选择“JSON”,并填写如下信息:
{
"name": "demo1",
"description": "项目描述",
"type": "scrum",
"homepage": ""
}
-
检查点:【1】来源为“响应码”,比较符为“等于(数字)”,目标值为“200”。【2】来源为“响应体(JSON)”,属性为“status”,比较符为“等于(字符串、区分大小写)”,目标值为“success”。
-
响应提取:出参为“project_uuid”,来源为“响应体(JSON)”,属性为“result.project.project_uuid”。此参数将作为后续API接口的输入。
2.2.2 “查询工作项列表” 步骤
在用例“manageProject”的编辑用例脚本页面的“测试步骤”中,新建“URL请求”, 名称设置为“queryWorkItemList”,并输入以下信息:
-
请求:请求信息的方法选为“POST”,URL填为“api.devcloud.huaweicloud.com/pcedge/v1/projects/${project_uuid}/issues/query”;请求头名称为“X-Auth-Token”,值为“${X-Auth-Token}”,此值为关键字getAuthToken的响应提取中的出参名称“X-Auth-Token”。请求体选择“JSON”,并填写如下信息:
{
"page_num": "1",
"page_size": "15",
"query_type": "backlog",
"tracker_id": [
2,
3,
7
]
}
-
检查点:来源为“响应码”,比较符为“等于(数字)”,目标值为“200”。
2.2.3 “创建工作项”步骤
在用例“manageProject”的编辑用例脚本页面的“测试步骤”中,新建“URL请求”, 名称设置为“createWorkItem”,并输入以下信息:
-
请求:请求信息的方法选为“POST”,URL填为“api.devcloud.huaweicloud.com/mobile/v1/projects/${project_uuid}/issues”;请求头名称为“X-Auth-Token”,值为“${X-Auth-Token}”,此值为关键字getAuthToken的响应提取中的出参名称“X-Auth-Token”。请求体选择“JSON”,并填写如下信息:
{
"subject": "Item1",
"description": "工作项描述",
"type_id": 3,
"start_date": "1566809662",
"due_date": "1566896062",
"priority_id": 3,
"servity_id": 12,
"status_id": 1,
"expected_work_hours": 8
}
-
检查点:来源为“响应码”,比较符为“等于(数字)”,目标值为“200”。
2.2.4 “查询工作项列表” 步骤
在用例“manageProject”的编辑用例脚本页面的“测试步骤”中,在步骤“queryWorkItemList”上点击“复制”,并将新的步骤拖拽到createWorkItem后面。
2.2.5 测试步骤“删除项目”
在用例“manageProject”的编辑用例脚本页面的“测试步骤”中,新建“URL请求”, 名称设置为“deleteProject”,并输入以下信息:
-
请求:请求信息的方法选为“DELETE”,URL填为“api.devcloud.huaweicloud.com/pcedge/v1/projects/${project_uuid}”;请求头名称为“X-Auth-Token”,值为“${X-Auth-Token}”,此值为关键字getAuthToken的响应提取中的出参名称“X-Auth-Token”。
-
检查点:来源为“响应码”,比较符为“等于(数字)”,目标值为“200”。
2.3 测试情况分析
假如测试用例正确创建,那么执行的正常结果应该为:【1】成功创建项目;【2】项目中工作项数量为0;【3】成功创建工作项;【4】工作项数量为1;【3】成功删除项目。在此过程中如果出现失败的情况,可以查看测试用例manageProject的结果页面,进行分析。
当然,大家仔细观察测试步骤中有2步是“查询工作项列表”,可以用关键字来进行处理,供大家自行实现。
本文通过案例展示了华为云DevCloud的接口测试特性的关键能力以及使用。在实际项目中,测试场景与测试用例等将更为复杂,因此正如前文所述,产品团队应该投入精力进行测试设计,在此基础上进行测试自动化,实现持续测试。当然持续测试不可能一蹴而就,产品团队可以采用迭代的方式,持续重构优化。
华为云DevCloud作为一站式云端DevOps平台,集成华为近30年研发实践和前沿理念,面向开发者提供研发工具服务,让软件开发简单高效。现支持5人以下额度范围内,可以免费使用,并且可以预约免费的产品演示和技术交流,详情查看华为云官网
作者:伦语春秋