IBM Cloud Docs
使用 RabbitMQ 管理插件进行连接

使用 RabbitMQ 管理插件进行连接

缺省情况下, IBM Cloud® Messages for RabbitMQ 部署已启用 RabbitMQ 管理插件,这允许从 Web 浏览器, API 或命令行访问 RabbitMQ 。

RabbitMQ 管理 UI

从部署的 " 仪表板概述" 中的 连接 ,打开 RabbitMQ 管理 UI。

链接以打开 RabbitMQ 管理 UI
图 1。 用于打开 RabbitMQ 管理 UI
的链接

URL 连接信息也在 连接字符串的 "https" 部分中。 RabbitMQ 部署的 Web 地址位于连接字符串的 "组合" 字段中。

由于 Messages for RabbitMQ 部署是使用自签名证书进行签名的,因此首次尝试打开页面时可能会迂到安全警告。 您可以配置系统以信任 提供的自签名证书。 查看浏览器或系统的文档以了解如何执行此操作。

接下来,将要求您输入用户名和密码。 登录后,您可以看到 RabbitMQ 部署的 概述

使用部署上的任何用户来访问 UI。 某些功能仅对随部署一起供应的管理用户可用。

有关更多信息,请参阅 RabbitMQ 管理插件 页面。

通过专用端点进行连接

Messages for RabbitMQ 还提供私有和公共云服务端点。 如果要从不在专用网络上的浏览器访问管理 UI ,那么必须执行 IBM Cloud® 数据库的 通过专用端点连接 文档中列出的这些额外步骤。

配置环境以进行专用端点访问后,可以从浏览器浏览到 Messages for RabbitMQ 管理端点 URL。 例如, https://bfdb-4263-8ad2-c9a4beaf4591.8f7bfc8f3faa4218afd56e0.databases.appdomain.cloud:323232

RabbitMQ 管理 HTTP API

管理插件还为 RabbitMQ 部署提供 API 。 基本端点与使用 /api的浏览器 URL 具有相同的 HTTP URL。 例如, https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/api/

API 使用 application/json 数据并需要基本认证。 您可以使用在部署上创建的任何用户来访问 UI。 但是,某些功能可能仅可供管理用户使用。

随部署一起提供的文档和示例位于浏览器 URL 中的 /api/index.html。 例如, https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/api/index.html

安装 rabbitmqadmin

rabbitmqadmin 二进制文件可直接从部署中获取。 可在管理插件的 /cli 页面上找到下载和安装指示信息。 例如, https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/cli

rabbitmqadmin 还随 RabbitMQ 软件包的完整本地安装一起提供。 但是,如果您下载的软件包版本与部署的 RabbitMQ 版本不匹配,那么可能无法连接。

使用 rabbitmqadmin 进行连接

rabbitmqadmin 连接信息位于 连接字符串的 "cli" 部分中。 该表包含供参考的细目。

表 1。 rabbitmqadmin/cli 连接信息
字段名称 索引 描述
Bin 用于创建连接的建议二进制文件; 在此情况下为 rabbitmqadmin
Composed 用于与部署建立连接的格式化命令。 该命令组合了 Bin 可执行文件, Environment 变量设置,并使用 Arguments
Environment 设置为环境变量的键或值的列表。
Arguments 0... 作为参数传递给 "Bin" 字段中显示的命令的信息。
Certificate Base64 自签名证书,用于确认应用程序连接到相应的服务器。 它是 base64 编码的。
Certificate 名称 自签名证书的已分配名称。
Type 使用此连接信息的包的类型; 在本例中为 cli
  • 0... 指示数组中可能有一个或多个这些条目。

示例命令列出了 RabbitMQ中的所有交换。

rabbitmqadmin --username=admin --password=$PASSWORD --ssl --ssl-ca-cert-file=0b22f14b-7ba2-11e8-b8e9-568642342d40 --host=1a619c43-6415-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud --port=31797 list exchanges
  • rabbitmqadmin -命令本身。
  • --username--password -用于连接的用户的认证。
  • --ssl -确保连接受 TLS/SSL 保护。
  • --ssl-ca-cert-file= -证书的本地副本的路径。
  • --host= -用于指定 rabbitmqadmin 命令连接的端点的参数。
  • --port= -用于指定 RabbitMQ 服务器正在侦听的端口的参数。
  • list exchanges - rabbitmqadmin 命令,用于列出 RabbitMQ 部署的数据库成员。

rabbitmqadmin 的文档和其他示例位于 RabbitMQ 管理命令行工具 页面上。

使用自签名证书

  1. 从连接信息的 Base64 字段复制证书信息。
  2. 将 Base64 字符串解码为文本,并将其保存到文件中。 (您可以使用提供的名称或您自己的文件名)。
  3. 提供 --ssl-ca-cert-file 参数的路径。

您还可以使用命令 ibmcloud cdb deployment-cacert "your-service-name"通过 CLI 插件显示部署的解码证书。 它将 base64 解码为文本。 将命令的输出复制并保存到文件,然后提供该文件的 --ssl-ca-cert-file 参数路径。