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

43 lines
1.6 KiB
Markdown
Raw Normal View History

2013-07-14 04:38:31 -04:00
---
2017-06-14 21:04:16 -04:00
description: |
The `packer fix` command takes a template and finds backwards incompatible
parts of it and brings it up to date so it can be used with the latest version
of Packer. After you update to a new Packer release, you should run the fix
command to make sure your templates work with the new release.
2015-07-22 22:31:00 -04:00
layout: docs
2017-06-14 21:04:16 -04:00
page_title: 'packer fix - Commands'
sidebar_current: 'docs-commands-fix'
---
2013-07-14 04:38:31 -04:00
# `fix` Command
2013-07-14 04:38:31 -04:00
The `packer fix` command takes a template and finds backwards incompatible
parts of it and brings it up to date so it can be used with the latest version
of Packer. After you update to a new Packer release, you should run the fix
command to make sure your templates work with the new release.
2013-07-14 04:38:31 -04:00
2015-07-22 22:31:00 -04:00
The fix command will output the changed template to standard out, so you should
redirect standard using standard OS-specific techniques if you want to save it
to a file. For example, on Linux systems, you may want to do this:
2013-07-14 04:38:31 -04:00
2017-06-14 21:04:16 -04:00
``` shell
$ packer fix old.json > new.json
```
2013-07-14 04:38:31 -04:00
2015-07-22 22:31:00 -04:00
If fixing fails for any reason, the fix command will exit with a non-zero exit
status. Error messages appear on standard error, so if you're redirecting
2013-07-14 04:38:31 -04:00
output, you'll still see error messages.
2018-10-26 20:02:51 -04:00
-> **Even when Packer fix doesn't do anything** to the template, the
template will be outputted to standard out. Things such as configuration key
ordering and indentation may be changed. The output format however, is
pretty-printed for human readability.
2013-07-14 04:38:31 -04:00
2015-07-22 22:31:00 -04:00
The full list of fixes that the fix command performs is visible in the help
output, which can be seen via `packer fix -h`.
## Options
2018-10-26 20:02:51 -04:00
- `-validate=false` - Disables validation of the fixed template. True by
default.