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

Blake Covarrubias b3cf47c861 Redirect /docs/guides/outage.html to Learn Resolves: #6953		5 years ago
.circleci	…
.github	bot: replace stalebot with hashibot (#7113 )	5 years ago
acl	Intentions ACL enforcement updates (#7028 )	5 years ago
agent	Fix segfault when removing both a service and associated check (#7108 )	5 years ago
api	fix the submodule go.mod and go.sum files (#7098 )	5 years ago
bench	…
build-support	…
command	bug: Consul lock does not receive signals if lock not acquired (#5909 )	5 years ago
connect	…
contributing	Add contributing dir with Config file checklist (#7017 )	5 years ago
demo	…
ipaddr	…
lib	…
logger	…
sdk	Fix up formatting in sdk package (#7109 )	5 years ago
sentinel	…
service_os	…
snapshot	…
terraform	…
test	…
testrpc	connect: check if intermediate cert needs to be renewed. (#6835 )	5 years ago
tlsutil	agent: setup grpc server with auto_encrypt certs and add -https-port (#7086 )	5 years ago
types	…
ui-v2	…
vendor	raft: update raft to v1.1.2 (#7079 )	5 years ago
version	…
website	Redirect /docs/guides/outage.html to Learn	5 years ago
.dockerignore	…
.gitignore	.gitignore: cut IDE-specific entries, cleanup (#7083 )	5 years ago
.hashibot.hcl	bot: replace stalebot with hashibot (#7113 )	5 years ago
CHANGELOG.md	Update CHANGELOG.md	5 years ago
GNUmakefile	test: run both the TestVaultProvider and TestVaultCAProvider tests in CI (#7097 )	5 years ago
INTERNALS.md	Add contributing dir with Config file checklist (#7017 )	5 years ago
LICENSE	…
NOTICE.md	…
README.md	Merge pull request #7102 from hashicorp/david-yu-patch-2	5 years ago
Vagrantfile	…
codecov.yml	…
go.mod	raft: update raft to v1.1.2 (#7079 )	5 years ago
go.sum	raft: update raft to v1.1.2 (#7079 )	5 years ago
main.go	…
main_test.go	…

README.md

Consul

Website: https://www.consul.io
Forum: Discuss

Consul is a tool for service discovery and configuration. Consul is distributed, highly available, and extremely scalable.

Consul provides several key features:

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.
Multi-Datacenter - Consul is built to be datacenter aware, and can support any number of regions without complex configuration.
Service Segmentation/Service Mesh - 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.

Consul runs on Linux, Mac OS X, FreeBSD, Solaris, and Windows. 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://www.consul.io/intro/getting-started/install
Kubernetes install: https://learn.hashicorp.com/consul/kubernetes/kubernetes-deployment-guide
Minikube install: https://learn.hashicorp.com/consul/kubernetes/minikube

Documentation

Full, comprehensive documentation is viewable on the Consul website:

https://www.consul.io/docs

Contributing

Thank you for your interest in contributing! Please refer to CONTRIBUTING.md for guidance.