RabbitMQ的使用(一)- RabbitMQ服务安装

RabbitMQ的使用(一)- RabbitMQ服务安装

作者:markjiang7m2
原文地址:https://www.cnblogs.com/markjiang7m2/p/12769627.html
官网地址:http://letyouknow.net

RabbitMQ,消息队列的一个中间件,这里不打算展开介绍了。此文意在记录工作中使用RabbitMQ时的过程及一些心得,大神可忽略。如有表述有误,各路大神可在留言区进行指正,不胜感谢。

Windows系统中安装RabbitMQ服务

安装Erlang运行环境

RabbitMQ是采用Erlang实现的,所以需要安装Erlang的运行环境。

安装Erlang OTP,官网下载https://www.erlang.org/downloads,版本自行选择,我这里用的是otp_win64_22.3.exe,下载完可执行文件双击运行安装即可,这里不展开。

安装RabbitMQ

官网下载https://www.rabbitmq.com/download.html,版本自行选择,我这里用的是rabbitmq-server-3.8.3.exe,也是直接安装即可,这里不展开

启动RabbitMQ服务

打开cmd命令框,切换至C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.3\sbin目录下,输入rabbitmqctl status查看状态,如果未启动,则可以通过rabbitmq-service进行启动,或者到Windows服务启动

RabbitMQ的使用(一)- RabbitMQ服务安装

RabbitMQ的使用(一)- RabbitMQ服务安装

rabbitmq-service命令如下,按需执行:

# 安装RabbitMQ服务
rabbitmq-service install
# 启动RabbitMQ服务
rabbitmq-service start
# 停止RabbitMQ服务
rabbitmq-service stop
# 删除RabbitMQ服务
rabbitmq-service remove

RabbitMQ的使用(一)- RabbitMQ服务安装

启用RabbitMQ管理插件

#cmd命令
rabbitmq-plugins.bat enable rabbitmq_management

然后在浏览器访问地址http://localhost:15672/,输入默认用户名和密码,都是guest

RabbitMQ的使用(一)- RabbitMQ服务安装

可以看到刚刚已经安装的RabbitMQ节点

一般我们都会先创建一个使用的user和virtual host,可以通过rabbitmqctl命令或者管理界面进行创建,我这里就直接在界面操作了。

RabbitMQ的使用(一)- RabbitMQ服务安装

RabbitMQ的使用(一)- RabbitMQ服务安装

分配user对我们将要用到的virtual host的权限

RabbitMQ的使用(一)- RabbitMQ服务安装

到这里为止,就已经完成了RabbitMQ服务的安装了。

自定义配置

RabbitMQ 服务默认监听的端口为5672,管理插件默认监听的端口为15672,那如果我们要更改这些端口,应该怎么做呢?

先贴出官网提供的文档链接https://www.rabbitmq.com/configure.html

其实官网说得很详细,我自己整理了一些我有用到的。

首先,RabbitMQ支持通过添加系统环境变量进行定制化配置。

RABBITMQ_NODE_PORT: 默认值为5672,RabbitMQ服务监听端口

RABBITMQ_NODENAME: Windows系统下默认值为%COMPUTERNAME%,RabbitMQ节点的名称

RABBITMQ_SERVICENAME: 默认值为RabbitMQ,RabbitMQ服务名称

添加/修改了系统环境变量后,需要重新安装RabbitMQ服务才能生效,是重新安装,不是重启,使用rabbitmq-service命令

再来看看我们创建的RabbitMQ节点的一些信息

RabbitMQ的使用(一)- RabbitMQ服务安装

这里就包含配置文件路径,数据库文件路径,日志文件路径,默认路径都是在C:\Users\%UserName%\AppData\Roaming\RabbitMQ目录下,也是可以通过环境变量进行个性化定制

RABBITMQ_CONFIG_FILE: 配置文件路径,默认值为%APPDATA%\RabbitMQ\rabbitmq,官文也特别说明了,配置的时候是不带文件后缀名的

RABBITMQ_ADVANCED_CONFIG_FILE: Advanced配置文件路径,默认值为%APPDATA%\RabbitMQ\advanced,同上,不带文件后缀名

