# FasterRunner

**Repository Path**: guanfuchang/FasterRunner

## Basic Information

- **Project Name**: FasterRunner
- **Description**: FasterRunner 接口自动化平台服务端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 5
- **Created**: 2021-08-04
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FasterRunner 接口自动化平台服务端

> FasterRunner that depends FasterWeb

- httprunner 是一个以python语言开发的用来运行测试用例的类库[框架]。
- fasterrunner 是httprunner 自动化测试框架的web化，后端FasterRunner使用django开发，前端FasterWeb使用vue开发。

httprunner 自从2017年推出后，经历了1.x，2.x，3.x 三个大版本。

目前github上的fastrunner 都是采用 httprunner 1.x 版本。 **本项目经过二次开发后，后端已采用httprunner 3.1.4**

**httprunner 官方文档：**

https://github.com/httprunner/FasterRunner

https://docs.httprunner.org/


## Docker 部署 uwsgi+nginx模式
1. 拉取mysql5.7镜像
```
docker pull docker.io/mysql:5.7
```

2. 运行mysql容器
``` 
docker run --name mysql --net=host -d --restart always -v /var/lib/mysql:/var/lib/mysql -p 3306:3306 -e  MYSQL_ROOT_PASSWORD=gfc123456 docker.io/mysql:5.7 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci 
```

3. 连接数据库, 新建一个db，例如fastrunner


4. 修改settings.py DATABASES 字典相关配置，NAME, USER, PASSWORD, HOST

5. 启动rabbitmq 
```
docker run -d --name rabbitmq --net=host --restart always  -e RABBITMQ_DEFAULT_USER=guest -e RABBITMQ_DEFAULT_PASS=guest -p 5672:5672 rabbitmq:3-management
```
6. 修改settings.py BROKER_URL(配置rabbittmq的IP，username,password)

7. 切换到FasterRunner目录，Linux环境执行下 (因为windos编写的bash有编码问题)
```
dos2unix ./start.sh
```

8. 构建docker镜像
```
docker build -t fastrunner:latest .   
```
9. 后台运行docker容器,默认后台端口8000,在uwsgi.ini中修改http指定IP和端口
```
docker run -d --name fastrunner --net=host  --restart always fastrunner:latest 
```
10 进入容器内部
```
docker exec -it fastrunner /bin/sh  
```

11. 创建应用数据库表
``` 

# make migrations for fastuser、fastrunner
python manage.py makemigrations

# migrate for database
python manage.py migrate
```

## 本地开发环境部署
##### 命令均在FastRunner根目录下执行
``` bash
1. pip install -r requirements.txt 安装依赖库
2. 建立自己所需的myconfig.conf文件，可直接复制根目录下的config.conf文件重命名为”myconfig.conf“
3. 若在本地用mysql，则需要安装mysql server，并创建NAME指定的database
4. python manage.py makemigrations 生成数据库迁移文件
5. python manage.py migrate 应用生成的库文件
6. python manage.py createsuperuser  # 按提示创建一个超级用户
7. python manage.py runserver 开发环境启动服务
8. 安装rabbmitMQ中间件，并配置setting中的BROKER_URL（默认一般不用修改）
9. celery -A FasterRunner worker -l info 启动异步worker
10. python manage.py celery beat -l info  启动beat监听定时任务
```