【原創】rabbitmq-plugins用戶手冊（翻譯）

      爲了方便工做中使用，週末抽空對 rabbitmq-plugins 用戶手冊進行了翻譯，鑑於本身水平有限，翻譯中不免有紕漏產生，若是疑問，歡迎指出探討。

官方原文：http://www.rabbitmq.com/man/rabbitmq-plugins.1.man.html

======== 我是分割線 ==========

經過 http://www.rabbitmq.com/manpages.html  可知 RabbitMQ 有5個 General Command ：

1. rabbitmqctl
2. rabbitmq-plugins
3. rabbitmq-server
4. rabbitmq-service

5. rabbitmq-echopid

若要對 server 進行高級配置，則須要參考 administrator's guide（http://www.rabbitmq.com/admin-guide.html） 

命令名

rabbitmq-plugins — 管理 RabbitMQ broker 的 plugin 的命令行工具

概要
rabbitmq-plugins {command} [command options...]

描述
      rabbitmq-plugins 是用於管理 RabbitMQ broker 的 plugin 的命令行工具，其容許您 enable，disable 以及 browse 全部 plugin。只有具備 RabbitMQ 配置目錄寫權限的用戶才能使用該命令。

      有一些 plugin 是須要依賴其餘的 plugin 才能正常工做的。rabbitmq-plugins 命令會遍歷依賴關係並 enable 全部必需的 plugin。經過 rabbitmq-plugins 列出來的 plugin 被標識爲 explicitly enabled ，依賴關係中涉及的 plugin 被標識爲 implicitly enabled 。Implicitly enabled 的 plugin 當不在被其餘的 plugin 須要時會被自動 disabled 。

命令
list [-v] [-m] [-E] [-e] [pattern]

-v
顯式所有 plugin 細節 (verbose).
-m
只顯示 plugin 名字 (minimal).
-E
只顯示 explicitly enabled 的 plugins.
-e
只顯示 explicitly 或者 implicitly enabled 的 plugins.
pattern
用於過濾 plugin 名字的模式.

      列舉當前已存在 plugin 、其版本信息、依賴關係和描述信息。每個 plugin 前面都會有一個代表狀態的指示符：
[ ] 表示 plugin 未 enabled
[E] 表示 plugin 被 explicitly enabled
[e] 表示 plugin 被 implicitly enabled
若是可選參數 pattern 存在，那麼只有名字與模式 pattern 匹配的 plugin 纔會顯示出來。

舉例：

rabbitmq-plugins list
列出全部 plugin，每行一條 

E:\Program Files\RabbitMQ Server\rabbitmq_server-2.8.7\sbin>rabbitmq-plugins.bat list
[ ] amqp_client                       2.8.7
[ ] eldap                             2.8.7-gite309de4
[ ] erlando                           2.8.7
[ ] mochiweb                          2.3.1-rmq2.8.7-gitd541e9a
[ ] rabbitmq_auth_backend_ldap        2.8.7
[ ] rabbitmq_auth_mechanism_ssl       2.8.7
[ ] rabbitmq_consistent_hash_exchange 2.8.7
[ ] rabbitmq_federation               2.8.7
[ ] rabbitmq_federation_management    2.8.7
[ ] rabbitmq_jsonrpc                  2.8.7
[ ] rabbitmq_jsonrpc_channel          2.8.7
[ ] rabbitmq_jsonrpc_channel_examples 2.8.7
[ ] rabbitmq_management               2.8.7
[ ] rabbitmq_management_agent         2.8.7
[ ] rabbitmq_management_visualiser    2.8.7
[ ] rabbitmq_mochiweb                 2.8.7
[ ] rabbitmq_shovel                   2.8.7
[ ] rabbitmq_shovel_management        2.8.7
[ ] rabbitmq_stomp                    2.8.7
[ ] rabbitmq_tracing                  2.8.7
[ ] rfc4627_jsonrpc                   2.8.7-gita5e7ad7
[ ] webmachine                        1.9.1-rmq2.8.7-git52e62bc

rabbitmq-plugins list -v  
列出全部 plugin 的詳細信息 

E:\Program Files\RabbitMQ Server\rabbitmq_server-2.8.7\sbin>rabbitmq-plugins.bat list
[ ] amqp_client
    Version:            2.8.7
    Description:        RabbitMQ AMQP Client


[ ] eldap
    Version:            2.8.7-gite309de4
    Description:        LDAP Client Library


[ ] erlando
    Version:            2.8.7
    Description:        Syntax extensions for Erlang


