# jiacrontab

**Repository Path**: opsfast/jiacrontab

## Basic Information

- **Project Name**: jiacrontab
- **Description**: jiacrontab 是一款完全自主设计并实现的定时任务&常驻任务管理工具。  提供了方便的界面用于完全控制系统中运行的定时任务和常驻任务。
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 65
- **Created**: 2019-08-05
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jiacrontab

[![Build Status](https://travis-ci.org/iwannay/jiacrontab.svg?branch=dev)](https://travis-ci.org/iwannay/jiacrontab) 

简单可信赖的任务管理工具

## v2.0.0版发布


## [❤jiacrontab 最新版下载点这里❤ ](https://jiacrontab.iwannay.cn/download/)

    1.自定义job执行  
    2.允许设置job的最大并发数  
    3.每个脚本都可在web界面下灵活配置，如测试脚本运行，查看日志，强杀进程，停止定时...  
    4.允许添加脚本依赖（支持跨服务器），依赖脚本提供同步和异步的执行模式  
    5.支持异常通知  
    6.支持守护脚本进程  
    7.支持节点分组


## 架构

![alt 架构](https://raw.githubusercontent.com/iwannay/static_dir/master/jiacrontab_arch.png)

## 说明

jiacrontab 由 jiacrontab_admin，jiacrontabd 两部分构成，两者完全独立通过 rpc 通信  
jiacrontab_admin：管理后台向用户提供web操作界面  
jiacrontabd：负责job数据存储，任务调度  


## 安装

#### 二进制安装

1.[下载](https://jiacrontab.iwannay.cn/download/) 二进制文件。

2.解压缩进入目录(jiarontab_admin,jiacrontabd)。

3.运行

```sh
$ nohup ./jiacrontab_admin &> jiacrontab_admin.log &
$ nohup ./jiacrontabd &> jiacrontabd.log &
```

### v2.0.x源码安装

1.安装 git，golang(version 1.12.x)；可参考官网。  
2.安装运行

```sh
$ cd $GOPATH/src
$ git clone git@github.com:iwannay/jiacrontab.git
$ cd jiacrontab
$ make build

$ cd build/jiacrontab/jiacrontab_admin/
$ nohup ./jiacrontab_admin &> jiacrontab_admin.log &

$ cd app/jiacrontab/jiacrontabd/
$ nohup ./jiacrontabd &> jiacrontabd.log &
```

<font color="red" size="3">浏览器访问 host:port (eg: localhost:20000) 即可访问管理后台</font>

### 升级版本

1、下载新版本压缩包，并解压。

2、替换旧版jiacrontab_admin,jiacrontabd为新版执行文件

3、运行

## 基本使用

### 定时任务

1. 超时设置和超时操作  
   超时后会进行设置的超时操作 默认值为 0 不判断超时

2. 最大并发数  
   最大并发数控制同一job同一个时刻最多允许存在的进程数，默认最大并发数为1，当前一次未执行结束时则放弃后续执行。    
   防止脚本无法正常退出而导致系统资源耗尽

3. 添加依赖  
   依赖就是用户脚本执行前，需要先执行依赖脚本，只有依赖脚本执行完毕才会执行当前脚本。  
   3.1 并发执行  
   &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;并发执行依赖脚本，任意一个脚本出错或超时不会影响其他依赖脚本，但是会中断用户job

   3.2 同步执行  
   &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;同步执行依赖脚本，执行顺序为添加顺序，如果有一个依赖脚本出错或超时，则会中断后继依赖，以及用户job

4. 脚本异常退出通知
   如果脚本退出码不为0，则认为是异常退出

### 常驻任务

常驻任务检查脚本进程是否退出，如果退出再次重启，保证脚本不停运行。  
注意：不支持后台进程。

## 附录

### 错误日志

错误日志存放在配置文件设置的目录下  
定时任务为 logs/crontab_task  
定时任务为 daemon_task
日志文件准确为日期目录下的 ID.log （eg: logs/crontab_task/2018/01/01/1.log）

#### 错误日志信息

1. 正常错误日志  
   程序原因产生的错误日志
2. 自定义错误日志  
   程序中自定义输出的信息，需要在输出信息后面加入换行

## v2.0.0截图

![alt 截图1](https://raw.githubusercontent.com/iwannay/static_dir/master/jiacrontab_preview_2.0.0_1.png)

![alt 截图2](https://raw.githubusercontent.com/iwannay/static_dir/master/jiacrontab_preview_2.0.0_2.png)

## 演示地址

[2.0.0版本演示地址](http://jiacrontab-spa.iwannay.cn/) 账号：test 密码：123456

## QQ群号：813377930
<img src="https://raw.githubusercontent.com/iwannay/jiacrontab/dev/qq.png" width="250" alt="qq群"/>

## 赞助
本项目花费了作者大量时间，如果你觉的该项目对你有用，或者你希望该项目有更好的发展，欢迎赞助。
<img src="https://raw.githubusercontent.com/iwannay/jiacrontab/dev/admire.jpg" alt="赞助"/>