1# FD.io Project CI Packer
3[Packer] is a tool for automatically creating VM and container images,
4configuring them and post-processing them into standard output formats.
6We build FD.io's CI images via Packer.
10You'll need to [install Packer], of course.
12FD.io's Packer configuration is divided into build-specific variables,
13output-specific templates and a set of shared provisioning scripts. To do a
14specific build, combine the template for the desired output artifact type with
15a variable file. To build a new basebuild instance the following would be done:
18packer build -var-file=vars/cloud-env.json -var-file=vars/centos.json templates/basebuild.json
21**NOTE:** vars/cloud-env.json is a gitignored file as it contains private
22information. There is a vars/cloud-env.json.example file that may be used as a
23base for creating the one needed.
25This would build a bootable image in the FD.io CI cloud environment.
27From a high level, the builds:
29* Boot a specified base image in the cloud
30* Run a set of shell scripts, listed in the template's shell provisioner
31 section, to do any configuration required by the builder.
32* Execute a shutdown of the running instance
33* Execute a 'nova image-create' operation against the shutdown instance.
34* Perform a 'nova delete' operation against the shutdown instance.