Merge pull request ceph#62896 from zdover23/wip-doc-2025-04-21-revert-62782-c4f0f8e

doc: Revert "doc/mgr: Promptify CLI commands and other formatting fixes"

Reviewed-by: Anthony D'Atri <[email protected]>

Author: zdover23

doc/mgr/administrator.rst

@@ -10,27 +10,21 @@ Usually, you would set up a ceph-mgr daemon using a tool such
 as ceph-ansible.  These instructions describe how to set up
 a ceph-mgr daemon manually.
 
-First, create an authentication key for your daemon:
+First, create an authentication key for your daemon::
 
-.. prompt:: bash #
-
-   ceph auth get-or-create mgr.$name mon 'allow profile mgr' osd 'allow *' mds 'allow *'
+    ceph auth get-or-create mgr.$name mon 'allow profile mgr' osd 'allow *' mds 'allow *'
 
 Place that key as file named ``keyring`` into ``mgr data`` path, which for a cluster "ceph"
 and mgr $name "foo" would be ``/var/lib/ceph/mgr/ceph-foo`` respective ``/var/lib/ceph/mgr/ceph-foo/keyring``.
 
-Start the ceph-mgr daemon:
-
-.. prompt:: bash #
+Start the ceph-mgr daemon::
 
-   ceph-mgr -i $name
+    ceph-mgr -i $name
 
 Check that the mgr has come up by looking at the output
-of ``ceph status``, which should now include a mgr status line:
-
-.. prompt:: bash #
+of ``ceph status``, which should now include a mgr status line::
 
-   mgr active: $name
+    mgr active: $name
 
 Client authentication
 ---------------------
@@ -39,7 +33,7 @@ The manager is a new daemon which requires new CephX capabilities. If you upgrad
 a cluster from an old version of Ceph, or use the default install/deploy tools,
 your admin client should get this capability automatically. If you use tooling from
 elsewhere, you may get EACCES errors when invoking certain ceph cluster commands.
-To fix that, add a ``mgr allow \*`` stanza to your client's cephx capabilities by
+To fix that, add a "mgr allow \*" stanza to your client's cephx capabilities by
 `Modifying User Capabilities`_.
 
 High availability
@@ -101,12 +95,9 @@ information about what functionality each module provides.
 
 Here is an example of enabling the :term:`Dashboard` module:
 
-.. prompt:: bash #
-
-   ceph mgr module ls
-
-::
+.. code-block:: console
 
+	$ ceph mgr module ls
 	{
 		"enabled_modules": [
 			"status"
@@ -116,13 +107,8 @@ Here is an example of enabling the :term:`Dashboard` module:
 		]
 	}
 
-.. prompt:: bash #
-
-   ceph mgr module enable dashboard
-   ceph mgr module ls
-
-::
-
+	$ ceph mgr module enable dashboard
+	$ ceph mgr module ls
 	{
 		"enabled_modules": [
 			"status",
@@ -132,12 +118,7 @@ Here is an example of enabling the :term:`Dashboard` module:
 		]
 	}
 
-.. prompt:: bash #
-
-   ceph mgr services
-
-::
-
+	$ ceph mgr services
 	{
 		"dashboard": "http://myserver.com:7789/"
 	}
@@ -176,11 +157,9 @@ Calling module commands
 Where a module implements command line hooks, the commands will
 be accessible as ordinary Ceph commands.  Ceph will automatically incorporate
 module commands into the standard CLI interface and route them appropriately to
-the module.
-
-.. prompt:: bash #
+the module.::
 
-   ceph <command | help>
+    ceph <command | help>
 
 Configuration
 -------------

doc/mgr/alerts.rst

@@ -16,58 +16,44 @@ as well.
 Enabling
 --------
 
-The *alerts* module is enabled with:
+The *alerts* module is enabled with::
 
-.. prompt:: bash #
-
-   ceph mgr module enable alerts
+  ceph mgr module enable alerts
 
 Configuration
 -------------
 
 To configure SMTP, all of the following config options must be set
-(When setting ``mgr/alerts/smtp_destination``, you can use commas to separate multiple):
-
-.. prompt:: bash #
-
-   ceph config set mgr mgr/alerts/smtp_host *<smtp-server>*
-   ceph config set mgr mgr/alerts/smtp_destination *<email-address-to-send-to>*
-   ceph config set mgr mgr/alerts/smtp_sender *<from-email-address>*
-
-By default, the module will use SSL and port 465.  To change that:
+(When setting ``mgr/alerts/smtp_destination``, you can use commas to separate multiple)::
 
-.. prompt:: bash #
+  ceph config set mgr mgr/alerts/smtp_host *<smtp-server>*
+  ceph config set mgr mgr/alerts/smtp_destination *<email-address-to-send-to>*
+  ceph config set mgr mgr/alerts/smtp_sender *<from-email-address>*
 
-   ceph config set mgr mgr/alerts/smtp_ssl false   # if not SSL
-   ceph config set mgr mgr/alerts/smtp_port *<port-number>*  # if not 465
+By default, the module will use SSL and port 465.  To change that,::
 
-To authenticate to the SMTP server, you must set the user and password:
+  ceph config set mgr mgr/alerts/smtp_ssl false   # if not SSL
+  ceph config set mgr mgr/alerts/smtp_port *<port-number>*  # if not 465
 
-.. prompt:: bash #
+To authenticate to the SMTP server, you must set the user and password::
 
-   ceph config set mgr mgr/alerts/smtp_user *<username>*
-   ceph config set mgr mgr/alerts/smtp_password *<password>*
+  ceph config set mgr mgr/alerts/smtp_user *<username>*
+  ceph config set mgr mgr/alerts/smtp_password *<password>*
 
 By default, the name in the ``From:`` line is simply ``Ceph``.  To
