This repository contains build scripts to golden images using Packer.
Interested in some best practices when using Packer with Windows? Check out my blog post on the topic.
The supported builds are:
The build.supported_os.yaml
file contains the list of Operating Systems that are supported and their settings.
The supported Operating Systems to build are:
If you just want to download the pre-build Vagrant images, download them from Vagrant Cloud.
Before you can run the build scripts, you need to prepare your system.
:white_check_mark: Tested on Ubuntu 16.04
Mono is required to run the build script.
# Install Mono
sudo apt-get install mono-complete -y
# Give the script execute permission
chmod +x build.sh
Additionally you will need to install:
:white_check_mark: Tested on Windows 10 Pro
# Set PowerShell Execution Policy
Set-ExecutionPolicy RemoteSigned -Force
# Install Chocolatey
iwr https://chocolatey.org/install.ps1 -UseBasicParsing | iex
# Install Packer
choco install packer -y
# Install Hyper-V
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
# Create an external Hyper-V Switch
# Commands may vary depending on your system.
Get-NetAdapter
# Find the name of the network adapter (make sure its status is also not disconnected)
# Create a new VM Switch using the name of the network adapter
New-VMSwitch -Name "External VM Switch" -AllowManagementOS $true -NetAdapterName "<Your Adapter Name Here>"
Depending on your platform, you either need to run:
build.ps1
on Windowsbuild.sh
on Linux / MacOS.If you are building images for Vagrant Cloud, you need to set the following environment variables:
# Windows
$env:ATLAS_TOKEN = "ABC123XYZ"
$env:ATLAS_USERNAME = "MattHodge" # Username to upload the boxes under
$env:ATLAS_VERSION = "1.0.1" # Version of the box being uploaded
# MacOS / Linux
export ATLAS_TOKEN="ABC123XYZ"
export ATLAS_USERNAME="MattHodge" # Username to upload the boxes under
export ATLAS_VERSION="1.0.1" # Version of the box being uploaded
The following commands will build you Hyper-V Images
# Builds Windows 2016 Standard Core and runs the Vagrant post processor (local).
.\build.ps1 -Target "hyperv-local" -os="Windows2016StdCore"
# Builds Windows 2012 R2 Core and runs the Atlas post processor.
.\build.ps1 -Target "hyperv-vagrant-cloud" --os="Win2012R2Core"
The following commands will build you VirtualBox Images
# Builds Windows 2016 Standard Core and runs the Vagrant post processor (local).
./build.sh --target "virtualbox-local" -os="Windows2016StdCore"
# Builds Windows 2012 R2 Core and runs the Atlas post processor.
./build.sh --target "virtualbox-vagrant-cloud" -os="Win2012R2Core"
If you aren't pushing your boxes to Atlas, you can import the *.box
files for use in Vagrant:
vagrant box add .\win2016stdcore-wmf5-nocm-hyperv.box --name Windows2016StdCore
You can also find all the boxes ready to be used with vagrant up
over at my VagrantBoxes Repository.