pilvivayla-basaari development environment
To start developing pilvivayla-basaari project, you can use this Vagrant box and ansible playbooks to setup isolated development environment.
Requirements
These components needs to be installed to your host machine (computer that you’re using for development):
- Virtualbox (v. 4.1.12 or higher)
- Vagrant (v. 1.6.3 or higher)
- pip (v. 1.0 or higher)
- Ansible (v. 1.7 or higher)
For Ubuntu 14.04 LTS:
- Virtualbox 4.3.10_Ubuntur93012 (sudo apt-get install virtualbox)
- Vagrant 1.6.3 ( https://dl.bintray.com/mitchellh/vagrant/vagrant_1.6.3_x86_64.deb)
- Ansible 1.7.1 (sudo pip install ansible)
Usage
First time usage
Create folder that is synced with vagrant box. Vagrantfile automatically uses /mnt/basaar folder in your host machine.
You can create folder using following command:
sudo mkdir -p /mnt/basaar
And then use chown command to change ownership to your user.
sudo chown -R <username> /mnt/basaar
To setup vagrantbox to your host machine, clone the repository
git clone https://github.com/koulutuksenpilvivayla/pilvivayla-provisioning.git
Run command from the repository root ./install.sh
The script will check that every requirements are satisfied.
No sudo required to run this script.
If you get message
Basaar is successfully installed. To run server login to vagrant box using 'vagrant ssh' command and run command /home/vagrant/basaar/sites/basaar/manage.py runserver 0.0.0.0:8000 Source code is located in host machine /mnt/basaar, you can use that with your favourite IDE. :-)
then your development environment is setup correctly.
Normal usage
If you already have installed the development environment, you can just cd to the repository where Vagrantfile is located and run command: vagrant up
Vagrant commands:
- vagrant up (starts the virtual environment)
- vagrant halt (stops the virtual environment)
- vagrant reload (restarts the virtual environment)
- vagrant ssh (access to virtual environemnt with ssh)
Start django server from virtual environment
After you have installed and the vagrant box is running (vagrant up command) you can access to it with vagrant ssh command. When you're inside vagrant box, run /home/vagrant/basaar/sites/basaar/manage.py runserver 0.0.0.0:8000 command. Then you can open browser from host machine and access to basaar application with url http://localhost:8000
Source code
After the installation, you can use favourite IDE/editor from your host machine. Source code is located on /mnt/basaar in your host machine.
Git
After instalation, please change git settings from /mnt/basaar/.git to use your github credentials or SSH.
Background information
Check this documentation to get more information about Vagrant and Ansible