-change that (e.g., to identify which cluster this is):
+change that (e.g., to identify which cluster this is),::
 
-.. prompt:: bash #
-
-   ceph config set mgr mgr/alerts/smtp_from_name 'Ceph Cluster Foo'
+  ceph config set mgr mgr/alerts/smtp_from_name 'Ceph Cluster Foo'
 
 By default, the module will check the cluster health once per minute
 and, if there is a change, send a message.  To change that
-frequency:
-
-.. prompt:: bash #
+frequency,::
 
-   ceph config set mgr mgr/alerts/interval *<interval>*   # e.g., "5m" for 5 minutes
+  ceph config set mgr mgr/alerts/interval *<interval>*   # e.g., "5m" for 5 minutes
 
 Commands
 --------
 
-To force an alert to be send immediately:
-
-.. prompt:: bash #
+To force an alert to be send immediately,::
 
-   ceph alerts send
+  ceph alerts send

doc/mgr/ceph_api/index.rst

@@ -53,11 +53,9 @@ be obtained, and it may then be reused for subsequent requests. The
     { "token": "<redacted_token>", ...}
 
 The token obtained must be passed together with every API request in the
-``Authorization`` HTTP header:
+``Authorization`` HTTP header::
 
-.. prompt:: bash $
-
-   curl -H "Authorization: Bearer <token>" ...
+  curl -H "Authorization: Bearer <token>" ...
 
 Authentication and authorization can be further configured from the
 Ceph CLI, the Ceph-Dashboard UI and the Ceph API itself (please refer to

doc/mgr/cli_api.rst

@@ -7,47 +7,33 @@ benchmarked for further testing.
 Enabling
 --------
 
-The *cli api commands* module is enabled with:
+The *cli api commands* module is enabled with::
 
-.. prompt:: bash #
+  ceph mgr module enable cli_api
 
-   ceph mgr module enable cli_api
+To check that it is enabled, run::
 
-To check that it is enabled, run:
-
-.. prompt:: bash #
-
-   ceph mgr module ls | grep cli_api
+  ceph mgr module ls | grep cli_api
 
 Usage
 --------
 
-To run a mgr module command, run:
-
-.. prompt:: bash #
-
-   ceph mgr cli <command> <param>
-
-For example, use the following command to print the list of servers:
-
-.. prompt:: bash #
-
-   ceph mgr cli list_servers
+To run a mgr module command, run::
 
-List all available mgr module commands with:
+  ceph mgr cli <command> <param>
 
-.. prompt:: bash #
+For example, use the following command to print the list of servers::
 
-   ceph mgr cli --help
+  ceph mgr cli list_servers
 
-To benchmark a command, run:
+List all available mgr module commands with::
 
-.. prompt:: bash #
+  ceph mgr cli --help
 
-   ceph mgr cli_benchmark <number of calls> <number of threads> <command> <param>
+To benchmark a command, run::
 
-For example, use the following command to benchmark the command to get osd_map:
+  ceph mgr cli_benchmark <number of calls> <number of threads> <command> <param>
 
-.. prompt:: bash #
+For example, use the following command to benchmark the command to get osd_map::
 
-   ceph mgr cli_benchmark 100 10 get osd_map
+  ceph mgr cli_benchmark 100 10 get osd_map

doc/mgr/crash.rst

@@ -6,17 +6,13 @@ it in the Ceph cluster for later analysis.
 Enabling
 --------
 
-The *crash* module is enabled with:
+The *crash* module is enabled with::
 
-.. prompt:: bash #
+  ceph mgr module enable crash
 
-   ceph mgr module enable crash
+The *crash* upload key is generated with::
 
-The *crash* upload key is generated with:
-
-.. prompt:: bash #
-
-   ceph auth get-or-create client.crash mon 'profile crash' mgr 'profile crash'
+  ceph auth get-or-create client.crash mon 'profile crash' mgr 'profile crash'
 
 On each node, you should store this key in
 ``/etc/ceph/ceph.client.crash.keyring``.
@@ -43,57 +39,57 @@ and a keyring needs to be in ``/etc/ceph``.
 
 Commands
 --------
-.. prompt:: bash #
+::
 
-   ceph crash post -i <metafile>
+  ceph crash post -i <metafile>
 
 Save a crash dump.  The metadata file is a JSON blob stored in the crash
 dir as ``meta``.  As usual, the ceph command can be invoked with ``-i -``,
 and will read from stdin.
 
-.. prompt:: bash #
+::
 
-   ceph crash rm <crashid>
+  ceph crash rm <crashid>
 
 Remove a specific crash dump.
 
-.. prompt:: bash #
+::
 
-   ceph crash ls
+  ceph crash ls
 
 List the timestamp/uuid crashids for all new and archived crash info.
 
-.. prompt:: bash #
+::
 
-   ceph crash ls-new
+  ceph crash ls-new
 
 List the timestamp/uuid crashids for all newcrash info.
 
-.. prompt:: bash #
+::
 
-   ceph crash stat
+  ceph crash stat
 
 Show a summary of saved crash info grouped by age.
 
-.. prompt:: bash #
+::
 
-   ceph crash info <crashid>
+  ceph crash info <crashid>
 
 Show all details of a saved crash.
 
-.. prompt:: bash #
+::
 
    ceph crash prune <keep>
 
 Remove saved crashes older than 'keep' days.  <keep> must be an integer.
 
-.. prompt:: bash #
+::
 
    ceph crash archive <crashid>
 
 Archive a crash report so that it is no longer considered for the ``RECENT_CRASH`` health check and does not appear in the ``crash ls-new`` output (it will still appear in the ``crash ls`` output).
 
-.. prompt:: bash #
+::
 
    ceph crash archive-all