Documentation
¶
Overview ¶
Package agentrev 计算「Agent 侧代码指纹」(AgentRev)。
背景(#124 / #143):整个仓库只有一个构建版本号,服务端每热更一次它就变一次;而 Agent 二进制只依赖少数几个包, 这些包没有变化时,不同版本号的 Agent 行为完全一样。拿版本号判断「可升级」,就会在每次服务端热更后让所有主机亮灯, 升级之后也看不出守护进程是否需要重启。
指纹是这些包的非测试源文件加上 go.mod / go.sum 的内容哈希:Agent 侧的代码真的变了,它才会变。 构建 Agent 时由 -X main.rev 注入;分发目录里的 REV 文件记录同一个值,服务端据此判断「可升级」。
设计约束:
- 只看文件内容与相对路径,不依赖 git、不依赖构建机的 Go 版本,所以在 Docker 构建上下文(没有 .git)里也能得到同一个值;
- 换行统一成 \n 再哈希,Windows 检出(CRLF)与 Linux 检出得到同一个值;
- 目录清单是静态的,覆盖是否完整由测试用 go list 在全部发布平台上核对(见 agentrev_test.go),清单漏项会让测试失败。
Index ¶
Constants ¶
View Source
const Length = 12
Length 是指纹的十六进制长度。
Variables ¶
View Source
var Dirs = []string{
"cmd/relaymesh-agent",
"internal/agent",
"internal/agent/cli",
"internal/agent/files",
"internal/agent/holder",
"internal/agent/ptyhost",
"internal/agent/record",
"internal/agent/runlog",
"internal/agent/sshcred",
"internal/buildinfo",
"internal/relsign",
"internal/relsign/trust",
"internal/secure",
"internal/sshexec",
"internal/termproto",
"internal/termstate",
}
Dirs 是 Agent 二进制(cmd/relaymesh-agent)在所有发布平台上依赖的、本模块内的包目录(相对模块根,不含子目录)。 Agent 新增依赖而没有更新这份清单时,agentrev_test.go 里的覆盖测试会失败——这是它唯一的防漏机制,不要绕过。
Functions ¶
func ComputeDirs ¶
ComputeDirs 与 Compute 相同,但目录清单由调用方给出(测试用)。
Types ¶
This section is empty.
Click to show internal directories.
Click to hide internal directories.