From ffef8efaf4fa20f5d183e9be7cf2cc68846bc2e4 Mon Sep 17 00:00:00 2001 From: Chris Bednarski Date: Tue, 18 Aug 2015 16:47:58 -0700 Subject: [PATCH] Added docs for discard; clarify mutual exclusivity between commit, discard, and export_path --- website/source/docs/builders/docker.html.markdown | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/website/source/docs/builders/docker.html.markdown b/website/source/docs/builders/docker.html.markdown index 76b1d4057..48489380b 100644 --- a/website/source/docs/builders/docker.html.markdown +++ b/website/source/docs/builders/docker.html.markdown @@ -68,11 +68,17 @@ builder. ### Required: +You must specify (only) one of `commit`, `discard`, or `export_path`. + - `commit` (boolean) - If true, the container will be committed to an image - rather than exported. This cannot be set if `export_path` is set. + rather than exported. + +- `discard` (boolean) - Throw away the container when the build is complete. + This is useful for the [artifice + post-processor](https://packer.io/docs/post-processors/artifice.html). - `export_path` (string) - The path where the final container will be exported - as a tar file. This cannot be set if `commit` is set to true. + as a tar file. - `image` (string) - The base image for the Docker container that will be started. This image will be pulled from the Docker registry if it doesn't