fuel-dev-tools/vagrant/README.md
Przemyslaw Kaminski 7b754dcfc5 Add fuel-astute tests info to README
Change-Id: I1955239f2020faa454a2b36fe320c31a570a9502
2015-05-06 14:39:28 +02:00

2.6 KiB

============================ Fuel development Vagrant box

This is a definition of a Vagrant box tailored for development of Mirantis Fuel. Configuration is done using SaltStack.

Usage

Clone and cd into this repo then run

vagrant up

to start the Vagrant box.

Then run

vagrant ssh
sudo su
salt-call state.highstate --local

to SSH into the machine and initially set up the environment. Then on the virtual machine as user vagrant you can do

workon fuel

to activate the Python virtualenv. To start the server type

/sources/fuel-web/nailgun/manage.py run --fake-tasks

and point your browser to http://localhost:8200 -- username/password for the test env is admin/admin.

Sometimes it might be necessary to repopulate the DB with fixtures, to do this just type (dropdb might be needed before):

./manage.py syncdb
./manage.py loaddefault # It loads all basic fixtures listed in settings.yaml
./manage.py loaddata nailgun/fixtures/sample_environment.json  # Loads fake nodes

As a shortut, a script nailgun_clean_db.sh is provided to reinitialize the database using the above commands.

To run tests:

cd /sources/fuel-web
./run_tests.sh

The sources directory is mounted under /sources on the Vagrant machine using Rsync for better performance (otherwise tests run incredibly slow). If you want Vagrant to automatically rsync your local directory to the virtualmachine run

vagrant rsync-auto

Note that this is a one-way sync, i.e. from your local machine to the virtual machine, not the other way around.

There is also the /vagrant/sources folder where sources are mounted too, but using the standard VirtualBox Synchronized Folders which is extremely slow.

For more information see http://docs.mirantis.com/fuel-dev/develop/nailgun/development/env.html and http://docs.mirantis.com/fuel-dev/develop/env.html

tmux

tmux is installed by default. Each tmux window's output is logged to a separate file for easier inspection of history. The file's name can be fetched in current active window from the TMUX_LOG_FILE variable (see /home/vagrant/.bash_profile).

Astute

To run Ruby tests for fuel-astute:

cd /sources/fuel-astute
rvm gemset use astute
./run_tests.sh

TODO

  • eliminate the need for running rsync-auto and instead install the rsync service inside the Vagrant box that synchronizes /vagrant/sources into /sources
  • add link (and Jenkins job?) to pre-generated Vagrant box