Skip to content

ropon/golang_crontab

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Golang分布式高性能任务调度(Crontab)

特性

  • 使用etcd作为分布式存储kv,支持分布式部署
  • 使用mongodb存储任务完成的相关日志记录以及查看
  • 任务管理
  • 分布式抢锁,保证只会有一台机器执行
  • 定时任务可以支持到秒以及年
  • 支持进行任务强杀
  • 服务拆分
  • 服务注册发现
  • releases已经编译好了,可以直接使用(确保有etcdmongodb)

太危险了,不敢给测试地址。

相关界面

后台界面

主界面:

master-main

健康节点(服务发现):

master-work-list

日志:

master-log

分布式worker

一个任务,只有抢到锁才会执行。

worker-run

要求

依赖 说明
Golang >= 1.10.1
Etcd >= 3.3.8
Mongodb >= 4.0.0

安装服务

etcd

etcd是一个分布式KV存储

etcd利用raft算法在集群中同步key-value,实现了强一致性

raft

raft是强一致性的集群日志同步算法。

它的算法原理是 大多数 算法。当机器总数为 2N+1时,一次同步通知只有更新到了N+1次,才算成功,才会commit

安装

本机安装

github 请自行按照对应系统以及给出的安装方法进行安装。

路径地址

/tmp/etcd-download-test

启动命令

启动并且监听所有ip

./etcd --listen-client-urls 'http://0.0.0.0:2379' --advertise-client-urls 'http://0.0.0.0:2379

docker下安装

镜像
docker pull quay.io/coreos/etcd
运行

在服务器A上运行一个ETCD实例,取名为etcd01

单机写法

docker run -d \
  -p 2379:2379 \
  -p 2380:2380 \
  --name etcd01 \
  quay.io/coreos/etcd:v3.3.8 \
  /usr/local/bin/etcd \
  --name s1 \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379

官网写法

docker run \
  -p 2379:2379 \
  -p 2380:2380 \
  --name etcd01 \
  quay.io/coreos/etcd \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir /etcd-data \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379 \
  --listen-peer-urls http://0.0.0.0:2380 \
  --initial-advertise-peer-urls http://0.0.0.0:2380 \
  --initial-cluster s1=http://0.0.0.0:2380 \
  --initial-cluster-token tkn \
  --initial-cluster-state new

mongodb

安装

docker下安装

镜像
docker pull  mongo 
运行
docker run -d -p 27017:27017 --name mongo mongo --bind_ip_all 
//这里的--name放在前面并映射端口
进入容器
docker exec -it 容器ID /bin/bash     //进入容器
进入控制台
mongo

运行注意

如果是下载releases里的成品,请注意下载对应操作系统版本。同时,master,master.json配置文件,webroot文件夹需要在同一目录下;worker与worker.json配置文件需要在同一目录下。

记得修改json配置文件中相应的配置项。

守护进程

可以使用superior做守护进程保护master或者使用centos7内的systemd,systemctl命令进行控制.

下面给出systemd的配置参考:

cron-master.service (master守护进程)

[Unit]
# 服务描述
Description=crontab master
# 要求必须执行网络
Requires=network-online.target
# 在网络启动之后启动
After=network-online.target

[Service]
# 简单服务
Type=simple
# 运行用户与用户组
User=work
Group=work
# 进程退出立即重启
Restart=always
# 执行命令
ExecStart=/home/work/crontab/master/main -config=/home/work/crontab/master/master.json
# 进程工作目录
WorkingDirectory=/home/work/crontab/master

[Install]
# 在系统启动后加载UNIT
WantedBy=multi-user.target

cron-worker.service (worker守护进程)

[Unit]
# 服务描述
Description=crontab worker
# 要求必须执行网络
Requires=network-online.target
# 在网络启动之后启动
After=network-online.target

