|
|
| (51 intermediate revisions by 16 users not shown) |
| Line 1: |
Line 1: |
| − | __NOTOC__
| |
| − | = [[OpenStack]] Dashboard =
| |
| | | | |
| − | The OpenStack Dashboard is a reference implementation for the django-nova project. Both are housed on Launchpad.
| + | <!-- #REDIRECT Horizon --> |
| | + | == OpenStack Dashboard documentation == |
| | | | |
| − | This web application (built in[http://www.djangoproject.com/ Django]) communicates with nova-api to allow the user to interact with the nova installation with a pleasing graphic interface.
| + | [http://docs.openstack.org/developer/horizon/ Horizon: The OpenStack Dashboard Project] |
| − | | |
| − | The overall steps for building a dashboard are:
| |
| − | | |
| − | # Get the source for both django-nova and openstack-dashboard from launchpad
| |
| − | # Build django-nova with the boostrap script and buildout commands as shown in the dajngo-nova README
| |
| − | # Change over to the openstack-dashboard directory
| |
| − | # Create a virtaulenv for openstack-dashboard (this loads all of it's dependent libraries)
| |
| − | # Configure openstack-dashboard (included example file below)
| |
| − | # Create the openstack-dashboard database (via the sync-db command)
| |
| − | # Run the server
| |
| − | | |
| − | The details of these steps are included below from the README files of each project.
| |
| − | | |
| − | | |
| − | <pre><nowiki>#!rst
| |
| − | | |
| − | OpenStack Dashboard
| |
| − | -------------------
| |
| − | | |
| − | The OpenStack Dashboard is a reference implementation of a Django site that
| |
| − | uses the Django-Nova project to provide web based interactions with the
| |
| − | OpenStack Nova cloud controller.
| |
| − | | |
| − | For more information about the Django-Nova project, please visit:
| |
| − | | |
| − | http://launchpad.net/django-nova
| |
| − | | |
| − | | |
| − | Getting Started
| |
| − | ---------------
| |
| − | | |
| − | The first step is to obtain a local copy of the django-nova project:
| |
| − | | |
| − | $ mkdir django-nova
| |
| − | $ cd django-nova
| |
| − | $ bzr init-repo .
| |
| − | $ bzr branch lp:django-nova/trunk
| |
| − | | |
| − | | |
| − | Next we will create the virtualenv for local development. A tool is included to
| |
| − | create one for you:
| |
| − | | |
| − | $ python tools/install_venv.py <path to django-nova/trunk>
| |
| − | | |
| − | | |
| − | 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.
| |
| − | | |
| − | Finally, issue the django syncdb command:
| |
| − | | |
| − | $ tools/with_venv.sh dashboard/manage.py syncdb
| |
| − | | |
| − | If after you have specified the admin user the script appears to hang, it
| |
| − | probably means the installation of Nova being referred to in local_settings.py
| |
| − | is unavailable.
| |
| − | | |
| − | | |
| − | If all is well you should now able to run the server locally:
| |
| − | | |
| − | $ tools/with_venv.sh dashboard/manage.py runserver
| |
| − | | |
| − | | |
| − | OpenStack Django-Nova
| |
| − | ---------------------
| |
| − | | |
| − | The Django-Nova project is a Django module that is used to provide web based | |
| − | interactions with the OpenStack Nova cloud controller.
| |
| − | | |
| − | There is a reference implementation that uses this module located at:
| |
| − | | |
| − | http://launchpad.net/openstack-dashboard
| |
| − | | |
| − | It is highly recommended that you make use of this reference implementation
| |
| − | so that changes you make can be visualized effectively and are consistent.
| |
| − | Using this reference implementation as a development environment will greatly
| |
| − | simplify development of the django-nova module.
| |
| − | | |
| − | Of course, if you are developing your own Django site using django-nova, then
| |
| − | you can disregard this advice.
| |
| − | | |
| − | | |
| − | | |
| − | Getting Started
| |
| − | ---------------
| |
| − | | |
| − | Django-Nova uses Buildout (http://www.buildout.org/) to manage local
| |
| − | development. To configure your local Buildout environment:
| |
| − | | |
| − | $ python bootstrap.py
| |
| − | $ bin/buildout
| |
| − | | |
| − | This will install all the dependencies of django-nova and provide some useful
| |
| − | scripts in the bin/ directory:
| |
| − | | |
| − | bin/python provides a python shell for the current buildout.
| |
| − | bin/django provides django functions for the current buildout.
| |
| − | | |
| − | | |
| − | You should now be able to run unit tests as follows:
| |
| − | | |
| − | $ bin/django test
| |
| − | | |
| − | | |
| − | | |
| − | </nowiki></pre>
| |
