Metadata-Version: 1.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
Description: ===============================
        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.
        
        
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
