如何为Windows虚拟机配置SaltStack自定义Grains？

一、先搞对文件路径与权限 #

Windows Salt Minion 的默认配置文件目录是 C:\salt\conf，很多人会踩路径错误的坑：

• 单独的 grains 文件要放在 C:\salt\conf\grains，不是根目录的 c:\salt\grains
• 不管用单独 grains 文件还是修改 C:\salt\conf\minion 配置，都要确保文件权限允许Local System账户读取（Minion服务默认用这个账户运行）。右键文件→属性→安全→添加Local System，给它读取权限

二、严格遵守YAML语法规则 #

SaltStack对YAML格式要求很严，这是最容易出错的点：

• 键值对冒号后必须加空格：environment: production（少了空格直接解析失败）
• 绝对不能用Tab键缩进，必须用空格
• 文件编码必须是UTF-8无BOM，Windows记事本默认存的是带BOM的UTF-8，会导致Minion解析出错，用VS Code、Notepad++这类工具保存成无BOM格式

正确配置示例 #

1. 单独 grains 文件（C:\salt\conf\grains）内容：

environment: production
location: dc-1

2. minion 配置文件中添加 grains 段：

grains:
  environment: production
  location: dc-1

三、正确重启Minion服务 #

别只在服务管理器点重启，用管理员权限的PowerShell执行命令更靠谱：

Restart-Service salt-minion

执行完可以检查服务状态确认是否正常启动：

Get-Service salt-minion

四、先本地验证，排除Master端问题 #

在Windows Minion本地先确认grains是否生效，避免白折腾：
打开管理员权限的PowerShell，执行：

salt-call grains.items

如果本地能看到自定义的environment字段，再去Master端执行salt 'wintest-001' grains.items；如果本地也看不到，回头检查配置文件的路径、语法和权限

五、日志排查 #

要是还是不行，直接看Minion日志找错误：
日志文件路径是 C:\salt\var\log\salt\minion，搜索grains关键词，里面会明确提示是解析错误、权限问题还是路径不对

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