agentrev

package
v2.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 25, 2026 License: Apache-2.0 Imports: 9 Imported by: 0

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 Compute

func Compute(root string) (string, error)

Compute 计算模块根 root 下的 Agent 侧代码指纹(Length 位小写十六进制)。

func ComputeDirs

func ComputeDirs(root string, dirs []string) (string, error)

ComputeDirs 与 Compute 相同,但目录清单由调用方给出(测试用)。

func Files

func Files(root string, dirs []string) ([]string, error)

Files 返回参与指纹的文件(相对模块根、斜杠分隔、按路径排序):go.mod / go.sum,以及各目录下的非测试 .go 文件。 所有平台的文件都计入(含 _windows.go 之类),所以同一份源码在任何平台上算出同一个指纹。

Types

This section is empty.

Jump to

Keyboard shortcuts

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