@godspideai/cognate-execution-wsl (英语)
作为Cognate执行世界的 WSL 分布: 文件系统和进程端口已执行 wsl.exe,在与其他所有供应商相同的合同背后——所以一个代理工具在Linux内部运行,而主机则停留在任何地方. 根是 POSIX 路径 分布式内; 从来没有Windows路径进入合同.
工作地点: 此提供者在 WSL 内部运行的 Linux 主机上被执行( Windows interop) wsl.exe 编辑 PATH) (中文(简体) ). 一个运行 Bun 的本地Windows主机未经测试,没有WSL安装和发行对象,提供商就毫无意义. 如果你只需要一个"Linux盒子", @godspeedai/cognate-execution-ssh 是更便携式的远程提供者.
安装
bun add @godspeedai/cognate-execution-wsl
要求数 阿宝 1.4.0, WSL 安装可透过 wsl.exe (以 wslBin),以及 @godspeedai/cognate-execution,其合同 这个提供者执行.
快开始
import { wslExecutionWorld } from "@godspeedai/cognate-execution-wsl";
const world = wslExecutionWorld({ worldId: "ubuntu", distro: "Ubuntu-24.04" });
const path = world.fileSystem.resolve("/home/me/project", "README.md");
const readme = await world.fileSystem.readText(path);
const result = await world.process.exec({ argv: ["cargo", "test"], cwd: "/home/me/project", timeoutMs: 300_000 });
console.log(result.exitCode, result.stdout, result.timedOut);
await world.dispose();
设计:发射 wsl.exe 尽可能少
wsl.exe 是堆栈的脆弱部分——在冷冷的分发上发射需要几秒钟,在装入Windows WSL服务时断断续续或失败发射(平面) wsl.exe -e true 已用9至20秒测量。 因此,提供者保留了一小批持久性的 sh -s 分布和运行 所有的东西 通过它们作为框架请求(出站、出站和在唯一标记之间的退出状态返回):
- 在稳定状态下,一个代理运行 发射没有
wsl.exe;只有会话启动才有。 一场未能上台的会话,在世界未能结束之前就被取代了. - 一个命令在自己的进程组中运行( O)
setsid) (中文(简体) ). 超时或中止时,该组从第二会场中被杀死,作为最后手段,繁忙会场被关闭——结束wsl.exe结束一切它开始, 所以整个过程树死亡. - 命令在不同的会话中平行运行;闲会返回池(最多为4个),一旦没有世界使用,则在短暂的宽限期后关闭. 一个会话的寿命被束缚在它的斯丁管上,所以如果主机进程死亡,它就会自行结束. 举行会话也使发行不被WSL闲置关闭.
- 文件操作基于
commandFileSystem从@godspeedai/cognate-execution,所以相同的形状适合容器. - 失败从来不是沉默,也不会是本地的:一个缺失
wsl.exe,无法到达的分布,或被支配的世界上升WorldUnavailableError。 。 。 .
选项
| 选项 | 含义 |
|---|---|
worldId, (中文(简体) ), distro | 注册名称和 WSL 分布到目标 |
user? | Linux 用户在发行区内部(wsl.exe -u; 默认省略 |
wslBin? | 路径 wsl.exe 二进制( 默认 ): wsl.exe 编辑 PATH(中文(简体) ) |
defaultTimeoutMs? | 默认命令超时( 30 s) |
fileOpTimeoutMs? | 固定会话中一个文件操作的停顿预算( 重新开始并重试一次) |
sessionStartTimeoutMs? | 开新会需要多长时间 |
maxOutputBytes? | 每个命令输出上限( 10 MiB) |
shellCommand? | 测试接合器替换整个发射命令(必须从 stdin 读取脚本类似 sh -s(中文(简体) ) |
限制
- 从WSL内部(使用Windows interop的Linux主机);运行 Bun的本地Windows主机尚未测试.
- WSL 自己的服务仍然可以失败会话启动; 错误报告
wsl.exe而不是回到本地执行. - 封装用途
realpath- 基于检查(检查-当时使用);不阻止同时互换的同义链接.
相关软件包
@godspeedai/cognate-execution合同和合规套件.@godspeedai/cognate-execution-ssh——SSH主机提供商,可移植替代品.@godspeedai/cognateSDK伞.
许可证
阿帕奇 - 2.0