github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
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.
19275 Commits
1702 Branches
457 Tags
697 MiB
 
 
 
 
 
 
Tree: 3e7e8ae9c5
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '3e7e8ae9c5'
${ noResults }
consul/docs/cli
Daniel Nephin 75c9c5f968
Move contributing to docs 		3 years ago
..
README.md Move contributing to 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.