Introduction

This project is used to provision a base box that can be used for Moodle development. This base box is built upon the boxes published by the Bento project.

This box is published to Vagrant Cloud. You can use this box with Vagrant like any other box that's published on Atlas.

The rest of this document is geared towards building this box, not how to use it. So likely you do not need to read any further.

Setup

1. Install the Chef Development Kit.
2. Install recommended versions of Vagrant and VirtualBox for the latest box release on Vagrant Cloud.
3. Install Vagrant Plugins: vagrant plugin install vagrant-hostmanager vagrant-berkshelf
4. To build the box, open your terminal and from within this project, run: vagrant up

Package

1. Run make (or make clean && make)
2. Upload the resulting package.box to Vagrant Cloud.
3. Tag the repository with the same version number used in Atlas.

Tag format {OS Version}-{Box Version}, EG:

$ git tag -a 18.04-1.0.0 -m "Ubuntu 18.04 box version 1.0.0"
$ git push origin 18.04-1.0.0

Update cookbooks

1. Update versions in Berksfile.
2. Run berks update which will update the Berksfile.lock.

Update base box

Look for new versions of the base box on Vagrant Cloud. Note that in the version description, there is a dump about the versions of VirtualBox and Vagrant that were used to build the box. We should match those versions.

To get the new base box:

$ vagrant box update
$ vagrant box prune

Then rebuild the box.

Helpful links

• Create self signed certificate
• LEMP
• Nginx
• Moodle Nginx
• Filesystem
• Tutorial on making base box