mirror of https://github.com/hashicorp/consul
37 lines
1.2 KiB
Plaintext
37 lines
1.2 KiB
Plaintext
|
---
|
||
|
|
layout: commands
|
||
|
|
page_title: 'Commands: Validate'
|
||
|
|
description: >
|
||
|
|
The `consul validate` command tests that config files are valid by attempting
|
||
|
|
to parse them. Useful to ensure a configuration change will not cause consul
|
||
|
|
to fail after a restart.
|
||
|
|
---
|
||
|
|
|
||
|
|
# Consul Validate
|
||
|
|
|
||
|
|
The `consul validate` command performs a thorough sanity test on Consul
|
||
|
|
configuration files. For each file or directory given, the command will
|
||
|
|
attempt to parse the contents just as the `consul agent` command would,
|
||
|
|
and catch any errors.
|
||
|
|
|
||
|
|
This is useful to do a test of the configuration only, without actually
|
||
|
|
starting the agent. This performs all of the validation the agent would, so
|
||
|
|
this should be given the complete set of configuration files that are going
|
||
|
|
to be loaded by the agent. This command cannot operate on partial
|
||
|
|
configuration fragments since those won't pass the full agent validation.
|
||
|
|
|
||
|
|
For more information on the format of Consul's configuration files, read the
|
||
|
|
consul agent [Configuration Files](/docs/agent/options#configuration-files)
|
||
|
|
section.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
Usage: `consul validate [options] FILE_OR_DIRECTORY...`
|
||
|
|
|
||
|
|
Returns 0 if the configuration is valid, or 1 if there are problems.
|
||
|
|
|
||
|
|
```shell-session
|
||
|
|
$ consul validate /etc/consul.d
|
||
|
|
Configuration is valid!
|
||
|
|
```
|