RABBITMQ_MNESIA_DIR: 数据库文件路径,默认值为%APPDATA%\RabbitMQ$RABBITMQ_NODENAME

到了这里,我在做实际操作的时候是有疑问的,因为出现了三个文件分别是rabbitmq.conf, rabbitmq.config, advanced.config,特别是前面两个,一开始我一度认为只是官文不小心写错了,它们说的应该是同一个文件,然而并不是,而且这两个配置文件的写法也不一样,我又仔细看了看上面链接的官文,自己也做了一下实验,得到了下面的结论(如果有不对的,各路大神请指正)。

rabbitmq.config为RabbitMQ 3.7.0之前使用的默认配置文件,写法使用的是Erlang格式,rabbitmq.conf是RabbitMQ 3.7.0版本开始使用的默认配置文件,写法使用的是sysctl格式。而advanced.config则是因为有一些配置无法或者很难用sysctl格式进行书写的,那就写在这个advanced.config文件中,所以advanced.config的写法使用的是Erlang格式。

旧版Erlang格式

[
  {rabbit, [{ssl_options, [{cacertfile,           "/path/to/ca_certificate.pem"},
                           {certfile,             "/path/to/server_certificate.pem"},
                           {keyfile,              "/path/to/server_key.pem"},
                           {verify,               verify_peer},
                           {fail_if_no_peer_cert, true}]}]}
].

新版sysctl格式

ssl_options.cacertfile           = /path/to/ca_certificate.pem
ssl_options.certfile             = /path/to/server_certificate.pem
ssl_options.keyfile              = /path/to/server_key.pem
ssl_options.verify               = verify_peer
ssl_options.fail_if_no_peer_cert = true

然后,为了兼容大家使用的旧版配置文件,新版RabbitMQ也仍然兼容rabbitmq.config配置,只是在安装服务的时候会有输出提示让大家尽快升级到新版。
那么这个时候就会有一个问题了,上面我们的环境变量RABBITMQ_CONFIG_FILE是说不包含文件后缀名的,那如果我两个文件同时存在,到底会是哪个配置文件被优先使用呢?

  • 如果rabbitmq.configrabbitmq.conf文件都不存在,优先使用advanced.config中的配置
  • 只要rabbitmq.config存在,优先使用rabbitmq.config文件,直接忽略advanced.config文件
  • 如果rabbitmq.config不存在,而rabbitmq.confadvanced.config同时存在,则这两个文件都会被使用

如果我们指定RABBITMQ_CONFIG_FILE为其它文件名或者其它路径,情况也是参考如上。

这里还有一个环境变量RABBITMQ_CONF_ENV_FILE,在Windows系统中对应的是一个批处理文件,通常命名为rabbitmq-env-conf.bat,只要我们配置了这个环境变量,那么刚刚前面我们提到的环境变量,都可以在这个批处理文件中添加,如下:

set RABBITMQ_CONFIG_FILE=D:\RabbitMQ\myrabbitmq.config

也是要注意的,记得重新安装服务。

所以回到我们一开始的问题,怎么修改RabbitMQ服务监听端口和管理插件监听端口?

  1. 通过环境变量RABBITMQ_NODE_PORT可以修改RabbitMQ服务监听端口
  2. 通过rabbitmq.configadvanced.config添加如下配置,使用Erlang格式:
[
  {rabbit, [
      {tcp_listeners, [5675]}
    ]
  },
  {rabbitmq_management, [
      {listener, [{port, 15675}]}
    ]
  }
].
  1. 通过rabbitmq.conf添加如下配置,使用sysctl格式:
listeners.tcp.default = 5675
    management.tcp.port = 15675

更多的配置项,可以查看官文https://www.rabbitmq.com/configure.html#config-itemshttps://www.rabbitmq.com/management.html,按需配置即可。

附带这三个文件的example文件
rabbitmq.config.example
rabbitmq.conf.example
advanced.config

总结

本文就记录了我在windows系统安装RabbitMQ服务的过程,没有太多的干货,但也确实在百度上能找到关于自定义配置的说明并不多,说得也比较模糊,所以我这里就给自己做了个笔记,下次再用的时候就不会迷路了,希望也能给各位提供一些有用信息。