openstack/rally
Code Issues Proposed changes
cf2f121515
rally/doc/source/install.rst
Mikhail Dubov 1ceb1555f3 Restructure Rally docs 
Modify Rally docs (for readthedocs), sticking to the following principles:
* Make the docs structure as simple as possible:
    1. Overview
    2. Install Rally
    3. Rally step-by-step
    4. User stories
    5. Plugins
    6. Contribute to Rally
    7. Rally OS Gates
    8. Request a New Feature
    9. Project Info
* Keep in mind what questions different target groups usually have about Rally.
  The new structure relates to these groups as follows:
    1 -> Managers
    2, 3, 4 -> QA
    5, 6, 7, 8, 9 -> QA & Developers
* Make each docs page to be easy to get through;
* Prefer pictures over text;
* Use hyperlinks to easily navigate from page to page;
* Fix incorrect English & typos.

Also add a sample for SLA plugins.

Change-Id: I720d87be851c273689a21aaba87fc67eacf0f161
2015-01-20 00:27:30 +03:00

3.2 KiB
Raw Blame History

Installation

Automated installation

git clone https://git.openstack.org/stackforge/rally
./rally/install_rally.sh

Notes: The installation script should be run as root or as a normal user using sudo. Rally requires either the Python 2.6 or the Python 2.7 version.

Alternatively, you can install Rally in a virtual environment:

git clone https://git.openstack.org/stackforge/rally
./rally/install_rally.sh -v

Rally with DevStack all-in-one installation

It is also possible to install Rally with DevStack. First, clone the corresponding repositories:

git clone https://git.openstack.org/openstack-dev/devstack
git clone https://github.com/stackforge/rally

Then, configure DevStack to run Rally:

cp rally/contrib/devstack/lib/rally devstack/lib/
cp rally/contrib/devstack/extras.d/70-rally.sh devstack/extras.d/
cd devstack
echo "enable_service rally" >> localrc

Finally, run DevStack as usually:

./stack.sh

Rally & Docker

There is an image on dokerhub with rally installed. To pull this image, just execute:

docker pull rallyforge/rally

Or you may want to build rally image from source:

# first cd to rally source root dir
docker build -t myrally .

Since rally stores local settings in user's home dir and the database in /var/lib/rally/database, you may want to keep this directories outside of container. This may be done by the following steps:

cd ~  #go to your home directory
mkdir rally_home rally_db
docker run -t -i -v ~/rally_home:/home/rally -v ~/rally_db:/var/lib/rally/database rallyforge/rally

You may want to save last command as an alias:

echo 'alias dock_rally="docker run -t -i -v ~/rally_home:/home/rally -v ~/rally_db:/var/lib/rally/database rallyforge/rally"' >> ~.bashrc

After executing dock_rally alias, or docker run you got bash running inside container with rally installed. You may do anytnig with rally, but you need to create db first:

user@box:~/rally$ dock_rally
rally@1cc98e0b5941:~$ rally-manage db recreate
rally@1cc98e0b5941:~$ rally deployment list
There are no deployments. To create a new deployment, use:
rally deployment create
rally@1cc98e0b5941:~$

More about docker: https://www.docker.com/