常见问题解答

本文档汇总了使用 TaskPyro 过程中的常见问题和解决方案。

数据持久化与 Docker 映射

如何在 Docker 中持久化数据？

TaskPyro 提供了两种数据持久化方式：

方式一：使用持久化文件管理系统（推荐）

TaskPyro 内置了完善的持久化文件管理系统，无需手动配置 Docker 卷映射。

优势：

• ✅ 无需修改 Docker 配置
• ✅ Web 界面可视化管理
• ✅ 支持文件上传、下载、目录管理
• ✅ 所有容器自动共享
• ✅ 提供标准访问路径和代码示例

使用方法：

1. 进入 系统设置 > 持久化文件
2. 创建文件夹或上传文件
3. 在代码中使用统一路径访问：

   # 保存文件到持久化存储
   file_path = '/app/../static/persistentMappedAddress/your-folder/data.txt'
   
   with open(file_path, 'w') as f:
       f.write('持久化数据')

📖 详细文档：持久化文件管理指南

方式二：自定义 Docker 卷映射

如果需要自定义映射到宿主机的特定目录，可以使用 Docker 卷映射方式：

操作步骤：

1. 在代码中指定保存路径，例如：/data/1.txt
2. 在 docker-compose.yml 文件中添加卷映射配置：

   volumes:
      - /opt/taskpyrodata:/data  # 映射宿主机的 /opt/taskpyrodata 目录到容器的 /data 目录

3. 重启容器使配置生效
4. 文件会自动映射到宿主机的指定目录

适用场景：

• 需要直接访问宿主机文件系统
• 已有固定的存储目录规划
• 需要与其他系统共享存储目录

注意事项：

• ⚠️ 需要修改 Docker 配置并重启容器
• ⚠️ 不同容器需要分别配置卷映射
• ⚠️ 路径规划需要提前做好

Python 包管理

如何处理无法正常下载的 Python 包或者执行一些特殊的安装命令？

有时候某些 Python 包可能无法正常通过 pip 安装到虚拟环境中，这时你可以：

1. 使用 Docker 命令进入容器：

   docker exec -it <container_id> /bin/bash

2. 导航到 Python 虚拟环境所在目录：

   cd ..  # 回根目录

   cd /static/taskProjectVenvs/<your-env-name>

3. 在虚拟环境中直接安装或管理包

任务运行状态说明

任务状态类型

TaskPyro 中的任务有三种运行状态：

1. 活跃中

• 表示任务是一个持续性的定时任务
• 不是一次性调度后就结束的任务
• 任务会按照设定的调度规则持续运行
• 可以通过查看调度历史了解任务执行情况

2. 已暂停

• 一次性调度任务执行完成后的状态
• 手动强制停止任务后的状态
• 没有后续调度计划的任务

3. 错误

• 调度系统出现异常
• 任务代码执行报错
• 需要检查日志来确定具体错误原因

仪表盘说明

有的定时任务出现了【错误】的标识，但是有反映说仪表盘并没有显示，这是因为这个错误类型属于你运行的代码本身报的错，仪表盘只记录的任务调度的状态，只记录是否成功调度，是否错过，是否调度失败。

提示

如果遇到任务状态异常，建议先查看任务日志，了解具体的错误信息，这样可以更快地定位和解决问题。