Management plugin: recommend rabbitmqadmin v2

(cherry picked from commit 4d04852)

Author: michaelklishin

deps/rabbitmq_management/bin/rabbitmqadmin

@@ -212,7 +212,11 @@ def title(name):
 
 
 def subcommands_usage():
-    usage = """Usage
+    usage = """
+IMPORTANT: this version of 'rabbitmqadmin' is no longer actively maintained.
+           See https://www.rabbitmq.com/docs/management-cli.
+
+Usage
 =====
   """ + short_usage() + """
 
@@ -241,12 +245,20 @@ def subcommands_usage():
     standard output along with the message metadata
 
   * If payload_file is specified on get, count must not be set
+
+IMPORTANT: this version of 'rabbitmqadmin' is no longer actively maintained.
+See https://www.rabbitmq.com/docs/management-cli.
 """
     return usage
 
 
 def config_usage():
-    usage = "Usage\n=====\n" + short_usage()
+    usage = """
+IMPORTANT: this version of 'rabbitmqadmin' is no longer actively maintained.
+See https://www.rabbitmq.com/docs/management-cli.
+"""
+
+    usage += "Usage\n=====\n" + short_usage()
     usage += "\n" + title("Configuration File")
     usage += """  It is possible to specify a configuration file from the command line.
   Hosts can be configured easily in a configuration file and called
@@ -277,6 +289,10 @@ def config_usage():
 """
     usage += title("Use")
     usage += """  rabbitmqadmin -c rabbitmqadmin.conf.example -N host_normal ..."""
+    usage += """
+IMPORTANT: this version of 'rabbitmqadmin' is no longer actively maintained.
+See https://www.rabbitmq.com/docs/management-cli.
+"""
     return usage
 
 
@@ -289,6 +305,9 @@ For more help use the help subcommand:
 
   rabbitmqadmin help subcommands  # For a list of available subcommands
   rabbitmqadmin help config       # For help with the configuration file
+
+IMPORTANT: this version of 'rabbitmqadmin' is no longer actively maintained.
+See https://www.rabbitmq.com/docs/management-cli.
 """
 
 

deps/rabbitmq_management/priv/www/api/index.html

@@ -66,6 +66,17 @@ <h2>Introduction</h2>
     <p>Most of the GET queries return many fields per
     object. The second part of this guide covers those.</p>
 
+    <h2>rabbitmqadmin</h2>
+    <p>
+      While the HTTP API can be used directly (with <code>curl</code>, <code>xh</code> and similar tools),
+      for most day-to-day operations the recommended option is <a href="https://www.rabbitmq.com/docs/management-cli">rabbitmqadmin</a>.
+    </p>
+
+    <h2>Client Libraries</h2>
+    <p>
+      <a href="https://www.rabbitmq.com/client-libraries/devtools">Client libraries for the HTTP API</a> are available for many programming languages.
+    </p>
+
     <h2>Examples</h2>
 
     <p>A few quick examples for Windows and Unix, using the command line