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

35 lines
1.0 KiB
Markdown
Raw Normal View History

2013-06-20 17:13:35 -04:00
---
2015-07-22 22:31:00 -04:00
layout: docs
sidebar_current: docs-commands-validate
page_title: packer validate - Commands
description: |-
The `packer validate` Packer command is used to validate the syntax and
configuration of a template. The command will return a zero exit status on
success, and a non-zero exit status on failure. Additionally, if a template
doesn't validate, any error messages will be outputted.
---
2013-06-20 17:13:35 -04:00
# `validate` Command
2013-06-20 17:13:35 -04:00
2015-07-22 22:31:00 -04:00
The `packer validate` Packer command is used to validate the syntax and
2017-03-28 18:28:34 -04:00
configuration of a [template](/docs/templates/index.html). The command
2015-07-22 22:31:00 -04:00
will return a zero exit status on success, and a non-zero exit status on
failure. Additionally, if a template doesn't validate, any error messages will
be outputted.
2013-06-20 17:13:35 -04:00
Example usage:
```text
2013-06-20 17:13:35 -04:00
$ packer validate my-template.json
Template validation failed. Errors are shown below.
Errors validating build 'vmware'. 1 error(s) occurred:
* Either a path or inline script must be specified.
```
## Options
- `-syntax-only` - Only the syntax of the template is checked. The configuration
is not validated.