execrun

package

v0.1.0 Latest Latest Go to latest Published: Sep 20, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/fleetlyrun/fleetly

Links

Open Source Insights

Documentation ¶

Rendered for

Overview ¶

Package execrun 是平台对外部子进程的统一生命周期封装（MG-1：外部进程/会话生命周期统一封装——架构评审结论：逐点修留漏网即缺机制）。

机制动机：Go 标准库 exec 的 cmd.Run 在「孙进程持有 stdout/stderr 管道写端」时会永久阻塞——cmd.Wait 要等 I/O 拷贝 goroutine 结束，而拷贝要等管道全部写端关闭；直接子进程死了、孙进程（git→ssh、docker exec→容器进程等）仍持有写端时，Wait 永不返回。这不是理论形态：E6（S19）已实证 SSH git 路径的通道失联挂死并打了 WaitDelay 补丁；本批 H3 又确认 webhook 拉源路径的 git fetch 同样裸奔（裸 exec.CommandContext 无 WaitDelay）。机制化的结论：平台拉起的一切外部子进程必须经同一封装治理，不再逐点补丁。

兜底手段（双保险，缺一不可）：

cmd.WaitDelay（Go 1.20+）：ctx 取消杀进程后，若管道写端仍被孙进程持有，Wait 至多再等 WaitDelay 即强制关闭管道并返回——I/O 挂死下 Wait 限时回收的唯一跨平台兜底；
进程组杀（unix）：Setpgid 让子进程自成进程组，ctx 取消时以 syscall.Kill(-pgid, SIGKILL) 组杀——把「只杀直接子进程、孙进程存活」的漏杀面在源头收掉。目标部署形态是 Linux（组杀全程生效）；Windows 无跨平台进程组原语，仅 WaitDelay 兜底。

契约：Run 的阻塞上界 = 调用方 ctx 自身预算 + WaitDelay——调用方永不因子进程/孙进程的 I/O 挂死而无限等待。

Index ¶

func Run(ctx context.Context, name string, args []string, opts Options) ([]byte, error)
type Options

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Run ¶

func Run(ctx context.Context, name string, args []string, opts Options) ([]byte, error)

Run 执行外部命令并等待其结束，返回捕获的 stderr 字节与错误。

生命周期保证（MG-1）：ctx 取消 → 子进程（unix 上连带整个进程组）被杀；孙进程持有 stderr 管道写端时 Wait 至多再等 WaitDelay 即返回。错误判定：进程被杀形态返回 *exec.ExitError（signal: killed）；进程在取消后仍以成功码退出等罕见竞态返回 ctx 错误——两者都把失败归因到「ctx 取消」这一唯一触发源，调用方以 err != nil && ctx.Err() != nil 判定即可。

Types ¶

type Options ¶

type Options struct {
	// Dir 是子进程工作目录（空 = 继承当前进程）。
	Dir string
	// Env 是追加在 os.Environ() 之上的环境变量（KEY=VALUE 词形）。
	Env []string
	// WaitDelay 覆盖缺省兜底上限；<=0 取 defaultWaitDelay。
	WaitDelay time.Duration
}

Options 是 Run 的可选参数（零值全取缺省）。

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL