Virtual machine templates for Ubuntu
Shell Ruby Makefile
Clone or download
rasa Merge pull request #151 from roock/ubuntu18041
Update to Ubuntu 18.04.1
Latest commit a3179ba Aug 13, 2018
Permalink
Failed to load latest commit information.
bin fix undefined variable for invalid template file arg Sep 27, 2017
box Initial commit May 5, 2014
floppy Add patches to enable VMware shared folder support Jun 7, 2015
http Rename "ubuntu-server" task -> "server" Aug 30, 2016
script Set pci slot number in vmx settings Sep 9, 2017
test Use latest docker packages Sep 20, 2015
tpl initial revision for 1704 Apr 14, 2017
.gitattributes Adding .gitattributes May 6, 2014
.gitignore Remove 32-bit boxes Sep 8, 2017
AUTHORS Rename "ubuntu-server" task -> "server" Aug 30, 2016
CHANGELOG.md Version 2.0.26 pushed to Atlas Dec 10, 2016
LICENSE Update LICENSE May 10, 2014
Makefile Phase out CM installs, use custom-script.sh instead Aug 27, 2016
README.md Update README.md Oct 21, 2017
VERSION Remove 32-bit boxes Sep 8, 2017
custom-script.sh Add support for adding a custom script Oct 24, 2015
ubuntu.json Add template for Ubuntu 18.04 Apr 28, 2018
ubuntu1204-desktop.json One tempalte to rule them all again Apr 25, 2016
ubuntu1204.json One tempalte to rule them all again Apr 25, 2016
ubuntu1404-desktop.json Bump 14.04 image to 14.04.5 Aug 22, 2016
ubuntu1404.json Bump 14.04 image to 14.04.5 Aug 22, 2016
ubuntu1604-desktop.json ubuntu-16.04.4-desktop-amd64.iso Apr 10, 2018
ubuntu1604.json ubuntu-16.04.4-server-amd64.iso Apr 10, 2018
ubuntu1704-desktop.json Fix for issue #139. Updated to use preseed-desktop.cfg file. Dec 8, 2017
ubuntu1704.json initial revision for 1704 Apr 14, 2017
ubuntu1804.json Update to Ubuntu 18.04.1 Aug 13, 2018

README.md

Packer templates for Ubuntu

Overview

This repository contains Packer templates for creating Ubuntu Vagrant boxes.

Current Boxes

We no longer provide pre-built binaries for these templates.

Building the Vagrant boxes with Packer

To build all the boxes, you will need VirtualBox, VMware Fusion/VMware Workstation and Parallels installed.

Parallels requires that the Parallels Virtualization SDK for Mac be installed as an additional preqrequisite.

We make use of JSON files containing user variables to build specific versions of Ubuntu. You tell packer to use a specific user variable file via the -var-file= command line option. This will override the default options on the core ubuntu.json packer template, which builds Ubuntu 16.04 by default.

For example, to build Ubuntu 16.04, use the following:

$ packer build -var-file=ubuntu1604.json ubuntu.json

If you want to make boxes for a specific desktop virtualization platform, use the -only parameter. For example, to build Ubuntu 16.04 for VirtualBox:

$ packer build -only=virtualbox-iso -var-file=ubuntu1604.json ubuntu.json

The boxcutter templates currently support the following desktop virtualization strings:

Building the Vagrant boxes with the box script

We've also provided a wrapper script bin/box for ease of use, so alternatively, you can use the following to build Ubuntu 16.04 for all providers:

$ bin/box build ubuntu1604

Or if you just want to build Ubuntu 16.04 for VirtualBox:

$ bin/box build ubuntu1604 virtualbox

Building the Vagrant boxes with the Makefile

A GNU Make Makefile drives a complete basebox creation pipeline with the following stages:

  • build - Create basebox *.box files
  • assure - Verify that the basebox *.box files produced function correctly
  • deliver - Upload *.box files to Artifactory, Atlas or an S3 bucket

The pipeline is driven via the following targets, making it easy for you to include them in your favourite CI tool:

make build   # Build all available box types
make assure  # Run tests against all the boxes
make deliver # Upload box artifacts to a repository
make clean   # Clean up build detritus

Proxy Settings

The templates respect the following network proxy environment variables and forward them on to the virtual machine environment during the box creation process, should you be using a proxy:

  • http_proxy
  • https_proxy
  • ftp_proxy
  • rsync_proxy
  • no_proxy

Tests

Automated tests are written in Serverspec and require the vagrant-serverspec plugin to be installed with:

vagrant plugin install vagrant-serverspec

The bin/box script has subcommands for running both the automated tests and for performing exploratory testing.

Use the bin/box test subcommand to run the automated Serverspec tests. For example to execute the tests for the Ubuntu 14.04 box on VirtualBox, use the following:

bin/box test ubuntu1604 virtualbox

Similarly, to perform exploratory testing on the VirtualBox image via ssh, run the following command:

bin/box ssh ubuntu1604 virtualbox

Variable overrides

There are several variables that can be used to override some of the default settings in the box build process. The variables can that can be currently used are:

  • cpus
  • disk_size
  • memory
  • update

The variable HEADLESS can be set to run Packer in headless mode. Set HEADLESS := true, the default is false.

The variable UPDATE can be used to perform OS patch management. The default is to not apply OS updates by default. When UPDATE := true, the latest OS updates will be applied.

The variable PACKER can be used to set the path to the packer binary. The default is packer.

The variable ISO_PATH can be used to set the path to a directory with OS install images. This override is commonly used to speed up Packer builds by pointing at pre-downloaded ISOs instead of using the default download Internet URLs.

The variables SSH_USERNAME and SSH_PASSWORD can be used to change the default name & password from the default vagrant/vagrant respectively.

The variable INSTALL_VAGRANT_KEY can be set to turn off installation of the default insecure vagrant key when the image is being used outside of vagrant. Set INSTALL_VAGRANT_KEY := false, the default is true.

The variable CUSTOM_SCRIPT can be used to specify a custom script to be executed. You can add it to the script/custom directory (content is ignored by Git). The default is custom-script.sh which does nothing.

Contributing

  1. Fork and clone the repo.
  2. Create a new branch, please don't work in your master branch directly.
  3. Add new Serverspec or Bats tests in the test/ subtree for the change you want to make. Run make test on a relevant template to see the tests fail (like make test-virtualbox/ubuntu1404).
  4. Fix stuff. Use make ssh to interactively test your box (like make ssh-virtualbox/ubuntu1404).
  5. Run make test on a relevant template (like make test-virtualbox/ubuntu1404) to see if the tests pass. Repeat steps 3-5 until done.
  6. Update README.md and AUTHORS to reflect any changes.
  7. If you have a large change in mind, it is still preferred that you split them into small commits. Good commit messages are important. The git documentatproject has some nice guidelines on writing descriptive commit messages.
  8. Push to your fork and submit a pull request.
  9. Once submitted, a full make test run will be performed against your change in the build farm. You will be notified if the test suite fails.

Would you like to help out more?

Contact moujan@annawake.com

Acknowledgments

Parallels provided a Business Edition license of their software to run on the basebox build farm.

SmartyStreets provided basebox hosting for the box-cutter project since 2015 - thank you for your support!