iSharkFly-Docs
/
packer-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document changes to shell-local post-processor

This commit is contained in:
Matthew Hooker 2016-12-07 18:18:59 -08:00
parent 332a208fee
commit 9e71730c38
No known key found for this signature in database
GPG Key ID: 7B5F933D9CE8C6A1
1 changed files with 43 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
website/source/docs/post-processors/shell-local.html.md
View File

@ -89,36 +89,61 @@ commonly useful environmental variables:
## Safely Writing A Script ## Safely Writing A Script
Whether you use the `inline` option, or pass it a direct `script` or `scripts`, it is important to understand a few things about how the shell-local post-processor works to run it safely and easily. This understanding will save you much time in the process. Whether you use the `inline` option, or pass it a direct `script` or `scripts`,
it is important to understand a few things about how the shell-local
post-processor works to run it safely and easily. This understanding will save
you much time in the process.
### Once Per Artifact ### Once Per Builder
The `shell-local` script(s) you pass are run once per artifact output file. That means that if your builder results in 1 output file, your script will be run once. If it results in 3 output files, it will run 3 times, once for each file. The `shell-local` script(s) you pass are run once per builder. That means that
if you have an `amazon-ebs` builder and a `docker` builder, your script will be
run twice. If you have 3 builders, it will run 3 times, once for each builder.
For example, the virtualbox builders, when configured to provide an `ovf` output format (the default), will provide **two** output files: ### Interacting with Build Artifacts
* The actual disk itself, in `.vmdk` format In order to interact with build artifacts, you may want to use the [manifest
* The appliance description file, in `.ovf` format post-processor](/docs/post-processors/manifest.html). This will write the list
of files produced by a `builder` to a json file after each `builder` is run.
Let's take a simple example. You want to run a post-processor that records the name of every artifact created to `/tmp/artifacts`. (Why? I don't know. For fun.) For example, if you wanted to package a file from the file builder into
a tarball, you might wright this:
Your post-processor should look like this: ```json
``` {.javascript}
{ {
"type": "shell-local", "builders": [
{
"content": "Lorem ipsum dolor sit amet",
"target": "dummy_artifact",
"type": "file"
}
],
"post-processors": [
[
{
"output": "manifest.json",
"strip_path": true,
"type": "manifest"
},
{
"inline": [ "inline": [
"echo \$1 >> /tmp/artifacts" "jq ".builds[].files[].name" manifest.json | xargs tar cfz artifacts.tgz"
],
"type": "shell-local"
}
]
] ]
} }
``` ```
The result of the above will be an output line for each builder. This uses the [jq](https://stedolan.github.io/jq/) tool to extract all of the
file names from the manifest file and passes them to tar.
### Always Exit Intentionally ### Always Exit Intentionally
If any post-processor fails, the `packer build` stops and all interim artifacts are cleaned up. If any post-processor fails, the `packer build` stops and all interim artifacts
are cleaned up.
For a shell script, that means the script **must** exit with a zero code. You *must* be extra careful to `exit 0` when necessary. For a shell script, that means the script **must** exit with a zero code. You
*must* be extra careful to `exit 0` when necessary.