docker 安装 xxl-job 详解

         在平常的开发工作中，我们经常会用到 xxl-job，之前用过 quartz、@schedule等定时任务，xxl-job 是分布式任务调度框架，那么在 docker 下如何安装 xxl-job 呢？今天简单总结下主要步骤。

       1：拉取 xxl-job 镜像

        docker  pull  xuxueli/xxl-job-admin:版本号
根据自己的需求，拉取合适的 xuxueli/xxl-job-admin 版本，如果 docker pull xuxueli/xxl-job-admin 命令，后面不写版本号，那么默认拉取最新的 xxl-job 镜像。拉取完成后，可以使用 docker images 命令查看拉取到的镜像，xxl-job-admin 镜像如下：

        

        注意：如果拉取镜像失败，可能是 docker 配置文件的问题。在 /etc/docker/ 目录下，修改 daemon.json 文件中的配置的镜像加速器。镜像加速器网上搜索很多，尝试修改配置，修改完后一定要重启docker服务，不然不生效。重启 docker 命令：systemctl restart docker。  

       2：初始化 xxl-job 对应的表

        如图所示：

        

       3：docker-compose.yml

xxl-job-admin:restart: always# docker 镜像image: xuxueli/xxl-job-admin:2.4.0# 容器名称container_name: xxl-job-adminvolumes:# 日志目录映射到主机目录- /docker/xxl_job/logs:/data/logsports:# 端口映射- "9018:9018"environment:# 设置启动参数PARAMS: '--server.port=9018--server.servlet.context-path=/xxl-job-admin--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=123456--spring.mail.username=xxx-job--spring.mail.password=123456# 代码里面需要指定的token--xxl.job.accessToken=123456789zxcvbnm'

        注意：在 docker-compose 中启动 xxl-job 时，连接 mysql 不能直接用 localhost，而需要用容器名（如 mysql）或服务名（如 mysql:3306），localhost 无法访问到 mysql 容器因为docker网络隔离机制，两者是不同的容器实例，有各自独立的网络栈。

       4：启动

        docker compose up xxl-job-admin，docker compose up -d 不阻塞当前命令窗口，docker compose up 阻塞当前命令页面，可以看到启动实时日志。

        查看启动状态：docker ps

       5：测试

        (1)：通过 ip:端口号 进行访问，登录的密码维护在 xxl_job_user 表中，登录即可，页面如下：

        可能遇到的问题，访问不通，那么可能是防火墙端口的问题，可能是 xxl-job 端口防火墙未开导致的，不同的内核版本有不同的对应命令，如果是 Centos 内核版本，查看版本可以用 cat /etc/os-release 命令，可以先查看 9018 端口是否开了防火墙，如果没开，则添加后重启防火墙，相关命令如下：

        查看防火墙开端口：firewall-cmd --zone=public --list-ports
添加端口：firewall-cmd --zone=public --add-port=9018/tcp --permanent
重启防火墙：firewall-cmd --reload

        (2)：登录后可在页面管理登录的用户，如图

        (3)：新增执行器

        (4)：新增定时任务

        (5)：查看运行日志

       6：总结

        以上为 docker 下安装 xxl-job 的基本步骤，主要是拉取镜像、初始化 xxl-job 对应的表、编写启动容器的 docker-compose.yml 文件，通过 docker compose up -d 启动。启动完成后可以通过 docker ps 查看容器的启动状态，如果启动失败，可以通过 docker logs 容器名称查看失败日志，根据失败日志修改对应的问题。启动成功后，可以在浏览器中输入 ip 地址和端口进行访问，登录的用户名和密码在 xxl-job-user 表中。