young8 / bento

Packer templates for building minimal Vagrant baseboxes

Bento

Bento is a project that encapsulates Packer templates for building Vagrant base boxes. A subset of templates are built and published to the bento org on Vagrant Cloud. The boxes also serve as default boxes for kitchen-vagrant.

Using Public Boxes

Adding a bento box to Vagrant

$ vagrant box add bento/ubuntu-16.04

Using a bento box in a Vagrantfile

Vagrant.configure("2") do |config|
  config.vm.box = "bento/ubuntu-16.04"
end

Building Templates

Requirements

• Packer
• At least one virtualization provider:
  • VirtualBox
  • VMware Fusion
  • Parallels Desktop

Using packer

To build a template for all providers simultaneously

$ packer build ubuntu-16.04-amd64.json

To build a template only for a list of specific providers

$ packer build -only=virtualbox-iso ubuntu-16.04-amd64.json

To build a template for all providers except a list of specific providers

$ packer build -except=parallels-iso,vmware-iso ubuntu-16.04-amd64.json

To use an alternate mirror

$ packer build -var 'mirror=http://ftp.jaist.ac.jp/pub/Linux/debian-cdimage/release' ubuntu-16.04-amd64.json

Congratulations! Ready to import box files should be in the ../builds directory.

Notes:

• The box_basename can be overridden like other Packer vars with -var 'box_basename=ubuntu-16.04'

Proprietary Templates

Templates for operating systems only available via license or subscription are also available in the repository, these include but are not limited to: Mac OS X, Red Hat Enterprise Linux, and SUSE Linux Enterprise. As the ISOs are not publicly available the URL values will need to be overridden as appropriate. We rely on the efforts of those with access to licensed versions of the operating systems to keep these up-to-date.

macOS / OSX

See our wiki page

Windows

The project does not include many definitions for building Windows boxes. For other approaches to building Windows boxes, please see the following community projects:

• Mischa Taylor's Boxcutter project
• Vagrant Windows Boxes and Puppet

Bugs and Issues

Please use GitHub issues to report bugs, features, or other problems.

License & Authors

These basebox templates were converted from veewee definitions originally based on work done by Tim Dysinger to make "Don't Repeat Yourself" (DRY) modular baseboxes. Thanks Tim!

Mac OS X templates were adopted wholesale from Fletcher Nichol's packer templates.

• Author: Seth Chisamore ([e-mail])
• Author: Stephen Delano ([e-mail])
• Author: Joshua Timberman ([e-mail])
• Author: Tim Dysinger ([e-mail])
• Author: Chris McClimans ([e-mail])
• Author: Julian Dunn ([e-mail])
• Author: Tom Duffield ([e-mail])
• Author: Ross Timson ([e-mail])
• Author: Fletcher Nichol ([e-mail])

Copyright 2012-2017, Chef Software, Inc. (<[e-mail]>)
Copyright 2011-2012, Tim Dysinger (<[e-mail]>)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.