docker-compose部署xxljob集群

### 使用 Docker 部署 XXL-JOB #### 准备工作 为了在 Linux 环境下使用 Docker 部署 XXL-JOB，需先确认已安装并配置好 Docker 和 Docker Compose。如果尚未完成这一步骤，则应按照官方文档指引进行设置。 #### 创建项目目录结构 创建用于存放 `Dockerfile` 及其他必要文件的工作空间： ```bash mkdir -p ~/xxl-job/docker/ cd ~/xxl-job/docker/ ``` 此命令将在用户的家目录下建立名为 `xxl-job/docker/` 的新文件夹[^1]。 #### 编写 Dockerfile 文件 编辑一个新的文本文件命名为 `Dockerfile` 并加入如下内容来定义镜像构建指令： ```dockerfile FROM openjdk:8-jdk-alpine LABEL maintainer="[email protected]" ENV XXL_JOB_HOME=/opt/xxl-job-admin \ JAVA_OPTS="-Xms512m -Xmx512m" WORKDIR ${XXL_JOB_HOME} COPY ./target/xxl-job-executor-sample.jar ./ EXPOSE 9999 ENTRYPOINT ["java", "-jar", "xxl-job-executor-sample.jar"] ``` 上述脚本指定了基础 JDK 版本、环境变量以及应用程序入口点等信息。注意这里假设已经编译好了执行器 JAR 包(`xxl-job-executor-sample.jar`)放在当前路径下的 target 子目录内；如果不是这种情况，请调整 COPY 行指向实际位置。 #### 构建自定义镜像 保存修改后的 `Dockerfile` 后，在同一级终端窗口运行下面的命令来进行本地镜像制作： ```bash docker build -t my-xxl-job . ``` 该操作会读取刚刚写的 `Dockerfile` 来组装成一个可分发使用的容器映像，并打上标签 `my-xxl-job`. #### 运行容器实例 最后通过以下方式启动服务端口监听于主机上的特定地址: ```bash docker run --name xxl-job-container -d -p 8080:8080 my-xxl-job ``` 此时应该可以在浏览器访问 http://localhost:8080 查看是否成功部署了 XXL-JOB 控制台页面。 对于更复杂的场景比如集群模式或者持久化存储需求，建议参考官方 GitHub 上给出的例子进一步定制化自己的解决方案。

### 如何将 XXL-JOB 部署到 Docker 容器中 #### 构建 XXL-JOB 执行器镜像 为了构建执行器的 Docker 镜像，在 `xxl-job/xxl-job-executor-sample` 目录下需运行如下命令： ```bash docker build -t xxl-job-executor-sample:2.3.0 . ``` 这会创建一个名为 `xxl-job-executor-sample` 版本号为 `2.3.0` 的 Docker 镜像[^1]。 #### 启动 MySQL 容器 在准备阶段，还需要有一个可用的 MySQL 数据库实例作为后台存储。可以通过下面这条指令来启动一个新的 MySQL 容器并设置环境变量以初始化数据库连接参数: ```bash docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag ``` 请注意替换 `-e MYSQL_ROOT_PASSWORD=my-secret-pw` 中的实际密码以及 `mysql:tag` 为你想要使用的具体 MySQL 版本标签。 #### 创建和移除旧版 Admin 镜像与容器 对于管理端（Admin），如果有之前版本的镜像存在则应先删除它；接着在同一位置重新构建新的镜像，并停止正在运行的老版本容器再将其彻底清除掉: ```bash docker rmi xxl-job-admin docker build -t xxl-job-admin . docker stop xxl-job-admin docker rm -f xxl-job-admin ``` 当 Dockerfile 和当前工作目录位于同一级别时可以直接这样做。但如果不在同一个文件夹内，则要额外指明 Dockerfile 路径，比如子目录下的情况可以用 `-f xxx/Dockerfile.custom` 或者绝对路径 `/xxx/xxx/Dockerfile.custom` 来指定[^2]. #### 运行 XXL-JOB Admin 容器 最后一步就是利用刚刚制作好的镜像去启动实际的服务容器了。这里给定了端口映射 (`-p`) 及挂载日志卷的方式 (`-v`) ，同时也赋予了一个易于识别的名字(`--name`) : ```bash docker run -p 8888:8888 -v /tmp:/data/applogs --name xxl-job-admin -d xxl-job-admin ``` 上述操作将会以后台模式(-d)启动服务并将宿主机上的临时文件夹(/tmp)绑定到了应用的日志保存路径上以便于查看日志信息. #### 使用 Docker Compose 方式部署 另一种更简便的方法是采用 Docker Compose 工具来进行多服务编排。只需在一个项目根目录放置好相应的 YAML 文件之后就可以通过一条简单命令完成整个集群的一键搭建: ```yaml version: '3' services: admin: image: xxl-job-admin ports: - "8888:8888" volumes: - ./applogs:/data/applogs ... ``` 然后只需要在这个项目的根目录执行以下命令即可让所有定义的服务都跑起来: ```bash docker compose up -d ``` 这种方式非常适合那些希望简化运维流程的人群使用[^4].