github.com/aspring/packer@v0.8.1-0.20150629211158-9db281ac0f89/website/source/docs/command-line/build.html.markdown (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Build - Command-Line"
     4  description: |-
     5    The `packer build` Packer 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.
     6  ---
     7  
     8  # Command-Line: Build
     9  
    10  The `packer build` Packer command takes a template and runs all the builds within
    11  it in order to generate a set of artifacts. The various builds specified within
    12  a template are executed in parallel, unless otherwise specified. And the
    13  artifacts that are created will be outputted at the end of the build.
    14  
    15  ## Options
    16  
    17  * `-color=false` - Disables colorized output. Enabled by default.
    18  
    19  * `-debug` - Disables parallelization and enables debug mode. Debug mode flags
    20    the builders that they should output debugging information. The exact behavior
    21    of debug mode is left to the builder. In general, builders usually will stop
    22    between each step, waiting for keyboard input before continuing. This will allow
    23    the user to inspect state and so on.
    24  
    25  * `-except=foo,bar,baz` - Builds all the builds except those with the given
    26    comma-separated names. Build names by default are the names of their builders,
    27    unless a specific `name` attribute is specified within the configuration.
    28  
    29  * `-force` - Forces a builder to run when artifacts from a previous build prevent
    30    a build from running. The exact behavior of a forced build is left to the builder.
    31    In general, a builder supporting the forced build will remove the artifacts from
    32    the previous build. This will allow the user to repeat a build without having to
    33    manually clean these artifacts beforehand.
    34  
    35  * `-only=foo,bar,baz` - Only build the builds with the given comma-separated
    36    names. Build names by default are the names of their builders, unless a
    37    specific `name` attribute is specified within the configuration.