用途:用于 Opik 项目的本地开发环境搭建与日常运行,帮助处理开发服务器、Docker 及本地测试相关操作。
主要能力与命令:通过 ./scripts/dev-runner.sh 脚本管理环境。首次或完整重建用 --restart;每日启动用 --start;停止用 --stop;检查状态用 --verify。另有 --be-only-restart 仅后端模式。构建命令包括 --build-be(仅后端)、--build-fe(仅前端)、--lint-be(Spotless)、--lint-fe(ESLint)、--migrate(数据库迁移)。
访问地址:标准模式前端为 localhost:5174,仅后端模式前端为 localhost:5173;后端 API 为 localhost:8080;健康检查为 http://localhost:8080/health-check?name=all。
日志查看:tail -f /tmp/opik-backend.log 查看后端;tail -f /tmp/opik-frontend.log 查看标准模式前端;docker logs -f opik-frontend-1 查看仅后端模式前端。SDK 配置可设置环境变量 OPIK_URL_OVERRIDE='http://localhost:8080' 与 OPIK_WORKSPACE='default'。
排障:无法启动时运行 --verify,用 lsof -i :8080 检查端口占用,再 --stop 后 --restart。构建失败可进入 apps/opik-backend 执行 mvn clean install -DskipTests,或进入 apps/opik-frontend 删除 node_modules 后执行 npm install。数据库问题可先 --stop,再执行 ./opik.sh --clean(注意会删除数据),然后 --restart。
适用场景:前端与全栈开发、后端开发及快速重建。限制:资料未提供更详细的环境依赖、版本要求或平台差异说明。