bench/vm/Readme.md

ERPNext VM Builder

Steps to build a VM Image

• python build.py builds a new Production VM, a Dev VM and a Dev Vagrant Box

Requirements

• Bench should be installed
• Ansible should be installed

How it works

Apart from the above the rest is handled by bench:

• Install prerequisites if not already installed
  • virtualbox
  • packer
• Cleanup
  • Clean the required directories
• Build the VM using packer
  • Packer downloads the mentioned Ubuntu iso, boots a virtual machine and preceeds the preseed.cfg file into it in order to setup a clean Ubuntu OS
  • Then packer uses ssh to enter the virtual machine to execute the required commands
  • scripts/debian_family/install_ansible.sh sets up ansible on the vm.
  • Depending on the VM being built, the vm-develop.json or the vm-production.json is used
  • scripts/set_message.sh sets welcome message (with update instructions) in the vm.
  • scripts/cleanup.sh writes zeros to all the free space in the disk, it shrinks the disk image
• Set the correct permissions for the built Vagrant and Virtual Appliance Images
• Cleanup
  • Delete the generated files from the required directories
• Restart nginx

Running the build.py script builds the VMs and puts them in ~/Public. It also creates the md5 hashes for the same, and puts them in the same folder.