Vagrant Bootstrap

Provides the virtual machine for building and testing kis-bootstrap framework.

Developer: Maciej Macowicz Backup: tbd Documentation: this file Git: vagrant-kis-bootstrap

Installation

Prerequisites

You will need Vagrant with VirtualBox provider ; installing on Linux:

sudo apt-get virtualbox vagrant virtualbox-dkms

MacOS: virtualBox from https://www.virtualbox.org/ (tested: v. 5.0.30 r112061), vagrant from https://www.vagrantup.com/downloads.html (tested: 1.7.4).

VM installation

The machine defintion (Vagrantfile) as well and provision and building scripts are stored in git. To bring it up:

git clone https://c4science.ch/source/vagrant-kis-bootstrap.git
cd vagrant-kis-bootstrap
vagrant up

The machine is provisioned with ruby, gem, nodejs and other JS development tools ... please be patient, it can take a while.

MacOS

The provisionning failed because the vm.hostname was defined as ubuntu-xeral. Modifying /etc/hosts (ubuntu-xeral => 127.0.0.1) solved the problem, but we had to reprovision the VM.

Building Bootstrap EPFL

Once the vagrant VM is up and running: connect via ssh, sudo to the 'kis' user then launch the build script:

\# ensure you are in vagrant-kis-bootstrap directory on host
vagrant ssh
\# inside the guest ...  vagrant VM :
sudo su - kis
sh /vagrant/build-bootstrap.sh

At the end, bootstrap EPFL is deployed in the test environment. So see if it worked ... http://localhost:3000/doc/styleguide/

Modifying and releasing Bootstrap EPFL

Please follow the instructions given in README.md in Bootstrap EPFL distribution (git: https://git.epfl.ch/repo/kis-bootstrap.git). Otherwise the whole source tree is also on guest machine in /home/kis/git/kis-bootstrap.

Enjoy :)