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="[***]" \  # 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=[***]
      - 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_URL	Tines 自托管实例的访问地址	-	必需
TINES_API_KEY	用于认证的 Tines API 密钥	-	必需
SCRIPT_TIMEOUT	脚本执行超时时间（秒）	300	可选
LOG_LEVEL	日志输出级别	info	可选
ALLOWED_SCRIPT_TYPES	允许执行的脚本类型（逗号分隔）	bash,python	可选
SCRIPT_WORKDIR	脚本执行工作目录	/tmp	可选

集成 Tines 工作流步骤

在 Tines 中创建新 Action：选择 "HTTP Request" 类型，配置请求目标为 run-script 服务地址（如 [***]）

配置请求参数：

请求方法：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}}"
  }
}