packer-cn/website/source/docs/commands/push.html.md

description	layout	page_title	sidebar_current
The `packer push` command uploads a template and other required files to the Atlas build service, which will run your packer build for you.	docs	packer push - Commands	docs-commands-push

push Command

!> The Packer and Artifact Registry features of Atlas will no longer be actively developed or maintained and will be fully decommissioned. Please see our guide on building immutable infrastructure with Packer on CI/CD for ideas on implementing these features yourself.

The packer push command uploads a template and other required files to the Atlas service, which will run your packer build for you. Learn more about Packer in Atlas.

Running builds remotely makes it easier to iterate on packer builds that are not supported on your operating system, for example, building docker or QEMU while developing on Mac or Windows. Also, the hard work of building VMs is offloaded to dedicated servers with more CPU, memory, and network resources.

When you use push to run a build in Atlas, you may also want to store your build artifacts in Atlas. In order to do that you will also need to configure the Atlas post-processor. This is optional, and both the post-processor and push commands can be used independently.

~> The push command uploads your template and other files, like provisioning scripts, to Atlas. Take care not to upload files that you don't intend to, like secrets or large binaries. If you have secrets in your Packer template, you should move them into environment variables.

Most push behavior is configured in your packer template. You can override or supplement your configuration using the options below.

Options

• -token - Your access token for the Atlas API. Login to Atlas to generate an Atlas Token. The most convenient way to configure your token is to set it to the ATLAS_TOKEN environment variable, but you can also use -token on the command line.

• -name - The name of the build in the service. This typically looks like hashicorp/precise64, which follows the form <username>/<buildname>. This must be specified here or in your template.

• -sensitive - A comma-separated list of variables that should be marked as sensitive in the Terraform Enterprise ui. These variables' keys will be visible, but their values will be redacted. example usage: -var 'supersecretpassword=mypassword' -sensitive=supersecretpassword1

• -var - Set a variable in your packer template. This option can be used multiple times. This is useful for setting version numbers for your build.

• -var-file - Set template variables from a file.

Environment Variables

• ATLAS_CAFILE (path) - This should be a path to an X.509 PEM-encoded public key. If specified, this will be used to validate the certificate authority that signed certificates used by an Atlas installation.

• ATLAS_CAPATH - This should be a path which contains an X.509 PEM-encoded public key file. If specified, this will be used to validate the certificate authority that signed certificates used by an Atlas installation.

Examples

Push a Packer template:

$ packer push template.json

Push a Packer template with a custom token:

$ packer push -token ABCD1234 template.json

Limits

push is limited to 5gb upload when pushing to Atlas. To be clear, packer can build artifacts larger than 5gb, and Atlas can store artifacts larger than 5gb. However, the initial payload you push to start the build cannot exceed 5gb. If your boot ISO is larger than 5gb (for example if you are building OSX images), you will need to put your boot ISO in an external web service and download it during the packer run.

Building Private .iso and .dmg Files

If you want to build a private .iso file you can upload the .iso to a secure file hosting service like Amazon S3, Google Cloud Storage, or Azure File Service and download it at build time using a signed URL. You should convert .dmg files to .iso and follow a similar procedure.

Once you have added variables in your packer template you can specify credentials or signed URLs using Atlas environment variables, or via the -var flag when you run push.