[ ] mochiweb
    Version:            2.3.1-rmq2.8.7-gitd541e9a
    Description:        MochiMedia Web Server


[ ] rabbitmq_auth_backend_ldap
    Version:            2.8.7
    Description:        RabbitMQ LDAP Authentication Backend


[ ] rabbitmq_auth_mechanism_ssl
    Version:            2.8.7
    Description:        RabbitMQ SSL authentication (SASL EXTERNAL)


[ ] rabbitmq_consistent_hash_exchange
    Version:            2.8.7
    Description:        Consistent Hash Exchange Type


[ ] rabbitmq_federation
    Version:            2.8.7
    Dependencies:       [amqp_client]
    Description:        RabbitMQ Federation


[ ] rabbitmq_federation_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        RabbitMQ Federation Management


[ ] rabbitmq_jsonrpc
    Version:            2.8.7
    Dependencies:       [rabbitmq_mochiweb,rfc4627_jsonrpc]
    Description:        Rabbit JSON-RPC


[ ] rabbitmq_jsonrpc_channel
    Version:            2.8.7
    Dependencies:       [rabbitmq_jsonrpc,amqp_client]
    Description:        RabbitMQ JSON-RPC Channels


[ ] rabbitmq_jsonrpc_channel_examples
    Version:            2.8.7
    Dependencies:       [rabbitmq_jsonrpc_channel]
    Description:        rabbit_jsonrpc_channel_examples


[ ] rabbitmq_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_mochiweb,amqp_client,
                         rabbitmq_management_agent]
    Description:        RabbitMQ Management Console


[ ] rabbitmq_management_agent
    Version:            2.8.7
    Description:        RabbitMQ Management Agent


[ ] rabbitmq_management_visualiser
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        RabbitMQ Visualiser


[ ] rabbitmq_mochiweb
    Version:            2.8.7
    Dependencies:       [mochiweb,webmachine]
    Description:        RabbitMQ Mochiweb Embedding


[ ] rabbitmq_shovel
    Version:            2.8.7
    Dependencies:       [amqp_client,erlando]
    Description:        Data Shovel for RabbitMQ


[ ] rabbitmq_shovel_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        Shovel Status


[ ] rabbitmq_stomp
    Version:            2.8.7
    Dependencies:       [amqp_client]
    Description:        Embedded Rabbit Stomp Adapter


[ ] rabbitmq_tracing
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        RabbitMQ message logging / tracing


[ ] rfc4627_jsonrpc
    Version:            2.8.7-gita5e7ad7
    Description:        JSON RPC Service


[ ] webmachine
    Version:            1.9.1-rmq2.8.7-git52e62bc
    Dependencies:       [mochiweb]
    Description:        webmachine

rabbitmq-plugins list -v management
列出全部名字中包含「management」字符串的 plugin 的詳細信息

E:\Program Files\RabbitMQ Server\rabbitmq_server-2.8.7\sbin>rabbitmq-plugins.bat list -v management
[ ] rabbitmq_federation_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        RabbitMQ Federation Management


[ ] rabbitmq_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_mochiweb,amqp_client,
                         rabbitmq_management_agent]
    Description:        RabbitMQ Management Console


[ ] rabbitmq_management_agent
    Version:            2.8.7
    Description:        RabbitMQ Management Agent


[ ] rabbitmq_management_visualiser
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        RabbitMQ Visualiser


[ ] rabbitmq_shovel_management
    Version:            2.8.7
    Dependencies:       [rabbitmq_management]
    Description:        Shovel Status

rabbitmq-plugins list -e rabbit
列出全部名字中包含「rabbit」字符串的 implicitly 或者 explicitly enabled 的 RabbitMQ plugin 的信息

E:\Program Files\RabbitMQ Server\rabbitmq_server-2.8.7\sbin>rabbitmq-plugins.bat list -e rabbit
（無輸出）

enable {plugin ...}
plugin
    指定須要 enable 的一個或多個 plugin
    
Enable 指定的 plugins 和其必須的依賴

舉例：
rabbitmq-plugins enable rabbitmq_shovel rabbitmq_management
該命令 enable 了 shovel 和 management plugin 以及其必須的所有依賴

disable {plugin ...}
plugin
    指定須要 disable 的一個或多個 plugin
    
該命令 disable 指定的 plugin 和全部依賴該 plugin 的其餘 plugin

舉例：
rabbitmq-plugins disable amqp_client
該命令 disable 了 amqp_client 以及全部依賴它的其餘 plugin