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

Iryna Shustava 22872b03a6 docs: Clarify the use of kustomize or ship with the Helm chart (#7154 )		5 years ago
.circleci	use 4 parallelism for go-test and print package names (#7152 )	5 years ago
.github	bot: replace stalebot with hashibot (#7113 )	5 years ago
acl	…
agent	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
api	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
bench	…
build-support	Pass the git commits year through as an env var to the ui build (#7126 )	5 years ago
command	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
connect	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
contributing	…
demo	…
ipaddr	…
lib	…
logging	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
sdk	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
sentinel	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
service_os	…
snapshot	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
terraform	…
test	Updates to Config Entries and Connect for Namespaces (#7116 )	5 years ago
testrpc	…
tlsutil	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
types	…
ui-v2	ui: Change environment switch statement to correct env vars	5 years ago
vendor	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
version	Release v1.7.0-beta3	5 years ago
website	docs: Clarify the use of kustomize or ship with the Helm chart (#7154 )	5 years ago
.dockerignore	…
.gitignore	…
.hashibot.hcl	hashibot: disable most of hashibot (#7139 )	5 years ago
CHANGELOG.md	Update CHANGELOG.md	5 years ago
GNUmakefile	Pass the git commits year through as an env var to the ui build (#7126 )	5 years ago
INTERNALS.md	…
LICENSE	…
NOTICE.md	…
README.md	…
Vagrantfile	…
codecov.yml	…
go.mod	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
go.sum	Allow users to configure either unstructured or JSON logging (#7130 )	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.