openstack/freezer
Code Issues Proposed changes
f6ad1e34f5
freezer/horizon_web_ui
History
Erno Kuvaja 403a76ccd3 Align requirements with global-requirements 
Setting requirements to mins and caps aligned with global requirements
on packages where it's possible.
Commenting the ones that does not align.

Change-Id: Iba37d120c980ba849f79851fcbfc005651ed600d
2015-08-05 08:14:31 +00:00
..
freezer_ui Add freezer dashboard documentation to html files 2015-07-31 13:28:33 +00:00
_50_freezer.py Improve installation docs for freezer dashboard 2015-07-31 14:49:13 +01:00
__init__.py Horizon implementation for jobs api endpoint 2015-07-15 16:49:41 +01:00
.pylintrc Copied tox.ini and .pylintrc from root directory 2015-06-19 10:53:57 +01:00
manage.py This version contains the following pages: 2015-05-31 17:01:57 +01:00
MANIFEST.in First version of setup.py 2015-06-21 18:10:07 +00:00
README.rst Improve installation docs for freezer dashboard 2015-07-31 14:49:13 +01:00
requirements.txt Improve installation docs for freezer dashboard 2015-07-31 14:49:13 +01:00
setup.cfg First version of setup.py 2015-06-21 18:10:07 +00:00
setup.py First version of setup.py 2015-06-21 18:10:07 +00:00
test-requirements.txt Align requirements with global-requirements 2015-08-05 08:14:31 +00:00
tox.ini Copied tox.ini and .pylintrc from root directory 2015-06-19 10:53:57 +01:00

README.rst

Freezer - Horizon Dashboard

Requirements

Freezer Dashboard requires a freezer API endpoint which you can install following this steps:

https://github.com/stackforge/freezer/blob/master/freezer_api/README.rst

API registration

Register freezer api endpoint:

https://github.com/stackforge/freezer/blob/master/freezer_api/README.rst#3-api-registration

If keystone service-create and endpoint-create are not available you can set as a fallback the following on:

# vim /opt/stack/horizon/openstack_dashboard/local/local_settings.py

# add FREEZER_API_URL = http://<api_url>:<port>

Dev Installation

In the installation procedure we'll assume your main Horizon dashboard directory is /opt/stack/horizon/openstack_dashboard/dashboards/.

To install freezer dashboard for development you need to do the following:

# git clone https://github.com/stackforge/freezer

# cd freezer/horizon_web_ui

# cp _50_freezer.py  /opt/stack/horizon/openstack_dashboard/local/enabled/

# modify _50_freezer.py (line 9) and point the path to the freezer repo.

# cd /opt/stack/horizon/

# ./run_tests.sh --runserver 0.0.0.0:8000

# pip install -r requirements.txt

Production Installation

To deploy freezer dashboard in production you need to do the following:

# git clone https://github.com/stackforge/freezer

# cd freezer/horizon_web_ui

# cp _50_freezer.py  /opt/stack/horizon/openstack_dashboard/local/enabled/

# modify _50_freezer.py (line 9) and point the path to the freezer repo.

# restart apache2 service

A new tab called "Disaster Recovery" will be on your panels.

Running the unit tests

  1. Create a virtual environment:

    virtualenv --no-site-packages -p /usr/bin/python2.7 .venv

  2. Activate the virtual environment:

    . ./.venv/bin/activate

  3. Install the requirements:

    pip install -r test-requirements.txt

  4. Run the tests:

    python manage.py test . --settings=freezer_ui.tests.settings

Test coverage

  1. Collect coverage information:

    coverage run --source='.' --omit='.venv/*' manage.py test . --settings=freezer_ui.tests.settings

  2. View coverage report:

    coverage report