returnpath/job-runner

镜像概述

本镜像整合了Docker任务调度器、分布式锁、任务运行器和告警系统，核心功能是基于Cron调度Kubernetes任务，支持通过YAML定义任务配置，同时兼容原生Kubernetes格式。

核心功能

• 任务调度：基于Cron表达式实现定时任务触发
• 分布式锁：通过Consul实现任务的分布式锁，避免重复执行
• 任务运行器：支持Docker、Kubernetes及Kubernetes原生三种运行方式
• 告警系统：集成Sensu告警，可配置Kibana链接用于日志查看
• 任务收割：自动清理Kubernetes中带有"jobrunner"标签的Pod

使用场景

适用于需要在Kubernetes集群中执行定时任务的场景，如数据备份、定期报表生成、系统维护脚本执行等。

配置说明

运行方式

1. Cron模式：无命令参数启动时进入Cron模式，按调度规则执行任务；可通过在任务YAML中添加SCHEDULED禁用Cron功能
2. 单任务模式：指定任务名称启动时，仅执行该任务并退出，此模式下锁和告警功能禁用

部署方式

Docker部署

bash
docker run sstarcher/job-runner:latest

Kubernetes部署（示例）

yaml
apiVersion: v1
kind: ReplicationController
metadata:
  name: job-runner
spec:
  replicas: 1
  selector:
    name: job-runner
  template:
    metadata:
      labels:
        name: job-runner
    spec:
      containers:
      - name: job-runner
        image: sstarcher/job-runner:latest
        env:
        - name: RUNNER
          value: kubernetes
        - name: KUBERNETES_MASTER
          value: http://kubernetes:8080

运行器配置

• Docker：挂载Docker socket或设置DOCKER_HOST环境变量
• Kubernetes：设置KUBERNETES_MASTER为集群地址（如http://127.0.0.1:8080），可通过IGNORE_OVERRUN控制重复任务告警
• Kubernetes-Native：设置RUNNER为kubernetes-native，将原生Kubernetes Job YAML文件放入k8s-jobs目录，Cron配置放入cron目录

锁配置（Consul）

• CONSUL_HOST：Consul集群地址（默认localhost）
• CONSUL_PORT：Consul端口（默认8500）

告警配置（Sensu）

• SENSU_HOST：Sensu地址（默认127.0.0.1）
• SENSU_PORT：Sensu客户端端口（默认3030）
• KIBANA_HOST：可选Kibana URL，用于告警中添加日志链接

任务配置示例

1. 创建Dockerfile：

dockerfile
FROM sstarcher/job-runner:latest

2. 创建jobs目录并添加任务YAML（如test.yaml）：

yaml
image: debian:jessie
Jobs:
  - Test:
      time: '* * * * *'
      command: echo $job

3. 构建并运行：

bash
docker build --pull -t jobs .
docker run jobs

项目地址：https://github.com/sstarcher/job-runner
Docker镜像地址：https://registry.hub.docker.com/u/sstarcher/job-runner/