tines/tines-command-runner

Tines 自托管运行脚本应用

概述

Tines 自托管运行脚本应用（Run Script）是 Tines 自动化平台自托管部署的附加组件，专为在自托管环境中执行自定义脚本任务而设计。该应用作为 Tines 工作流的扩展，允许用户通过 Tines 工作流触发并执行各类脚本，实现自动化流程中的自定义逻辑处理，增强自托管 Tines 环境的灵活性和功能性。

核心功能与特性

1. 多脚本类型支持

• 兼容主流脚本语言，包括但不限于 Bash、Python、Ruby、PowerShell 等
• 支持脚本文件直接执行或内联脚本内容传递

2. Tines 工作流深度集成

• 与 Tines 工作流引擎无缝对接，可通过 Tines Action 触发脚本执行
• 支持接收 Tines 工作流传递的输入参数，并将脚本执行结果返回至工作流

3. 安全执行环境

• 提供隔离的脚本执行环境，限制脚本权限，降低安全风险
• 支持配置执行超时时间，防止长时间运行的脚本占用资源

4. 完善的日志与监控

• 记录脚本执行过程、输出日志及结果状态
• 支持将执行日志集成至 Tines 平台日志系统，便于问题排查

5. 灵活的部署配置

• 轻量级容器化设计，适配 Tines 自托管部署架构
• 支持通过环境变量和配置文件自定义运行参数

使用场景

1. 数据处理与转换

在自动化工作流中执行自定义数据处理脚本，如格式转换、数据清洗、计算分析等，弥补内置功能的局限性。

2. 系统操作自动化

通过脚本执行服务器管理任务，如文件备份、服务重启、系统监控检查等，实现 IT 运维流程自动化。

3. 第三方系统集成

编写脚本对接未提供 API 的第三方系统，通过脚本调用其内部接口或操作界面，扩展 Tines 的集成能力。

4. 自定义业务逻辑

针对特定业务场景编写专有脚本，如订单处理规则、用户权限校验、业务指标计算等，实现个性化自动化需求。

使用方法与配置说明

前提条件

• 已部署 Tines 自托管环境（版本需与该应用兼容，具体版本要求参见 Tines 官方文档）
• 具备 Docker 及 Docker Compose 运行环境
• 拥有 Tines 平台管理员权限，可配置工作流及 API 访问凭证

基本部署命令

Docker Run 部署

bash
docker run -d \
  --name tines-run-script \
  --network tines-network \  # 需与 Tines 主服务在同一网络
  -e TINES_URL="https://your-tines-instance.example.com" \  # Tines 实例地址
  -e TINES_API_KEY="your-tines-api-key" \  # Tines API 密钥（需具备相应权限）
  -e SCRIPT_TIMEOUT=300 \  # 脚本超时时间（秒），默认 300
  -v /path/to/local/scripts:/scripts \  # 挂载本地脚本目录（可选）
  tines/run-script:latest

Docker Compose 部署

在 Tines 自托管的 docker-compose.yml 中添加以下服务配置：

yaml
services:
  run-script:
    image: tines/run-script:latest
    container_name: tines-run-script
    networks:
      - tines-network
    environment:
      - TINES_URL=https://your-tines-instance.example.com
      - TINES_API_KEY=your-tines-api-key
      - SCRIPT_TIMEOUT=300
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error，默认 info
    volumes:
      - ./scripts:/scripts  # 本地脚本目录挂载
    restart: unless-stopped

核心环境变量配置

集成 Tines 工作流步骤

1. 在 Tines 中创建新 Action：选择 "HTTP Request" 类型，配置请求目标为 run-script 服务地址（如 http://run-script:3000/execute）
2. 配置请求参数：
   • 请求方法：POST
   • 请求体（JSON 格式）：

     json
     {
       "script_type": "bash",  # 脚本类型，如 bash/python
       "script_content": "echo 'Hello from Tines workflow: $INPUT_VALUE'",  # 内联脚本内容
       "input_params": {  # 传递给脚本的参数（会作为环境变量注入）
         "INPUT_VALUE": "{{.previous_action.output.value}}"
       }
     }
     

   • 或通过 script_path 指定挂载目录中的脚本文件："script_path": "/scripts/your-script.sh"
3. 接收执行结果：脚本执行完成后，run-script 服务会返回 JSON 格式结果，包含 status（success/failure）、output（脚本输出）、error（错误信息，如有），可在后续 Tines Action 中引用。

日志与故障排查

• 容器日志可通过 docker logs tines-run-script 查看
• 脚本执行日志默认输出至容器内 /var/log/tines-run-script/ 目录，可通过挂载该目录持久化保存
• 若脚本执行失败，可检查 TINES_URL 和 TINES_API_KEY 配置是否正确，网络是否通畅，以及脚本语法或权限是否存在问题

注意事项

• 生产环境中建议限制 ALLOWED_SCRIPT_TYPES，仅开放必要的脚本类型
• 避免在脚本中使用高权限操作，最小化执行权限以降低安全风险
• 定期更新镜像版本，以获取最新功能和安全修复
• 大规模部署时建议配合 Tines 负载均衡配置，确保高可用性

更多详细信息请参见 Tines 官方文档