Resource Management API Framework
Go to file
Zuul c7c6cd725a Merge "Revert "Fix Audit Trail event_details db size"" 2020-02-18 16:45:45 +00:00
doc Merge Python3 branch 2019-10-29 10:36:00 -05:00
etc Add Domain name to ranger region 2020-02-13 19:14:32 +00:00
images Fixed error in Dockerfile 2020-01-22 10:39:25 -06:00
orm Merge "Revert "Fix Audit Trail event_details db size"" 2020-02-18 16:45:45 +00:00
public initial commit 2017-07-27 09:14:42 -05:00
releasenotes Merge Python3 branch 2019-10-29 10:36:00 -05:00
tools Removed unneeded Variables from image gate and update latest 2019-11-22 11:12:29 -06:00
.coveragerc Add coverage to ranger 2017-08-15 14:04:01 -07:00
.gitignore Services pecan log Configuration – Debug Enabled/Disable 2019-05-08 16:37:11 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:50:45 +00:00
.stestr.conf Services pecan log Configuration – Debug Enabled/Disable 2019-05-08 16:37:11 +00:00
.zuul.yaml Fix Ranger quay.io robot credentials 2019-11-19 16:33:49 -06:00
MANIFEST.in initial commit 2017-07-27 09:14:42 -05:00
Makefile Fix makefile to pass IMAGE_TAG parameter 2020-01-23 17:10:01 +00:00
README.rst Minor README change 2019-06-06 09:24:41 -07:00
babel.cfg initial commit 2017-07-27 09:14:42 -05:00
bandit.yaml Bandit scan changes for ranger 2018-12-13 18:22:43 +05:30
bindep.txt Makefile Syntax Fixes 2019-11-21 08:12:59 -06:00
config.py initial commit 2017-07-27 09:14:42 -05:00
requirements.txt Ranger - remove git logic 2019-11-25 13:03:01 -08:00
setup.cfg Fix bad path copy of policy.json 2020-02-04 13:06:49 -06:00
setup.py Cleanup Ranger config and db setup files 2018-08-24 19:53:17 +00:00
test-requirements.txt Merge Python3 branch 2019-10-29 10:36:00 -05:00
tox.ini Merge Python3 branch 2019-10-29 10:36:00 -05:00

README.rst

Ranger

Ranger is an OpenStack Resource Management tool capable of managing different types of clouds into one platform. Here are the following of what it provides:

  • Multi-region common resource management.
  • Light weight, stateless and interface with external self-service portals.
  • Runs on DCP.
  • Resource agents will run on LCP to orchestrate and keep resources in sync from a

    centralized repository.

Before Setting Up

Make sure ranger-agent is running before installing and running ranger since that is required for connecting with Openstack.

Devstack Installation

  1. Add the following line in local.conf to include ranger repository in your devstack.

    enable_plugin ranger https://git.openstack.org/openstack/ranger

  2. Make sure MYSQL_PASSWORD is included for creating and accessing the database.
  3. Run ./stack.sh from devstack directory.

Installation

1. Navigate to ranger/tools directory:

$ cd /opt/stack/ranger/tools

2. To make changes to the port numbers and other configurations, please go to base_config.py under

the orm folder before continuing to the next steps.

  1. Run ./ranger_create_db.sh to create ranger databases.
  2. Run ./setup_apache.sh to create conf files for each of the services to apache.
  3. Run stack_orm.sh to set up ranger.
  4. If stack_orm.sh is not running properly, navigate to /opt/stack/ranger and run the following:
    1. sudo pip install -r requirements.txt
    2. sudo python setup.py develop 2>&1 | tee $root_dir/tools/install.log

Generate ranger.conf file

$tox -e genconfig

A blank configuration file will be generated at etc/ranger.conf

Running Ranger Services

To run each of the services, type in these commands in order to run each of the services.
  • Audit: orm-audit
  • Uuidgen: orm-uuidgen
  • RDS (Resource Distributor Service): orm-rds
  • RMS (Resource Management Service): orm-rms
  • FMS (Flavor Management Service): orm-fms
  • CMS (Customer Management Service): orm-cms
  • IMS (Image Management Service): orm-ims

For RMS, FMS, CMS, and IMS to be running, Audit, Uuidgen, and RDS must also be running properly as well in order to use them.

Docker Container:

  1. $ cd ranger
  2. Update /ranger/tools/.ssh/ranger with your ssh key to your git repo containing heat templates. You can clone https://github.com/ranger , but pull requests won't be accepted.
  3. $ sudo docker build -t ranger .
  4. $ sudo docker run -h "ranger" --net host -it --privileged ranger bash Creating docker image and publish will be done by deployment jobs. For Refernce and validation manually image could push using. a). $ docker login <docker_user_id> b). $ docker tag ranger <docker_user_id>/ranger:0.1.0 c). $ docker push <docker_user_id>/ranger:0.1.0
  5. This docker container will be used by helm chart in order to deploy ranger.