脚本

适用版本：1.0.0。任务 → 新增/编辑 → 插件 SCRIPT。

入口与准备

使用 ADMIN 创建、配置和保存任务；ADMIN 或 OPERATOR 可以执行已发布定义，详细日志和输入输出变量由 ADMIN 查看。资源必须启用并可被执行节点访问。任务公共超时、重试和版本规则见任务，角色动作见权限矩阵。

字段说明

“默认值”指 1.0.0 新建表单的初始值；空表示尚未填写，不表示必填项可以省略。显示条件决定当前分支中是否出现字段。“条件必填”只在对应分支启用时要求填写。

执行配置

• 执行方式：LOCAL 在 Worker 执行；SSH 在资源对应远端主机执行。
• SSH 资源：必须选择启用的 SSH 资源。
• 脚本引擎：LOCAL 支持 SHELL/BAT/POWERSHELL/PYTHON；SSH 仅 SHELL/PYTHON。
• Python 解释器：单一解释器命令或路径，不附加参数。
• 脚本内容：脚本内容；支持平台变量替换。
• 工作目录（可选）：LOCAL 留空使用进程默认目录；SSH 填写以 / 开头的远端绝对路径。 本字段不做平台变量插值。
• 脚本编码：生成脚本文件的编码。
• 输出编码：stdout/stderr 解码编码。
• 环境变量：环境变量不是秘密存储；SSH 名称使用 [A-Za-z_][A-Za-z0-9_]*。 本字段不做平台变量插值。

使用边界

• 完整脚本配置最多 8 MiB。
• 脚本 ${name} 由平台替换，原生 ${...} 使用 $${...} 转义。
• 退出码非零表示失败；日志/输出受限。
• SSH 连接关闭不等于远端进程已终止。
• 仅 script 做平台插值；env 和 workingDir 是静态配置值。

典型配置：输出 3 行处理计数

按下表填写界面，资源名称需替换为自己的已启用资源。这是配置说明，不是可直接导入的 JSON。完整数据准备与执行步骤见本节末尾教程。

使用具有BAT或SHELL解释器的执行Worker；此脚本仅输出文本与变量，不实际处理订单。

脚本内容：

echo hello-ijob
echo __VAR__:rows=3
exit 0

预期结果： 实例 SUCCESS，输出变量 rows 为字符串 "3"，日志含 hello-ijob。

跟做完整教程。保存定义后再手动执行；实例状态与业务结果分别核对。

真实界面

技术字段对照

以下键名用于导入配置、接口或排障。规则中的 [] 表示集合元素；不需要把这些键名填入界面标签。

相关页面

任务与版本 · 参数与表达式 · 场景教程