]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commitdiff
Addressing review comments
authorRedouane Kachach <rkachach@redhat.com>
Thu, 6 Oct 2022 09:08:14 +0000 (11:08 +0200)
committerAdam King <adking@redhat.com>
Wed, 5 Apr 2023 17:30:44 +0000 (13:30 -0400)
Signed-off-by: Redouane Kachach <rkachach@redhat.com>
(cherry picked from commit 7fdb145f1a6de774ee0e40163e93049b707bf2b4)

doc/cephadm/services/rgw.rst
doc/mgr/rgw.rst
src/python-common/ceph/rgw/rgwam_core.py

index be813a0820dc2efa42f95b96fcafd39a14a1fddf..e9aee3c6b7fc6ae10059b00104a87b390d3efd11 100644 (file)
@@ -86,8 +86,8 @@ To deploy RGWs serving the multisite *myorg* realm and the *us-east-1* zone on
    ceph orch apply rgw east --realm=myorg --zonegroup=us-east-zg-1 --zone=us-east-1 --placement="2 myhost1 myhost2"
 
 Note that in a multisite situation, cephadm only deploys the daemons.  It does not create
-or update the realm or zone configurations.  To create a new realm and zone, you can use
-:ref:`mgr-rgw-module` or manually using something like:
+or update the realm or zone configurations.  To create a new realms, zones and zonegroups
+you can use :ref:`mgr-rgw-module` or manually using something like:
 
 .. prompt:: bash #
 
index f2a6de1161d538c61892ad92b404522eb4590f06..5632fa64f7107c171561421dde4ad252b655d794 100644 (file)
@@ -21,8 +21,7 @@ Bootstrapping RGW realm creates a new RGW realm entity, a new zonegroup,
 and a new zone. It configures a new system user that can be used for
 multisite sync operations. Under the hood this module instructs the
 orchestrator to create and deploy the corresponding RGW daemons. The module
-supports both passing the arguments in the cmd line as in the form of a spec
-file:
+supports both passing the arguments through the cmd line or as a spec file:
 
 .. prompt:: bash #
 
@@ -48,15 +47,15 @@ Following is an example of RGW mutlisite spec file:
   spec:
     rgw_frontend_port: 5500
 
-.. note:: The spec file used by RGW has the same format as the one used by cephadm. Thus,
-          the user can provide any cephadm rgw supported parameter as any other advanced
-          configuration items such as SSL certificates etc.
+.. note:: The spec file used by RGW has the same format as the one used by the orchestrator. Thus,
+          the user can provide any orchestration supported rgw parameters including advanced
+          configuration features such as SSL certificates etc.
 
 
 Realm Credentials Token
 -----------------------
 
-User can list the available tokens for the created (or already existing) realms.
+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:
index af7197ddb8ee2b5c8aa87ed627addfa9015faad4..c9e8f2f94e21d50fb8930452fe12a18562a092db 100644 (file)
@@ -609,8 +609,7 @@ class RGWAM:
 
     def realm_rm_zone_creds(self, realm_token_b64):
         if not realm_token_b64:
-            print('missing realm token')
-            return False
+            raise RGWAMException('missing realm token')
 
         realm_token = RealmToken.from_base64_str(realm_token_b64)
         try:
@@ -744,7 +743,7 @@ class RGWAM:
     def zonegroup_create(self, realm_token_b64, zonegroup_name=None,
                          endpoints=None, zonegroup_is_master=True):
         if not realm_token_b64:
-            print('missing realm access config')
+            raise RGWAMException('missing realm access config')
             return False
 
         realm_token = RealmToken.from_base64_str(realm_token_b64)
@@ -791,7 +790,6 @@ class RGWAM:
         logging.info(f"Pulled realm {realm_info['name']} ({realm_info['id']})")
         realm_name = realm_info['name']
         realm_id = realm_info['id']
-        logging.info(f"Pulled realm {realm_name} ({realm_id})")
 
         realm = EntityID(realm_id)
         period_info = self.period_op().get(realm)