Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.

consul api-gateway kubernetes ecs service-discovery service-mesh vault

Go to file

Luke Kysow 95096e2c03 peering: retry establishing connection more quickly on certain errors (#13938 ) When we receive a FailedPrecondition error, retry that more quickly because we expect it will resolve shortly. This is particularly important in the context of Consul servers behind a load balancer because when establishing a connection we have to retry until we randomly land on a leader node. The default retry backoff goes from 2s, 4s, 8s, etc. which can result in very long delays quite quickly. Instead, this backoff retries in 8ms five times, then goes exponentially from there: 16ms, 32ms, ... up to a max of 8152ms.		2 years ago
.changelog	Add changelog note	2 years ago
.circleci	Add Consul Lambda integration tests (#13770 )	2 years ago
.github	ci: Use correct branch name for 1.13 nightly test (#13945 )	2 years ago
.release	[CI-only] Support fossa scanning (#13694 )	2 years ago
acl	Add ACL enforcement to peering endpoints	2 years ago
agent	peering: retry establishing connection more quickly on certain errors (#13938 )	2 years ago
api	feat: convert destination address to slice	2 years ago
bench	…
build-support	makefile: give better error for tool installed by wrong package (#13797 )	2 years ago
command	fix (cli): import empty directory to kv (#13939 )	2 years ago
connect	Ensure connections are closed before WaitGroup marked as done	2 years ago
contributing	…
docs	peering: add config to enable/disable peering (#13867 )	2 years ago
grafana	…
internal	Extract AWS auth implementation out of Consul (#13760 )	2 years ago
ipaddr	…
lib	Extract AWS auth implementation out of Consul (#13760 )	2 years ago
logging	peering: emit exported services count metric (#13811 )	2 years ago
proto	Add ACL enforcement to peering endpoints	2 years ago
proto-public	Rename some protobuf package names to be fqdn like (#13861 )	2 years ago
sdk	…
sentinel	…
service_os	…
snapshot	…
test	Update envoy metrics label extraction for peered clusters and listeners (#13818 )	2 years ago
testrpc	…
tlsutil	server: ensure peer replication can successfully use TLS over external gRPC (#13733 )	2 years ago
tools/internal-grpc-proxy	…
types	…
ui	ui: Make peered intentions read-only (#13814 )	2 years ago
version	…
website	Merge pull request #13917 from hashicorp/docs/show-cli-cmd-options-before-general-options-2	2 years ago
.dockerignore	…
.gitignore	chore: ignore vscode files	2 years ago
.golangci.yml	…
CHANGELOG.md	…
Dockerfile	…
GNUmakefile	…
LICENSE	…
NOTICE.md	…
README.md	…
Vagrantfile	…
fixup_acl_move.sh	…
go.mod	Extract AWS auth implementation out of Consul (#13760 )	2 years ago
go.sum	update generate token endpoint to take external addresses (#13844 )	2 years ago
main.go	…

README.md

Consul

Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.

Website: https://www.consul.io
Tutorials: HashiCorp Learn
Forum: Discuss

Consul provides several key features:

Multi-Datacenter - Consul is built to be datacenter aware, and can support any number of regions without complex configuration.
Service Mesh/Service Segmentation - Consul Connect enables secure service-to-service communication with automatic TLS encryption and identity-based authorization. Applications can use sidecar proxies in a service mesh configuration to establish TLS connections for inbound and outbound connections without being aware of Connect at all.
Service Discovery - Consul makes it simple for services to register themselves and to discover other services via a DNS or HTTP interface. External services such as SaaS providers can be registered as well.
Health Checking - Health Checking enables Consul to quickly alert operators about any issues in a cluster. The integration with service discovery prevents routing traffic to unhealthy hosts and enables service level circuit breakers.
Key/Value Storage - A flexible key/value store enables storing dynamic configuration, feature flagging, coordination, leader election and more. The simple HTTP API makes it easy to use anywhere.

Consul runs on Linux, macOS, FreeBSD, Solaris, and Windows and includes an optional browser based UI. A commercial version called Consul Enterprise is also available.

Please note: We take Consul's security and our users' trust very seriously. If you believe you have found a security issue in Consul, please responsibly disclose by contacting us at security@hashicorp.com.

Quick Start

A few quick start guides are available on the Consul website:

Standalone binary install: https://learn.hashicorp.com/tutorials/consul/get-started-install
Minikube install: https://learn.hashicorp.com/tutorials/consul/kubernetes-minikube
Kind install: https://learn.hashicorp.com/tutorials/consul/kubernetes-kind
Kubernetes install: https://learn.hashicorp.com/tutorials/consul/kubernetes-deployment-guide

Documentation

Full, comprehensive documentation is available on the Consul website:

https://www.consul.io/docs

Contributing

Thank you for your interest in contributing! Please refer to CONTRIBUTING.md for guidance. For contributions specifically to the browser based UI, please refer to the UI's README.md for guidance.