{"id":13582385,"url":"https://github.com/shunfei/cronsun","last_synced_at":"2025-04-06T14:30:52.139Z","repository":{"id":38866791,"uuid":"90715445","full_name":"shunfei/cronsun","owner":"shunfei","description":"A Distributed, Fault-Tolerant Cron-Style Job System.","archived":false,"fork":false,"pushed_at":"2024-06-06T06:17:43.000Z","size":78533,"stargazers_count":2917,"open_issues_count":86,"forks_count":456,"subscribers_count":111,"default_branch":"master","last_synced_at":"2024-11-17T12:47:12.420Z","etag":null,"topics":["cron","crontab","fault-tolerance","go","golang","job-scheduler"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shunfei.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-09T07:24:57.000Z","updated_at":"2024-11-09T19:57:22.000Z","dependencies_parsed_at":"2024-11-05T22:32:49.180Z","dependency_job_id":"456ff2ea-8938-47d9-a26e-88e484df06a5","html_url":"https://github.com/shunfei/cronsun","commit_stats":{"total_commits":331,"total_committers":14,"mean_commits":"23.642857142857142","dds":0.661631419939577,"last_synced_commit":"0e5a7b9acb5534c64d003333dee9d714e24dd878"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunfei%2Fcronsun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunfei%2Fcronsun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunfei%2Fcronsun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunfei%2Fcronsun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shunfei","download_url":"https://codeload.github.com/shunfei/cronsun/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247495710,"owners_count":20948100,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cron","crontab","fault-tolerance","go","golang","job-scheduler"],"created_at":"2024-08-01T15:02:39.939Z","updated_at":"2025-04-06T14:30:50.278Z","avatar_url":"https://github.com/shunfei.png","language":"Go","funding_links":[],"categories":["Misc","开源类库","Cron Job","Go","Open source library","Go (531)","Repositories"],"sub_categories":["任务/定时器","IRC","Task/Timer"],"readme":"# cronsun [![Build Status](https://travis-ci.org/shunfei/cronsun.svg?branch=master)](https://travis-ci.org/shunfei/cronsun)\n\n`cronsun` is a distributed cron-style job system. It's similar with `crontab` on stand-alone `*nix`.\n\n[简体中文](README_ZH.md)\n\n## Purpose\n\nThe goal of this project is to make it much easier to manage jobs on lots of machines and provides high availability.\n`cronsun` is different from [Azkaban](https://azkaban.github.io/), [Chronos](https://mesos.github.io/chronos/), [Airflow](https://airflow.incubator.apache.org/).\n\n## Features\n\n- Easy manage jobs on multiple machines\n- Management panel\n- Mail service\n- Multi-language support\n- Simple authentication and accounts manager(default administrator email and password: admin@admin.com/admin)\n\n## Status\n\n`cronsun` has been tested in production for years on hundreds of servers. \nAlthough the current version is not release as an stable version, but we think it is completely available for the production environment.\nWe encourage you to try it, it's easy to use, see how it works for you. We believe you will like this tool.\n\n\n## Architecture\n\n```\n                                                [web]\n                                                  |\n                                     --------------------------\n           (add/del/update/exec jobs)|                        |(query job exec result)\n                                   [etcd]                 [mongodb]\n                                     |                        ^\n                            --------------------              |\n                            |        |         |              |\n                         [node.1]  [node.2]  [node.n]         |\n             (job exec fail)|        |         |              |\n          [send mail]\u003c-----------------------------------------(job exec result)\n\n```\n\n\n## Security\n\n`cronsun` support security with `security.json` config. When `open=true`， job command is only allow local files with special extension on the node.\n\n```json\n{\n    \"open\": true,\n    \"#users\": \"allowed execution users\",\n    \"users\": [\n        \"www\", \"db\"\n    ],\n    \"#ext\": \"allowed execution file extensions\",\n    \"ext\": [\n        \".cron.sh\", \".cron.py\"\n    ]\n}\n```\n\n## Getting started\n\n### Setup / installation\n\nInstall from binary [latest release](https://github.com/shunfei/cronsun/releases/latest)\n\nOr build from source, require `go \u003e= 1.11+`.\n\u003e NOTE: The branch `master` is not in stable, using Cronsun for production please checkout corresponding tags.\n\n```\nexport GO111MODULE=on\ngo get -u github.com/shunfei/cronsun\ncd $GOPATH/src/github.com/shunfei/cronsun\ngo mod vendor\nsh build.sh\n```\n\n### Run\n\n1. Install [MongoDB](http://docs.mongodb.org/manual/installation/)\n2. Install [etcd3](https://github.com/coreos/etcd)\n3. Open and update Etcd(`conf/etcd.json`) and MongoDB(`conf/db.json`) configurations\n4. Start cronnode: `./cronnode -conf conf/base.json`, start cronweb: `./cronweb -conf conf/base.json`\n5. Open `http://127.0.0.1:7079` in browser\n6. Login with username `admin@admin.com` and password `admin`\n\n## Screenshot\n\n**Brief**:\n\n![](doc/img/Cronsun_dashboard_en.png)\n\n**Exec result**:\n\n![](doc/img/Cronsun_log_list_en.png)\n![](doc/img/Cronsun_log_item_en.png)\n\n**Job**:\n\n![](doc/img/Cronsun_job_list_en.png)\n\n![](doc/img/Cronsun_job_new_en.png)\n\n**Node**:\n\n![](doc/img/Cronsun_node_en.png)\n\n## Credits\n\ncron is base on [robfig/cron](https://github.com/robfig/cron)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshunfei%2Fcronsun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshunfei%2Fcronsun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshunfei%2Fcronsun/lists"}