blob: 34a8ae30edabacc48b6146e0d63ef44bfda9aebb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
Using Vagrant for development
=============================
These instructions will get you up and running using Alaveteli with
[Vagrant](http://vagrantup.com) to create a development virtual machine.
Setup
-----
First of all install dependencies like VirtualBox and then install Vagrant:
`gem install vagrant`.
You'll also need `nfsd` installed on your machine for NFS shared folders. This
is required for performance reasons. On Ubuntu install the `nfs-server`
package.
Usage
-----
### Clone the Alaveteli repo
git clone https://github.com/sebbacon/alaveteli.git
cd alaveteli
### Download, install and run VM
NOTE: This will download at least 400MB and take some time (30 minutes
with a broadband internet connection). The downloading is only
required the first time you run this command.
You'll be asked for your password to sudo - this is required to create NFS
shared folders.
vagrant up
### SSH to the new box and switch to the Alaveteli directory
vagrant ssh
cd /vagrant
### Load sample data and index it
bundle exec ./script/load-sample-data && bundle exec ./script/rebuild-xapian-index
### Run the tests
bundle exec rake spec
### Start the development server
bundle exec ./script/server
### And you're golden
Now visit `http://localhost:3000` on your local machine to see your hard work.
Edit files on your local machine and see the changes reflected when you refresh
your browser. To run tests, SSH to the Vagrant machine with `vagrant ssh`.
|
