open-consul/contributing/cli/README.md

1.4 KiB

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.