Packer templates for building minimal Vagrant baseboxes
Latest commit 05772bd Nov 14, 2018
Permalink
Failed to load latest commit information.
.github Add github templates Aug 10, 2018
_common Fix startup mount error on Parallels 14 guest tools Oct 9, 2018
builds Remove subdirectories under `build/` as they are no longer used. Jun 27, 2015
centos Add curl to CentOS 5 install Aug 23, 2018
debian Merge pull request #1138 from chef/debian_9.6 Nov 14, 2018
fedora Added libvirt support in fedora29. Nov 14, 2018
freebsd Remove EOL FreeBSD 11.1 Oct 3, 2018
hardenedbsd Adding name field to fix build/upload Aug 25, 2018
macos Remove EOL macOS 10.9 Jul 8, 2018
opensuse Add openSUSE leap 15.0 Aug 10, 2018
oraclelinux Update RHELs to 6.10 / 7.5 Jul 8, 2018
rhel Update RHELs to 6.10 / 7.5 Jul 8, 2018
scientificlinux Use a faster scientific mirror Jul 8, 2018
sles this doesn't work on sles 11 Jul 13, 2018
solaris Revert "Added guest_additions_url as a user-variable for VirtualBox b… Jan 2, 2018
ubuntu Merge pull request #1133 from sheurich/patch-1 Nov 12, 2018
windows Use the registry resource instead of execute Nov 6, 2018
.gitattributes Force CRLF on Autounattend files for Windows Feb 23, 2014
.gitignore Moving boostrap.sh to bento-ya Aug 30, 2017
.travis.yml Test with the latest packer Jul 10, 2018
CHANGELOG.md Release v201808.24.0 Sep 2, 2018
Gemfile Chefstyle and fail if build_box not used correctly (#770) Mar 13, 2017
LICENSE [OC-1013] - move definitions from basebox project Jul 16, 2012
MAINTAINERS.md Update templates to reflect re-organization Aug 31, 2017
NOTICE.md Opscode -> Chefs and other minor stuff Aug 7, 2015
README.md Release v201808.24.0 Sep 2, 2018
Rakefile Adding release_all action, clean before build Mar 24, 2018
builds.yml Added fedora-29 in builds.yml for public releases. Nov 14, 2018

README.md

Bento

Build Status

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. These published boxes serve as the 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 Boxes

Requirements

*NOTE: support for these providers is considered experimental and corresponding Vagrant Cloud images may or may not exist.

Using packer

To build an Ubuntu 16.04 box for only the VirtualBox provider

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

To build Debian 9.1 32bit boxes for all possible providers (simultaneously)

$ cd debian
$ packer build debian-9.1-i386.json

To build CentOS 7.3 boxes for all providers except VMware and Parallels

$ cd centos
$ packer build -except=parallels-iso,vmware-iso centos-7.3-x86_64.json

To use an alternate mirror

$ cd fedora
$ packer build -var 'mirror=http://mirror.utexas.edu/fedora/linux' fedora-26-x86_64.json

If the build is successful, ready to import box files will be in the builds directory at the root of the repository.

*NOTE: 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.

Networking/Firewalls

Most of the providers expect unrestricted access to networking in order to build as expected. We can't enumerate all possible firewall configurations but include some snippets below that might be useful to users.

Windows

$VS = "Standardswitch"
$IF_ALIAS = (Get-NetAdapter -Name "vEthernet ($VS)").ifAlias
New-NetFirewallRule -Displayname "Allow incomming from $VS" -Direction Inbound -InterfaceAlias $IF_ALIAS -Action Allow

macOS / OSX

See this wiki page

Bugs and Issues

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

Related projects

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.

Copyright 2012-2017, Chef Software, Inc. (<legal@chef.io>)
Copyright 2011-2012, Tim Dysinger (<tim@dysinger.net>)

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.