github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '1a9b2f09dd'
${ noResults }
consul/contributing/cli
History
Daniel Nephin d0af0bfc1d
contrib: Add CLI docs 		3 years ago
..
README.md contrib: Add CLI docs 3 years ago

README.md

Command-Line Interface (CLI)

This section is a work in progress.

The consul binary provides a CLI for interacting with the HTTP API. Some commands may also exec other processes or generate data used by Consul (ex: tls certificates). The agent command is responsible for starting the Consul agent.

The cli reference in Consul user documentation has a full reference to all available commands.

Code

The CLI entrypoint is main.go and the majority of the source for the CLI is under the command directory. Each subcommand is a separate package under command. The CLI uses github.com/mitchellh/cli as a framework, and uses the flag package from the stdlib for command line flags.

Important notes

The cli.Ui wraps an io.Writer for both stdout and stderr. At the time of writing both Info and Output go to stdout. Writing Info to stdout has been a source of a couple bugs. To prevent these bugs in the future it is recommended that Info should no longer be used. Instead, send all information messages to stderr by using Warn.