DevOps on DevCloud|如何实现应用接口的混合驱动测试

引言：在“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。

图6 使用关键字

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人以下额度范围内，可以免费使用，并且可以预约免费的产品演示和技术交流，详情查看华为云官网