OLD | NEW |
1 Adblock Plus infrastructure | 1 Adblock Plus infrastructure |
2 =========================== | 2 =========================== |
3 | 3 |
4 The new Adblock Plus infrastructure uses | 4 The new Adblock Plus infrastructure uses |
5 [Puppet](http://puppetlabs.com/) to set up and configure our nodes, | 5 [Puppet](http://puppetlabs.com/) to set up and configure our nodes, |
6 and to have realistic test environments for infrastructure components. | 6 and to have realistic test environments for infrastructure components. |
7 | 7 |
8 Our Puppet manifests are only tested with Ubuntu 12.04 right now. | 8 Our Puppet manifests are only tested with Ubuntu 12.04 right now. |
9 | 9 |
10 Development environment | 10 Development environment |
11 ----------------------- | 11 ----------------------- |
12 | 12 |
13 With the new infrastructure, any work we do on our systems or | 13 With the new infrastructure, any work we do on our systems or |
14 infrastructure components should be done in a local test | 14 infrastructure components should be done in a local test |
15 environment. Thanks to Puppet, we can easily set up local VMs just | 15 environment. Thanks to Puppet, we can easily set up local VMs just |
16 like our production environments. | 16 like our production environments. |
17 | 17 |
18 The most convenient way to do this is to use Vagrant, as described | 18 The most convenient way to do this is to use Vagrant, as described |
19 below. | 19 below. |
20 | 20 |
21 ### Requirements | 21 ### Requirements |
22 | 22 |
23 * [VirtualBox](https://www.virtualbox.org/) | 23 * [VirtualBox](https://www.virtualbox.org/) |
24 * [Vagrant](http://vagrantup.com/) | 24 * [Vagrant](http://vagrantup.com/) |
25 | 25 |
26 ### Set up the server | 26 ### Start a VM |
27 | 27 |
28 All you have to do is start _Vagrant_ (that's going to take a while on | 28 Right now, there's only one VM called _webserver_, but we'll have one |
29 first boot): | 29 for each type of server we manage in the future. |
30 | 30 |
31 vagrant up | 31 To start the _webserver_ VM: |
| 32 |
| 33 vagrant up webserver |
32 | 34 |
33 After you've made changes to Puppet manifests, you can update it like this: | 35 After you've made changes to Puppet manifests, you can update it like this: |
34 | 36 |
35 » vagrant provision | 37 » vagrant provision webserver |
36 | 38 |
37 Website development | 39 Website development |
38 ------------------- | 40 ------------------- |
39 | 41 |
40 ### Requirements | 42 ### Requirements |
41 | 43 |
42 * Make sure the _adblockplusorg_ module is included in _vagrant.pp_. | |
43 * A clone of the _anwiki_ repository, next to this directory. | 44 * A clone of the _anwiki_ repository, next to this directory. |
| 45 * The running _webserver_ VM. |
44 | 46 |
45 ### Set up anwiki | 47 ### Set up anwiki |
46 | 48 |
47 1. Go to [http://10.8.0.97](http://10.8.0.97). | 49 1. Go to [http://10.8.0.97](http://10.8.0.97). |
48 | 50 |
49 2. Click on the green _Begin installation_ button. | 51 2. Click on the green _Begin installation_ button. |
50 | 52 |
51 3. Enter _http://10.8.0.97/_ as _Root URL_ and empty the _Cookies | 53 3. Enter _http://10.8.0.97/_ as _Root URL_ and empty the _Cookies |
52 domain_ field. | 54 domain_ field. |
53 | 55 |
(...skipping 30 matching lines...) Expand all Loading... |
84 | 86 |
85 vagrant ssh | 87 vagrant ssh |
86 | 88 |
87 Then execute the following: | 89 Then execute the following: |
88 | 90 |
89 sudo deploy-anwiki | 91 sudo deploy-anwiki |
90 | 92 |
91 If you have a clone of anwiki (see _Requirements_), this will deploy | 93 If you have a clone of anwiki (see _Requirements_), this will deploy |
92 it on the virtual machine. If not, it will clone anwiki from the | 94 it on the virtual machine. If not, it will clone anwiki from the |
93 official repository. | 95 official repository. |
OLD | NEW |