@genroc/eval-node (英语)
类型脚本任务 流派。软件包提供了两个二进制:
genroc-import:捆绑人.genctl运行在每一个apply财务报告和审定财务报表generate转向$import: ./script.ts输入一个已选中的自定义模块字符串.genroc-eval-node曰:工人来也. 它从 genroc 队列中声称脚本任务并运行每个任务 一个在新鲜的工人线.
要求数 节点24+。完整指南 : 类型脚本评价。 。 。 .
快开始
genctl init --eval-node
这台脚手架上有一个项目 包,一个 .genroc 登记
解析器, a tsconfig.json,可重用 script-node 儿童过程,a compose.yaml 那个
经营工人.
添加到现有项目
npm i -D @genroc/eval-node
在 .genroc 除定义外:
resolvers:
- name: import
phase: typed
ext: [.ts]
command: [npx, genroc-import]
types:
Input: task.action.input.input
Output: task.action.result
然后引用任务中的脚本 。 最简单的方式是传播 script-node 那个孩子
genctl init --eval-node 生成 :
- id: greet
action:
type: child
<<: "$process: ./script-node.genroc.yaml"
input:
code: "$import: ./greet.ts"
input: { who: "$: input.who" }
result_schema:
type: object
properties: { greeting: { type: string } }
required: [greeting]
写入脚本
脚本是ES模块. 它的默认导出收到 input,其返回值变为
任务结果。 该函数可能是同位素.
import type { Input, Output } from "./greet.genroc";
export default function (input: Input): Output {
return { greeting: `hello, ${input.who}` };
}
genctl generate写入greet.genroc.d.ts除了剧本.Input财务报告和审定财务报表Output来自 定义,所以不匹配会失败类型检查 .genctl apply类型检查和捆绑. 类型错误或缺少默认导出失败 应用.- 导入的文件和 npm 包被嵌入到捆绑中, 所以一个存储的定义永远不会
取决于以后安装什么。 节点内建( N)
node:fs,.)保持为进口并解决 对工人. - 生成的配置扩展您最近的
tsconfig.json。使用节点环球和 内建, 添加"types": ["node"]对它.
经营工人
docker run -e GENROC_SERVER=http://host:8448 ghcr.io/genroc/eval-node:latest
# or
GENROC_SERVER=http://localhost:8448 npx genroc-eval-node
工人与genroc相接,而不是相反,所以它只需要外出访问.
| 环境 | 默认 | |
|---|---|---|
GENROC_SERVER | http://localhost:8448 | 流派服务器 |
GENROC_TOKEN 编号 : GENROC_TOKEN_FILE | (无) | 当服务器使用时, 指示符, 或持有它的文件 --auth |
PROCESS 编号 : TASK | script-node 编号 : eval_node | 进程和任务 ID 这个工人的主张; 默认是脚本节点的。 设定 PROCESS 重命名为副本。 也可能是空的. |
CONCURRENCY | 4 | 脚本立即运行 |
LEASE_MS | 30000 | 索赔租赁,每三分之一续租一次 |
POLL_MS | 250 | 闲置民意调查间隔 |
WORKER_ID | evaluator-<pid> | 索赔人的姓名 |
在启用了认证后,创建一个只有 worker 权限 :
genctl token create --perms worker --label evaluator -q
如果拒绝批准,工人将退出,而不是重新试验.
错误
当一个脚本失败时, 工人会为您报告五个错误代码中的一个 on_error 规则
相匹配的。 匹配的。 重试对其中任何一个都无济于事,因为同一代码失败的方式相同:
| 代码 | 何时 |
|---|---|
threw | 脚本扔出或拒绝 |
timeout | 它跑过了任务 timeout (任务无时为5000毫秒) |
compile_error | 模块不解析或没有默认导出功能 |
nonserializable | 返回值不能序列化为 JSON(周期, a) BigInt(中文(简体) ) |
exited | 脚本调用 process.exit() |
error.data 实值 {name, stack?}。 。 。 . name 错误的类名, 所以丢弃自己的
class LimitExceeded extends Error {} 区分失败; 设置 e.name 推翻它,
和被扔的无Error 实值 Thrown。堆栈被映射回您的源线.
如果工人本身有过失,则会为另一名工人释放任务,并报告没有出错.
任务就是 timeout 是脚本的预算,在包含的队列中等待。 工人停下来了
之前的剧本和答案 timeout这样 external.timeout 意味着没有工人回答
一点也不 与 script-node,设置它通过 timeout_ms 输入.
限制
- 不是一个沙盒. 脚本有工人宿主的文件系统,网络和环境. 只运行你信任的代码.
- 不是决定主义的. 在一次重试中, 脚本再次以真实的时钟和随机运行
数字。 传递任何必须保持稳定的值
input。 。 。 . - 记忆不是孤立的. 一部没有记忆的剧本 摧毁了整个工人.
- 运行即是选入. 如果一个工人中途死亡, 任务再次要求和脚本
再次运行。 标记任务
only_once如果您的脚本有副作用. - 内置代码需要逃跑. 当你写的时候
code直接在YAML中而不是$import,写入${作为$${,因为流派读取${作为插入。 脚本在.ts文件不需要逃跑 .