legionio/legion

LegionIO 镜像说明

镜像概述

LegionIO是一款基于Ruby开发的开源异步任务引擎与自动化框架，旨在实现任务调度、服务间关系建立及异构数据转换。该框架采用MIT协议完全免费，支持通过扩展（LEX）连接多种第三方服务，具备高可用性和可扩展性，适用于个人homelab到企业级的自动化需求。

核心功能

1. 任务调度：支持Cron表达式（如*/5 * * * *）或固定间隔的任务执行，可灵活配置执行策略。
2. 服务关系：允许创建多路径、并行的服务依赖关系（如A→B→C同时B→E→Z），实现复杂工作流。
3. 条件判断：通过lex-conditioner扩展实现嵌套式条件逻辑，控制任务触发条件（如仅当宠物类型为狗且饥饿时执行）。
4. 数据转换：通过lex-transformation扩展使用ERB语法转换数据格式，解决异构服务通信问题（如生成PagerDuty告警消息）。
5. 扩展生态：提供丰富扩展，涵盖HTTP请求、SSH命令、InfluxDB操作、日志记录、Pushover通知等功能。
6. 高可用：基于RabbitMQ分发任务，多实例部署可提高系统容错能力，无付费墙或隐藏功能。
7. 安全特性：支持Hashicorp Vault存储密钥、全局消息加密（AES-256-CBC）及节点间加密通信。

使用场景

• Homelab自动化：智能家居设备数据同步、虚拟机定时更新、Pi-Hole域名管理。
• 企业任务管理：定时数据备份、跨系统工作流触发、服务状态监控与告警。
• IoT数据处理：ESPHome传感器数据转发至InfluxDB存储分析。

配置说明

基础安装

1. 安装核心依赖：gem install legionio
2. 启用数据库功能：gem install legion-data
3. 启动命令：legionio start（引擎启动）、legion（交互操作）、lex_gen（生成扩展）

扩展安装

通过gem安装常用扩展：

• HTTP扩展：gem install lex-http
• SSH扩展：gem install lex-ssh
• InfluxDB扩展：gem install lex-influxdb

Docker部署示例

Docker Run

bash
# 启动容器并进入交互模式
docker run -it --rm docker.xuanyuan.run/legionio/legion bash
# 容器内安装依赖
gem install legionio legion-data lex-http lex-ssh
# 启动引擎
legionio start

Docker Compose（含RabbitMQ）

yaml
version: '3.8'
services:
  legion:
    image: legionio/legion
    volumes:
      - ./legion_config:/root/.legion  # 持久化配置
    command: ["legionio", "start"]
    depends_on:
      - rabbitmq
  rabbitmq:
    image: rabbitmq:3-management
    ports:
      - "5672:5672"  # 消息队列端口
      - "***:***"  # 管理界面端口