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

Chris Piraino 1a853fc954 Always require Host header values for http services (#7990 ) Previously, we did not require the 'service-name.' host header value when on a single http service was exposed. However, this allows a user to get into a situation where, if they add another service to the listener, suddenly the previous service's traffic might not be routed correctly. Thus, we always require the Host header, even if there is only 1 service. Also, we add the make the default domain matching more restrictive by matching "service-name.ingress." by default. This lines up better with the namespace case and more accurately matches the Consul DNS value we expect people to use in this case.		5 years ago
.circleci	Use linkmode=external for the arm builds (#8029 )	5 years ago
.github	fixed links (#8020 )	5 years ago
acl	Replace whitelist/blacklist terminology with allowlist/denylist (#7971 )	5 years ago
agent	Always require Host header values for http services (#7990 )	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	fix some flaky snapshot tests (#8015 )	5 years ago
connect	ci: Add staticcheck and fix most errors	5 years ago
contributing	Add contributing dir with Config file checklist (#7017 )	5 years ago
demo	…
internal/go-sso	Add unconvert linter	5 years ago
ipaddr	Ensure Consul is IPv6 compliant (#5468 )	6 years ago
lib	Replace goe/verify.Values with testify/require.Equal (#7993 )	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	Allow users to configure either unstructured or JSON logging (#7130 )	5 years ago
service_os	…
snapshot	ci: Add staticcheck and fix most errors	5 years ago
terraform	…
test	Always require Host header values for http services (#7990 )	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: Blocking with filtering intentions amends (#8027 )	5 years ago
vendor	Replace goe/verify.Values with testify/require.Equal (#7993 )	5 years ago
version	Putting source back into Dev Mode	5 years ago
website	docs: Fix rendering of markdown on performance page	5 years ago
.dockerignore	…
.gitignore	.gitignore: cut IDE-specific entries, cleanup (#7083 )	5 years ago
.golangci.yml	Increase lint timeout	5 years ago
.hashibot.hcl	hashibot: let hashibot help us more (#7281 )	5 years ago
CHANGELOG.md	Update CHANGELOG.md	5 years ago
GNUmakefile	Make envoy integration tests a `go test` suite (#7842 )	5 years ago
INTERNALS.md	Add contributing dir with Config file checklist (#7017 )	5 years ago
LICENSE	…
NOTICE.md	…
README.md	Add link to Learn to the top, move service mesh higher up on list of features. (#7474 )	5 years ago
Vagrantfile	…
codecov.yml	ui: Test Coverage Reporting (#7027 )	5 years ago
go.mod	Replace goe/verify.Values with testify/require.Equal (#7993 )	5 years ago
go.sum	acl: add auth method for JWTs (#7846 )	5 years ago
main.go	cli: slightly more direct way of printing custom version	5 years ago
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.