Metadata-Version: 2.1
Name: ranger-agent
Version: 2016.3.0.dev61
Summary: Ranger Resource Distributor
Home-page: http://www.openstack.org/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: pbr (>=1.8)
Requires-Dist: oslo.config (>=3.14.0)
Requires-Dist: oslo.messaging (>=5.29.0)
Requires-Dist: oslo.serialization (>=1.10.0)
Requires-Dist: oslo.db (>=4.15.0)
Requires-Dist: oslo.log (>=3.11.0)
Requires-Dist: oslo.utils (>=3.18.0)
Requires-Dist: pecan (!=1.0.2,!=1.0.3,!=1.0.4,>=1.0.0)
Requires-Dist: python-heatclient (>=1.6.1)
Requires-Dist: python-glanceclient (>=2.5.0)
Requires-Dist: python-keystoneclient (>=3.8.0)
Requires-Dist: werkzeug (>=0.11.5)
Requires-Dist: eventlet (!=0.18.3,>=0.18.2)
Requires-Dist: SQLAlchemy (<1.1.0,>=1.0.10)
Requires-Dist: sqlalchemy-migrate (>=0.9.6)
Requires-Dist: PyMySQL (>=0.7.6)
Requires-Dist: lxml (!=3.7.0,>=2.3)
Requires-Dist: PasteDeploy (>=1.5.0)
Requires-Dist: enum34 ; (python_version=='2.7' or python_version=='2.6' or python_version=='3.3')

===============================
Ranger-Agent
===============================

This is the ranger-agent project. At the highest view, provides an API interface
for users to move OpenStack templates from CodeCloud into OS Heat.

This project is designed to show a recommended set of modules
for creating a simple API server and Engine, with a versioned API, clean separation
of modules, a standard way of structuring both unit and functional tests,
configuration files, and documentation.

Devstack Installation
---------------------
1. You can include ranger-agent repository in `local.conf` when running devstack.
	`enable_plugin ranger-agent https://git.openstack.org/openstack/ranger-agent`

2. Make sure `MYSQL_PASSWORD` is included for creating and accessing the database.


Installation
------------

Clone the repo and go to the `tools` directory.

  $ `git clone https://git.openstack.org/openstack/ranger-agent`

Docker Container:
-----------------

1. $ `cd ranger-agent`

2. Update /ranger-agent/tools/.ssh/ranger_agent with your ssh key to your git repo
   containing heat templates.
   You can clone https://github.com/ranger-agent , but pull requests won't be accepted.

3. $ `sudo docker build -t ranger-agent .`

4. $ `sudo docker run -h "ranger-agent" --net host -it --privileged  ranger-agent  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-agent <docker_user_id>/ranger-agent:0.1.0`
   c). $ `docker push <docker_user_id>/ranger-agent:0.1.0`

5. This docker container will be used by helm chart to deploy ranger-agent.

Manual:
------

1. $ `cd ranger-agent/tools`

2. Run `./ranger-agent-db.sh` for setting up the database.

3. Run `./with_venv.sh`.

4. Run `./run_ranger_agent.sh` and it should have ranger-agent running.

5. If `run_ranger_agent.sh` is not running properly, please do the following:
	1. cd to the root folder.
	2. `source localrc`
	3. `sudo -H pip install -r requirements.txt`
	4. `sudo python setup.py install`
	5. `sudo nohup ord-dbsync > /dev/null 2>&1 &`
	6. `sudo nohup ord-engine > /dev/null 2>&1 &`

6. If you want to reinstall and run ranger-agent again, make sure you run
   `./clear_install_files.sh` to remove previous installation files.



