50b6486df9
While current package name "disaster_recovery" is a valid slug inside of the Horizon, when it comes to the Python package naming, it is not conforming with Horizon Dashboard naming pattern, where all existing dashboard packages end their names on `dashboard` or `ui`. Current naming might break Horizon installation logic by some common deployment tools, like OpenStack-Ansible. To prevent that we rename the package given the opportunity, that project is currently in Inactive state and major changes can be made to it. Change-Id: I965b545b6aada866ab5c6eb2279154b70bc5dff1
Team and repository tags
Freezer - Horizon Dashboard
freezer-web-ui is a horizon plugin based in django aimed at providing an interaction with freezer
- Issue tracking and feature specifications: https://storyboard.openstack.org/#!/project/openstack/freezer-web-ui
Requirements
Freezer Dashboard requires a freezer API client to be installed in the same environment as horizon:
git clone https://github.com/openstack/python-freezerclient
cd python-freezerclient
python setup.py install (is important that freezer API client is installed from source and not with pip and
is installed on horizon virtual environment)Freezer Dashboard requires a freezer API endpoint which you can install following this steps:
https://github.com/openstack/freezer-api/blob/master/README.rst
API registration
Register freezer api endpoint:
https://github.com/openstack/freezer-api/blob/master/README.rst#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/openstack/freezer-web-ui
# cd freezer-web-ui
# cp freezer-web-ui/freezer_ui/enabled/_5050_freezer.py /opt/stack/horizon/openstack_dashboard/enabled/_5050_freezer.py
# to disable the panel just copy the following file
# cp freezer-web-ui/freezer_ui/enabled/_7050_freezer_remove_panel_.py /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer_remove_panel_.py
# cd /opt/stack/horizon/
# pip install -r requirements.txt
# make sure freezer is installed from source as detailed in the first step
# ./run_tests.sh --runserver 0.0.0.0:8000Production Installation
To deploy freezer dashboard in production you need to do the following:
# git clone https://github.com/openstack/freezer-web-ui
# cd freezer-web-ui
# cp freezer-web-ui/freezer_ui/enabled/_5050_freezer.py /opt/stack/horizon/openstack_dashboard/enabled/_5050_freezer.py
# to disable the panel just copy the following file
# cp freezer-web-ui/freezer_ui/enabled/_7050_freezer_remove_panel_.py /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer_remove_panel_.py
# make sure freezer is installed from source as detailed in the first step
# restart apache2 serviceA new tab called "Disaster Recovery" will appear on your panels.
Tox
Run tox:
tox -v
Development under proxy
If you are developing or deploying under proxies remember to set no_proxies for:
freezer-api endpoint
keystone endpointSource Code
The project source code repository is located at: https://opendev.org/openstack/freezer-web-ui/