调度中心以下称服务端，执行器所在称客户端

1.部署调度中心

下载xxl-job源码，将目录(xxl-job→doc→db)下的sql文件在数据库(例如库名localdb)中执行

1.1jar 部署

将项目中需要修改的数据库用户名密码等其他内容修改后，将项目打成jar包运行即可

1.2docker 容器部署

使用docker hub中的image

拉取镜像

arduino 复制代码

//命令
docker pull xuxueli/xxl-job-admin:2.4.0

运行

ruby 复制代码

// 替换项目中所用的数据库 用户名 密码 
docker run -e PARAMS="--spring.datasource.url=jdbc:mysql://host.docker.internal:3306/localdb?useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false&allowMultiQueries=true&serverTimezone=Asia/Shanghai&useSSL=false --spring.datasource.username=xxx --spring.datasource.password=xxx" -p 8080:8080 -v /tmp:/data/applogs --name xxl-job-admin  -d xuxueli/xxl-job-admin:2.4.0 --add-host="host.docker.internal:host-gateway"

自制image

将上述的jar，使用目录(xxl-job→xxl-job-admin)下的Dockerfile脚本自制运行即可。自行编写.dockerignore文件

bash 复制代码

docker build -t xxl/xxl-job-admin-copy:v1 .

2.添加job(自建的springboot项目)

2.1引入依赖

xml 复制代码

<dependency>
    <groupId>com.xuxueli</groupId>
    <artifactId>xxl-job-core</artifactId>
    <version>2.3.0</version>
</dependency>

2.2添加配置文件

创建application.properties

shell 复制代码

# log config
logging.config=classpath:logback-spring.xml

### xxl-job admin address list, such as "http://address" or "http://address01,http://address02"
### 调度中心的地址
xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin

### xxl-job, access token
### 和调度中心的token一致
xxl.job.accessToken=default_token

### xxl-job executor appname
### 执行器的名字
xxl.job.executor.appname=test
### xxl-job executor registry-address: default use address to registry , otherwise use ip:port if address is null
### 执行器的地址。 为空会默认取xxl.job.executor.ip:xxl.job.executor.port
xxl.job.executor.address=
### xxl-job executor server-info
### 执行器ip。 为空默认取本机地址
xxl.job.executor.ip=
### 执行器端口。 为空默认取9999
xxl.job.executor.port=9999
### xxl-job executor log-path
### 日志记录路径 客户端的日志会在该目录下建文件
xxl.job.executor.logpath=E:/testlog/xxl-job
### xxl-job executor log-retention-days
### 日志保留时长
xxl.job.executor.logretentiondays=30

2.3 添加job

kotlin 复制代码

@Slf4j
@Configuration
public class XxlJobConfiguration {

    @Value("${xxl.job.admin.addresses}")
    private String adminAddresses;

    @Value("${xxl.job.accessToken}")
    private String accessToken;

    @Value("${xxl.job.executor.appname}")
    private String appname;

    @Value("${xxl.job.executor.address}")
    private String address;

    @Value("${xxl.job.executor.ip}")
    private String ip;

    @Value("${xxl.job.executor.port}")
    private int port;

    @Value("${xxl.job.executor.logpath}")
    private String logPath;

    @Value("${xxl.job.executor.logretentiondays}")
    private int logRetentionDays;

    @Bean
    public XxlJobSpringExecutor xxlJobExecutor() {
        log.info(">>>>>>>>>>> xxl-job config init.");
        XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
        xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
        xxlJobSpringExecutor.setAppname(appname);
        xxlJobSpringExecutor.setAddress(address);
        xxlJobSpringExecutor.setIp(ip);
        xxlJobSpringExecutor.setPort(port);
        xxlJobSpringExecutor.setAccessToken(accessToken);
        xxlJobSpringExecutor.setLogPath(logPath);
        xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);

        return xxlJobSpringExecutor;
    }

}

typescript 复制代码

@Component
@Slf4j
public class MyJobHandler {
    @XxlJob(value = "demoJobHandler", init="init", destroy = "destory")
    public Result<String> execute(String param) {

        log.info("exeute schedule trigger:" + LocalDateTime.now());
        return Result.success("success");
    }

    private void init() {
        log.info("init method is called successfully");
    }

    private void destory() {
        log.info("destory method is called successfully");
    }
}

调度中心配置执行器和job

浏览器输入 http://127.0.0.1:8080/xxl-job-admin/

执行器管理
新增
新增执行器参数 appName为客户端application.properties中 xxl.job.executor.appname 值。名称为自定义的。注册方式自动注册不需要填写机器地址，手动注册需要添加机器地址

任务管理
新增
新增任务参数。

css 复制代码

执行器：选择添加的执行器
任务描述：自定义
负责人：自定义
报警邮件：任务执行错误发邮件给谁
调度类型：cron 按照表达式执行。固定速度 多长间隔执行一次
运行模式：bean 
JobHandler：填写 @XxlJob中的value
路由策略: 
调度过期策略：
阻塞处理策略：
失败重试次数：调度失败进行重试的次数
任务超时时间：在客户端执行的会记录时间，超过改时间判定任务失败
子任务ID:在父任务回调成功后会执行子任务。id用逗号分割

测试调度结果

3.部分参数解释

3.1路由策略

对于注册的执行器，选择哪个执行器去执行任务