freezer-web-ui

======================== Team and repository tags

.. image:: https://governance.openstack.org/tc/badges/freezer-web-ui.svg :target: https://governance.openstack.org/tc/reference/tags/index.html

.. Change things from this point on

=========================== 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
<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
<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>

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 set `DISABLED = True` in /opt/stack/horizon/openstack_dashboard/enabled/_5050_freezer.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:8000

A 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 endpoint

Source Code

The project source code repository is located at: https://opendev.org/openstack/freezer-web-ui/