タイトル: XXL-JOB使用概要
日付: 2023-07-14 11:35:19
タグ:
- XXL-ジョブ
- サーバーの
カテゴリ: - 開発テクノロジーとフレームワークの
カバー: https://cover.png
機能: false
1. スケジュールデータベースの初期化
公式 Web サイトおよびドキュメント:分散タスク スケジューリング プラットフォーム XXL-JOB
プロジェクトアドレス:
プロジェクトの doc/db ディレクトリにデータベース初期化スクリプトがあります。スクリプトを実行してデータベースを初期化します。
2. 導入ディスパッチセンターを構成する
3 つのモジュールを含むプロジェクトをローカルにクローンします。
- xxl-job-admin: スケジューリング センター
- xxl-job-core: パブリック依存関係
- xxl-job-executor-samples: Executor サンプル (直接使用できる適切なバージョンの Executor を選択するか、それを参照して既存のプロジェクトを Executor に変換します)
- xxl-job-executor-sample-springboot: SpringBoot バージョン、SpringBoot を通じてエグゼキューターを管理、推奨
- xxl-job-executor-sample-frameless: フレームレスバージョン
ディスパッチ センター構成ファイル、プロジェクト ルート パス リソースの下の application.properties ファイル、および logback.xml ファイルのログ パスを変更します。これらは個人の選択に従って変更できます。
設定ファイルの内容は以下のように記述されており、状況に応じて変更できます。
### 调度中心JDBC链接:链接地址请保持和所创建的调度数据库的地址一致
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root_pwd
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
### 报警邮箱
spring.mail.host=smtp.qq.com
spring.mail.port=25
[email protected]
spring.mail.password=xxx
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
### 调度中心通讯TOKEN [选填]:非空时启用;
xxl.job.accessToken=
### 调度中心国际化配置 [必填]: 默认为 "zh_CN"/中文简体, 可选范围为 "zh_CN"/中文简体, "zh_TC"/中文繁体 and "en"/英文;
xxl.job.i18n=zh_CN
## 调度线程池最大线程配置【必填】
xxl.job.triggerpool.fast.max=200
xxl.job.triggerpool.slow.max=100
### 调度中心日志表数据保存天数 [必填]:过期日志自动清理;限制大于等于7时生效,否则, 如-1,关闭自动清理功能;
xxl.job.logretentiondays=30
次に、XxlJobAdmin を起動し、http://localhost:8080/xxl-job-admin
管理ページにアクセスします。特定のポートとパスは個人構成の対象になります。このアドレスは、実行プログラムのコールバック アドレスです。
デフォルトのユーザー名とパスワードは admin/123456 で、ログイン後のメインインターフェイスは次のとおりです。
これまでのところ、ディスパッチセンタープロジェクトは順調に運営されています
3. デプロイメントエグゼキュータプロジェクトを構成する
プロジェクトでは xxl-job-core 依存関係が導入されています
<dependency>
<groupId>com.xuxueli</groupId>
<artifactId>xxl-job-core</artifactId>
<version>2.4.0</version>
</dependency>
設定ファイルは次のとおりです。
xxl:
job:
# 执行器通讯TOKEN [选填]:非空时启用
accessToken:
# 调度中心部署根地址 [选填]:如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调";为空则关闭自动注册
admin:
addresses: http://127.0.0.1:8080/xxl-job-admin
executor:
# 执行器AppName [选填]:执行器心跳注册分组依据;为空则关闭自动注册
appname: xxl-job-executor-sample
# 执行器注册 [选填]:优先使用该配置作为注册地址,为空时使用内嵌服务 ”IP:PORT“ 作为注册地址。从而更灵活的支持容器类型执行器动态IP和动态映射端口问题
address:
# 执行器IP [选填]:默认为空表示自动获取IP,多网卡时可手动设置指定IP,该IP不会绑定Host仅作为通讯实用;地址信息用于 "执行器注册" 和 "调度中心请求并触发任务"
ip:
# 执行器端口号 [选填]:小于等于0则自动获取;默认端口为9999,单机部署多个执行器时,注意要配置不同执行器端口
port: 9999
# 执行器运行日志文件存储磁盘路径 [选填] :需要对该路径拥有读写权限;为空则使用默认路径
logpath: logs
# 执行器日志文件保存天数 [选填] : 过期日志自动清理, 限制值大于等于3时生效; 否则, 如-1, 关闭自动清理功能
logretentiondays: 7
構成クラス XxlJobConfig を追加します
@Configuration
public class XxlJobConfig {
@Value("${xxl.job.admin.addresses}")
private String adminAddresses;
@Value("${xxl.job.executor.appname}")
private String appname;
@Value("${xxl.job.executor.ip}")
private String ip;
@Value("${xxl.job.executor.port}")
private int port;
@Value("${xxl.job.accessToken}")
private String accessToken;
@Value("${xxl.job.executor.logpath}")
private String logPath;
@Value("${xxl.job.executor.logretentiondays}")
private int logRetentionDays;
@Bean
public XxlJobSpringExecutor xxlJobExecutor() {
XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
xxlJobSpringExecutor.setAppname(appname);
xxlJobSpringExecutor.setIp(ip);
xxlJobSpringExecutor.setPort(port);
xxlJobSpringExecutor.setAccessToken(accessToken);
xxlJobSpringExecutor.setLogPath(logPath);
xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);
return xxlJobSpringExecutor;
}
}
定期的に実行する必要があるメソッドにアノテーションを追加します@XxlJob("JobHandler")
。ここでの値は、後続のスケジュールされたタスク JobHandler の値になります。
@RestController
public class TestController {
@GetMapping("/test")
@XxlJob("test")
public String test() {
System.out.println("test");
return "test";
}
}
それからプロジェクトを開始します
4. スケジュールされたタスクを実行する
まず、エグゼキュータを追加する必要があります。AppName は、エグゼキュータ構成ファイルの appname の値です。マシン アドレスの自動登録または手動入力を選択できます。ここでは、自動登録を選択します
追加が完了してしばらく待つと、マシンアドレスが自動登録されたことがわかりますが、常に空白の場合は自動登録に問題があるため、アクチュエータ設定ファイルのディスパッチセンターのアドレスとポートが正しいか確認する必要があります。
次に、スケジュールされたタスクを追加し、作成したばかりのエグゼキュータを選択します。JobHandler の値は前の値です@XxlJob("JobHandler")
。
保存後、「実行」を 1 回クリックしてテストします
スケジュール ログでは、実行が成功したことがわかります。
5. サーバーへのデプロイ
導入プロジェクトについては、Fan's Web を参照してください。
ここで注意すべき点は、ディスパッチ センターをサーバーにデプロイした後、ローカル エグゼキュータをディスパッチ センターに登録することはできますが、スケジュールされたタスクの実行に失敗し、ローカル アドレスへの接続がタイムアウトになることに注意してください。正常に実行するには、ローカル プロジェクトをサーバーにデプロイしてください。