OpenAF oJob Docker镜像文档

镜像概述

OpenAF oJob Docker镜像是一个预配置的运行环境，集成了OpenAF自动化框架和oJob工作流管理工具。该镜像旨在提供开箱即用的环境，帮助用户快速部署和运行基于oJob定义的工作流与自动化任务，无需手动配置依赖环境。

核心功能与特性

主要功能

• 工作流定义与执行：支持通过简单的JSON/YAML格式定义工作流，包含任务依赖、并行/串行执行逻辑
• 任务调度：内置定时任务调度能力，支持cron表达式定义执行周期
• 跨平台兼容：基于轻量级基础镜像，可在Linux、Windows、macOS等多种操作系统的Docker环境中运行
• 集成OpenAF生态：无缝对接OpenAF的脚本能力，支持JavaScript/ECMAScript语法编写任务逻辑
• 日志与监控：提供标准输出日志，支持集成外部日志系统

特性

• 轻量级：基于Alpine或精简Linux基础镜像，镜像体积小，资源占用低
• 预配置环境：无需手动安装OpenAF和oJob依赖，直接运行即可使用
• 灵活扩展：支持挂载外部工作流配置文件和脚本，便于动态更新任务逻辑
• 版本一致性：固定OpenAF和oJob版本，确保不同环境下的执行一致性

使用场景

• 自动化任务执行：服务器日常维护脚本、文件备份、日志清理等自动化操作
• 定时作业调度：按指定时间间隔或 cron 表达式运行的周期性任务
• 工作流编排：多步骤任务的依赖管理（如数据ETL流程、应用部署流程）
• 微服务集成：作为轻量级任务协调器，连接多个微服务的执行流程

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull openaf/ojob:latest

运行容器（基本示例）

bash
docker run -d --name ojob-instance openaf/ojob:latest

运行指定工作流文件

通过挂载本地工作流配置文件（.ojob 或 .ojob.yaml）到容器内的 /workflows 目录：

bash
docker run -v /local/path/to/workflows:/workflows openaf/ojob:latest ojob /workflows/my-workflow.ojob

环境变量配置

持久化数据

挂载工作流配置和日志目录，实现数据持久化：

bash
docker run -d \
  --name ojob-persistent \
  -v /local/workflows:/workflows \
  -v /local/ojob-logs:/var/log/ojob \
  -e OJOB_LOG_LEVEL=debug \
  openaf/ojob:latest

工作流定义示例

创建简单的定时任务工作流文件 sample.ojob.yaml：

yaml
name: "Sample定时任务"
description: "每5分钟执行一次的示例任务"
schedule: "*/5 * * * *"
jobs:
  - name: "printMessage"
    exec: "print('Hello from oJob! Current time: ' + new Date())"

运行该工作流：

bash
docker run -v $(pwd)/sample.ojob.yaml:/workflows/sample.ojob.yaml openaf/ojob:latest ojob /workflows/sample.ojob.yaml

注意事项

• 工作流文件需符合oJob语范，详细定义可参考OpenAF oJob文档
• 容器运行时需确保挂载的工作流文件有正确的读写权限
• 定时任务依赖容器内的系统时间，建议通过 -v /etc/localtime:/etc/localtime:ro 挂载主机时间以保持一致