nuvla/job-lite

Job Engine (极简版) 镜像文档

镜像概述

本镜像是Job Engine的极简版本，专注于以拉取模式（pull mode）执行作业任务。它采用轻量级设计，去除了非必要组件，旨在提供高效、资源占用低的作业执行环境，适用于需要定期从外部源拉取并执行任务的场景。

核心功能与特性

• 极简设计：仅保留核心作业执行功能，减少资源消耗
• 拉取模式支持：主动从指定源拉取作业任务并执行
• 轻量级：镜像体积小，启动速度快，适合资源受限环境
• 灵活配置：支持通过环境变量自定义拉取频率、作业源地址等参数
• 任务隔离：每个作业在独立进程中执行，确保稳定性

使用场景

• 需要定期从API或消息队列拉取任务的自动化场景
• 资源有限的边缘计算环境或轻量级服务器
• 微服务架构中的作业执行节点
• 定时任务处理系统（如数据同步、报表生成等）

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d --name job-engine-minimal \
  -e JOB_PULL_INTERVAL=60 \  # 作业拉取间隔（秒），默认60秒
  -e JOB_SOURCE_URL=http://job-server:8080/jobs \  # 作业源API地址，必填
  -e LOG_LEVEL=info \  # 日志级别，可选：debug/info/warn/error，默认info
  your-registry/job-engine-minimal:latest

Docker Compose 配置

yaml
version: '3'
services:
  job-engine:
    image: your-registry/job-engine-minimal:latest
    container_name: job-engine-minimal
    environment:
      - JOB_PULL_INTERVAL=30
      - JOB_SOURCE_URL=http://job-server:8080/jobs
      - LOG_LEVEL=debug
    restart: unless-stopped

环境变量配置说明

作业源API要求

作业源API需返回JSON格式的待执行作业列表，示例：

json
[
  {
    "id": "job-123",
    "command": "echo 'Hello World'",
    "timeout": 60
  },
  {
    "id": "job-456",
    "command": "python /scripts/data-process.py",
    "timeout": 120
  }
]

注意事项

• 确保作业源API可被容器访问，网络配置需正确
• 作业命令中涉及的文件或依赖需提前挂载到容器内（可通过-v参数挂载）
• 高并发场景下建议适当调整MAX_CONCURRENT_JOBS参数，避免资源耗尽
• 生产环境中建议配置持久化日志（如挂载日志目录或使用日志驱动）