Enabling
--------
-The *rgw* module is enabled with::
+To enable the ``rgw`` module, run the following command:
- ceph mgr module enable rgw
+.. prompt:: bash #
+
+ ceph mgr module enable rgw
RGW Realm Operations
.. prompt:: bash #
- ceph rgw realm bootstrap [--realm-name] [--zonegroup-name] [--zone-name] [--port] [--placement] [--start-radosgw]
+ ceph rgw realm bootstrap [--realm-name] [--zonegroup-name] [--zone-name] [--port] [--placement] [--start-radosgw]
The command supports providing the configuration through a spec file (`-i option`):
.. prompt:: bash #
- ceph rgw realm bootstrap -i myrgw.yaml
+ ceph rgw realm bootstrap -i myrgw.yaml
Following is an example of RGW multisite spec file:
Users can list the available tokens for the created (or already existing) realms.
The token is a base64 string that encapsulates the realm information and its
master zone endpoint authentication data. Following is an example of
-the `ceph rgw realm tokens` output:
+the ``ceph rgw realm tokens`` output:
.. prompt:: bash #
- ceph rgw realm tokens | jq
+ ceph rgw realm tokens | jq
.. code-block:: json
Commands
--------
-::
- ceph rgw realm bootstrap -i spec.yaml
+.. prompt:: bash #
+
+ ceph rgw realm bootstrap -i spec.yaml
Create a new realm + zonegroup + zone and deploy rgw daemons via the
orchestrator using the information specified in the YAML file.
-::
+.. prompt:: bash #
- ceph rgw realm tokens
+ ceph rgw realm tokens
List the tokens of all the available realms
-::
+.. prompt:: bash #
- ceph rgw zone create -i spec.yaml
+ ceph rgw zone create -i spec.yaml
Join an existing realm by creating a new secondary zone (using the realm token)
-::
+.. prompt:: bash #
- ceph rgw admin [*]
+ ceph rgw admin [*]
RGW admin command
#. From the primary node, ensure that the ``curl`` command can be run by the
user:
- .. prompt:: bash [root@primary-node]#
+ .. prompt:: bash [user@primary-node]$
curl https://<host_ip>:443