From 87ded1351c43ba67fbda194b7b2a694013db2524 Mon Sep 17 00:00:00 2001 From: Tzu-Mainn Chen Date: Tue, 13 Aug 2013 11:07:54 -0400 Subject: [PATCH] Updates documentation for plugin architecture Change-Id: Iab77ae6a3672120ae48dd8b2a84c6fd44e0cd7f2 --- README.rst | 29 +++++++++++++++++++++++++---- docs/index.rst | 29 +++++++++++++++++++++++++---- docs/install.rst | 25 +++++++++++++++++++------ 3 files changed, 69 insertions(+), 14 deletions(-) diff --git a/README.rst b/README.rst index e14b2d522..9b5a05685 100644 --- a/README.rst +++ b/README.rst @@ -2,8 +2,8 @@ tuskar-ui ========= **tuskar-ui** is a user interface for -`Tuskar `__, a management API for -OpenStack deployments. It is based on (and forked from) `OpenStack +`Tuskar `__, a management API for +OpenStack deployments. It is a plugin for `OpenStack Horizon `__. High-Level Overview @@ -14,10 +14,29 @@ as much as possible. We use existing Horizon libraries and components where possible. If added libraries and components are needed, we will work with the OpenStack community to push those changes back into Horizon. +Code Repository +--------------- + +We've moved the code to `stackforge `__ +to be more familiar to the OpenStack developers. Please go there if you +want to check it out: + + git clone https://github.com/stackforge/tuskar-ui.git + +The list of bugs and blueprints is on Launchpad: + +``__ + +We use OpenStack's Gerrit for the code contributions: + +``__ + +and we follow the `OpenStack Gerrit Workflow `__. + Installation Guide ------------------ -Use the `Installation Guide `_ to install Tuskar-UI. +Use the `Installation Guide `_ to install Tuskar-UI. License ------- @@ -29,7 +48,7 @@ Further Documentation --------------------- Check out our `docs directory -`_ +`_ for expanded documentation. Contact Us @@ -39,3 +58,5 @@ Join us on IRC (Internet Relay Chat):: Network: Freenode (irc.freenode.net/tuskar) Channel: #tuskar + +Or send an email to openstack-dev@lists.openstack.org. diff --git a/docs/index.rst b/docs/index.rst index b3c268781..3b6e8cb49 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,7 +2,7 @@ Tuskar-UI ========= -Tuskar-UI is a user interface for `Tuskar `_, a management API for OpenStack deployments. It is based on (and forked from) `OpenStack Horizon `_. +Tuskar-UI is a user interface for `Tuskar `_, a management API for OpenStack deployments. It is a plugin for `OpenStack Horizon `_. High-Level Overview ------------------- @@ -18,12 +18,31 @@ Developer Information Installation Guide ~~~~~~~~~~~~~~~~~~ -Follow the `Installation Guide `_ to install Tuskar-UI. +Follow the `Installation Guide `_ to install Tuskar-UI. + +Contributing +~~~~~~~~~~~~ + +We've moved the code to `stackforge `__ +to be more familiar to the OpenStack developers. Please go there if you +want to check it out: + + git clone https://github.com/stackforge/tuskar-ui.git + +The list of bugs and blueprints is on Launchpad: + +``__ + +We use OpenStack's Gerrit for the code contributions: + +``__ + +and we follow the `OpenStack Gerrit Workflow `__. If you're interested in the code, here are some key places to start: -* `openstack_dashboard/api/tuskar.py `_ - This file contains all the API calls made to the Tuskar API (through python-tuskarclient). -* `openstack_dashboard/dashboards/infrastructure `_ - The Tuskar UI code is contained within this directory. Up to this point, UI development has been focused within the resource_management/ subdirectory. +* `tuskar_ui/api.py `_ - This file contains all the API calls made to the Tuskar API (through python-tuskarclient). +* `tuskar_ui/infrastructure `_ - The Tuskar UI code is contained within this directory. Up to this point, UI development has been focused within the resource_management/ subdirectory. Future Work ----------- @@ -35,3 +54,5 @@ Join us on IRC (Internet Relay Chat):: Network: Freenode (irc.freenode.net/tuskar) Channel: #tuskar + +Or send an email to openstack-dev@lists.openstack.org. diff --git a/docs/install.rst b/docs/install.rst index f0ce39f1b..a0b9cae08 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -20,7 +20,7 @@ Installation prerequisites are: machine as tuskar-ui, but it must be network accessible. You may find -`the Tuskar install guide `_ +`the Tuskar install guide `_ helpful. For baremetal provisioning, you will want a Nova Baremetal driver @@ -70,17 +70,24 @@ On RHEL 6, you'll need to build nodejs from source: Install the management UI ------------------------- -Begin by cloning the tuskar-ui repository: +Begin by cloning the horizon and tuskar-ui repositories: :: - git clone git://github.com/tuskar/tuskar-ui.git + git clone git://github.com/openstack/horizon.git + git clone git://github.com/stackforge/tuskar-ui.git + +Go into horizon and create a symlink to the tuskar-ui code: + +:: + + cd horizon + ln -s ../tuskar-ui/tuskar_ui Then, install a virtual environment for your setup: :: - cd tuskar-ui python tools/install_venv.py Next, run ``run_tests.sh`` to have pip install dependencies: @@ -93,7 +100,7 @@ Set up your ``local_settings.py`` file: :: - cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py + cp ../tuskar-ui/local_settings.py.example openstack_dashboard/local/local_settings.py Open up the copied ``local_settings.py`` file in your preferred text editor. You will want to customize several settings: @@ -142,7 +149,13 @@ First, activate your virtual environment: source .venv/bin/activate -Then, synchronize your local database: +tuskar-ui introduces one additional dependency - python-tuskarclient: + +:: + + pip install git+http://github.com/stackforge/python-tuskarclient.git + +Finally, synchronize your local database: ::