83 lines
2.6 KiB
Markdown
83 lines
2.6 KiB
Markdown
============================
|
|
Fuel development Vagrant box
|
|
============================
|
|
|
|
This is a definition of a Vagrant box tailored for development of Mirantis Fuel.
|
|
Configuration is done using [SaltStack](http://saltstack.com/).
|
|
|
|
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](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](http://tmux.sourceforge.net/) 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
|