diff --git a/website/source/docs/command-line/build.html.markdown b/website/source/docs/command-line/build.html.markdown new file mode 100644 index 000000000..e6ae28c24 --- /dev/null +++ b/website/source/docs/command-line/build.html.markdown @@ -0,0 +1,26 @@ +--- +layout: "docs" +--- + +# Command-Line: Build + +The `packer build` command takes a template and runs all the builds within +it in order to generate a set of artifacts. The various builds specified within +a template are executed in parallel, unless otherwise specified. And the +artifacts that are created will be outputted at the end of the build. + +## Options + +* `-debug` - Disables parallelization and enables debug mode. Debug mode flags + the builders that they should output debugging information. The exact behavior + of debug mode is left to the builder. In general, builders usually will stop + between each step, waiting keyboard input before continuing. This will allow + the user to inspect state and so on. + +* `-except=foo,bar,baz` - Builds all the builds except those with the given + comma-separated names. Build names by default are the names of their builders, + unless a specific `name` attribute is specified within the configuration. + +* `-only=foo,bar,baz` - Only build the builds with the given comma-separated + names. Build names by default are the names of their builders, unless a + specific `name` attribute is specified within the configuration. diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index 22ace5071..15ea6add5 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -32,7 +32,7 @@