HttpRunnerManager 搭建使用方法

HttpRunnerManager

Design Philosophy

基于HttpRunner的接口自动化测试平台: HttpRunner, djcelery and Django_. HttpRunner手册: http://cn.httprunner.org/

Key Features

• 项目管理：新增项目、列表展现及相关操做，支持用例批量上传(标准化的HttpRunner json和yaml用例脚本)
• 模块管理：为项目新增模块，用例和配置都归属于module，module和project支持同步和异步方式
• 用例管理：分为添加config与test子功能，config定义所有变量和request等相关信息 request能够为公共参数和请求头，也可定义所有变量
• 场景管理：能够动态加载可引用的用例，跨项目、跨模快，依赖用例列表支持拖拽排序和删除
• 运行方式：可单个test，单个module，单个project，也可选择多个批量运行，支持自定义测试计划，运行时能够灵活选择配置和环境，
• 分布执行：单个用例和批量执行结果会直接在前端展现，模块和项目执行可选择为同步或者异步方式，
• 环境管理：可添加运行环境，运行用例时能够一键切换环境
• 报告查看：全部异步执行的用例都可在线查看报告，可自主命名，为空默认时间戳保存，
• 定时任务：可设置定时任务，遵循crontab表达式，可在线开启、关闭，完毕后支持邮件通知
• 持续集成：jenkins对接，开发中。。。

本地开发环境部署

1. 安装mysql数据库服务端(推荐5.7+),并设置为utf-8编码，建立相应HttpRunner数据库，设置好相应用户名、密码，启动mysql

2. 修改:HttpRunnerManager/HttpRunnerManager/settings.py里DATABASES字典和邮件发送帐号相关配置

        DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'HttpRunner', # 新建数据库名 'USER': 'root', # 数据库登陆名 'PASSWORD': 'lcc123456', # 数据库登陆密码 'HOST': '127.0.0.1', # 数据库所在服务器ip地址 'PORT': '3306', # 监听端口 默认3306便可 } } EMAIL_SEND_USERNAME = 'username@163.com' # 定时任务报告发送邮箱，支持163,qq,sina,企业qq邮箱等，注意须要开通smtp服务 EMAIL_SEND_PASSWORD = 'password' # 邮箱密码

3. 安装rabbitmq消息中间件，

4. path加入%RABBIT_HOME%\sbin        RABBIT_HOME   E:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.8地址

(1)运行命令行窗口cmd

(2)输入命令rabbitmq-plugins enable rabbitmq_management

1. 启动服务，访问：http://host:15672/#/ host即为你部署rabbitmq的服务器ip地址 username：guest、Password：guest, 成功登录便可

       service rabbitmq-server start
   

2. 修改:HttpRunnerManager/HttpRunnerManager/settings.py里worker相关配置

       djcelery.setup_loader()
       CELERY_ENABLE_UTC = True CELERY_TIMEZONE = 'Asia/Shanghai' BROKER_URL = 'amqp://guest:guest@127.0.0.1:15672//' # 127.0.0.1:15672即为rabbitmq-server所在服务器ip地址 CELERYBEAT_SCHEDULER = 'djcelery.schedulers.DatabaseScheduler' CELERY_RESULT_BACKEND = 'djcelery.backends.database:DatabaseBackend' CELERY_ACCEPT_CONTENT = ['application/json'] CELERY_TASK_SERIALIZER = 'json' CELERY_RESULT_SERIALIZER = 'json' CELERY_TASK_RESULT_EXPIRES = 7200 # celery任务执行结果的超时时间， CELERYD_CONCURRENCY = 10 # celery worker的并发数 也是命令行-c指定的数目 根据服务器配置实际更改 默认10 CELERYD_MAX_TASKS_PER_CHILD = 100 # 每一个worker执行了多少任务就会死掉，我建议数量能够大一些，默认100
    DEBUG = True 改为False
   
   在C:\Users\00\Desktop\HttpRunnerManager-master\templates的base.html修改
   

