NOTE: this project has been significantly refactored. See the _archived folder for legacy configurations.

These packer configurations allow us to build and update Mugo's Vagrant development boxes. They can be used to run existing projects or bootstrap new ones. Each variant of the base boxes is available as a standalone project that can be run independently.

The boxes are organized using the following folder structure:

<< OS >> / << PHP VERSION >> /

For instance, the CentOS 8 PHP 7.2 box is located at mugo_base_boxes/centos8/php7.2/.

Scripts automate building, provisioning, cleaning up, shrinking, and exporting the boxes.

To build a box, simply CD into one its directory and invoke packer with the its configuration file. For example, to build the CentOS 8 PHP 7.2 box:

cd mugo_base_boxes/centos8/php7.2/
packer build php7.2.json

Once the build has completed, the mugo_base_boxes/centos8/php7.2/builds directory will have a Vagrant box in it. There will also be a corresponding .json file, to facilitate cloud-based versioned usage. These can be uploaded to Mugo Web's google cloud storage bucket via a browser or the command line:

gsutil cp builds/centos8-php7.2* gs://mugoweb

Based on Hashicorp's recommendation, all boxes are built from scratch using forked versions of the Bento Box configuration files.

The boxes are configured as follows:

• a root user with password root
• a vagrant user with password vagrant and passwordless sudo
• an ezpub user with password ezpub and passwordless sudo
• an entry for the vagrant insecure key in ~/.ssh/authorized_keys for both users
• apache listening on port 80 and 443
• mysql listening on port 3306 and with root password root
• php-xdebug installed and available on port 9000 but disabled by default (enable in /etc/php.d/xdebug.ini)
• varnish configured to listen on 8080 but disabled by default
• nginx installed but disabled by default
• nfsd installed and configured to share the webroot
• firewalld installed, enabled, and configured for the stack
• a local dev.crt and dev.pem in /etc/ssl
• 250G VirtualBox primary disk (useful on larger projects -- most publicly available boxes have 40G disks). Note: that this means you will need more than 250G disk space on the machine that you use to build the boxes (see scripts/common/minimize.sh to understand why).

The boxes include the following software:

• acl
• atop
• bash-completion
• byobu
• composer
• curl
• git
• htop
• iotop
• java
• memcached
• nodejs
• pv
• vim
• redis
• rsync
• sendmail
• tree
• unzip
• vim
• Virtual Box Guest Additions
• wget
• zip

The boxes include the following NPM packages installed system-wide:

• diff-so-fancy
• node-sass
• uglifycss
• uglify-js

The boxes include the following VIM addons:

• eunuch
• gitgutter
• nerdtree
• papercolor-theme
• polyglot
• powerline
• vundle

The CentOS boxes include the following additional repos:

• epel
• remi

The apache daemon's umask is set to 0002, server users belong to the apache group, and the apache daemon belongs to the server users' groups.

All customization should be done in ansible, by editing the ansible/main.yml and ansible/host_vars/common.yml files. If you plan to use packer to rebuild the vagrant box using your customizations, you should also update the packer JSON file's variables sections (this will help generate the correct outputs by the script). So for instance, if you've made some tweaks to the ansible/main.yml file and want to build a new version of the box for the team to use, you should also edit the version variable in the packer configuration file so that a new version of the box is generated in the box's JSON file:

    "variables": {
      ...
      "version": "0.1",
      ...
    }

All roles are from Ansible Galaxy but included in this repo.