Deckard Docker镜像文档

镜像概述和主要用途

Deckard 是一个循环优先级队列（Cyclic Priority Queue, CPQ）系统，旨在提供基于优先级的循环任务调度与队列管理能力。本Docker镜像封装了Deckard服务，提供开箱即用的部署方式，简化依赖配置，支持快速启动循环优先级队列服务。

核心功能和特性

• 循环优先级调度：支持按任务优先级进行循环调度，确保高优先级任务优先处理的同时，避免低优先级任务长期饥饿。
• 队列管理：提供队列创建、删除及任务添加、移除、查询等基础操作。
• REST API接口：通过HTTP API暴露队列操作能力，便于与外部系统集成。
• 轻量级部署：基于Docker容器化封装，依赖精简，启动快速，资源占用低。
• 可配置化：通过环境变量灵活调整服务参数，适配不同场景需求。

使用场景和适用范围

• 任务调度系统：需按优先级循环处理周期性任务（如定时批处理、多级别任务协调）。
• 资源分配场景：按优先级循环分配系统资源（如服务器算力、网络带宽调度）。
• 消息分发系统：需按优先级循环分发消息（如多渠道通知推送、分级消息路由）。
• 服务编排：微服务架构中，按优先级循环调用下游服务（如依赖服务任务分发）。

使用方法

Docker run 命令

基础启动命令（映射默认端口8081）：

docker run --rm \
  -p 8081:8081 \
  --name deckard \
  blipai/deckard

参数说明：

• --rm：容器停止后自动清理文件系统。
• -p 8081:8081：端口映射，主机端口:容器端口（默认服务端口为8081）。
• --name deckard：指定容器名称，便于管理。

后台运行方式：

docker run -d \
  -p 8081:8081 \
  --name deckard \
  --restart unless-stopped \
  blipai/deckard

Docker Compose 配置

创建 docker-compose.yml 文件：

version: '3.8'
services:
  deckard:
    image: blipai/deckard
    container_name: deckard
    ports:
      - "8081:8081"
    environment:
      - DECKARD_PORT=8081  # 服务监听端口
      - LOG_LEVEL=INFO     # 日志级别（DEBUG/INFO/WARN/ERROR）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

docker-compose up -d

配置说明

环境变量

Deckard 支持通过环境变量配置服务参数，完整环境变量列表请参考 GitHub 仓库配置说明。以下为常用环境变量示例：

参考链接

• Deckard 官方仓库
• 完整配置说明