通过Puppet执行go env -w设置环境变量失败求助

问题场景 #

尝试通过Puppet配置Go环境变量，使用以下Exec资源：

exec { 'set_go_env':
  command => '/snap/bin/go env -w GOPATH=/root/go/pkg'
}

报错信息 #

执行后返回错误：

'/snap/bin/go env -w GOPATH=/root/go/pkg' returned 1 instead of one of [0]

/Stage[main]/Testmodul/Exec[set_go_env]/returns) change from 'notrun' to ['0'] failed: '/snap/bin/go env -w GOPATH=/root/go/pkg' returned 1 instead of one of [0] (corrective)

/Stage[main]/Testmodul/Exec[set_go_env]/returns) go: cannot find go env config: neither $XDG_CONFIG_HOME nor $HOME are defined

对比测试 #

通过SSH以root身份直接执行命令/snap/bin/go env -w GOPATH=/root/go/pkg，无任何错误。

排查结果 #

• 使用inotifywait检测到/snap/go/10630/go.env被访问；
• auditd日志显示Puppet运行时是以root用户身份访问该文件。

inotifywait日志对比 #

Puppet执行时的日志： #

/var/lib/snapd/inhibit/ OPEN go.lock
/snap/go/10630/meta/ OPEN snap.yaml
/snap/go/10630/meta/ ACCESS snap.yaml
/var/lib/snapd/sequence/ OPEN go.json
/var/lib/snapd/sequence/ ACCESS go.json
/var/lib/snapd/cookie/ OPEN snap.go
/var/lib/snapd/cookie/ ACCESS snap.go
/root/snap/ OPEN,ISDIR go
/root/snap/go/ OPEN,ISDIR 
/root/snap/go/ OPEN,ISDIR 10630
/root/snap/go/10630/ OPEN,ISDIR 
/var/lib/snapd/seccomp/bpf/ OPEN snap.go.go.bin2
/var/lib/snapd/seccomp/bpf/ ACCESS snap.go.go.bin2
/snap/go/10630/meta/ OPEN snap.yaml
/snap/go/10630/meta/ ACCESS snap.yaml
/snap/go/10630/bin/ OPEN go
/snap/go/10630/bin/ ACCESS go
/snap/go/10630/bin/ ACCESS go
/snap/go/10630/ OPEN go.env
/snap/go/10630/ ACCESS go.env

SSH执行时的日志： #

/var/lib/snapd/inhibit/ OPEN go.lock
/snap/go/10630/meta/ OPEN snap.yaml
/snap/go/10630/meta/ ACCESS snap.yaml
/var/lib/snapd/sequence/ OPEN go.json
/var/lib/snapd/sequence/ ACCESS go.json
/var/lib/snapd/cookie/ OPEN snap.go
/var/lib/snapd/cookie/ ACCESS snap.go
/root/snap/ OPEN,ISDIR go
/root/snap/go/ OPEN,ISDIR 
/root/snap/go/ OPEN,ISDIR 10630
/root/snap/go/10630/ OPEN,ISDIR 
/var/lib/snapd/seccomp/bpf/ OPEN snap.go.go.bin2
/var/lib/snapd/seccomp/bpf/ ACCESS snap.go.go.bin2
/snap/go/10630/meta/ OPEN snap.yaml
/snap/go/10630/meta/ ACCESS snap.yaml
/snap/go/10630/bin/ OPEN go
/snap/go/10630/bin/ ACCESS go
/snap/go/10630/bin/ ACCESS go
/root/.config/go/ OPEN env
/root/.config/go/ ACCESS env
/snap/go/10630/ OPEN go.env
/snap/go/10630/ ACCESS go.env
/root/.config/go/ OPEN env
/root/.config/go/ ACCESS env
/root/.config/go/ MODIFY env
/root/.config/go/ OPEN env
/root/.config/go/ MODIFY env

疑问 #

为何Puppet执行时会出现找不到环境变量的错误？

核心原因 #

Puppet执行Exec资源时，默认不会加载用户的shell环境变量——即便以root身份运行，HOME和XDG_CONFIG_HOME这类变量也不会自动设置。而go env -w命令依赖这些变量定位配置文件存储路径（默认是$HOME/.config/go/env），变量缺失时Go命令就会报错。

从inotifywait日志的差异也能验证这一点：SSH执行时会访问并修改/root/.config/go/env，但Puppet执行时完全没触及该路径，说明Go命令根本没找到配置文件的存储位置。

解决方案 #

在Puppet的Exec资源中显式指定所需环境变量即可，修改后的配置如下：

exec { 'set_go_env':
  command     => '/snap/bin/go env -w GOPATH=/root/go/pkg',
  environment => ['HOME=/root', 'XDG_CONFIG_HOME=/root/.config'],
}

也可以通过设置shell => true让Puppet通过shell执行命令，从而加载root的环境变量，但显式设置环境变量的方式更可靠，能避免依赖shell配置的不确定性。

内容的提问来源于stack exchange，提问作者cd4user