tatu-dashboard/README.rst
2018-01-09 00:09:20 -06:00

80 lines
2.3 KiB
ReStructuredText

========================
Team and repository tags
========================
.. image:: http://governance.openstack.org/badges/designate-dashboard.svg
:target: http://governance.openstack.org/reference/tags/index.html
.. Change things from this point on
===============================
tatudashboard
===============================
Tatu Horizon UI bits
* Free software: Apache license
Features
--------
* TODO
Howto
-----
1. Package the tatudashboard by running::
python setup.py sdist
This will create a python egg in the dist folder, which can be used to install
on the horizon machine or within horizon's python virtual environment.
-- or --
Install directly from source by running "python setup.py --install"
Note: On some systems python may throw an error like
'Exception: Versioning for this project requires either an sdist tarball, or access
to an upstream git repository'
this seems to be a result of mismatched pbr versioning. A hacking workaround for development
purposes is replacing the pbr call with a hard-coded version (e.g. '1.0.1') in
tatudashboard/__init__.py.
2. Copy panel plugin files into your Horizon config. These files can be found in tatudashboard/enabled
and should be copied to /usr/share/openstack-dashboard/openstack_dashboard/local/enabled or the
equivalent directory for your openstack-dashboard install.
3. Make sure your keystone catalog contains endpoints for service type 'dns'. If no such endpoints are
found, the tatudashboard panels will not render.
4. (Optional) Copy the tatu policy file into horizon's policy files folder, and add this config::
'ssh': 'tatu_policy.json',
5. (Optional) Within your horizon settings file(s) (either the local settings or the other settings.py), add
the line below. This will make it so the record create/update screen uses a drop down of your floating ip
addresses instead of a free form text field::
TATU = { 'records_use_fips': True }
Test
----
* How to run JS tests:
* Install npm and nodejs=4.8.4
$ ``sudo apt-get install npm``
$ ``curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -``
$ ``sudo apt-get install -y nodejs``
1. ``npm install`` (to create virtual environment and install all dependencies in package.json)
2. ``npm run lint`` for eslint
3. ``npm run test`` for JS unit tests