跳至主要内容
版本:4.0

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 工具使用。

运行和管理节点

与其他一些安装方法不同,例如 DebianRPM 软件包,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
© 2024 RabbitMQ. All rights reserved.