Coyotes 的诞生起源于在使用 Laravel 的定时任务时,由于 PHP 本身的限制(不安装线程相关扩展),无法实现并发的任务执行,如果任务执行时间过长,就会影响到其它定时任务的执行。不同于其它重量级任务队列,Coyotes 仅仅提供了对命令行程序执行的支持,这样就避免了开发者需要学习任务队列相关 API,针对任务队列开发任务程序的需要。只需要提供一个可执行的文件或者脚本执行命令,Coyotes 就可以并发的执行。
**channel-default** string
默认channel名称,用于消息队列 (default "default")
**colorful-tty**
是否启用彩色模式的控制台输出
**concurrent** int
并发执行线程数 (default 5)
**host** string
redis连接地址,必须指定端口(depressed,使用redis-host) (default "127.0.0.1:6379")
**http-addr** string
HTTP监控服务监听地址+端口 (default "127.0.0.1:60001")
**password** string
redis连接密码(depressed,使用redis-password)
**pidfile** string
pid文件路径 (default "/tmp/coyotes.pid")
**redis-db** int
redis默认数据库0-15
**redis-host** string
redis连接地址,必须指定端口 (default "127.0.0.1:6379")
**redis-password** string
redis连接密码
**task-mode**
是否启用任务模式,默认启用,关闭则不会执行消费 (default true)
编译安装需要安装 **Go1.7+**,执行以下命令编译
上述命令编译后是当前平台的可执行文件(**./bin/coyotes**)。比如在Mac系统下完成编译后只能在Mac系统下使用,Linux系统下编译则可以在Linux系统下使用。 如果要在Mac系统下编译Linux系统下使用的可执行文件,需要本地先配置好交叉编译选线,之后执行下面的命令完成Linux版本编译
将生成的执行文件(在**bin**目录)复制到系统的`/usr/local/bin`目录即可。
项目目录下提供了`supervisor.conf`配置文件可以直接在supervisor下使用,使用supervisor管理Coyotes进程。Coyotes在启动之前需要确保Redis服务是可用的。
如果需要退出进程,需要向进程发送`USR2`信号,以实现平滑退出。
请不要直接使用`kill -9`终止进程,使用它会强制关闭进程,可能会导致正在执行中的命令被终止,造成任务队列数据不完整。
将待执行的任务推送给 Coyotes 执行有两种方式
直接将任务写入到Redis的队列`task:prepare:queue`
使用HTTP API
将任务以json编码的形式写入到Redis的`task:prepare:queue`即可。
写入到`task:prepare:queue`之后,Coyotes会实时的去从中取出任务分发到相应的channel队列供worker消费。
Request:
Response:
**Coyotes** 会使用shell执行任务队列里的任何命令,包括系统相关的命令,如果不严格控制好输入,恶意用户可以非常轻松的拿到系统的root权限。
一定不要直接开放给外网,**只在内部信任的网络使用**,比如绑定http地址到`192.168`开头的网卡或者`127.0.0.1`本地网络
如果执行的命令包含来自用户的输入,一定要对输入内容进行严格检查,否则会引起命令注入,造成严重的安全问题,**不要相信任何来自用户的输入**
不要使用**root权限**执行
解决退出信号会传递到子进程的问题
队列channel持久化
支持单个channel的退出
排队中的任务取消
实现队列调度器
使用可选后端记录任务执行结果、任务执行结果回调
实现RabbitMQ作为broker的支持
队列状态监控
集群支持(任务分发,新增队列)
支持脚本文件实时分发、执行
定时任务执行能力,发送一个任务到队列,设定一个执行时间,时间到了的时候再执行该任务(延迟执行)
增加配置文件
增加对Redis Sentinel和Redis Cluster的支持
解决可以执行任意系统命令带来的安全问题