diff --git a/website/source/docs/templates/post-processors.html.markdown b/website/source/docs/templates/post-processors.html.markdown index 5dd151daf..608b6733e 100644 --- a/website/source/docs/templates/post-processors.html.markdown +++ b/website/source/docs/templates/post-processors.html.markdown @@ -89,3 +89,39 @@ compressed then uploaded, but the compressed result is not kept. As you may be able to imagine, the **simple** and **detailed** definitions are simply shortcuts for a **sequence** definition of only one element. + +## Input Artifacts + +When using post-processors, the input artifact (coming from a builder or +another post-proccessor) is discarded by default after the post-processor runs. +This is because generally, you don't want the intermediary artifacts on the +way to the final artifact created. + +In some cases, however, you may want to keep the intermediary artifacts. +You can tell Packer to keep these artifacts by setting the +`keep_input_artifact` configuration to `true`. An example is shown below: + +
+{
+ "post-processors": [
+ {
+ "type": "compress",
+ "keep_input_artifact": true
+ }
+ ]
+}
+
+
+This setting will only keep the input artifact to _that specific_
+post-processor. If you're specifying a sequence of post-processors, then
+all intermediaries are discarded by default except for the input artifacts
+to post-processors that explicitly state to keep the input artifact.
+
+