[Service]
# 简单服务
Type=simple
# 运行用户与用户组
User=work
Group=work
# 进程退出立即重启
Restart=always
# 执行命令
ExecStart=/home/work/crontab/worker/main -config=/home/work/crontab/worker/worker.json
# 进程工作目录
WorkingDirectory=/home/work/crontab/worker

[Install]
# 在系统启动后加载UNIT
WantedBy=multi-user.target

配置systemctl

# 装载
systemctl enable cron-master.service
systemctl enable cron-worker.service

# 启动
systemctl start cron-master.service
systemctl start cron-worker.service

nginx负载均衡

将master进行负载均衡。

没什么不一样的地方,给出参考:

upstream masters {      #定义一个服务组
    server 127.0.0.1:8090 weight=1 max_fails=3 fail_timeout=10s;
}
server {
    server {
        listen       8090;
        server_name  _;

        location / {
                proxy_pass http://masters;
                proxy_connect_timeout 2s;
                proxy_read_timeout 2s;
                proxy_send_timeout 2s;
        }
}

源码修改

架构

整体架构

OverallFramework

架构思路

  1. 利用etcd同步全量任务列表到所有worker节点

  2. 每个worker独立调度全量任务,无需与master产生直接RPC

  3. 各个work利用分布式锁抢占,解决并发调度相同任务的问题

Master架构

MasterFramework

master功能

  1. 任务管理HTTP接口:新建、修改、查看、删除任务

  2. 任务日志HTTP接口:查看任务执行历史日志

  3. 任务控制HTTP接口:提供强制结束任务的接口

  4. 实现web管理界面:基于query+ bootstrap的Web控制台,前后端分离

Worker架构

WorkerFramework

worker功能

  1. 任务同步:监听etcd中/cron/jobs/目录变化

  2. 任务调度.基于cron表达式计算,触发过期任务

  3. 任务执行:协程池并发执行多任务,基于etcd分布式锁抢占

  4. 日志保存:捕获任务执行输出,保存到MongoDB

调度协程

  1. 监听任务变更event,更新内存中维护的任务列表

  2. 检查任务cron表达式,扫描到期任务,交给执行协程运行

  3. 监听任务控制event,强制中断正在执行中的子进程

  4. 监听任务执行result,更新内存中任务状态,投递执行日志

执行协程

  1. 在etcd中抢占分布式乐观锁: /cron/lock/任务名

  2. 抢占成功则通过Command类执行shell任务

  3. 捕获Command输出并等待子进程结束,将执行结果投递给调度协程

日志协程

  1. 监听调度发来的执行日志,放入一个batch中

  2. 对新batch启动定时器,超时未满自动提交

  3. 若batch被放满,那么立即提交,并取消自动提交定时器

第三方库

crontab表达式解析

可以解析linux的crontab原来的分时日月周格式,也可以支持秒分时日月周年

获取

go get github.com/gorhill/cronexpr

点我查看更多

etcd

golang程序中连接etcd服务端

获取

go get go.etcd.io/etcd/clientv3

点我查看更多

mongodb

golang程序中连接mongodb服务端

获取

go get go.mongodb.org/mongo-driver/mongo@~1.0.0

点我查看更多

编译

golang对不同操作系统的编译是不一样的,可以通过交叉编译跨平台的可执行程序。

Mac

//Mac 下编译 Linux 可执行程序
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build xxx/master/main
//Mac 下编译 Windows 64位 可执行程序
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build xxx/master/main

Linux

//Linux 下编译 Mac 可执行程序
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build xxx/master/main
//Linux 下编译 Windows 64位可执行程序
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build xxx/master/main

Windows

//Windows 下编译 Mac 可执行程序
SET CGO_ENABLED=0
SET GOOS=darwin
SET GOARCH=amd64
go build xxx/master/main
//Windows 下编译 Linux 可执行程序
SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build xxx/master/main

注意

具体编译路径根据本机的GOPATH或者临时的PATH路径而定。

记得编译master完毕后别忘记了worker

About

Golang分布式高性能任务调度(Crontab)

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 77.5%
  • HTML 22.5%