Skip to content

devops-cheat-sheets/consul-cheat-sheet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Consul Cheat Sheet

Agent Commands

Command Description
consul agent Starts a Consul agent with default configuration.
consul agent -dev Starts a development mode Consul agent, useful for local testing.
consul agent -config-file= Starts a Consul agent with the provided configuration file.
consul agent -data-dir= Specifies the data directory for the Consul agent.
consul agent -enable-script-checks Enables script-based health checks.
consul agent -join= Specifies an address to join an existing Consul cluster.
consul agent -node= Specifies the node name for the Consul agent.
consul agent -bootstrap-expect= Specifies the number of server nodes to expect when bootstrapping a new cluster.
consul agent -ui Starts the Consul agent with the UI enabled.

Catalog Commands

Command Description
consul catalog datacenters Lists the datacenters known to the Consul agent.
consul catalog nodes Lists the nodes in the Consul cluster.
consul catalog services Lists the services registered in the Consul cluster.
consul catalog service Lists the nodes providing a specific service.
consul catalog node Retrieves information about a specific node.
consul catalog service -tag= Lists the nodes providing a specific service with a given tag.
consul catalog connect -service= Retrieves the connection information for a service.
consul catalog connect -service= -tag= Retrieves the connection information for a service with a given tag.

Key-Value Commands

Command Description
consul kv put Sets the value of a key in the key-value store.
consul kv get Retrieves the value of a key from the key-value store.
consul kv delete Deletes a key from the key-value store.
consul kv list Lists all keys with a given prefix from the key-value store.
consul kv export Exports all key-value pairs from the key-value store.
consul kv import Imports key-value pairs from a file into the key-value store.
consul kv get -recurse Retrieves all keys and values from the key-value store.
consul kv delete -recurse Deletes all keys and values from the key-value store.

Service Commands

Command Description
consul services register Registers a new service with Consul using the provided configuration.
consul services deregister Deregisters a service from Consul using its ID.
consul services list Lists all services registered with Consul.
consul services list -service= Lists all instances of a specific service.
consul services health Provides the health status of all services.
consul services health -service= Provides the health status of a specific service.
consul services maintenance -enable Puts a service into maintenance mode.
consul services maintenance -disable Takes a service out of maintenance mode.

ACL Commands

Command Description
consul acl bootstrap Generates the initial ACL tokens and policy for Consul.
consul acl policy create Creates a new ACL policy with the given name and policy file.
consul acl policy read Reads the details of a specific ACL policy.
consul acl policy update Updates an existing ACL policy with the given name and policy file.

Maintenance Commands

Command Description
consul maintenance enable -reason= Puts the Consul agent into maintenance mode with a specific reason.
consul maintenance disable Takes the Consul agent out of maintenance mode.
consul maintenance status Checks the maintenance status of the Consul agent.

Event Commands

Command Description
consul event fire Fires a custom event with the given name.
consul event list Lists all the events in the cluster.
consul event list -name= Lists all the instances of a specific event.
consul event fire -node= Fires a custom event on a specific node.
consul event fire -service= Fires a custom event on all instances of a specific service.

Consul Template Commands

Command Description
consul-template -consul-addr= -template=: Renders a template file using Consul data and writes the output to a file.
consul-template -consul-addr= -template=: Renders a template file using Consul data and executes a command with the output.
consul-template -consul-addr= -template=: Renders a template file using Consul data and passes the output as arguments to a command.
consul-template -config= Starts Consul Template using the provided configuration file.

Health Checking Commands

Command Description
consul check list Lists all health checks in the cluster.
consul check register Registers a new health check using the provided check definition file.
consul check deregister Deregisters a health check using its ID.
consul check ttl Updates the status of a TTL-based health check.
consul check ttl Updates the status of a TTL-based health check with a note.
consul check http Registers an HTTP health check with the provided URL and interval.
consul check tcp Registers a TCP health check with the provided address and interval.
consul check script Registers a script-based health check with the provided script file and interval.
consul check http -header= Registers an HTTP health check with a custom header.

This cheat sheet provides a comprehensive list of commands for different aspects of HashiCorp Consul administration, including agent management, catalog management, key-value operations, service registration, ACL management, query execution, snapshot handling, network configuration, maintenance mode, event handling, Consul Template usage, health checking, and more.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published