项目安装与使用指南：零跑自动化测试平台（Zerorunner）

项目安装与使用指南：零跑自动化测试平台（Zerorunner）

zerorunner 一个接口自动化平台，使用fastapi + vue3 ，快速实现接口自动化，方便维护扩展 项目地址: https://gitcode.com/gh_mirrors/ze/zerorunner

1. 项目目录结构及介绍

Zerorunner 是一个基于 FastAPI 和 Vue3 构建的接口自动化测试平台，旨在简化接口自动化测试流程并提供易于维护和扩展的解决方案。下面是其主要的目录结构概览：

.
├── backend                 # 后端服务代码
│   ├── script              # 数据库初始化脚本
│   │   └── zerorunner.sql
│   ├── config.py           # 主配置文件，包括数据库和Redis等配置
│   ├── env.example         # 示例环境变量文件
│   ├── main.py             # 启动文件
│   └── requirements.txt    # 项目依赖列表
├── frontend                # 前端应用源码
│   ├── env                 # 环境配置
│   ├── package.json        # 前端项目配置
│   ├── yarn.lock           # Yarn依赖锁定文件
│   └── ...                 # 包含vue应用的所有源码和配置
├── README.md               # 项目说明文档
├── LICENCE                # 许可证文件
├── ...                     # 其他辅助或配置文件

• backend: 包括所有后端逻辑和服务，config.py用于存放应用程序的配置信息。
• script: 提供数据库初始化SQL脚本，确保数据库正确设置。
• main.py: 后端服务的入口，启动服务器的命令执行处。
• frontend: 包含Vue3应用程序的全部前端资源，用于构建用户界面。
• env.example: 提示如何设置环境变量，以适应不同环境需求。

2. 项目的启动文件介绍

后端启动

• 文件：backend/main.py
• 启动命令：
  • 在Linux或macOS中：

    celery -A celery_worker worker --loglevel=INFO -c 10 -P solo -n zerorunner-celery-worker
    python backend/main.py
    

  • 在Windows中由于celery的限制，需执行以下命令：

    celery -A celery_worker worker --pool=solo -l INFO
    python backend/main.py
    

前端启动

• 入口命令：
  • 首先，在前端目录运行：

    yarn install  # 或使用cnpm进行安装，如果偏好淘宝npm源
    

  • 开发模式启动：

    yarn dev
    

  • 打包生产环境：

    yarn build
    

3. 项目的配置文件介绍

• 后端配置：位于backend/config.py，这是核心配置文件，包含数据库连接信息、Redis地址等关键配置项。也可以通过.env文件来设置这些环境变量，提高安全性。
• 前端环境配置：在frontend目录下的.env.development和.env.production分别适用于开发和生产环境。重要参数如API的基础URL(VITE_API_BASE_URL)等在此定义。

务必替换示例配置中的占位符，例如数据库地址和Redis地址，以确保项目能够正确连接到服务。此外，确保所有的依赖已通过pip install和yarn安装完成，遵循上述步骤，您即可顺利运行并使用此接口自动化测试平台。

zerorunner 一个接口自动化平台，使用fastapi + vue3 ，快速实现接口自动化，方便维护扩展 项目地址: https://gitcode.com/gh_mirrors/ze/zerorunner