0


Docker 部署 XXL-JOB

Docker 部署 XXL-JOB

目录

  1. 引言
  2. 环境准备
  3. 创建 MySQL 用户并授予权限
  4. 使用 Docker 部署 XXL-JOB
  5. 配置 XXL-JOB
  6. 验证部署
  7. 总结

1. 引言

XXL-JOB 是一个开源的分布式任务调度平台,旨在简化定时任务的管理和调度操作。其强大的功能和灵活性,使其在互联网公司和各大企业的定时任务管理中得到了广泛应用。本文将详细介绍如何在 MySQL 中创建一个专门的用户以支持 XXL-JOB,并使用 Docker 容器化方式快速部署 XXL-JOB 的管理端。

2. 环境准备

在开始部署之前,确保你已经准备好以下环境:

  • MySQL:用于存储 XXL-JOB 的调度任务和日志。
  • Docker:用于容器化部署 XXL-JOB,确保其在不同环境中快速一致地运行。

此外,还需要确保 MySQL 服务已经启动并能够接受远程连接。Docker 的安装和基础操作应当已具备,以确保后续的部署工作顺利进行。

3. 创建 MySQL 用户并授予权限

为了确保 XXL-JOB 在 MySQL 中拥有足够的权限操作调度任务数据,我们需要创建一个独立的 MySQL 用户并授予其适当的权限。

3.1 登录 MySQL

首先,使用以下命令以 root 用户身份登录到 MySQL:

mysql -u root -p

3.2 创建数据库

接着,创建一个专用于存储 XXL-JOB 数据的数据库:

CREATEDATABASEIFNOTEXISTS`xxl_job`DEFAULTCHARACTERSET utf8mb4 COLLATE utf8mb4_unicode_ci;

此步骤确保数据库使用 UTF-8 编码,以支持多语言环境下的数据存储。
在这里插入图片描述

3.3 创建用户并授予权限

为 XXL-JOB 创建一个专门的 MySQL 用户,并授予其对

xxl_job

数据库的全部操作权限:

CREATEUSER'xxl_job'@'%' IDENTIFIED BY'your_password';GRANTALLPRIVILEGESON xxl_job.*TO'xxl_job'@'%';
FLUSH PRIVILEGES;

在这里,我们使用通配符

%

允许来自任何主机的连接。如果安全性要求较高,可以将其限制为特定主机。
在这里插入图片描述

3.4 初始化 XXL-JOB 数据库

XXL-JOB 提供了一套初始化 SQL 脚本,用于创建所需的数据表和初始数据。你可以从Github仓库获取 XXL-JOB 数据库初始化SQL,并在 MySQL 中运行:

