qdonl/xxl-job

xxl-job Docker镜像文档

镜像概述

xxl-job是一款分布式任务调度平台，本Docker镜像基于官方源码优化构建，提供便捷的容器化部署方案。镜像支持多架构环境（amd64/arm64/arm/v7），通过环境变量灵活配置数据库连接，简化分布式任务调度系统的搭建与维护流程。

核心功能与特性

• 多架构支持：支持linux/amd64、linux/arm64、linux/arm/v7等多种架构，适配x86与ARM系列服务器
• 环境变量配置：通过环境变量动态配置数据库连接信息，无需修改源码即可适配不同环境
• Dockerfile优化：取消冗余params参数，避免与全局变量冲突，精简镜像体积
• 快速部署：提供docker-compose配置示例，支持一键启动服务

使用场景与适用范围

• 分布式任务调度需求：适用于需要定时执行、分布式部署的任务调度场景，如数据同步、定时报表生成、服务监控等
• 跨架构服务器环境：特别适合混合使用x86（amd64）和ARM（arm64/arm/v7）架构服务器的企业级应用集群
• 容器化部署架构：可无缝集成到Docker/Kubernetes容器编排平台，简化服务扩容与版本管理

使用方法与配置说明

1. 编译方式

1.1 修改源码

1.1.1 修改application.properties文件

为支持通过环境变量配置数据库连接，需调整配置文件，将数据库参数设置为环境变量占位符（含默认值）：

properties
spring.datasource.url=${DB_URL:jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai}
spring.datasource.username=${DB_USERNAME:root}
spring.datasource.password=${DB_PWD:root}
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

1.1.2 修改Dockerfile文件

优化Dockerfile，移除冗余params参数，避免与全局变量冲突：

Dockerfile
FROM arm64v8/openjdk:8-jdk-slim

ENV TZ=PRC
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
ADD target/xxl-job-admin-*.jar /app.jar
ENTRYPOINT ["sh","-c","java -jar $JAVA_OPTS /app.jar"]

1.2 镜像编译（多平台支持）

使用docker buildx进行多平台镜像编译，生成支持amd64、arm64、arm/v7架构的镜像：

bash
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t qdonl/xxl-job:2.4.0 -o type=registry .

2. 部署示例

2.1 docker-compose部署

通过docker-compose快速部署，配置数据库连接与网络：

yaml
version: '3'

services:
  xxl-job:
    image: qdonl/xxl-job:2.4.0
    container_name: xxl-job
    environment:
      # 数据库连接URL（需提前创建xxl_job数据库）
      DB_URL: jdbc:mysql://mysql80:3306/xxl_job
      # 数据库用户名
      DB_USERNAME: xxl_job
      # 数据库密码
      DB_PWD: xxl_job
    ports:
      - 9210:8080  # 宿主机端口:容器内端口（容器内默认8080）
    networks:
      - common_net  # 接入自定义网络，需确保与数据库服务在同一网络

networks:
  common_net:
    name: common_net  # 自定义网络名称

2.2 手动启动（docker run）

直接使用docker run命令启动容器：

bash
docker run -d \
  --name xxl-job \
  -e DB_URL="jdbc:mysql://mysql80:3306/xxl_job" \
  -e DB_USERNAME="xxl_job" \
  -e DB_PWD="xxl_job" \
  -p 9210:8080 \
  --network common_net \
  qdonl/xxl-job:2.4.0

3. 环境变量配置说明

注意：使用前需确保目标数据库已创建xxl_job数据库，并执行官方源码中doc/db/tables_xxl_job.sql初始化表结构。