文档目录
系统
跨端
计算与环境分开;远端工作区;在另一台电脑上执行 PowerShell 或 Bash。
计算与环境
一个会话有两个「在哪」,建会话时定下,之后不变:
| 名字 | 是什么 |
|---|---|
| 计算 | 会话的 Harness 在哪台 Client 上启动 |
| 环境 | 会话干活的地方:一台 Client 和它上面的一个目录 |
| 会话 | 计算 | 环境 |
|---|---|---|
| 工作流步骤的作者、评审者 | 角色绑定的 Client | 运行的 Repo 所在的 Client,目录是 Repo 的主检出 |
| 你直接开的会话 | 你选的那台 Client 上的 Harness | 你选的 Client 与文件夹 |
两者在同一台时是本机会话,不在同一台时是远端工作区。对引擎、界面和 Router 来说,两种会话是同一个 Worker。
所以没装 Harness 的电脑也能放要干活的仓库。别人的电脑上只装了一个 Harness 时,把一个角色绑到那台上,Desk 就能异步地驱动它干活。
远端工作区
计算那台上放一份环境目录的镜像。Agent 用 Harness 自带的工具读、搜、改镜像里的文件;命令(测试、构建、Git)经 ail shell 在环境那台执行,执行前后自动同步两边的文件。
- 镜像在计算那台的状态目录里。环境目录是 Git 检出时,镜像里是 Git 看得到的文件;被忽略的文件不同步,
.git不进镜像。 - 每一轮开始前、结束后各同步一次,每条
ail shell前后也各同步一次。所以环境上的命令和引擎看到的,总是 Agent 改过的文件。 ail get、ail put在本机和环境之间取、放单个文件,不受忽略规则限制。- 同步有冲突时这一轮以
SYNC_CONFLICT失败,由 Agent 定下用哪一边。
选镜像而不是「每个文件都经网络读写」,是因为读、搜、改都在本机:延迟再大,也只有几次命令过网络。
非交互执行
ail shell 在某个 Client 上跑一条 PowerShell 或 Bash 命令。发起方把请求交给 Desk,Desk 鉴权后转给目标 Client 的 Daemon 执行,结果原路返回。
ail shell --target home-server --shell bash "uname -a"
含引号、$、换行的命令经标准输入传,逐字节送达:
ail shell --target home-server --shell bash --stdin <<'EOF'
df -h / | tail -1
EOF
请求的字段:
| 字段 | 含义 |
|---|---|
target |
目标 Client 的 id。不写时是发起会话的环境所在的 Client |
shell |
powershell 或 bash |
command |
命令文本,原样交给 shell |
cwd |
可选,目标机上的工作目录 |
timeout_s |
可选,默认 30,上限 600 |
结果的字段:
| 字段 | 含义 |
|---|---|
ok |
请求是否被执行了。命令自己失败(非 0 退出码)时仍是 true |
exit_code |
退出码,超时是 124 |
stdout、stderr |
UTF-8 文本,各自最多 64KB |
duration_ms、timed_out、truncated |
耗时、是否超时、是否截断过 |
执行的规则:
- 不等输入。 命令的标准输入是关着的,要读输入的命令立刻得到 EOF。
- 超时杀整棵进程树。 Windows 用 Job Object,Linux 用进程组。
- 编码一律 UTF-8。
- 不顶替。 目标机上没有请求的 shell 就报
SHELL_NOT_AVAILABLE,不换另一种。 - 命令以 Daemon 的运行用户执行。
命令行最多等 8 秒。命令没结束时返回 pending,命令在目标机上照常跑完,结果用 ail op 取。
谁可以对哪台 Client 用哪种 shell,由 Desk 上的授权规则决定,默认拒绝。
交互式控制台
你在创建会话页选 Client、文件夹和 PowerShell 或 Bash,得到一个终端页签。Daemon 在本机开伪终端,字节流经 Desk 转给浏览器。只有你能开控制台;Agent 只有非交互执行。