bramw_baserow/deploy/vagrant

Vagrant Baserow Ubuntu Install Test

This folder contains a vagrant file and bootstrap.sh which together will start up a local Ubuntu 18.04 virtual machine with Baserow installed and working. To do this it extracts the bash from the install-on-ubuntu.md guide and runs it in a fresh new VM.

WARNING: Using this vagrant setup is currently intended only for local testing and development.

How to run

1. Install virtualbox - https://www.virtualbox.org/wiki/Downloads
2. Install vagrant - https://www.vagrantup.com/downloads
3. cd tests/vagrant_ubuntu_install
4. Install required vagrant plugins:
   1. vagrant plugin install landrush
      1. Used to setup a local dns server so you can visit Baserow using a domain
   2. vagrant plugin install vagrant-vbguest
      1. So we can mount in your local baserow repo and use that to install Baserow
   3. vagrant vbguest
5. On Ubuntu I had to follow the instructions in https://github.com/vagrant-landrush/landrush/blob/master/doc/Usage.adoc#visibility-on-the-host
   1. Also see https://gist.github.com/neuroticnerd/30b12648a933677ad2c4 for more landrush dns tips.
6. Change the branch found at the end of line 6 in the Vagrantfile to be the branch you want to test.
7. vagrant up
   1. You might need to interactively enter your password for the landrush dns plugin to successfully add local dns entries on your host for Baserow running inside the vm.
8. Wait a long time for everything to be provisioned
9. Once done visit http://baserow.vagrant.test on your host machine to see the Baserow running inside the vm.
10. Run vagrant ssh to ssh into the VM and make changes, inspect the logs, restart services etc.