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

Tree: 2ed1c44440

Brandon Romano 2ed1c44440 Adds og:title		5 years ago
.circleci	Give ember-build a larger container (#7873 )	5 years ago
.github	Adding redirect to discuss, moving question to old (#7732 )	5 years ago
acl	…
agent	http: migrate from instrumentation in s.wrap() to an s.enterpriseHandler()	5 years ago
api	Add unconvert linter	5 years ago
bench	…
build-support	ui: Upgrade to node 12 LTS (#7248 )	5 years ago
command	Use proxy-id in gateway auto-registration (#7845 )	5 years ago
connect	…
contributing	…
demo	…
internal/go-sso	Add unconvert linter	5 years ago
ipaddr	…
lib	Filter wildcard gateway services to match listener protocol	5 years ago
logging	Merge pull request #7469 from djmgit/log_dir	5 years ago
sdk	sdk: extracting testutil.RequireErrorContains from various places it was duplicated (#7753 )	5 years ago
sentinel	…
service_os	…
snapshot	cli: fix usage of gzip.Reader to better detect corrupt snapshots during save/restore (#7697 )	5 years ago
terraform	…
test	Merge pull request #7759 from hashicorp/ingress/tls-hosts	5 years ago
testrpc	…
tlsutil	rpc: oss changes for network area connection pooling (#7735 )	5 years ago
types	…
ui-v2	ui: Add namespaces to gateway services (#7868 )	5 years ago
vendor	acl: add auth method for JWTs (#7846 )	5 years ago
version	…
website	Adds og:title	5 years ago
.dockerignore	…
.gitignore	…
.golangci.yml	Add unconvert linter	5 years ago
.hashibot.hcl	…
CHANGELOG.md	removed duplicated line about JWT auth method	5 years ago
GNUmakefile	…
INTERNALS.md	…
LICENSE	…
NOTICE.md	…
README.md	…
Vagrantfile	…
codecov.yml	ui: Test Coverage Reporting (#7027 )	5 years ago
go.mod	acl: add auth method for JWTs (#7846 )	5 years ago
go.sum	acl: add auth method for JWTs (#7846 )	5 years ago
main.go	…
main_test.go	…

README.md

Consul

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.
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.
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.

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://learn.hashicorp.com/consul/getting-started/install
Minikube install: https://learn.hashicorp.com/consul/kubernetes/minikube
Kubernetes install: https://learn.hashicorp.com/consul/kubernetes/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.