使用SaltStack管理macOS时Homebrew部署报错求助

管理几十台Mac电脑，需完成：

• 部署Putty、Git、Draw-io、Mosquitto等软件
• 限制用户权限（如禁止自行下载软件）

已完成前置配置：

• 每台Mac手动安装SaltStack
• 配置Salt Master并完成密钥认证

执行部署命令时持续报错，执行命令：

salt 'MAC-08-mac.local' state.highstate saltenv=development

报错信息 #

ID: homebrew
        Function: pkg.installed
          Result: False
         Comment: Unable to run command '['brew', '--prefix']' with the context '{'cwd': '/var/root', 'shell': False, 'env': {'OLDPWD': '/', 'PATH':
 '/usr/bin:/bin:/usr/sbin:/sbin', 'PWD': '/opt/salt', 'XPC_FLAGS': '0x0',
 'XPC_SERVICE_NAME': '0', 'SHLVL': '0', 'LC_CTYPE': 'C', 'SSL_CERT_DIR':
 '/private/etc/ssl/certs', 'SSL_CERT_FILE': '/private/etc/ssl/cert.pem',
 'LC_NUMERIC': 'C', 'LC_TIME': 'C', 'LC_COLLATE': 'C', 'LC_MONETARY': 'C',
 'LC_MESSAGES': 'C', 'LC_PAPER': 'C', 'LC_NAME': 'C', 'LC_ADDRESS': 'C',
 'LC_TELEPHONE': 'C', 'LC_MEASUREMENT': 'C', 'LC_IDENTIFICATION': 'C',
 'LANGUAGE': 'C'}, 'stdin': None, 'stdout': -1, 'stderr': -2, 
'with_communicate': True, 'timeout': None, 'bg': False, 'close_fds': True}',
 reason: [Errno 2] No such file or directory: 'brew'
         Started: 17:51:13.166312
        Duration: 15.798 ms
         Changes:
     
              ID: putty
        Function: pkg.installed
          Result: False
         Comment: One or more requisite failed: mac.software.putty.homebrew
         Started: 17:51:13.182820
        Duration: 0.003 ms
         Changes:
    -----------
    Summary for MAC-08-mac.local

已尝试方案 #

• 单独安装Homebrew后再部署Putty
• 修改/etc/salt/minion的sudo_user及user参数
• 使用Homebrew Cask扩展

相关SLS文件 #

putty.sls #

putty:
  pkg.installed:
    - require:
      - pkg: homebrew

homebrew.sls #

homebrew:
  pkg.installed

software-mac.sls #

include:
#soft
  - software.homebrew
  - software.putty

问题根源 #

1. PATH环境变量缺失：Salt Minion以root身份运行时，默认PATH仅包含/usr/bin:/bin:/usr/sbin:/sbin，而Homebrew默认安装路径（Intel Mac为/usr/local/bin，Apple Silicon Mac为/opt/homebrew/bin）不在该列表中，导致Salt无法找到brew命令。
2. HOME环境变量不匹配：Salt运行时的HOME目录为/var/root，而手动安装Homebrew时通常是在普通用户目录下完成，root用户未初始化Homebrew的环境配置。
3. 权限与路径冲突：普通用户安装的Homebrew，root用户因权限或路径问题无法直接调用。

解决方法 #

方法1：修正Salt Minion的环境变量 #

编辑/etc/salt/minion，添加PATH配置：

env:
  PATH: "/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"

重启Salt Minion服务：

sudo launchctl restart com.saltstack.salt.minion

方法2：通过脚本自动安装并指定Homebrew路径 #

修改homebrew.sls，先通过命令安装Homebrew，再指定brew路径：

install_homebrew:
  cmd.run:
    - name: |
        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    - creates: /usr/local/bin/brew  # Intel Mac使用此路径
        # creates: /opt/homebrew/bin/brew  # Apple Silicon Mac使用此路径

homebrew:
  pkg.installed:
    - require:
      - cmd: install_homebrew
    - brew_path: /usr/local/bin/brew  # 对应上面的安装路径

方法3：指定Salt运行的用户 #

若需以普通用户身份运行Homebrew，修改/etc/salt/minion：

user: 你的管理员用户名
sudo_user: root

确保该管理员用户已安装Homebrew，且其PATH包含brew路径。

方法4：初始化root用户的Homebrew环境 #

若已手动安装Homebrew，切换到root用户执行：

# Intel Mac
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> /var/root/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

# Apple Silicon Mac
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /var/root/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

参考资料 #

• SaltStack官方文档：macOS平台pkg模块使用说明
• Homebrew官方文档：多用户环境下的安装与配置指南

内容的提问来源于stack exchange，提问作者PUBG MOBILE NoVeL