use`xxl_job`;SET NAMES utf8mb4;CREATETABLE`xxl_job_info`(`id`int(11)NOTNULLAUTO_INCREMENT,`job_group`int(11)NOTNULLCOMMENT'执行器主键ID',`job_desc`varchar(255)NOTNULL,`add_time`datetimeDEFAULTNULL,`update_time`datetimeDEFAULTNULL,`author`varchar(64)DEFAULTNULLCOMMENT'作者',`alarm_email`varchar(255)DEFAULTNULLCOMMENT'报警邮件',`schedule_type`varchar(50)NOTNULLDEFAULT'NONE'COMMENT'调度类型',`schedule_conf`varchar(128)DEFAULTNULLCOMMENT'调度配置,值含义取决于调度类型',`misfire_strategy`varchar(50)NOTNULLDEFAULT'DO_NOTHING'COMMENT'调度过期策略',`executor_route_strategy`varchar(50)DEFAULTNULLCOMMENT'执行器路由策略',`executor_handler`varchar(255)DEFAULTNULLCOMMENT'执行器任务handler',`executor_param`varchar(512)DEFAULTNULLCOMMENT'执行器任务参数',`executor_block_strategy`varchar(50)DEFAULTNULLCOMMENT'阻塞处理策略',`executor_timeout`int(11)NOTNULLDEFAULT'0'COMMENT'任务执行超时时间,单位秒',`executor_fail_retry_count`int(11)NOTNULLDEFAULT'0'COMMENT'失败重试次数',`glue_type`varchar(50)NOTNULLCOMMENT'GLUE类型',`glue_source`mediumtextCOMMENT'GLUE源代码',`glue_remark`varchar(128)DEFAULTNULLCOMMENT'GLUE备注',`glue_updatetime`datetimeDEFAULTNULLCOMMENT'GLUE更新时间',`child_jobid`varchar(255)DEFAULTNULLCOMMENT'子任务ID,多个逗号分隔',`trigger_status`tinyint(4)NOTNULLDEFAULT'0'COMMENT'调度状态:0-停止,1-运行',`trigger_last_time`bigint(13)NOTNULLDEFAULT'0'COMMENT'上次调度时间',`trigger_next_time`bigint(13)NOTNULLDEFAULT'0'COMMENT'下次调度时间',PRIMARYKEY(`id`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_log`(`id`bigint(20)NOTNULLAUTO_INCREMENT,`job_group`int(11)NOTNULLCOMMENT'执行器主键ID',`job_id`int(11)NOTNULLCOMMENT'任务,主键ID',`executor_address`varchar(255)DEFAULTNULLCOMMENT'执行器地址,本次执行的地址',`executor_handler`varchar(255)DEFAULTNULLCOMMENT'执行器任务handler',`executor_param`varchar(512)DEFAULTNULLCOMMENT'执行器任务参数',`executor_sharding_param`varchar(20)DEFAULTNULLCOMMENT'执行器任务分片参数,格式如 1/2',`executor_fail_retry_count`int(11)NOTNULLDEFAULT'0'COMMENT'失败重试次数',`trigger_time`datetimeDEFAULTNULLCOMMENT'调度-时间',`trigger_code`int(11)NOTNULLCOMMENT'调度-结果',`trigger_msg`textCOMMENT'调度-日志',`handle_time`datetimeDEFAULTNULLCOMMENT'执行-时间',`handle_code`int(11)NOTNULLCOMMENT'执行-状态',`handle_msg`textCOMMENT'执行-日志',`alarm_status`tinyint(4)NOTNULLDEFAULT'0'COMMENT'告警状态:0-默认、1-无需告警、2-告警成功、3-告警失败',PRIMARYKEY(`id`),KEY`I_trigger_time`(`trigger_time`),KEY`I_handle_code`(`handle_code`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_log_report`(`id`int(11)NOTNULLAUTO_INCREMENT,`trigger_day`datetimeDEFAULTNULLCOMMENT'调度-时间',`running_count`int(11)NOTNULLDEFAULT'0'COMMENT'运行中-日志数量',`suc_count`int(11)NOTNULLDEFAULT'0'COMMENT'执行成功-日志数量',`fail_count`int(11)NOTNULLDEFAULT'0'COMMENT'执行失败-日志数量',`update_time`datetimeDEFAULTNULL,PRIMARYKEY(`id`),UNIQUEKEY`i_trigger_day`(`trigger_day`)USINGBTREE)ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_logglue`(`id`int(11)NOTNULLAUTO_INCREMENT,`job_id`int(11)NOTNULLCOMMENT'任务,主键ID',`glue_type`varchar(50)DEFAULTNULLCOMMENT'GLUE类型',`glue_source`mediumtextCOMMENT'GLUE源代码',`glue_remark`varchar(128)NOTNULLCOMMENT'GLUE备注',`add_time`datetimeDEFAULTNULL,`update_time`datetimeDEFAULTNULL,PRIMARYKEY(`id`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_registry`(`id`int(11)NOTNULLAUTO_INCREMENT,`registry_group`varchar(50)NOTNULL,`registry_key`varchar(255)NOTNULL,`registry_value`varchar(255)NOTNULL,`update_time`datetimeDEFAULTNULL,PRIMARYKEY(`id`),KEY`i_g_k_v`(`registry_group`,`registry_key`,`registry_value`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_group`(`id`int(11)NOTNULLAUTO_INCREMENT,`app_name`varchar(64)NOTNULLCOMMENT'执行器AppName',`title`varchar(12)NOTNULLCOMMENT'执行器名称',`address_type`tinyint(4)NOTNULLDEFAULT'0'COMMENT'执行器地址类型:0=自动注册、1=手动录入',`address_list`textCOMMENT'执行器地址列表,多地址逗号分隔',`update_time`datetimeDEFAULTNULL,PRIMARYKEY(`id`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_user`(`id`int(11)NOTNULLAUTO_INCREMENT,`username`varchar(50)NOTNULLCOMMENT'账号',`password`varchar(50)NOTNULLCOMMENT'密码',`role`tinyint(4)NOTNULLCOMMENT'角色:0-普通用户、1-管理员',`permission`varchar(255)DEFAULTNULLCOMMENT'权限:执行器ID列表,多个逗号分割',PRIMARYKEY(`id`),UNIQUEKEY`i_username`(`username`)USINGBTREE)ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;CREATETABLE`xxl_job_lock`(`lock_name`varchar(50)NOTNULLCOMMENT'锁名称',PRIMARYKEY(`lock_name`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4;INSERTINTO`xxl_job_group`(`id`,`app_name`,`title`,`address_type`,`address_list`,`update_time`)VALUES(1,'xxl-job-executor-sample','示例执行器',0,NULL,'2018-11-03 22:21:31');INSERTINTO`xxl_job_info`(`id`,`job_group`,`job_desc`,`add_time`,`update_time`,`author`,`alarm_email`,`schedule_type`,`schedule_conf`,`misfire_strategy`,`executor_route_strategy`,`executor_handler`,`executor_param`,`executor_block_strategy`,`executor_timeout`,`executor_fail_retry_count`,`glue_type`,`glue_source`,`glue_remark`,`glue_updatetime`,`child_jobid`)VALUES(1,1,'测试任务1','2018-11-03 22:21:31','2018-11-03 22:21:31','XXL','','CRON','0 0 0 * * ? *','DO_NOTHING','FIRST','demoJobHandler','','SERIAL_EXECUTION',0,0,'BEAN','','GLUE代码初始化','2018-11-03 22:21:31','');INSERTINTO`xxl_job_user`(`id`,`username`,`password`,`role`,`permission`)VALUES(1,'admin','e10adc3949ba59abbe56e057f20f883e',1,NULL);INSERTINTO`xxl_job_lock`(`lock_name`)VALUES('schedule_lock');commit;

执行完这些 SQL 语句后,XXL-JOB 将拥有必要的数据结构来存储任务信息和执行日志。

在这里插入图片描述

4. 使用 Docker 部署 XXL-JOB

XXL-JOB 支持 Docker 容器化部署,使其可以快速在任何支持 Docker 的环境中运行。以下是详细的部署步骤:

4.1 拉取 XXL-JOB 镜像

首先,从 Docker Hub 拉取最新版本的 XXL-JOB 管理端镜像:

docker pull xuxueli/xxl-job-admin:2.4.1

确保使用的是最新版镜像,以获得最新功能和安全更新。

4.2 运行 XXL-JOB 容器

使用以下命令运行 XXL-JOB 容器:

mkdir-p /usr/local/docker/xxl-job/logs

docker run --restart=always --privileged=true -ePARAMS="--spring.datasource.username=xxl_job --spring.datasource.password=your_password --spring.datasource.url=jdbc:mysql://your_mysql_host:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai"-p8080:8080 -v /usr/local/docker/xxl-job/logs:/data/applogs --name xxl-job-admin -d xuxueli/xxl-job-admin:2.4.1

这里,我们使用了多种参数来确保 XXL-JOB 能够正确连接到 MySQL 数据库,并且配置了日志存储路径。

在这里插入图片描述

参数解析
  • --restart=always:确保容器在崩溃后自动重启。
  • --privileged=true:为容器赋予更多权限,避免某些受限操作失败。
  • -e PARAMS:通过环境变量传递 Spring Boot 配置项,确保数据库连接参数正确无误。
  • -p 8080:8080:将容器内部的 8080 端口映射到主机,以便外部访问。
  • -v /usr/local/docker/xxl-job/logs:/data/applogs:将主机的日志目录挂载到容器,方便日志持久化和分析。

4.3 常见问题与调试

在运行过程中,可能会遇到 MySQL 连接失败或端口冲突等问题。你可以通过以下步骤进行排查:

  • 确认 MySQL 服务正常运行,并且 Docker 容器可以访问 MySQL 服务器。
  • 检查 docker logs xxl-job-admin 输出,分析日志以排除配置错误或环境问题。

5. 配置 XXL-JOB

当容器成功运行后,你可以通过浏览器访问

http://your_server_ip:8080/xxl-job-admin

进行管理后台的配置。首次登录时,使用默认的用户名和密码:

admin/123456

5.1 修改默认密码

出于安全考虑,建议立即修改默认密码。登录后进入用户管理页面,更新管理员账户的密码,避免因弱密码带来的安全风险。

5.2 配置调度中心

调度中心配置

页面中,设置集群信息和调度策略。你可以根据业务需求配置不同的执行策略,如并行执行、错峰执行等,以满足复杂场景下的任务调度需求。

6. 验证部署

配置完成后,你可以创建一个简单的任务来验证 XXL-JOB 是否正常工作。以下是一个快速的验证步骤:

  1. 进入 XXL-JOB 管理后台。
  2. 新建一个调度任务,例如每分钟执行一次的 Hello World 打印任务。
  3. 观察任务执行情况,确保任务按预期时间和频率执行。

如果任务执行成功,说明 XXL-JOB 已经正确部署并可以投入生产使用。

在这里插入图片描述

7. 总结

通过本文的介绍,我们完成了在 Docker 环境中部署 XXL-JOB 的全过程。从 MySQL 数据库用户的创建,到 Docker 容器的部署,再到最后的任务验证,XXL-JOB 的部署步骤清晰明确。借助 Docker,XXL-JOB 可以快速部署到任何支持 Docker 的环境中,极大简化了运维工作。

标签: docker 容器 运维

本文转载自: https://blog.csdn.net/Li_WenZhang/article/details/141234643
版权归原作者 li.wz 所有, 如有侵权,请联系我们删除。

“Docker 部署 XXL-JOB”的评论:

还没有评论