csap/xxl-job

镜像概述

本镜像为xxl-job分布式任务调度平台的官方任务执行器（executor）Docker镜像，用于作为任务执行节点接收并执行xxl-job-admin调度中心分发的各类任务（定时任务、一次性任务等）。通过容器化封装，简化了执行器的部署流程，支持灵活配置，可快速集成到xxl-job调度生态中。

核心功能与特性

• 任务执行：作为执行节点接收xxl-job-admin的任务指令，执行具体业务逻辑
• 配置灵活：通过环境变量动态配置连接调度中心的核心参数，无需修改配置文件
• 轻量部署：容器化封装依赖环境，一键启动，减少手动配置成本
• 通信支持：默认暴露9999端口，与xxl-job-admin保持通信，确保任务调度链路畅通

使用场景

• 分布式系统中部署xxl-job执行节点，扩展任务处理能力
• 快速搭建xxl-job调度平台的执行层，适配开发、测试、生产等多环境
• 容器化部署架构中集成任务执行组件，便于集群管理和水平扩展

使用方法与配置说明

基本部署命令

通过docker run快速启动执行器容器：

bash
docker run -d --name xxl-job-executor -e PARAMS="--xxl.job.admin.addresses=http://host:port/xxl-job-admin" -p 9999:9999 csap/xxl-job:executor

参数说明

核心配置项（PARAMS参数）

• 必填项：--xxl.job.admin.addresses
  示例：--xxl.job.admin.addresses=http://192.168.1.100:8080/xxl-job-admin
  说明：xxl-job-admin调度中心的访问地址，需替换为实际部署的调度中心IP和端口

• 可选扩展配置（参考xxl-job官方文档）：

  • --xxl.job.executor.appname：执行器名称（默认xxl-job-executor）
  • --xxl.job.executor.port：执行器端口（默认9999，需与-p映射端口一致）
  • --xxl.job.executor.logpath：任务日志路径（默认容器内/data/applogs/xxl-job/jobhandler）

注意事项

• 确保xxl-job-admin已提前部署并可访问，执行器需通过--xxl.job.admin.addresses正确配置其地址
• 生产环境建议挂载日志目录（如-v /host/logs:/data/applogs/xxl-job/jobhandler），避免容器重启后日志丢失
• 多执行器节点部署时，需确保各节点名称（--name）唯一，且端口映射不冲突