coolexp/xxl-job

Nacos配置集成版XXL-Job镜像

镜像概述

本镜像基于XXL-Job分布式任务调度平台构建，集成Nacos配置中心功能，实现任务调度配置的动态管理。通过Nacos统一管理XXL-Job的核心配置（如调度中心地址、数据库连接等），支持配置实时更新，无需重启服务即可生效，适用于分布式系统中需要灵活配置的任务调度场景。

核心功能与特性

核心功能

• Nacos配置集成：支持通过Nacos配置中心管理XXL-Job的核心配置参数
• 动态配置更新：配置变更后自动生效，无需重启容器
• XXL-Job原生功能：完整保留XXL-Job的分布式任务调度、任务管理、监控告警等核心能力
• 配置持久化：配置存储于Nacos，支持多环境、多实例共享配置

特性优势

• 配置集中化：避免分散配置管理，简化分布式部署复杂度
• 高灵活性：支持动态调整调度策略、数据库连接等关键配置
• 兼容性强：与XXL-Job官方版本API完全兼容，支持平滑迁移
• 轻量级部署：基于Docker容器化部署，环境依赖隔离，部署便捷

使用场景

• 分布式系统任务调度：在微服务架构中统一管理跨服务定时任务
• 动态配置需求场景：需频繁调整任务调度参数（如执行频率、重试策略）的业务场景
• 多环境配置管理：通过Nacos命名空间区分开发/测试/生产环境配置
• 高可用部署：配合Nacos集群实现配置高可用，保障任务调度稳定性

使用方法

环境变量配置

Nacos配置内容示例

在Nacos中创建Data ID为xxl-job-config、Group为DEFAULT_GROUP的配置，格式为Properties：

properties
# XXL-Job调度中心配置
xxl.job.admin.addresses=http://xxl-job-admin:8080

# 执行器配置
xxl.job.executor.appname=xxl-job-executor-sample
xxl.job.executor.port=9999
xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler
xxl.job.executor.logretentiondays=30

# 数据库配置（若使用JDBC方式）
spring.datasource.url=jdbc:mysql://mysql:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

Docker部署示例

1. 单容器部署（docker run）

bash
docker run -d \
  --name xxl-job-nacos \
  -p 9999:9999 \
  -e NACOS_SERVER_ADDR=192.168.1.100:8848 \
  -e NACOS_NAMESPACE=dev \
  -e NACOS_DATA_ID=xxl-job-config \
  your-registry/xxl-job-nacos:latest

2. Docker Compose部署

创建docker-compose.yml：

yaml
version: '3'
services:
  xxl-job-executor:
    image: your-registry/xxl-job-nacos:latest
    container_name: xxl-job-executor
    ports:
      - "9999:9999"
    environment:
      - NACOS_SERVER_ADDR=nacos:8848
      - NACOS_NAMESPACE=prod
      - NACOS_GROUP=XXL_JOB_GROUP
      - NACOS_DATA_ID=xxl-job-prod-config
    depends_on:
      - nacos
      - xxl-job-admin

  nacos:
    image: nacos/nacos-server:v2.2.0
    container_name: nacos
    ports:
      - "8848:8848"
    environment:
      - MODE=standalone

  xxl-job-admin:
    image: xuxueli/xxl-job-admin:2.4.0
    container_name: xxl-job-admin
    ports:
      - "8080:8080"
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=root

启动命令：

bash
docker-compose up -d

注意事项

1. 确保Nacos服务已正常运行，且配置的Data ID、Group存在并格式正确
2. 首次启动时需确保Nacos配置已提前创建，否则容器可能启动失败
3. 配置更新后，执行器将在30秒内自动拉取最新配置（可通过nacos.config.refreshInterval调整刷新间隔）
4. 生产环境建议使用Nacos集群模式，保障配置服务高可用