This repository provides a quick setup of Internet-in-a-Box (IIAB) development environment using Vagrant. You will need a computer with virtualization enabled and git, Vagrant (2.0 or later) and VirtualBox installed.
- git
- Vagrant (2.0 or later)
- Virtualbox
- Editor (Atom, Emacs, Vi etc)
- Ansible
- Ansible-lint and [Ansible-review)[https://github.com/willthames/ansible-review] tools
-
Check out this repository and its submodules on to your development machine.
git clone --recursive https://github.com/arky/iiab-dev-mode.git
-
Change directory into 'iiab-dev-mode' with
cd iiab-dev-mode
. You can update all the submodules to latest master usinggit submodule foreach git pull origin master
-
Setup a vagrant machine with
vagrant up
and provision it withvagrant provision
. Please select the available bridge network interface (wlan0 or eth0) that connects your host machine to the Internet. -
You can now connect to your vagrant machine with
vagrant ssh
. All your local development files available as shared folder in/opt/iiab
directory. -
You can setup IIAB from the Ansible Playbooks following the installation wiki page.
cd /opt/iiab/iiab/scripts/ ./ansible cd /opt/iiab/iiab/ ./runansible cd /opt/iiab/iiab-admin-console/ ./install cd /opt/iiab/iiab-menu/ ./cp-menus
-
Hack away! You can commit your local changes and send pull request to IIAB project by setting a default git remote push setting with
cd <repo> && git remote set-url --push origin [email protected]:<your_username>/<your_forked_iiab_repo_name>.git
. Learn more by reading this blog post and Working with Remotes in Pro Git Book -
Once you are done, you can stop your vagrant machine with
vagrant halt
or remove it completely withvagrant destroy
.