jantman/ecsjobs

ecsjobs

http://www.repostatus.org/badges/latest/wip.svg](http://www.repostatus.org/#wip)

• 文档: http://ecsjobs.readthedocs.io/en/latest/
• 构建: https://travis-ci.org/jantman/ecsjobs
• 源码: https://github.com/jantman/ecsjobs

镜像概述和主要用途

ecsjobs是一个针对ECS的定时任务包装器，主要专注于邮件报告功能，并增加了docker exec和本地命令执行能力。这是一个非常小众的项目，适用于特定场景下的ECS定时任务管理需求。

核心功能和特性

• 邮件报告：任务执行成功或失败后生成详细的邮件报告，包含执行状态和输出信息
• docker exec支持：可在运行中的ECS服务容器内执行命令
• 本地命令执行：支持运行本地系统命令
• 解决ECS定时任务痛点：弥补Scheduled ECS Tasks缺乏内置故障监控、无法在运行容器中执行命令以及缺乏实用邮件报告的不足

使用场景和适用范围

该镜像适用于以下场景：

• 个人小型AWS基础设施（如单t2.micro ECS实例）
• 需要运行定时任务并获取执行状态报告
• 预算有限，不想因使用CloudWatch告警而增加AWS支出
• 需要在现有ECS服务容器中执行命令（docker exec）
• 需要通过邮件接收任务成功/失败状态及输出信息

使用方法和配置说明

基本信息

ecsjobs是一个Python项目，以ECS就绪的Docker镜像形式分发，用于处理定时任务的运行并发送邮件报告。

配置文件

使用时需通过配置文件（如exampleconfig.yml）定义任务。配置文件应包含任务调度信息、命令详情、邮件设置等。

邮件报告

生成的HTML格式邮件报告包含任务执行状态、输出信息等关键内容，示例如下：

!https://raw.githubusercontent.com/jantman/ecsjobs/master/docs/source/report.png

部署示例

Docker Run命令（示例）

bash
docker run -d \
  -v /path/to/config.yml:/app/config.yml \
  -e SMTP_SERVER=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=user@example.com \
  -e SMTP_PASSWORD=password \
  -e EMAIL_FROM=ecsjobs@example.com \
  -e EMAIL_TO=recipient@example.com \
  docker.xuanyuan.run/jantman/ecsjobs

Docker Compose配置（示例）

yaml
version: '3'
services:
  ecsjobs:
    image: docker.xuanyuan.run/jantman/ecsjobs
    volumes:
      - ./config.yml:/app/config.yml
    environment:
      - SMTP_SERVER=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=user@example.com
      - SMTP_PASSWORD=password
      - EMAIL_FROM=ecsjobs@example.com
      - EMAIL_TO=recipient@example.com
    restart: always

环境变量说明