davechallis/ocypod

ocypod

Ocypod是一款语言无关、基于Redis的任务队列服务器，提供HTTP接口，专注于处理长时间运行的任务。

镜像概述

Ocypod旨在简化分布式任务调度与执行，仅依赖Redis作为数据存储，支持任意语言的客户端/worker通过HTTP/JSON协议交互，特别适合处理持续数小时甚至数天的长时间任务。

核心功能

• 部署简单：仅需Redis作为依赖
• 语言无关：通过HTTP/JSON协议通信，可在任何语言中实现客户端/worker
• 长任务支持：处理长时间运行的任务，通过心跳机制早期检测失败
• 简洁HTTP接口：无复杂二进制协议或客户端逻辑
• 灵活的任务元数据：支持进度跟踪、部分结果返回等多种使用模式
• 任务检查：可查询系统中所有提交任务的状态
• 标签功能：自定义标签便于相关任务的分组与搜索
• 自动重试：任务失败或超时时自动重新入队

使用场景

• 后台批量数据处理任务（如日志分析、数据清洗）
• 长时间运行的计算任务（如模型训练、科学计算）
• 分布式系统中的任务调度与协调
• 需要可靠重试机制的异步任务处理

配置说明

Ocypod主要通过环境变量配置，关键参数包括：

• REDIS_URL：Redis连接地址（默认：redis://localhost:6379）
• PORT：服务监听端口（默认：8080）
• WORKER_HEARTBEAT_TIMEOUT：worker心跳超时时间（默认：30秒）

部署示例

Docker Run

bash
# 假设Redis已在本地运行
docker run -d -p 8080:8080 -e REDIS_URL=redis://host.docker.internal:6379 davechallis/ocypod

Docker Compose

yaml
version: '3.8'
services:
  redis:
    image: redis:alpine
    container_name: ocypod-redis
    volumes:
      - redis-data:/data
  ocypod:
    image: davechallis/ocypod
    container_name: ocypod-server
    environment:
      - REDIS_URL=redis://redis:6379
      - PORT=8080
    ports:
      - "8080:8080"
    depends_on:
      - redis
volumes:
  redis-data: