python-packer
A Python interface for packer.io
Packer version
The interface has been developed vs. Packer v0.7.5.
Installation
You must have Packer installed prior to using this client though as installer class is provided to install packer for you.
pip install python-packer
# or, for dev:
pip install https://github.com/nir0s/python-packer/archive/master.tar.gzUsage Examples
Packer.build()
import packer
packerfile = 'packer/tests/resources/packerfile.json'
exc = []
only = ['my_first_image', 'my_second_image']
vars = {"variable1": "value1", "variable2": "value2"}
var_file = 'path/to/var/file'
packer_exec_path = '/usr/bin/packer'
p = packer.Packer(packerfile, exc=exc, only=only, vars=vars,
var_file=var_file, exec_path=packer_exec_path)
p.build(parallel=True, debug=False, force=False)Packer.fix()
...
p = packer.Packer(packerfile, ...)
output_file = 'packer/tests/resources/packerfile_fixed.json'
print(p.fix(output_file))The output_file parameter will write the output of the fix function to a file.
Packer.inspect()
A -machine-readable (mrf) argument is provided.
If the mrf argument is set to True, the output will be parsed and an object containing the parsed output will be exposed as a dictionary containing the components:
...
p = packer.Packer(packerfile, ...)
result = p.inspect(mrf=True)
print(result.parsed_output)
# print(result.stdout) can also be used here
# output:
"variables": [
{
"name": "aws_access_key",
"value": "{{env `AWS_ACCESS_KEY_ID`}}"
},
{
"name": "aws_secret_key",
"value": "{{env `AWS_ACCESS_KEY`}}"
}
],
"provisioners": [
{
"type": "shell"
}
],
"builders": [
{
"type": "amazon-ebs",
"name": "amazon"
}
]If the mrf argument is set to False, the output will not be parsed but rather returned as is:
...
p = packer.Packer(packerfile, ...)
result = p.inspect(mrf=True)
print(result.stdout)
# output:
Optional variables and their defaults:
aws_access_key = {{env `AWS_ACCESS_KEY_ID`}}
aws_secret_key = {{env `AWS_ACCESS_KEY`}}
Builders:
amazon (amazon-ebs)
Provisioners:
shell
...Packer.push()
You must be logged into Atlas to use the push function:
...
p = packer.Packer(packerfile, ...)
atlas_token = 'oi21mok3mwqtk31om51o2joj213m1oo1i23n1o2'
p.push(create=True, token=atlas_token)Packer.validate()
...
p = packer.Packer(packerfile, ...)
p.validate(syntax_only=False)Packer.version()
...
p = packer.Packer(packerfile, ...)
print(p.version())PackerInstaller.install()
This installs packer to packer_path using the installer_path and verifies that the installation was successful.
packer_path = '/usr/bin/'
installer_path = 'Downloads/packer_0.7.5_linux_amd64.zip'
p = packer.Installer(packer_path, installer_path)
p.install()Shell Interaction
The sh Python module is used to execute Packer.
As such, return values from all functional methods (validate, build, etc..) other than the version method
will return an sh execution object. This is meant for you to be able to read stdout, stderr, exit codes and more after executing the commands. With the progression of python-packer less abstract objects will return and more concise return values will be provided.
Additionally, to verify that all errors return with as much info as possible, error handling is done gently. Most errors will raise an sh exception so that you're able to interact with them. Again, as this module progresses, these exceptions will be handled properly.
Testing
Please contribute. Currently tests are not really developed.
git clone [email protected]:nir0s/python-packer.git
cd python-packer
pip install tox
toxContributions..
..are always welcome.