Homebrew RabbitMQ 公式
概述
Homebrew 是 macOS 和 Linux 的一个流行的软件包管理器。一个 RabbitMQ 公式 可从 Homebrew 的核心库(开箱即用)获得。该公式由 Homebrew 社区维护,而不是 RabbitMQ 团队。
将安装最新 支持的 Erlang/OTP 版本 作为依赖项。
请从头到尾阅读本简短指南。该公式有一些注意事项,其中一些可能导致节点无法升级到 RabbitMQ 3.12 及更高版本,因为已禁用了稳定的 功能标记。
安装
在安装之前,请确保库已更新
brew update
然后,使用以下命令安装 RabbitMQ 服务器
brew install rabbitmq
安装 RabbitMQ 公式将安装关键依赖项,例如 支持的 Erlang/OTP 版本。
但是,安装公式不会启动服务(RabbitMQ 节点)。请参阅下面的 运行和管理节点。
位置
RabbitMQ 服务器脚本和 CLI 工具 都安装到 Intel Mac 上 /usr/local/Cellar/rabbitmq/{version}/
或 Apple Silicon Mac 上 /opt/homebrew/Cellar/rabbitmq/{version}/
下的 sbin
目录中。
它们应该可以通过 Intel Mac 上的 /usr/local/opt/rabbitmq/sbin
或 Apple Silicon Mac 上的 /opt/homebrew/opt/rabbitmq/sbin
访问。指向二进制文件的链接已在 Intel Mac 上的 /usr/local/sbin
或 Apple Silicon Mac 上的 /opt/homebrew/sbin
下创建。
要找出您的安装位置,请使用
brew info rabbitmq
有效操作系统用户
使用 Homebrew,节点和 CLI 工具默认使用登录的 OS 用户帐户。这对于开发环境来说是最佳的,意味着相同的 共享密钥文件 由 RabbitMQ 节点和 CLI 工具使用。
运行和管理节点
与其他一些安装方法不同,例如 Debian 和 RPM 软件包,RabbitMQ Homebrew 公式使用 通用 UNIX 二进制构建 并且不需要 sudo
。
启动服务器
在前台启动节点
要在前台启动节点,请运行
CONF_ENV_FILE="/opt/homebrew/etc/rabbitmq/rabbitmq-env.conf" /opt/homebrew/opt/rabbitmq/sbin/rabbitmq-server
在启动节点后,建议在节点上启用所有功能标记
# highly recommended: enable all feature flags on the running node
/opt/homebrew/sbin/rabbitmqctl enable_feature_flag all
在后台启动节点
要在后台启动节点,请使用 brew services start
# starts a local RabbitMQ node
brew services start rabbitmq
# highly recommended: enable all feature flags on the running node
/opt/homebrew/sbin/rabbitmqctl enable_feature_flag all
停止服务器
要停止运行的节点,请使用
# stops the locally running RabbitMQ node
brew services stop rabbitmq
或直接使用 CLI 工具
/opt/homebrew/sbin/rabbitmqctl shutdown
```bash
The command will wait for the node process to stop. If the target node is not running,
it will exit with a warning.
## Using RabbitMQ CLI Tools with Homebrew \{#cli}
The formula sets up links to CLI tools under `/usr/local/sbin` for Intel Macs or `/opt/homebrew/sbin` for Apple Silicon Macs.
In case that directory is not in `PATH`, it is recommended to append it:
```bash
# for macOS Intel
export PATH=$PATH:/usr/local/sbin
# for Apple Silicon
export PATH=$PATH:/opt/homebrew/sbin
将上述导出添加到 shell 配置文件(如 bash 的 ~/.bashrc
或 zsh 的 ~/.zshrc
)中,以便在每个新 shell(包括 OS 重启)中更新 PATH
。
启用功能标记
Homebrew 公式在安装后不会启用 功能标记。要在安装后启用所有功能标记(这对获取某些功能的访问权限以及未来的版本兼容性来说非常重要),请使用
/opt/homebrew/sbin/rabbitmqctl enable_feature_flag all
配置 Homebrew 安装的 RabbitMQ 节点
Homebrew 使用的文件和目录位置因 Intel Mac 和 Apple Silicon Mac 而异。要找出您的安装位置,请使用
brew info rabbitmq
在 Apple Silicon Mac 上,RabbitMQ 配置文件 位于 /opt/homebrew/etc/rabbitmq/rabbitmq.conf
。该文件默认不存在,必须由用户创建。然后,必须重新启动节点,以便它在引导时获取新的配置文件。
可以使用 环境变量 来控制某些设置。rabbitmq-env.conf
位于 /opt/homebrew/etc/rabbitmq/rabbitmq-env.conf
请参阅 RabbitMQ 配置指南 以了解详细信息。
重新安装公式
要重新安装公式,例如,如果旧的安装无法升级,因为它 没有主动启用所有功能标记,请先卸载它,然后删除所有节点数据文件
brew services stop rabbitmq
brew uninstall rabbitmq
# Now delete all node's data directories and configuration files.
# This assumes that Homebrew root is at /opt/homebrew
rm -rf /opt/homebrew/etc/rabbitmq/
rm -rf /opt/homebrew/opt/rabbitmq/
rm -rf /opt/homebrew/var/lib/rabbitmq/
# the launch agent file
rm -f $HOME/Library/LaunchAgents/homebrew.mxcl.rabbitmq.plist
# re-install
brew install rabbitmq
## start the service if necessary
# brew services start rabbitmq
## after starting the service, enable all feature flags
# /opt/homebrew/sbin/rabbitmqctl enable_feature_flag all