基于 Docker Compose 一键部署 XXL-Job 调度中心实战

1. 为什么选择Docker Compose部署XXL-Job第一次接触XXL-Job时我尝试过传统部署方式先手动安装MySQL再配置Java环境最后部署war包。光是处理各种依赖冲突就花了半天时间。直到发现Docker Compose方案整个部署过程从半天缩短到10分钟。这种集装箱式的部署方式就像把家具打包成标准集装箱运输彻底解决了在我的机器上能跑的环境一致性问题。XXL-Job作为分布式任务调度系统核心组件包括调度中心和执行器。传统部署需要分别配置数据库、Web服务、日志系统等模块。而使用Docker Compose可以一键启动所有关联服务MySQLXXL-Job版本固化环境配置再也不怕升级导致兼容性问题资源隔离不会污染宿主机环境快速迁移整个环境打包带走实测下来用Docker Compose部署的生产环境在服务器迁移时只需要拷贝一个docker-compose.yml文件和数据库卷5分钟就能在新机器上重建完整环境。这对于需要频繁部署测试环境的团队特别友好。2. 部署前的准备工作2.1 安装Docker引擎不同操作系统安装方式略有差异这里以CentOS 7为例其他系统可参考官方文档# 卸载旧版本 sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 安装工具包 sudo yum install -y yum-utils device-mapper-persistent-data lvm2 # 设置稳定版仓库 sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 安装社区版 sudo yum install docker-ce docker-ce-cli containerd.io # 启动服务 sudo systemctl start docker sudo systemctl enable docker验证安装是否成功docker --version # 应该输出类似Docker version 20.10.17, build 100c7012.2 安装Docker Compose推荐安装v2版本注意命令中的docker compose中间没有横线# 下载二进制文件 sudo curl -L https://github.com/docker/compose/releases/download/v2.6.1/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose # 赋予执行权限 sudo chmod x /usr/local/bin/docker-compose # 验证版本 docker compose version # 应输出Docker Compose version v2.6.1如果遇到权限问题可以尝试将用户加入docker组sudo usermod -aG docker $USER newgrp docker # 刷新组权限3. 编写Docker Compose编排文件创建项目目录并编写docker-compose.ymlversion: 3.8 services: xxl-job: image: xuxueli/xxl-job-admin:2.3.1 container_name: xxl-job restart: unless-stopped ports: - 8080:8080 environment: PARAMS: - --spring.datasource.urljdbc:mysql://mysql:3306/xxl_job?useUnicodetruecharacterEncodingUTF-8autoReconnecttrueserverTimezoneAsia/Shanghai --spring.datasource.usernameroot --spring.datasource.password123456 depends_on: mysql: condition: service_healthy networks: - xxl-net mysql: image: mysql:5.7 container_name: xxl-mysql restart: unless-stopped ports: - 3306:3306 environment: MYSQL_ROOT_PASSWORD: 123456 MYSQL_DATABASE: xxl_job volumes: - ./mysql/data:/var/lib/mysql - ./mysql/init:/docker-entrypoint-initdb.d healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 10s retries: 10 networks: - xxl-net networks: xxl-net: driver: bridge这个配置有几个关键优化点使用健康检查确保MySQL完全启动后再运行XXL-Job通过网络隔离创建专属bridge网络数据持久化MySQL数据挂载到本地目录采用unless-stopped重启策略更合理4. 初始化数据库在项目目录下执行以下操作mkdir -p mysql/init wget -O mysql/init/tables_xxl_job.sql https://raw.githubusercontent.com/xuxueli/xxl-job/master/doc/db/tables_xxl_job.sql这个SQL文件会自动在MySQL容器启动时执行无需手动导入。如果需要自定义初始化脚本可以继续在mysql/init目录添加.sql文件。5. 启动与验证服务一键启动所有服务docker compose up -d观察日志确认服务状态docker compose logs -f当看到XXL-Job日志出现Started XxlJobAdminApplication in XX seconds时访问http://服务器IP:8080/xxl-job-admin使用默认账号admin/123456登录。如果遇到端口冲突可以修改docker-compose.yml中的端口映射比如ports: - 9080:8080 # 主机端口:容器端口6. 生产环境调优建议6.1 安全加固配置默认配置存在安全风险建议修改修改默认管理员密码添加TLS证书启用HTTPS限制MySQL仅内网访问调整后的环境变量示例environment: PARAMS: - --spring.datasource.urljdbc:mysql://mysql:3306/xxl_job?useUnicodetrue --spring.datasource.usernamexxl_user --spring.datasource.passwordStrongPassword123 --xxl.job.login.usernameadmin --xxl.job.login.passwordNewAdminPassword!20236.2 性能优化参数高并发场景下建议调整JVM参数xxl-job: environment: JAVA_OPTS: -Xms1g -Xmx2g -XX:UseG1GCMySQL配置优化新建my.cnf文件并挂载volumes: - ./mysql/conf:/etc/mysql/conf.d6.3 备份与恢复方案定期备份MySQL数据卷docker run --rm --volumes-from xxl-mysql -v $(pwd)/backup:/backup alpine tar cvf /backup/mysql-$(date %Y%m%d).tar /var/lib/mysql使用watchtower自动更新镜像services: watchtower: image: containrrr/watchtower volumes: - /var/run/docker.sock:/var/run/docker.sock command: --interval 3600 --cleanup7. 常见问题排查7.1 数据库连接失败症状XXL-Job启动时报Communications link failure解决方法检查MySQL容器日志docker logs xxl-mysql确认网络连通性docker exec xxl-job ping mysql验证数据库权限docker exec -it xxl-mysql mysql -uroot -p GRANT ALL PRIVILEGES ON xxl_job.* TO xxl_user%;7.2 调度任务不执行可能原因执行器未注册时间配置错误检查步骤进入Admin界面查看执行器列表确认任务CRON表达式正确检查执行器与调度中心时钟同步7.3 内存溢出问题在docker-compose.yml中添加内存限制xxl-job: deploy: resources: limits: memory: 2G监控内存使用docker stats xxl-job