owlint/ocypod

ocypod

镜像概述

Ocypod是一个基于Redis的语言无关作业队列服务器，通过HTTP/JSON协议提供服务，专注于处理长时间运行的任务（如数小时或数天的作业）。本镜像为原项目的fork版本，核心优化点是让容器以非root用户（UID/GID 1000）运行，增强部署安全性。

核心功能

1. 部署简单：仅依赖Redis服务，无额外复杂依赖
2. 语言无关：支持任意语言实现客户端/工作者，通过HTTP/JSON交互
3. 长时间任务支持：通过心跳机制检测任务失败，适配数小时/天级别的作业
4. 简洁接口：无复杂二进制协议，降低集成成本
5. 灵活元数据：支持作业进度跟踪、部分结果存储等自定义场景
6. 作业管理：可实时查看所有作业状态、分组标签及自动重试失败任务

使用场景

• 异步处理长时间任务：如数据批量分析、文件转换、后台计算
• 跨语言服务调度：作为多语言架构中的任务中间件
• 可靠任务重试：需要自动恢复失败任务的业务系统

配置说明

1. Redis连接：通过环境变量REDIS_URL指定Redis地址（如redis://redis-host:6379）
2. 权限适配：由于容器以非root用户运行，挂载目录需确保UID/GID 1000有读写权限

部署示例

Docker Run命令

bash
docker run -d --name ocypod \
  -e REDIS_URL=redis://your-redis-server:6379 \
  -p 8080:8080 \
  owlint/ocypod

Docker Compose配置

yaml
version: '3'
services:
  ocypod:
    image: owlint/ocypod
    environment:
      - REDIS_URL=redis://redis:6379
    ports:
      - "8080:8080"
    depends_on:
      - redis

  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

参考文档

官方用户指南与API文档