3. 命令行窗口执行pip install -r requirements.txt 安装工程所依赖的库文件

4. 命令行窗口切换到HttpRunnerManager目录 生成数据库迁移脚本,并生成表结构

5.  pip install  Celery

   是在 Django 中， 链接数据库时使用的是 MySQLdb 库，这在与 python3 的合做中就会报如下错误
   django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module: No module named 'MySQLdb'
   解决方法：在 __init__.py 文件中添加如下代码便可。 
   import pymysql
   pymysql.install_as_MySQLdb() 

6.    cd   C:\Users\00\Desktop\HttpRunnerManager-master  python manage.py makemigrations ApiManager #生成数据迁移脚本 python manage.py migrate #应用到db生成数据表
   

7. 建立超级用户，用户后台管理数据库，并按提示输入相应用户名，密码，邮箱。 如不需用，可跳过此步骤

       python manage.py createsuperuser

8. 启动服务,

       python manage.py runserver 0.0.0.0:8000
   

9. 启动worker, 若是选择同步执行并确保不会使用到定时任务，那么此步骤可忽略

       python manage.py celery -A HttpRunnerManager worker --loglevel=info  #启动worker python manage.py celery beat --loglevel=info #启动定时任务监听器 celery flower #启动任务监控后台

10. 访问：http://127.0.0.1:5555/dashboard 便可查看任务列表和状态

11. 浏览器输入：http://127.0.0.1:8000/api/register/ 注册用户，开始尽情享用平台吧

12. 浏览器输入http://127.0.0.1:8000/admin/ 输入步骤6设置的用户名、密码，登陆后台运维管理系统，可后台管理数据

生产环境uwsgi+nginx部署参考：https://www.jianshu.com/p/d6f9138fab7b

新手入门手册

一、首先须要注册一个新用户,注册成功后会自动跳转到登陆页面，正常登陆便可访问页面

二、登录后默认跳转到首页，左侧为菜单栏，上排有快捷操做按钮，当前只简单的作了项目，模块，用例，配置的统计

三、首先应该先添加一个项目，用例都是以项目为维度进行管理, 注意简要描述和其余信息能够为空, 添加成功后会自动重定向到项目列表

四、支持对项目进行二次编辑,也能够进行筛选等,项目列表页面能够选择单个项目运行，也能够批量运行，注意：删除操做会强制删除该项目下全部数据，请谨慎操做

五、当前项目能够新增模块了，以后用例或者配置都会归属模块下，必须指定模块所属的项目,模块列表与项目列表相似，故不赘述

六、新增用例，遵循HtttpRuunner脚本规范，能够跨项目，跨模块引用用例，支持拖拽排序，动态添加和删减，极大地方便了场景组织, HttpRunner用例编写很灵活，建议规范下编写方式







七、新增配置，可定义全局变量，全局hook，公共请求参数和公共headers,通常可用于测试环境，验证环境切换配置，具体用法参考HttpRunner手册

八、支持添加项目级别定时任务，模块集合的定时任务，遵循crontab表达式, 模块列表为空默认为整个项目，定时任务支持选择环境和配置
九、定时任务列表能够对任务进行开启或者关闭、删除，不支持二次更改

十、用例列表运行用例能够选择单个，批量运行，鼠标悬浮到用例名称后会自动展开依赖的用例，方便预览，鼠标悬浮到对应左边序列栏会自动收缩,只能同步运行

十一、项目和模块列表能够选择单个，或者批量运行，能够选择运行环境，配置等，支持同步、异步选择，异步支持自定义报告名称，默认时间戳命名

十二、异步运行的用例还有定时任务生成的报告均会存储在数据库，能够在线点击查看，当前不提供下载功能

1三、高大上的报告(基于extentreports实现), 能够一键翻转主题哦

其余

MockServer：https://github.com/yinquanwang/MockServer

因时间限制，平台可能还有不少潜在的bug，使用中如遇到问题，欢迎issue, 若是任何疑问好好的建议欢迎github提issue, 或者能够直接加群(628448476)，反馈会比较快