Skip to content
Packer is a tool for creating identical machine images for multiple platforms from a single source configuration.
Go JavaScript Shell CSS Makefile PowerShell
Branch: master
Clone or download

Latest commit

nywilken Merge pull request #9352 from cpwc/patch-1
fix: typo in CHANGELOG.md
Latest commit 8e4a366 Jun 3, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Interpolate generatedData in the Inspec provisioner (#9262) May 20, 2020
.github add how to pull experimental binaries to CONTRIBUTING.md Jun 2, 2020
builder Merge pull request #9303 from arizvisa/GH-8528.unit-tests Jun 2, 2020
cmd appease linter May 29, 2020
command Json vs HCL2 parity refactor (#9301) May 28, 2020
common HCL2: generate hcl tags with go-cty tags too (#9306) May 28, 2020
communicator show a better error message in ssh.scpSession (#9217) May 13, 2020
contrib Fix zsh auto-completion Sep 26, 2019
examples builder/hyperone: Add examples for HCL syntax May 18, 2020
fix Refactor communicator config for Qemu and add SkipNatMapping option (#… Jun 2, 2020
hcl2template Merge branch 'master' into master Jun 2, 2020
helper Refactor communicator config for Qemu and add SkipNatMapping option (#… Jun 2, 2020
packer show build block name and source name if possible Jun 2, 2020
plugin/example Add golangci-lint to project (#8686) Feb 14, 2020
post-processor HCL2: generate hcl tags with go-cty tags too (#9306) May 28, 2020
provisioner provisioner/windows-restart: Get full hostname, instead of just the N… Jun 2, 2020
scripts slow down the changelog script to prevent rate limiting (#9172) May 6, 2020
template remove outdated comment May 29, 2020
test builder/hyperone: Add tests for HCL syntax May 18, 2020
vendor Drop the iso_checksum_type & iso_checksum_url fields (#8437) May 28, 2020
version update to v1.6.0-dev May 1, 2020
website Merge pull request #9245 from AdrienneCohea/master Jun 2, 2020
.codecov.yml remove codecov status (#9225) May 14, 2020
.gitattributes clean up documentation for new NIC and storage params Apr 13, 2020
.gitignore scrape builder docs from https://www.packer.io/docs/ Jun 5, 2019
.golangci.yml Add golangci-lint to project (#8686) Feb 14, 2020
.hashibot.hcl update hashibot config not to comment when locking super old and stal… Apr 3, 2020
CHANGELOG.md fix: typo in CHANGELOG.md Jun 3, 2020
CODEOWNERS Add CODEOWNERS of bats tests (#9259) May 19, 2020
Dockerfile dockerfile: add minimal image with provisioners support Oct 31, 2018
LICENSE LICENSE: MPL2 Jun 24, 2013
Makefile add generator to create a list of all the deprecated options that the… May 29, 2020
README.md Add Codecov badge and remove report style (#8896) Mar 16, 2020
Vagrantfile vagrantfile: add support for docker provider Oct 31, 2018
background_check.go surface notimplemented errs too Sep 19, 2019
background_check_openbsd.go copypasta Sep 18, 2019
checkpoint.go move packer to hashicorp Apr 4, 2017
commands.go implement a packer console analogous to the terraform console Jun 5, 2019
config.go make period stripping more strict so that users can disable provisine… Feb 13, 2020
config_test.go Merge pull request #8616 from hashicorp/packer-plugin-path Jan 28, 2020
go.mod Drop the iso_checksum_type & iso_checksum_url fields (#8437) May 28, 2020
go.sum Drop the iso_checksum_type & iso_checksum_url fields (#8437) May 28, 2020
log.go log errors in scanner and manually close logging pipe if we hit an er… Nov 11, 2019
main.go enable force, debug, and on-error for hcl2 builds May 14, 2020
main_test.go move packer to hashicorp Apr 4, 2017
panic.go Add telemetry reporting through checkpoint Jun 15, 2017
tty.go allow building packer on solaris by removing progress bar and tty imp… May 7, 2019
tty_solaris.go allow building packer on solaris by removing progress bar and tty imp… May 7, 2019

README.md

Packer

Build Status Windows Build Status GoDoc GoReportCard codecov

Packer is a tool for building identical machine images for multiple platforms from a single source configuration.

Packer is lightweight, runs on every major operating system, and is highly performant, creating machine images for multiple platforms in parallel. Packer comes out of the box with support for many platforms, the full list of which can be found at https://www.packer.io/docs/builders/index.html.

Support for other platforms can be added via plugins.

The images that Packer creates can easily be turned into Vagrant boxes.

Quick Start

Note: There is a great introduction and getting started guide for those with a bit more patience. Otherwise, the quick start below will get you up and running quickly, at the sacrifice of not explaining some key points.

First, download a pre-built Packer binary for your operating system or compile Packer yourself.

After Packer is installed, create your first template, which tells Packer what platforms to build images for and how you want to build them. In our case, we'll create a simple AMI that has Redis pre-installed. Save this file as quick-start.json. Export your AWS credentials as the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.

{
  "variables": {
    "access_key": "{{env `AWS_ACCESS_KEY_ID`}}",
    "secret_key": "{{env `AWS_SECRET_ACCESS_KEY`}}"
  },
  "builders": [{
    "type": "amazon-ebs",
    "access_key": "{{user `access_key`}}",
    "secret_key": "{{user `secret_key`}}",
    "region": "us-east-1",
    "source_ami": "ami-af22d9b9",
    "instance_type": "t2.micro",
    "ssh_username": "ubuntu",
    "ami_name": "packer-example {{timestamp}}"
  }]
}

Next, tell Packer to build the image:

$ packer build quick-start.json
...

Packer will build an AMI according to the "quick-start" template. The AMI will be available in your AWS account. To delete the AMI, you must manually delete it using the AWS console. Packer builds your images, it does not manage their lifecycle. Where they go, how they're run, etc., is up to you.

Documentation

Comprehensive documentation is viewable on the Packer website:

https://www.packer.io/docs

Developing Packer

See CONTRIBUTING.md for best practices and instructions on setting up your development environment to work on Packer.

You can’t perform that action at this time.