RabbitMQ 3.7+ CLI 工具架构设计:从 rabbitmqctl 到可扩展的 Elixir 命令框架
RabbitMQ 3.7+ CLI 工具架构设计:从 rabbitmqctl 到可扩展的 Elixir 命令框架
导读
本文基于 deps/rabbitmq_cli/DESIGN.md,系统讲解 RabbitMQ 自 3.7.0 起全新 CLI 工具套件(rabbitmqctl、rabbitmq-plugins、rabbitmq-diagnostics)的架构设计:包括命令执行全流程、RabbitMQ.CLI.CommandBehaviour 行为契约、命令作用域(scope)、可插拔的输出格式化体系以及环境配置机制。读完本文,你将理解 CLI 是如何在 Elixir 中实现"每个命令独立成模块、支持插件扩展、多工具共享命令、多种输出格式"的,并掌握编写自定义命令与别名配置的完整方法。
一、设计背景:为什么要重写 CLI
RabbitMQ 3.7 之前,rabbitmqctl 存在一系列难以维护的问题,DESIGN.md 中明确列出旧工具套件的痛点:
- 内置于 RabbitMQ server 代码中,与服务器耦合过深;
- 使用自研的参数解析器,功能有限且不易维护;
- 通过
erl启动,依赖大量与安装环境相关的启动参数; - 单个工具承载了过多命令,入口臃肿;
- 所有命令都放在同一个模块(仅靠函数子句区分),代码量庞大且难以扩展。
新 CLI 从设计上针对性地解决了上述问题:
- 独立成库,以 Elixir 实现,使用 Elixir 标准
OptionParser解析命令行参数; - 每个命令是独立模块,职责单一;
- 可扩展:插件可以注册自己的命令;
- 命令输出支持多种格式(如 JSON、CSV);
- 编译为单个可执行 escript 文件,除 Erlang 运行时外自带全部依赖;
- 引入命令作用域(command scopes),使不同工具(如
rabbitmq-diagnostics)复用rabbitmqctl中的相关命令。
二、总体架构
DESIGN.md 将 CLI 核心拆分为若干模块,职责如下:
| 模块 | 职责 |
|---|---|
RabbitMQCtl |
入口点,通用执行逻辑 |
Parser |
命令行参数解析(驱动 Elixir 的 OptionParser) |
CommandModules |
命令模块的发现与加载 |
Config |
配置统一:合并环境变量与命令行参数值 |
Output |
输出格式化 |
Helpers |
通用辅助函数 |
在仓库源码中,这些模块位于 deps/rabbitmq_cli/lib/rabbitmq/cli/core/ 目录,入口模块为 deps/rabbitmq_cli/lib/rabbitmqctl.ex。
2.1 命令执行全过程
2.1.1 参数解析
命令行参数由 Elixir 标准库 OptionParser 解析。解析结果分为两部分:
- 无名参数(unnamed arguments):一个字符串列表,第一个元素是命令名;
- 命名参数(named arguments):一个 options 映射(map)。
命名参数分为全局参数和命令专属参数两类。命令专属参数的名称与类型在命令模块的 switches/0 回调中声明;全局参数则在 deps/rabbitmq_cli/lib/rabbitmq/cli/core/parser.ex 的 default_switches/0 与 default_aliases/0 中集中定义。该文件中可见全局开关包括 node、quiet、silent、dry_run、vhost、timeout、longnames、formatter、printer、file、script_name、rabbitmq_home、data_dir、plugins_dir、enabled_plugins_file、aliases_file、erlang_cookie、help、print_stacktrace 等,其单字母别名如 p: :vhost、n: :node、q: :quiet、t: :timeout、l: :longnames、s: :silent 也在此定义。
解析时,全局开关会与命令的 switches/0、formatter 的开关合并;若命令或 formatter 试图重定义全局开关且类型不一致,解析器会直接退出并报错(见 merge_if_different/3 与 assert_no_conflict/4)。
2.1.2 命令发现
若参数列表非空,其第一个元素即被视为命令名。命令名被转换为 CamelCase,并据此选择 RabbitMQ.CLI.*.Commands.<CommandName>Command 命名的模块。
实际实现位于 deps/rabbitmq_cli/lib/rabbitmq/cli/core/command_modules.ex:look_up_command/2 先只加载核心命令(load_core/1,对应 rabbitmqctl 应用自带的命令,避免每次扫描插件),若未命中再加载插件命令并合并(load/1)。可用命令模块的集合取决于当前工具的作用域(见下文"命令作用域")。
2.1.3 默认值与校验
找到命令模块后,计算生效参数:将全局默认值与命令专属默认值合并到无名参数与命名参数上。命令通过 merge_defaults/2 回调指定默认值。
参数随后经 validate/2 回调校验。validate_execution_environment/2 是另一个(可选的)校验函数,签名与 validate/2 相同,专门用来校验非 CLI 参数的外部条件,例如:文件是否存在、目标节点上 RabbitMQ 是运行中还是已停止。
在入口模块 deps/rabbitmq_cli/lib/rabbitmqctl.ex 中可以看到完整的执行决策树:先 merge_defaults → 标准化节点名(normalise_node_option)→ validate → validate_execution_environment → 打印 banner → run → output。校验失败时,错误信息与 usage 会打印到 stderr,并返回非零退出码(通常为 64,见下文退出码一节)。
2.1.4 命令别名(Command Aliases)
可以通过别名文件为命令定义别名。文件名由环境变量 RABBITMQ_CLI_ALIASES_FILE 或命令行参数 --aliases-file 指定。
别名采用 alias = command [options] 格式,例如:
lq = list_queues
lq_vhost1 = list_queues -p vhost1
lq_off = list_queues --offline
配置上述别名文件后运行:
RABBITMQ_CLI_ALIASES_FILE=/path/to/aliases.conf rabbitmqctl lq
等价于:
RABBITMQ_CLI_ALIASES_FILE=/path/to/aliases.conf rabbitmqctl list_queues
而:
RABBITMQ_CLI_ALIASES_FILE=/path/to/aliases.conf rabbitmqctl lq_off
等价于:
RABBITMQ_CLI_ALIASES_FILE=/path/to/aliases.conf rabbitmqctl list_queues --offline
内置命令或插件提供的命令优先于别名被查找:若某名称能匹配到真实命令,则不会再检查别名,因此无法通过配置别名覆盖已有命令。与命令查找一样,别名展开也发生在 RabbitMQ.CLI.Core.Parser 模块中。在 parser.ex 中,command_alias/3 与 load_aliases/1 实现了按 = 切分、以 OptionParser.split 解析别名内容的逻辑;若别名文件不可读,会向 stderr 打印错误并视作无别名。
2.1.5 带变量的命令别名
别名可以携带参数。= 之后的第一个词必须是命令名。别名中指定的参数会先于命令行传入的参数。
例如,定义别名 passwd_user1 = change_password user1 后,可调用:
rabbitmqctl passwd_user1 new_password
结合 eval 命令,别名能成为强大而无需开发插件的定制工具。例如,下面的别名删除一个 vhost 中的所有队列:
delete_vhost_queues = eval '[rabbit_amqqueue:delete(Q, false, false, <<"rabbit-cli">>) || Q <- rabbit_amqqueue:list(_1)]'
该命令需要一个位置参数指定 vhost:
rabbitmqctl delete_vhost_queues vhost1
也可以使用非整数的下划线变量来引用命名参数形式的 vhost:
delete_vhost_queues = eval '[rabbit_amqqueue:delete(Q, false, false, <<"rabbit-cli">>) || Q <- rabbit_amqqueue:list(_vhost)]'
然后这样调用:
rabbitmqctl delete_vhost_queues -p vhost1
# 或
rabbitmqctl delete_vhost_queues ---vhost <vhost>1
需要提醒的是:eval 命令只接受全局参数](#三-全局参数与命令行用法)作为命名参数,官方建议优先使用位置参数。编号参数(如 _1)会以 Elixir 字符串(或 Erlang binary)的形式传给被求值的代码,依赖这些参数的代码需要自行做类型转换,例如使用 rabbit_data_coercion 模块中的函数。从源码看,eval 命令的实现位于 [deps/rabbitmq_cli/lib/rabbitmq/cli/ctl/commands/eval_command.ex:它通过 ErlEval.parse_expr/1 解析表达式,再用 :rabbit_misc.rpc_call 在目标节点上执行 :erl_eval.exprs/2,支持从位置参数或标准输入读取表达式。
2.1.6 命令执行
命令主体逻辑在 run/2 回调中,该回调可返回任意值(通常是对 broker 的 RPC 调用结果)。run/2 的返回值交由 output/2 回调处理,格式化为特定类型;output/2 也可以返回一个错误及对应的退出码。
2.1.7 打印与格式化
output/2 的返回值由 output.ex 模块交给相应的 formatter 与 printer 处理:
- formatter(格式化器):把输出值转换为字符串序列或错误值,例如
json、csv、erlang; - printer(打印机):把格式化后的字符串渲染到输出设备(如 stdout、文件)。
在源码中,formatter 位于 deps/rabbitmq_cli/lib/rabbitmq/cli/formatters/,printer 位于 deps/rabbitmq_cli/lib/rabbitmq/cli/printers/。RabbitMQ.CLI.Core.Output(output.ex)负责分发:format_output/3 调用 formatter,print_output/3 初始化 printer、逐条打印、最后 finish 收尾;流式输出({:stream, enum})通过 Enum.reduce_while 逐元素打印,遇到 {:error, err} 元素即停止并以非零退出码结束。
2.1.8 返回与退出码
执行期间的错误(校验失败、命令错误等)打印到 stderr。命令执行失败时返回非零退出码。
退出码定义于 deps/rabbitmq_cli/lib/rabbitmq/cli/core/exit_codes.ex,采用了 FreeBSD sysexits 约定:
| 退出码 | 含义 | 典型场景 |
|---|---|---|
0 |
成功 | 命令正常完成 |
64 |
用法错误(usage) | 参数不足/过多、非法选项、未知命令 |
65 |
数据错误(dataerr) | 参数值非法、vhost 不存在、节点名非法 |
67 |
用户不存在(nouser) | no_such_user |
69 |
服务不可用(unavailable) | badrpc :nodedown、版本不兼容 |
70 |
软件错误(software) | 未预期的异常 |
75 |
临时失败(tempfail) | RPC 超时 |
78 |
配置错误(config) | Erlang 分布启动失败 |
三、全局参数与命令行用法
CLI 工具是一个 Elixir Mix 应用,被编译为 escript 可执行文件。该文件内嵌了 Elixir、rabbit_common 与 rabbitmqcli 应用,可在任何安装了 escript(随 Erlang 发行版自带)的环境中执行。
不过,部分命令需要知道 broker 的代码目录与数据目录,例如 rabbitmq-plugins 工具中的命令以及集群控制类命令(forget_cluster_node、rename_cluster_node 等)。这些目录可以通过环境选项或 RabbitMQ 环境变量指定。在 broker 发行版中,escript 由一个 shell/cmd 脚本调用,该脚本加载 broker 环境并导出到脚本进程中。环境变量同样用于指定 enabled plugins 文件与 plugins 目录。
所有已启用的插件都会被搜索命令:插件提供的命令会出现在 usage 中并可执行。
3.1 常用全局参数
DESIGN.md 给出的常用参数(括号内为单字母别名):
| 参数 | 别名 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
node |
n |
atom | rabbit@<当前主机> |
broker 节点名 |
quiet |
q |
boolean | false |
为 true 时不显示命令 banner |
timeout |
t |
integer | infinity |
超时值,单位秒(部分命令使用) |
vhost |
p |
string | / |
要操作的 vhost |
formatter |
- | string | 命令默认 | 格式化命令输出的 formatter(见输出格式化一节) |
printer |
- | string | 命令默认 | 渲染输出的 printer |
dry-run |
- | boolean | - | 指定后命令不真正执行,仅打印 banner |
注意:源码 parser.ex 中
node的实际类型为:string(解析后按需原子化),timeout在入口模块中被normalise_timeout/1乘以 1000 转为毫秒后传入命令。
3.2 环境参数
| 参数 | 类型 | 说明 |
|---|---|---|
script-name |
atom | 可配置的工具名(rabbitmq-plugins、rabbitmqctl),用于选择命令作用域 |
rabbitmq-home |
string | broker 安装目录 |
mnesia-dir |
string | broker mnesia 数据目录(源码中已更名为 data-dir,保留 mnesia_dir 作为向后兼容别名) |
plugins-dir |
string | broker 插件目录 |
enabled-plugins-file |
string | broker 已启用插件文件 |
longnames |
l |
boolean |
aliases-file |
string | 从中加载别名的文件名 |
erlang-cookie |
atom | Erlang 分布 cookie |
环境参数的默认值从 RabbitMQ 环境变量加载(见"环境配置"一节)。某些命名参数拥有单字母别名(见括号)。不带值的布尔选项按 true 解析。
例如,解析命令:
rabbitmqctl list_queues --vhost my_vhost -t 10 --formatter=json name pid --quiet
结果如下:
- 无名参数列表:
["list_queues", "name", "pid"] - 命名参数映射:
%{vhost: "my_vhost", timeout: 10, quiet: true}
3.3 帮助与 usage 输出
- CLI 不带任何参数调用,或参数解析出现问题时,会显示 usage,此时退出码为 64;
- 若想显示 usage 并返回退出码
0,请运行help命令:
rabbitmqctl help
每个工具(rabbitmqctl、rabbitmq-plugins)只显示自己作用域内的命令列表。在入口模块中,无参数调用被视为无效调用(与 curl、grep 行为一致),而 --help 则被显式处理为成功(退出码 0)。
四、CommandBehaviour:命令模块契约
每个命令都是一个实现 RabbitMQ.CLI.CommandBehaviour 行为的 Elixir(或 Erlang)模块。行为定义位于 deps/rabbitmq_cli/lib/rabbitmq/cli/command_behaviour.ex。
4.1 必须实现的回调
usage() :: String.t | [String.t]
命令的 usage 字符串,或若干字符串(每行一条),用于命令列表展示。通常形如 command_name [arg] --option=opt_value。
banner(arguments :: List.t, options :: Map.t) :: String.t
命令执行前打印的 banner。指定 --quiet 时被忽略;指定 --dry-run 时,CLI 只打印 banner 而不执行命令。此外,从 rabbitmqctl.ex 的实现看,--silent 与机器可读的 formatter(如 JSON)也会抑制 banner。
merge_defaults(arguments :: List.t, options :: Map.t) :: {List.t, Map.t}
合并参数与命名参数的默认值,返回生效的参数与选项元组,后续会传给 validate/2 与 run/2。
validate(arguments :: List.t, options :: Map.t) :: :ok | {:validation_failure, Atom.t | {Atom.t, String.t}}
校验生效的参数与选项。若返回 {:validation_failure, err},CLI 将 usage 打印到 stderr 并退出(典型退出码 64)。
run(arguments :: List.t, options :: Map.t) :: run_result :: any
运行命令,通常会对 broker 发起 RPC 调用。
output(run_result :: any, options :: Map.t) :: :ok | {:ok, output :: any} | {:stream, Enum.t} | {:error, ExitCodes.exit_code, [String.t]}
把 run/2 的返回值转换为可格式化的值及退出码:
:ok—— 返回退出码0,不打印任何内容;{:ok, output}—— 返回退出码0,并用 formatter 的format_output/2回调打印输出;{:stream, stream}—— 用 formatter 的format_stream/2回调逐元素迭代格式化可枚举数据;流处理过程中出错可返回非零码(错误元素应为{:error, Message});{:error, exit_code, strings}—— 把错误信息打印到stderr并返回exit_code。
该回调在 DefaultOutput 模块中提供了默认实现(deps/rabbitmq_cli/lib/rabbitmq/cli/default_output.ex)。大多数标准命令通过 use RabbitMQ.CLI.DefaultOutput 使用默认实现——它会自动处理 badrpc(节点不可达、cookie 认证失败)、nodedown、超时等常见错误,并把可枚举结果自动转为流。
4.2 可选回调
switches() :: Keyword.t
命令的开关(参数名与类型)关键字列表。例如 def switches(), do: [offline: :boolean, time: :integer] 会把 --offline --time=100 解析为 %{offline: true, time: 100}。这些开关会追加到全局开关之上(见参数解析)。
aliases() :: Keyword.t
命令参数的单字母别名关键字列表,例如 [o: :offline, t: :timeout]。
usage_additional() :: String.t | [String.t]
在所有命令基础 usage 之后打印的补充 usage 字符串,用于解释额外参数且不干扰命令列表展示。
formatter() :: Atom.t
命令的默认 formatter,应为实现 RabbitMQ.CLI.FormatterBehaviour 的模块名。
scopes() :: [Atom.t]
命令所属的作用域列表(见下文)。
此外,行为中还有 printer/0、description/0、help_section/0、usage_doc_guides/0、validate_execution_environment/2 与 distribution/1 等可选回调。distribution/1 用于控制 Erlang 分布::cli 使用默认的 rabbitmqctl 节点名、:none 禁用分布(适合离线命令)、{:fun, fun} 使用自定义函数启动分布。
4.3 一个真实的命令模块实例
以 list_queues 为例(deps/rabbitmq_cli/lib/rabbitmq/cli/ctl/commands/list_queues_command.ex),可以直观看到各回调的组合:
def description(), do: "Lists queues and their properties"
def usage(),
do:
"list_queues [--vhost <vhost>] [--online] [--offline] [--local] [--no-table-headers] [<column>, ...]"
def scopes(), do: [:ctl, :diagnostics]
def switches(), do: [offline: :boolean, online: :boolean, local: :boolean, timeout: :integer]
def aliases(), do: [t: :timeout]
它同时属于 :ctl 与 :diagnostics 两个作用域(因此在 rabbitmq-diagnostics 中也可用),声明了 offline、online、local 等布尔开关,并给 timeout 提供了 -t 别名;merge_defaults/2 提供默认列(name messages)与默认 vhost /,formatter/0 默认使用 RabbitMQ.CLI.Formatters.Table 输出表格。
关于命令开发的完整逐步教程,可参考仓库中的 deps/rabbitmq_cli/COMMAND_TUTORIAL.md,其中以"删除队列"命令为例,给出了从模块声明、usage、switches/aliases、banner、merge_defaults/validate、run 到 output 的完整 Elixir 与 Erlang 双版本实现。
五、命令作用域(Command Scopes)
命令可以组织到不同作用域中,供不同工具使用,如 rabbitmq-diagnostics 或 rabbitmq-plugins。
- 一个命令可以属于多个作用域,在命令模块的
scopes/0回调中以原子值列表声明; - 默认按命名约定选择作用域:若命令模块名为
RabbitMQ.CLI.MyScope.Commands.DoSomethingCommand,它即属于my_scope作用域。作用域应为 snake_case,命名空间会转换为 CamelCase; - CLI 运行时,作用域由脚本名选择——即 escript 文件名,或传入的
--script-name参数; - 脚本名与作用域在应用环境中一一对应:
| 脚本名 | 作用域 |
|---|---|
rabbitmqctl |
:ctl |
rabbitmq-plugins |
:plugins |
rabbitmq-diagnostics |
:diagnostics |
该环境可由插件的 :scopes 环境变量扩展,但不能被覆盖;插件之间的作用域可以互相覆盖,因此应谨慎使用。
因此,RabbitMQ.CLI.Ctl.Commands 命名空间下的所有命令对 rabbitmqctl 脚本可用,RabbitMQ.CLI.Plugins.Commands 下的命令对 rabbitmq-plugins 可用。要把命令加入 rabbitmqctl,只需用 RabbitMQ.CLI.Ctl.Commands 前缀命名,或在 scopes() 回调中返回包含 :ctl 的列表。
在命令发现阶段,CommandModules.script_scope/1(command_modules.ex)通过 Config.get_option(:script_name, opts) 查询应用环境中的 :scopes 映射来确定当前作用域。
六、输出格式化体系
CLI 支持可扩展的输出格式化,分为两个阶段:
- 格式化(formatting):把命令输出转换为一系列行;
- 打印(printing):把行输出到某个设备(如 stdout 或文件系统)。
6.1 FormatterBehaviour(格式化器)
formatter 是实现 RabbitMQ.CLI.FormatterBehaviour 行为的模块:
format_output(output :: any, options :: Map.t) :: String.t | [String.t]
格式化单个返回值:接收命令输出与命名参数(options),返回应打印的字符串列表。
format_stream(output_stream :: Enumerable.t, options :: Map.t) :: Enumerable.t
格式化返回值流。该函数利用 Elixir 的 Stream 抽象定义对连续数据的处理,使 CLI 能实时输出数据,用于异步产出数据的 list_* 系列命令。DefaultOutput 会把所有可枚举数据作为流返回,因此会走此函数。
仓库内置的 formatter 位于 deps/rabbitmq_cli/lib/rabbitmq/cli/formatters/,包括 json、csv、erlang、table、pretty_table、string、inspect、report、plugins、msacc、string_per_line、json_stream 等。
6.2 PrinterBehaviour(打印机)
printer 是实现 RabbitMQ.CLI.PrinterBehaviour 行为的模块:
init(options :: Map.t) :: {:ok, printer_state :: any} | {:error, error :: any}
初始化内部打印机状态(例如打开文件句柄)。
finish(printer_state :: any) :: :ok
收尾内部打印机状态。
print_output(output :: String.t | [String.t], printer_state :: any) :: :ok
在打印机状态上下文中打印输出行。对 {:ok, val} 命令输出,在用 formatter 格式化 val 之后调用;对 {:stream, enum} 可枚举,对每个元素调用。
print_ok(printer_state :: any) :: :ok
在没有任何值的情况下打印输出,用于 :ok 命令返回值。
内置 printer 位于 deps/rabbitmq_cli/lib/rabbitmq/cli/printers/:std_io(默认,输出到标准 I/O)、std_io_raw 与 file(输出到文件,配合 --file 全局参数)。
6.3 output/2 返回值的处理规则
输出格式化逻辑定义在 output.ex 模块中,对 output/2 返回值的处理规则如下:
output/2 返回值 |
处理方式 | 退出码 |
|---|---|---|
:ok |
初始化 printer → print_ok → 收尾 |
0 |
{:ok, value} |
formatter 的 format_output/2 格式化后交给 printer |
0 |
{:stream, enum} |
formatter 的 format_stream/2 增强流,初始化 printer,对每个成功格式化的元素调用 print_output/2 |
无错误时为 0;出现 {:error, msg} 元素时流停止、错误打印到 stderr,非零退出 |
{:error, exit_code, msg} |
将 msg 打印到 stderr 并退出 |
exit_code |
七、环境配置(Environment Configuration)
部分命令需要服务器环境信息才能正确运行,包括:
- rabbitmq 代码目录;
- rabbitmq mnesia 目录;
- enabled plugins 文件;
- plugins 目录。
其中,enabled plugins 文件与 plugins 目录还用于定位插件命令。这些信息可以通过命令行参数提供(见"环境参数"),默认从与 rabbitmq broker 相同的环境变量加载:
| 参数名 | 环境变量 |
|---|---|
rabbitmq-home |
RABBITMQ_HOME |
mnesia-dir |
RABBITMQ_MNESIA_DIR |
plugins-dir |
RABBITMQ_PLUGINS_DIR |
enabled-plugins-file |
RABBITMQ_ENABLED_PLUGINS_FILE |
longnames |
RABBITMQ_USE_LONGNAME |
node |
RABBITMQ_NODENAME |
aliases-file |
RABBITMQ_CLI_ALIASES_FILE |
erlang-cookie |
RABBITMQ_ERLANG_COOKIE |
在源码 deps/rabbitmq_cli/lib/rabbitmq/cli/core/config.ex 中,get_option/2 的取值优先级为:命令行选项 → 系统环境变量(get_system_option/2)→ 内置默认值(default/1)。其中:
script-name直接取自 escript 文件名(Path.basename(:escript.script_name()));aliases-file与erlang-cookie分别读取RABBITMQ_CLI_ALIASES_FILE、RABBITMQ_ERLANG_COOKIE;node、longnames、rabbitmq-home、data-dir、plugins-dir、enabled-plugins-file等通过:rabbit_env.get_context/1获取 broker 环境上下文,因此会自动感知 broker 的节点名、长短节点名类型、插件路径等实际配置;- 默认 formatter 为
RabbitMQ.CLI.Formatters.String,默认 printer 为RabbitMQ.CLI.Printers.StdIO(config.ex)。
八、结语:从设计到实践
RabbitMQ 3.7+ 的 CLI 工具套件通过"每个命令独立模块 + 行为契约 + 命令作用域 + 可插拔输出"的设计,解决了旧 rabbitmqctl 单体、难扩展、难维护的问题。理解这份设计文档后,你可以:
- 熟练使用
--formatter=json、--printer=file等全局参数组合,把 CLI 输出接入脚本与自动化流水线; - 借助
RABBITMQ_CLI_ALIASES_FILE与eval组合出"删除某 vhost 全部队列"这类自定义运维操作; - 基于
RabbitMQ.CLI.CommandBehaviour为自己的插件编写命令,并通过命名约定或scopes/0将其暴露给rabbitmqctl或rabbitmq-diagnostics; - 参考 deps/rabbitmq_cli/COMMAND_TUTORIAL.md 的完整示例,在 Elixir 或 Erlang 中实现一个从参数声明到输出处理全流程的自定义命令。