Support for multi-region + documentation

Author: alexcos78

caso/extract/nova.py

@@ -32,6 +32,17 @@
 
 CONF = cfg.CONF
 
+opts = [
+    cfg.StrOpt('region_name',
+               default=None,
+               help='OpenStack Region to use. This option will force cASO to '
+                    'extract records from a specific OpenStack Region, in '
+                    'there are several defined in the OpenStack site. '
+                    'Defaults to None.')
+]
+
+CONF.register_opts(opts)
+
 CONF.import_opt("site_name", "caso.extract.base")
 CONF.import_opt("benchmark_name_key", "caso.extract.base")
 CONF.import_opt("benchmark_value_key", "caso.extract.base")
@@ -44,8 +55,10 @@ def __init__(self):
         super(OpenStackExtractor, self).__init__()
 
     def _get_nova_client(self, project):
+        region_name = CONF.region_name
         session = keystone_client.get_session(CONF, project)
-        return novaclient.client.Client(2, session=session)
+        return novaclient.client.Client(2, session=session,
+                                        region_name=region_name)
 
     def _get_glance_client(self, project):
         session = keystone_client.get_session(CONF, project)

doc/source/multi-region.rst

@@ -0,0 +1,41 @@
+============
+cASO multi-region support
+============
+
+* In case the monitored projects rely on a specific region, define the
+  following variable in the /etc/caso/caso.conf
+
+.. code-block:: bash
+
+  [DEFAULT]
+  region_name = <REGION>
+
+
+* In case the monitored Project(s) rely on different regions, prepare different
+  files /etc/caso/caso-<REGION>.conf
+
+.. code-block:: bash
+
+  [DEFAULT]
+  region_name = <REGION>
+
+
+* List the Project(s) in the /etc/caso/voms.json as from the documentation
+
+.. code-block:: JSON
+
+  {
+    "Project1": {
+      "projects": ["Project1"]
+    },
+    "Project2": {
+      "projects": ["Project2"]
+    }
+  }
+
+* Execute caso-extract for each Project (and related REGION) to be monitored (Project1-REGION1, Project2-REGION2)
+
+.. code-block:: bash
+
+    /usr/bin/caso-extract --projects "Project1" --config-file /etc/caso/caso-<REGION1>.conf
+    /usr/bin/caso-extract --projects "Project2" --config-file /etc/caso/caso-<REGION2>.conf

releasenotes/notes/multi-region-support-4395450dfbc4e8a3.yaml

@@ -0,0 +1,5 @@
+---
+features:
+  - |
+    Add multi-region support in order to extract information from several 
+    regions through different configuration files.