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: 4563fe4064

R.B. Boyer 4563fe4064 update changelog		5 years ago
.circleci	Make envoy integration tests a `go test` suite (#7842 )	5 years ago
.github	Adding redirect to discuss, moving question to old (#7732 )	5 years ago
acl	Replace whitelist/blacklist terminology with allowlist/denylist (#7971 )	5 years ago
agent	acl: allow auth methods created in the primary datacenter to optionally create global tokens (#7899 )	5 years ago
api	acl: allow auth methods created in the primary datacenter to optionally create global tokens (#7899 )	5 years ago
bench	…
build-support	Replace whitelist/blacklist terminology with allowlist/denylist (#7971 )	5 years ago
command	acl: allow auth methods created in the primary datacenter to optionally create global tokens (#7899 )	5 years ago
connect	ci: Add staticcheck and fix most errors	5 years ago
contributing	…
demo	…
internal/go-sso	Add unconvert linter	5 years ago
ipaddr	…
lib	Merge pull request #7963 from hashicorp/dnephin/replace-lib-translate-keys	5 years ago
logging	Merge pull request #7469 from djmgit/log_dir	5 years ago
sdk	acl: remove the deprecated `acl_enforce_version_8` option (#7991 )	5 years ago
sentinel	…
service_os	…
snapshot	ci: Add staticcheck and fix most errors	5 years ago
terraform	…
test	Make envoy integration tests a `go test` suite (#7842 )	5 years ago
testrpc	acl: remove the deprecated `acl_enforce_version_8` option (#7991 )	5 years ago
tlsutil	ci: Add staticcheck and fix most errors	5 years ago
types	…
ui-v2	UI Release Merge (1.8-beta-2: ui-staging merge) (#7919 )	5 years ago
vendor	acl: add auth method for JWTs (#7846 )	5 years ago
version	…
website	acl: allow auth methods created in the primary datacenter to optionally create global tokens (#7899 )	5 years ago
.dockerignore	…
.gitignore	…
.golangci.yml	ci: Add staticcheck and fix most errors	5 years ago
.hashibot.hcl	…
CHANGELOG.md	update changelog	5 years ago
GNUmakefile	Make envoy integration tests a `go test` suite (#7842 )	5 years ago
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.