cronsun 安装与使用指南

一、项目的目录结构及介绍

cronsun作为一个分布式的故障容错Cron样式的作业管理系统，其内部组织结构清晰，便于开发者理解和维护。下面是主要目录及其功能的概述:

• conf: 配置文件目录，包括数据库连接、ETCD配置以及基础服务配置。

  • db.json: MongoDB数据库配置文件。
  • etcd.json: ETCD集群配置文件。
  • base.json: 服务的基础配置，包括日志路径等。

• cmd: 包含命令行工具，如启动Web界面的服务(cronweb)和Node执行器(cronnode)。

• internal: 内部包和逻辑实现，具体分为:

  • dal: 数据访问层，处理数据库操作。
  • model: 结构模型定义，用于数据持久化。
  • server: HTTP服务器相关代码。

• pkg: 第三方库，通过go mod vendor进行管理，存放了所有依赖项。

此外还有docs, examples, 和testdata等辅助性目录，分别用于文档、示例代码和测试数据存储。

二、项目的启动文件介绍

cronnode

cronnode是负责实际执行定时任务的组件，该组件作为守护进程运行在各个节点上，读取配置并执行任务。可以通过以下命令进行启动:

./cronnode -conf conf/base.json start

cronweb

cronweb提供了Web前端界面以方便管理和监控任务状态。要启动cronweb，可以运行下列指令:

./cronweb -conf conf/base.json 

启动后，默认网页可在http://127.0.0.1:7079访问，登录凭据默认为[e-mail]和密码admin。

三、项目的配置文件介绍

db.json

MongoDB数据库设置参数，例如:

{
    "url": "localhost",
    "port": 27017,
    "database": "cronsun"
}

etcd.json

ETCD服务端口和地址的详细设定，用于节点间的通信和协调，模板如下:

{
    "endpoints": ["http://127.0.0.1:2379"]
}

base.json

包含所有服务运行的基本环境配置，比如日志等级、工作路径等重要细节。

{
    "logLevel": "info",
    "rootPath": "./logs/"
}

以上介绍了cronsun项目的主要组成部分及其如何配置和启动的关键步骤。这对于初次接触或希望深入了解此系统的用户来说，是个良好的起步参考。