Norc 技术文档

1. 安装指南

环境要求

• Python 2.5 或 2.6
• Django 1.1
• MySQL
• 操作系统：OS X 或 Linux

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/your-repo/norc.git
   cd norc
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 配置数据库： 在 settings.py 中配置 MySQL 数据库连接信息。

4. 同步数据库：

   python manage.py syncdb
   

5. 启动调度器和执行器：

   python norc_scheduler.py
   python norc_executor.py
   

2. 项目的使用说明

任务管理

• 创建任务：通过 Django 管理界面或 API 创建任务。
• 任务依赖：可以设置任务之间的依赖关系，确保任务按顺序执行。
• 任务日志：所有任务的输出都会被记录在标准化的日志中，支持上传到外部存储（如 Amazon S3）。

调度任务

• 简单调度：设置任务的重复执行周期。
• Cron 调度：使用复杂的 Cron 表达式来定义任务的执行时间。

监控与交互

• Web 界面：通过 Norc 的 Web 前端监控系统状态，控制执行器和调度器。
• 命令行工具：使用 norc_control、norc_reporter 和 norc_log_viewer 进行系统管理。

3. 项目API使用文档

创建任务

from norc.core.models import CommandTask

task = CommandTask.objects.create(
    command="echo 'Hello, Norc!'",
    description="Example task"
)

创建调度

from norc.core.models import Schedule

schedule = Schedule.objects.create(
    task=task,
    period=60,  # 每 60 秒执行一次
    repetitions=10  # 执行 10 次
)

获取任务日志

from norc.core.models import Log

logs = Log.objects.filter(task=task)
for log in logs:
    print(log.content)

4. 项目安装方式

手动安装

1. 克隆项目仓库。
2. 安装依赖。
3. 配置数据库。
4. 同步数据库。
5. 启动调度器和执行器。

自动化安装

可以使用 setup.py 进行自动化安装：

python setup.py install

通过以上步骤，您可以顺利安装并使用 Norc 任务管理与调度系统。