README.md

# Vagrant Démarches Simplifiées

Vagrant box for Démarches Simplifiées

## Prerequisites

* Virtualbox 
* Vagrant
* git
* r10k (see below how to do this properly)

## r10k installation on a workstation

TODO: this should be correctly explained and tested (which by now may not be the case :) )

1. On your workstation, install [RBenv](https://github.com/rbenv/rbenv). RBenv allows a user to have different versions of Ruby running on a system and isolate them. This is a great help when using Puppet on Linux, as Ruby versions shipped with distros can be quite old. Moreover, RBenv allows user to have a Ruby installation in its user-space, so that no root privileges are required.
1. With RBenv install Ruby 2.5.x (please follow RBenv documentation to do that)
1. Install r10k: `gem install r10k`

## Usage

### For the first time : set a dev environnement

Create a new project that is your local working development repository, for example: 

```
cd project
git clone https://github.com/adullact/demarches-simplifiees.fr.git
```

Grab the vagrant-demarches-simplifiees repository, get into it, grab Puppet modules needed:

```
git clone git@gitlab.adullact.net:demarches-simplifiees/vagrant-demarches-simplifiees.git
cd vagrant-demarches-simplifiees
./BUILD.sh
```

Edit the `Vagrantfile` config.vm.synced_folder parameter to match with your local working directory:
 The first parameter is the relative path to the local project that you working on. For example here it's `../demarches-simplifiees.fr`
 The second parameter is the path where it will be shared on the VM. `/shared_dev` as example.
 
```
config.vm.synced_folder "../demarches-simplifiees.fr", "/shared_dev"
```

Edit file 'manifests/default.pp'
Be sure that the variable `$local_source_code_of_ds` is the right one.  If you haven't changed it, it's '/shared_dev/'.

``` 
$local_source_code_of_ds = '/shared_dev/'
```

Then run the vagrant file from the project directory:

```
vagrant up
```

Once the build is done, follow the instructions in [this document](Prerequisite_unautomated.md) to complete the installation.

### To rebuild a vm 

If you already have the all environment just run vagrant from the project directory: 

```
vagrant destroy -f && vagrant up
```

And follow the instructions in [this document](Prerequisite_unautomated.md).