github.com/daniellockard/packer@v0.7.6-0.20141210173435-5a9390934716/website/source/docs/command-line/push.html.markdown (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Push - Command-Line"
     4  description: |-
     5    The `packer push` Packer command takes a template and pushes it to a build service that will automatically build this Packer template.
     6  ---
     7  
     8  # Command-Line: Build
     9  
    10  The `packer push` Packer command takes a template and pushes it to a build
    11  service. The build service will automatically build your Packer template and
    12  expose the artifacts.
    13  
    14  This command currently only sends templates to
    15  [Atlas](https://atlas.hashicorp.com) by HashiCorp, but the command will
    16  be pluggable in the future with alternate implementations.
    17  
    18  External build services such as Atlas make it easy to iterate on Packer
    19  templates, especially when the builder you're running may not be easily
    20  accessable (such as developing `qemu` builders on Mac or Windows).
    21  
    22  For the `push` command to work, the
    23  [push configuration](/docs/templates/push.html)
    24  must be completed within the template.
    25  
    26  ## Options
    27  
    28  * `-create=true` - If the build configuration matching the name of the push
    29    doesn't exist, it will be created if this is true. This defaults to true.
    30  
    31  * `-token=FOO` - An access token for authenticating the push. This can also
    32    be specified within the push configuration in the template. By setting this
    33    in the template, you can take advantage of user variables.