2a465428ff
Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using these versions will allow especially: * Linking from HTML to PDF document * Allow parallel building of documents * Fix some rendering problems Update Sphinx version as well. Change pygments_style to 'native' since old theme version always used 'native' and the theme now respects the setting and using 'sphinx' can lead to some strange rendering. openstackdocstheme renames some variables, so follow the renames before the next release removes them. A couple of variables are also not needed anymore, remove them. See also http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html Change-Id: I420adfab0ff40fffd9a211d72ad6c953a495676e
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/disaster_recovery/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/disaster_recovery/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/disaster_recovery/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/disaster_recovery/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/