ratch-job

ratch-job 是一个rust实现的分布式任务调度平台服务。 完全兼容xxl-job协议，同时增强一些任务调度平台能力。

特性

1. 自带raft分布式储存,不依赖外部数据库，可直接运行服务。
2. 轻量、高性能，每秒运行1000任务持续超过6分钟，cpu使用单核38%，内存占用85M；
3. 完全兼容xxl-job协议，支持使用xxl-job服务的应用平滑迁移到ratch-job；
4. 支持open-api管理任务。

一、 安装运行 ratch-job

【单机部署】

方式1：下载二进制包运行

从 github release 下载对应系统的应用包，解压后即可运行。

linux 或 MacOS

# 解压
tar -xvf ratchjob-x86_64-apple-darwin-v0.1.4.tar.gz
# 运行
./ratchjob

windows 解压后直接运行 ratchjob.exe 即可。

注: 默认配置启动后通过http://127.0.0.1:8825/ratchjob/可以访问ratch-job控制台。

方式2: 通过docker 运行

docker pull qingpan/ratchjob:stable
docker run --name myratchjob -p 8725:8725 -p 8825:8825 -p 8925:8925 -d qingpan/ratchjob:stable

docker 的容器运行目录是/io，会从这个目录读写数据文件

docker 版本说明

应用每次打包都会同时打对应版本的docker包 ，qingpan/ratchjob:$tag 。

每个版本会打两类docker包

支持使用 qingpan/ratchjob:stable 和 qingpan/ratchjob:stable-alpine

方式3: 通过docker-compose 运行

单机部署样列:

docker-compose.yaml

# 集群部署样例,数据目录: ./data
version: '3.8'

services:
  ratchjob:
    image: qingpan/ratchjob:latest
    container_name: ratchjob
    ports:
      - "8725:8725"
      - "8825:8825"
      - "8925:8925"
    volumes:
      - ./data:/io:rw
    environment:
      - RATCH_HTTP_API_PORT=8725
      - RATCH_XXL_DEFAULT_ACCESS_TOKEN=default_token
      - DEFAULT_XXL_JOB_ADMIN_PREFIX_PATH=/xxl-job-admin
    restart: always

集群部署样列:

参考 ratch-job-cluster docker-compose.yaml

方式4：通过 cargo 编译安装

# 安装
cargo install ratchjob
# 运行
ratchjob

方式5: 下载源码编译运行

git clone https://github.com/ratch-job/ratch-job.git
cd ratch-job
cargo build --release
cargo run --release

方式6: MacOS支持通过brew安装

# 把r-nacos加入taps
brew tap ratch-job/ratch-job 

# brew 安装 ratch-job
brew install ratch-job

# 运行
ratchjob

# 后续可以直接通过以下命令更新到最新版本
# brew upgrade ratch-job

方式7: 部署到k8s

待补充

启动配置:

二、 运行xxl-job执行器

1、 java执行器

参考xxl-job执行样例

关键配置application.properties信息：

xxl.job.admin.addresses=http://127.0.0.1:8725/xxl-job-admin
xxl.job.accessToken=default_token

把两项设置为ratch-job对应的信息，打包运行，如果正常可在ratch-job控制台-> 执行器管理查看到执行器与其实例信息。

2、rust执行器

参考作者写的rust xxl-job sdk对应样例xxljob-sdk-rs examples

其它语言

待补充

三、创建设置任务

ratch-job支持通过控制台或open-api创建任务。

1、方式一：任务管理中创建任务

2、方式二：通过open-api创建任务

curl -X POST "http://127.0.0.1:8725/ratch/v1/job/create" -H 'Content-Type: application/json' -d '{"appName":"xxl-job-executor-sample","namespace":"xxl","handleName":"demoJobHandler","scheduleType":"CRON","cronValue":"0/15 * * * * *","blockingStrategy":"SERIAL_EXECUTION"}'

响应信息为:

{"content":{"id":2,"enable":true,"appName":"xxl-job-executor-sample","namespace":"xxl","description":"","scheduleType":"CRON","cronValue":"0/15 * * * * *","delaySecond":0,"intervalSecond":0,"runMode":"BEAN","handleName":"demoJobHandler","triggerParam":"","routerStrategy":"ROUND_ROBIN","pastDueStrategy":"DEFAULT","blockingStrategy":"SERIAL_EXECUTION","timeoutSecond":0,"tryTimes":0,"versionId":0,"lastModifiedMillis":1743353817624,"createTime":1743353817624,"retryInterval":0},"code":200,"msg":null}%

创建任务后，如果是启用状态ratch-job会按配置的规则触发任务

3、手动触发任务

支持选择指定执行器运行任务。

四、任务相关其它功能

1. 查看任务执行记录

任务对应执行记录，每个任务默认只保留最近100条记录。

2. 全局最近执行记录

全局默认保留最近10000条记录.

五、系统监控

ratch-job控制台自带服务监控，包含服务应用cpu,内存水位、任务调度rps、状态、数量等关键指标。

六、性能

为了确认ratch-job性能，对几个使用水位分别做的压测，以下为压测结果：

• 100tps

• 1000tps

• 2000tps

• 5000tps

• 10000tps

七、open api

待补充说明