OpenCue RQD 渲染客户端镜像

镜像概述

OpenCue RQD（Render Queue Daemon）是OpenCue开源渲染管理系统的核心客户端组件，负责在渲染节点上运行并与OpenCue管理器（Cuebot）通信。其主要功能包括接收渲染任务、执行任务流程、监控本地硬件资源（CPU/内存/GPU）使用状态，并向Cuebot实时上报节点状态与任务进度。该镜像提供容器化部署方案，简化分布式渲染集群的搭建与维护。

核心功能与特性

任务调度执行：接收Cuebot分配的渲染任务，支持主流渲染器（Arnold/V-Ray/RenderMan等）的任务处理，确保任务按优先级有序执行。
资源监控上报：实时采集节点CPU、内存、GPU（如启用）使用率，动态调整任务负载，避免资源过载。
跨节点通信：通过REST API与Cuebot保持心跳连接，上报节点状态、任务完成结果及错误信息，支持任务中断与恢复。
容器化部署：基于轻量级容器封装，兼容物理机/虚拟机/云服务器环境，降低节点配置复杂度。
日志与诊断：生成结构化任务日志，包含执行时间、资源消耗、错误堆栈等信息，便于问题定位与性能优化。

使用场景

影视动画制作：在电影、动画后期制作中，作为分布式渲染农场的计算节点，处理大规模帧序列渲染任务。
可视化渲染：支持建筑可视化、产品设计等领域的批量渲染需求，提升渲染效率。
集群资源管理：在企业级渲染集群中，作为标准化客户端组件，统一节点配置与资源管控。

使用方法与配置说明

前提条件

已部署OpenCue Cuebot服务（渲染管理服务器），且RQD节点可访问Cuebot网络端口。
宿主环境已安装Docker 19.03+，GPU渲染需额外配置nvidia-container-runtime。

基础部署命令

bash
docker run -d \
  --name rqd-node \
  --network=host \  # 推荐使用主机网络确保通信稳定性
  -e CUEBOT_HOST=192.168.1.100 \  # Cuebot服务器IP/主机名（必填）
  -e CUEBOT_PORT=8080 \  # Cuebot服务端口（默认8080）
  -e RQD_PORT=8443 \  # RQD本地监听端口（默认8443）
  --restart=unless-stopped \
  opencue/rqd:latest

核心配置参数（环境变量）

参数名	描述	默认值
`CUEBOT_HOST`	OpenCue Cuebot服务器地址，RQD通过此地址注册节点并接收任务	无（必填）
`CUEBOT_PORT`	Cuebot服务通信端口	8080
`RQD_PORT`	RQD本地监听端口，用于Cuebot反向通信	8443
`RQD_LOG_LEVEL`	日志输出级别（debug/info/warn/error）	info
`MAX_CPU_CORES`	节点可用CPU核心数限制（整数或百分比，如"16"或"80%"）	全部核心
`MAX_MEMORY_GB`	节点可用内存限制（GB）	全部内存
`GPU_ENABLED`	是否启用GPU资源监控（true/false）	false
`NVIDIA_VISIBLE_DEVICES`	指定可用GPU设备（如"0,1"表示使用第1、2块GPU）	空（全部GPU）

高级配置示例（GPU渲染节点）

bash
docker run -d \
  --name rqd-gpu-node \
  --network=host \
  --gpus all \  # 启用GPU支持（需宿主环境配置nvidia-container-runtime）
  -e CUEBOT_HOST=cuebot.example.com \
  -e CUEBOT_PORT=8080 \
  -e RQD_LOG_LEVEL=debug \
  -e MAX_CPU_CORES=24 \
  -e MAX_MEMORY_GB=128 \
  -e GPU_ENABLED=true \
  -e NVIDIA_VISIBLE_DEVICES=0,1 \
  --restart=unless-stopped \
  opencue/rqd:latest