AI 测试平台部署调测文档

AI 测试平台部署调测文档1. 文档基础信息项目内容文档名称AI 测试平台部署调测文档本地开发路径D:\机器学习资料\ai_test_platform_By_skill远程服务器***.***.***.***(服务器EIP)远程账号root / (服务器root密码)远程部署目录/home/admin/ai_test_platform预制管理员账号admin / admin123AI 模型网关https://apihub.agnes-ai.com/v1适配环境Windows10/11 本地开发、Linux CentOS7/Ubuntu20.04 容器部署2. 前置环境依赖清单2.1 通用依赖本地 服务器Python 3.11Redis 7MySQL 8.0MinIODocker Docker Compose v22.2 Windows 本地额外依赖Node.js 18前端 Vue3 开发GitPython pipPostman2Jmx 工具包2.3 Linux 服务器额外配置防火墙放行端口80、8000、3306、6379、9000、90013. Windows 本地开发部署单机调试3.1 Windows 环境安装Python 3.11 安装安装时勾选 Add Python to PATHRedis Windows 版启动本地 redis 服务默认端口 6379 无密码MySQL 8.0 本地安装root 密码自定义创建空数据库 ai_test_platformMinIO Windows 二进制本地启动minio.exe server D:\minio_data --console-address :9001Node.js 18 LTS 安装用于前端 Vite 开发Postman2Jmx 工具包拷贝至固定路径 D:\机器学习资料\Postman2Jmx确保存在 P2JConvert_v2207.py3.2 项目代码初始化项目根目录D:\机器学习资料\ai_test_platform_By_skill后端依赖安装cd D:\机器学习资料\ai_test_platform_By_skill\backend pip install -r requirements.txt前端依赖安装cd ../frontend npm install3.3 本地环境变量配置项目根目录 .env# MySQL DB_HOST127.0.0.1 DB_PORT3306 DB_USERroot DB_PASSWORD本地mysql密码 DB_NAMEai_test_platform DB_ECHOTrue Redis REDIS_HOST127.0.0.1 REDIS_PORT6379 REDIS_PASSWORD MinIO MINIO_ENDPOINT127.0.0.1:9000 MINIO_ACCESS_KEYminioadmin MINIO_SECRET_KEYminioadmin MINIO_SECUREFalse 邮件测试可先不填 EMAIL_SMTP_SERVERsmtp.qq.com EMAIL_SMTP_PORT587 EMAIL_SENDERxxxqq.com EMAIL_PASSWORD邮箱授权码注Agnes AI 密钥已固化在 core/config.py无需在 .env 修改。3.4 Postman2Jmx 本地校验打开文件夹 D:\机器学习资料\Postman2Jmx确认存在P2JConvert_v2207.pyREADME.txt缺失则复制工具包到此目录转换功能依赖该路径。3.5 本地分步启动流程多终端分开运行终端 1FastAPI 后端主服务precd D:\机器学习资料\ai_test_platform_By_skill\backend uvicorn main:app --reload --host 0.0.0.0 --port 8000p启动自动执行创建全量数据表、初始化 admin 账号 admin/admin123。/p /li listrong终端 2Celery Worker 异步任务导入、转换、自动化执行/strong precd D:\机器学习资料\ai_test_platform_By_skill\backend celery -A core.celery_app worker --loglevelinfo终端 3Celery Beat 定时任务每日 8 点日报、凌晨 2 点自动化、每小时清理日志cd D:\机器学习资料\ai_test_platform_By_skill\backend celery -A core.celery_app beat --loglevelinfo终端 4Vue3 前端开发服务cd D:\机器学习资料\ai_test_platform_By_skill\frontend npm run dev3.6 本地访问地址与验证FastAPI 接口文档High Performance Web Crawler API - Swagger UI前端页面http://127.0.0.1:5173MinIO 控制台http://127.0.0.1:9001登录校验账号 admin密码 admin123登录成功返回 JWT Token 即代表基础环境正常。4. 远程 Linux 服务器 Docker 部署***.***.***.***4.1 服务器登录与前置依赖安装SSH 登录服务器ssh root***.***.***.*** # 密码(服务器root密码)安装 Docker Docker Compose# CentOS yum install docker -y systemctl start docker systemctl enable docker 安装 compose 插件 curl -L https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose chmod x /usr/local/bin/docker-compose放行防火墙端口firewall-cmd --add-port80/tcp --permanent firewall-cmd --add-port8000/tcp --permanent firewall-cmd --add-port3306/tcp --permanent firewall-cmd --add-port6379/tcp --permanent firewall-cmd --add-port9000/tcp --permanent firewall-cmd --add-port9001/tcp --permanent firewall-cmd --reload4.2 项目上传至远程目录mkdir -p /home/admin/ai_test_platform cd /home/admin/ai_test_platformWindows 本地将完整项目压缩为 ai_test_platform.zip上传至服务器解压拷贝 Postman2Jmx 工具至项目 tools/postman2jmx 目录容器启动自动映射至 /app/tools/postman2jmx。4.3 生产环境 .env 配置修改项目根目录 .env# MySQL容器配置 DB_HOSTmysql DB_PORT3306 DB_USERroot DB_PASSWORDroot123456 DB_NAMEai_test_platform DB_ECHOFalse Redis容器 REDIS_HOSTredis REDIS_PORT6379 REDIS_PASSWORD MinIO容器 MINIO_ENDPOINTminio:9000 MINIO_ACCESS_KEYminioadmin MINIO_SECRET_KEYminioadmin MINIO_SECUREFalse 生产邮件配置必须填写才能发送日报 EMAIL_SMTP_SERVERsmtp.qq.com EMAIL_SMTP_PORT587 EMAIL_SENDER平台对外邮箱qq.com EMAIL_PASSWORD邮箱授权码4.4 Postman2Jmx 容器适配校验项目内 tools/postman2jmx 必须存在转换脚本 P2JConvert_v2207.pycore/config.py 中 DOCKER_P2J_PATH/app/tools/postman2jmx 已固化无需修改。4.5 Docker Compose 一键构建启动cd /home/admin/ai_test_platform # 后台构建并启动全部服务 docker-compose up -d --build服务启动顺序mysql → redis → minio → backend → celery-worker → celery-beat → frontend4.6 容器服务启停、重启、日志查看命令查看全部容器运行状态predocker-compose ps停止所有服务docker-compose down 保留数据卷仅停止容器如需清空数据加 -v docker-compose down -v单独重启某一个服务示例后端docker-compose restart backend实时查看后端日志docker-compose logs -f backend查看 Celery 定时任务日志排查日报、自动化定时docker-compose logs -f celery-beat查看性能转换任务日志docker-compose logs -f celery-worker4.7 初始化校验容器启动完成后执行访问接口文档问卷调查管理平台 - Swagger UI登录校验admin / admin123登录无报错代表数据库初始化完成MinIO 校验访问 MinIO Console查看 5 个业务桶自动创建完成数据库校验进入 mysql 容器docker exec -it ai_test_mysql mysql -uroot -proot123456 ai_test_platform # 查询预置角色、admin用户 select username, is_super_admin from sys_user; select role_name from sys_role;5. 各模块访问地址汇总5.1 Windows 本地开发FastAPI 接口文档High Performance Web Crawler API - Swagger UIVue 前端页面http://127.0.0.1:5173MinIO 控制台http://127