# hrm2
**Repository Path**: zywstart/hrm2
## Basic Information
- **Project Name**: hrm2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-11-01
- **Last Updated**: 2024-08-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
HttpRunnerManager
=================
支持python3.10,更新了主要组件，使用django4、mysql8.0、celery5、django-celery-beat、django-celery-results
=================
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数据库服务端,并设置为utf-8编码，创建相应HttpRunner数据库，设置好相应用户名、密码，启动mysql
2. 修改:HttpRunnerManager/HttpRunnerManager/settings.py里DATABASES字典和邮件发送账号相关配置
```python
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消息中间件，启动服务，访问：http://host:15672/#/ host即为你部署rabbitmq的服务器ip地址
username：guest、Password：guest, 成功登陆即可
```bash
service rabbitmq-server start
```
4. 修改:HttpRunnerManager/HttpRunnerManager/celeryconfig.py里worker相关配置
5. 命令行窗口执行pip install -r requirements.txt 安装工程所依赖的库文件
6. 命令行窗口切换到HttpRunnerManager目录 生成数据库迁移脚本,并生成表结构
```bash
python manage.py makemigrations ApiManager #生成数据迁移脚本
python manage.py migrate #应用到db生成数据表
```
7. 创建超级用户，用户后台管理数据库，并按提示输入相应用户名，密码，邮箱。 如不需用，可跳过此步骤
```bash
python manage.py createsuperuser
```
8. 启动服务,
```bash
python manage.py runserver 0.0.0.0:8000
```
9. 新版本Celery https://blog.csdn.net/u013117791/article/details/129584654
10. 使用django-celery-results
```bash
1、安装：pip install django-celery-results
2、注册：
INSTALLED_APPS = (
...,
'django_celery_results',
)
3、数据库迁移： python manage.py migrate django_celery_results
4、在django的setting.py中添加配置
CELERY_RESULT_BACKEND = 'django-db' # 使用数据库做后端
CELERY_CACHE_BACKEND = 'django-cache' # 老实说，不知道这个缓存配置到底有什么作用，但是官网推荐使用这个配置，我也就留着了
5、启动
Celery -A HttpRunnerManager worker -l info -P eventlet
```
11. 定时任务配置django-celery-beat
```bash
1、安装：pip install django-celery-beat
2、注册：
INSTALLED_APPS = (
...,
'django_celery_beat',
)
3、数据库迁移： python manage.py migrate django_celery_beat
4、启动
celery -A HttpRunnerManager beat -l info
```
12. 启动flower 任务监控
```bash
1、celery -A HttpRunnerManager flower --port-5555
```
13. 访问：http://localhost:5555 即可查看任务列表和状态
14. 浏览器输入：http://127.0.0.1:8000/api/register/ 注册用户，开始尽情享用平台吧
15. 浏览器输入http://127.0.0.1:8000/admin/ 输入步骤6设置的用户名、密码，登录后台运维管理系统，可后台管理数据
## 收集依赖
pip freeze > requirements.txt
### 生产环境uwsgi+nginx部署参考：https://www.jianshu.com/p/d6f9138fab7b
### 非Debug模式样式丢失问题处理
在setting.py 中设置
DEBUG = False # 关闭debug模式
ALLOWED_HOSTS = ['*']
在setting最后添加
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR,'static')
然后在项目目录下，执行命令，yes就可以了
python manage.py collectstatic
原文链接：https://blog.csdn.net/weixin_47649808/article/details/125949731
新手入门手册
-----------
1、首先需要注册一个新用户,注册成功后会自动跳转到登录页面，正常登录即可访问页面
2、登陆后默认跳转到首页，左侧为菜单栏，上排有快捷操作按钮，当前只简单的做了项目，模块，用例，配置的统计
3、首先应该先添加一个项目，用例都是以项目为维度进行管理, 注意简要描述和其他信息可以为空, 添加成功后会自动重定向到项目列表
4、支持对项目进行二次编辑,也可以进行筛选等,项目列表页面可以选择单个项目运行，也可以批量运行，注意：删除操作会强制删除该项目下所有数据，请谨慎操作
5、当前项目可以新增模块了，之后用例或者配置都会归属模块下，必须指定模块所属的项目,模块列表与项目列表类似，故不赘述
6、新增用例，遵循HtttpRuunner脚本规范，可以跨项目，跨模块引用用例，支持拖拽排序，动态添加和删减，极大地方便了场景组织, HttpRunner用例编写很灵活，建议规范下编写方式
7、新增配置，可定义全局变量，全局hook，公共请求参数和公共headers,一般可用于测试环境，验证环境切换配置，具体用法参考HttpRunner手册
8、支持添加项目级别定时任务，模块集合的定时任务，遵循crontab表达式, 模块列表为空默认为整个项目，定时任务支持选择环境和配置
9、定时任务列表可以对任务进行开启或者关闭、删除，不支持二次更改
10、用例列表运行用例可以选择单个，批量运行，鼠标悬浮到用例名称后会自动展开依赖的用例，方便预览，鼠标悬浮到对应左边序列栏会自动收缩,只能同步运行
11、项目和模块列表可以选择单个，或者批量运行，可以选择运行环境，配置等，支持同步、异步选择，异步支持自定义报告名称，默认时间戳命名
12、异步运行的用例还有定时任务生成的报告均会存储在数据库，可以在线点击查看，当前不提供下载功能
13、高大上的报告(基于extentreports实现), 可以一键翻转主题哦
### 其他
MockServer：https://github.com/yinquanwang/MockServer
因时间限制，平台可能还有很多潜在的bug，使用中如遇到问题，欢迎issue,
如果任何疑问好好的建议欢迎github提issue, 或者可以直接加群(628448476)，反馈会比较快
### 分支说明
master：基于httprunner1.5
panda62：基于master修复部分问题
hrm4：基于httprunner4.3（依赖pytest）（数据不兼容其他分支）
hrm4-newui：基于hrm4换了UI库，支持api管理，用例调试，用例引用api，环境变量配置，全局配置等，但目前不支持定时任务和测试套件(数据不兼容其他分支)