callac/xxl-job

调度中心 Docker 镜像文档

镜像概述

调度中心 Docker 镜像提供了一个轻量级、可扩展的任务与资源调度解决方案，旨在集中管理分布式环境中的任务执行、资源分配和流程协调。该镜像基于高效的调度引擎构建，支持多类型任务调度策略，可无缝集成到各类分布式系统、微服务架构或数据处理平台中，帮助用户实现任务的自动化分发、执行监控和资源优化。

核心功能与特性

• 多策略任务调度：支持定时调度（如 cron 表达式）、事件触发调度、依赖调度等多种任务触发方式，满足不同场景下的任务执行需求。
• 资源动态分配：可根据节点负载、资源利用率等指标，智能分配任务至合适节点，实现资源负载均衡。
• 任务生命周期管理：提供任务创建、提交、执行、暂停、恢复、终止等全生命周期管理能力，支持任务优先级设置。
• 监控与告警：内置任务执行状态监控、资源使用统计功能，支持异常状态告警（如邮件、WebHook 等方式）。
• 高可用支持：支持集群部署模式，通过主从选举机制确保调度服务的高可用性，避免单点故障。
• 可扩展性：提供开放 API 接口，支持自定义任务类型、调度策略及集成第三方系统。

使用场景与适用范围

• 分布式系统协调：在分布式应用中协调多节点间的任务执行，确保业务流程有序推进。
• 微服务架构管理：调度微服务实例的启停、扩缩容，或协调跨服务的业务流程（如订单处理、数据同步）。
• 数据处理任务调度：管理大数据平台中的批处理任务（如 ETL 流程、数据分析任务），优化资源利用效率。
• 定时任务管理：替代传统 cron 服务，提供更灵活的定时任务调度、监控和失败重试机制。
• DevOps 流程自动化：调度 CI/CD 流程中的构建、测试、部署等任务，实现开发运维自动化。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动调度中心容器：

bash
docker run -d \
  --name scheduler-center \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_NAME=scheduler \
  -e DB_USER=root \
  -e DB_PASSWORD=password \
  docker.xuanyuan.run/scheduler-center:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置调度中心及依赖服务（如数据库）：

yaml
version: '3'
services:
  scheduler:
    image: docker.xuanyuan.run/scheduler-center:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=scheduler
      - DB_USER=root
      - DB_PASSWORD=password
      - LOG_LEVEL=INFO
    depends_on:
      - mysql
    restart: always

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=scheduler
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

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

访问与使用

服务启动后，可通过以下方式访问调度中心：

• Web 管理界面：http://<容器IP>:8080（默认账号密码：admin/admin）
• API 接口：通过 http://<容器IP>:8080/api/v1 调用（详见官方 API 文档）

注意事项

• 生产环境建议启用集群模式（CLUSTER_ENABLED=true），并配置至少 3 个节点以确保高可用。
• 数据库需提前创建，首次启动时会自动初始化表结构。
• 任务执行日志默认存储在容器内 /var/log/scheduler 目录，建议通过挂载卷持久化日志。
• 对于大规模任务调度场景，可调整 JVM 参数（如 -Xms512m -Xmx1024m）优化性能。