a17570110f
Buildout has been removed entirely, all dev installation is now done via the single tools/install_venv.py script. Django's manage.py script has also been updated to a newer version/convention; this allows for less python path mangling and makes things cleaner and more explicit. Note that, as such, it has been moved up a directory level. Change-Id: I62f9f06ee00568fc91e5ba7e1fd15d22ea849d1f
43 lines
1.3 KiB
Plaintext
43 lines
1.3 KiB
Plaintext
===================
|
|
OpenStack Dashboard
|
|
===================
|
|
|
|
The OpenStack Dashboard is a reference implementation of a Django site that
|
|
uses the Horizon project to provide web based interactions with the various
|
|
OpenStack projects.
|
|
|
|
|
|
Getting Started
|
|
===============
|
|
|
|
For local development, first create a virtualenv for the project.
|
|
In the Horizon ``tools`` directory there is a script to create one for you:
|
|
|
|
$ python tools/install_venv.py
|
|
|
|
Alternatively, the ``run_tests.sh`` script will also install the environment
|
|
for you and then run the full test suite to verify everything is installed
|
|
and functioning correctly.
|
|
|
|
Now that the virtualenv is created, you need to configure your local
|
|
environment. To do this, create a ``local_settings.py`` file in the ``local/``
|
|
directory. There is a ``local_settings.py.example`` file there that may be
|
|
used as a template.
|
|
|
|
If all is well you should now able to run the development server locally:
|
|
|
|
$ tools/with_venv.sh openstack-dashboard/manage.py runserver
|
|
|
|
or, as a shortcut::
|
|
|
|
$ ./run_tests.sh --runserver
|
|
|
|
Settings Up OpenStack
|
|
=====================
|
|
|
|
The recommended tool for installing and configuring the core OpenStack
|
|
components is `Devstack`_. Refer to their documentation for getting
|
|
Nova, Keystone, Glance, etc. up and running.
|
|
|
|
.. _Devstack: http://devstack.org/
|