Trove Horizon plugin.

Go to file

lingyongxu 2aeba36540 Update the documentation link for doc migration This patch is proposed according to the Direction 10 of doc migration(https://etherpad.openstack.org/p/doc-migration-tracking). Change-Id: I1af71d90df1777244093de6301186a140f601011		2017-12-19 05:48:34 +00:00
devstack	Ensure to compile translation catalogs	2016-02-24 00:37:48 +09:00
releasenotes	Imported Translations from Zanata	2017-07-25 06:19:43 +00:00
tools	make trove-dashboard use upper-constraints	2016-11-03 22:02:45 +00:00
trove_dashboard	Imported Translations from Zanata	2017-07-25 06:19:43 +00:00
.gitignore	Add reno for release notes management	2016-04-14 20:56:32 +00:00
.gitreview	Add missing .gitreview file	2016-01-12 16:44:45 +00:00
babel-django.cfg	Setup for translations	2016-01-26 07:46:57 +09:00
babel-djangojs.cfg	Setup for translations	2016-01-26 07:46:57 +09:00
CONTRIBUTING.rst	Update the documentation link for doc migration	2017-12-19 05:48:34 +00:00
HACKING.rst	Update the documentation link for doc migration	2017-12-19 05:48:34 +00:00
LICENSE	Completing the plugin	2015-12-18 15:53:31 -07:00
manage.py	Completing the plugin	2015-12-18 15:53:31 -07:00
MANIFEST.in	Completing the plugin	2015-12-18 15:53:31 -07:00
README.rst	Update the documentation link for doc migration	2017-12-19 05:48:34 +00:00
requirements.txt	Completing the plugin	2015-12-18 15:53:31 -07:00
run_tests.sh	Completing the plugin	2015-12-18 15:53:31 -07:00
setup.cfg	Update the documentation link for doc migration	2017-12-19 05:48:34 +00:00
setup.py	Completing the plugin	2015-12-18 15:53:31 -07:00
test-requirements.txt	Remove discover from test-requirements	2016-07-21 07:56:28 +00:00
tox.ini	Fix Django 1.10 Compatibility	2016-12-09 14:51:46 -05:00

README.rst

OpenStack Dashboard plugin for Trove project

How to use with Horizon on server:

Use pip to install the package on the server running Horizon. Then either copy or link the files in trove_dashboard/enabled to openstack_dashboard/local/enabled. This step will cause the Horizon service to pick up the trove plugin when it starts.

How to use with devstack:

Add the following to your devstack local.conf file:

enable_plugin trove-dashboard git://git.openstack.org/openstack/trove-dashboard

To run unit tests:

./run_tests.sh

Editing Code

Apache

Make a change to trove-dashboard then goto to the horizon directory and compress the code with django and then restart apache.:

# rsync code to /opt/stack/trove-dashboard
# copy or link files from trove-dashboard/enabled/* to horizon/openstack_dashboard/local/enabled/
cd /opt/stack/horizon
python manage.py compress
python manage.py collectstatic --noinput
sudo service apache2 restart

Django

You can also speed up development time using the django test server instead of apache.:

/opt/stack/horizon/run_tests.sh --runserver

If you set COMPRESS_ENABLED and COMPRESS_OFFLINE to False in local_settings.py that allows you to bypass the compress and collectstatic as well.

Settings

The use of a cross-process cache such as Memcached is required.

Install Memcached itself and a Memcached binding such as python-memcached.

For a single horizon instance use the CACHES setting like the example below.

CACHES = {

'default': {: 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache', 'LOCATION': '127.0.0.1:11211',

}

For multiple horizon instances behind a load balancer configure each instance to use the same cache like the example below.

CACHES = {

'default': {: 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache', 'LOCATION': [u'10.2.100.133:11211', u'10.2.100.134:11211'']

}

NOTE:

As of the Mitaka release, the dashboard for trove is now maintained outside of the Horizon codebase, in this repository.

Links:

Trove project: https://git.openstack.org/openstack/trove

Trove at wiki.openstack.org: https://wiki.openstack.org/wiki/Trove

Launchpad project: https://launchpad.net/trove-dashboard