Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
 
 
 
 
 
 
Go to file
Matt Keeler 93e29a7992 Upgrade to using hashicorp/go-metrics@v0.5.4
This also requires bumping the dependencies for:

* memberlist
* serf
* raft
* raft-boltdb/v2

Tidy up other submodules

Fixup a few ci jobs where build tag was missing.

Add tagging to the lint-enums job

Update linting rules to disallow usage of armon/go-metrics

Also prevent usage of hashicorp/go-metrics/compat as that should only be used by libraries.

Dont use the deprecated -tags option to enumcover

Try to get the tags passed through correctly.

Fix serf config cloning test due to new field present in the config.

Attempt to get build tags flowing properly when utilizing gotestsum splitting.

More quoting

One more attempt at passing build tags in GOFLAGS

Add tags to the golden file checker
2025-01-24 16:33:52 -05:00
.changelog sec: bump go and deps versions (#22084) 2025-01-21 11:32:08 -05:00
.github Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
.release Suppress redhat linux CVEs (#22015) 2024-12-18 17:24:28 +00:00
acl [Security] Secvuln 8633 Consul configuration allowed repeated keys (#21908) 2024-11-14 09:57:08 -06:00
agent Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
api Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
bench Gets benchmarks running again and does a rough pass for 0.7.1. 2016-11-29 13:02:26 -08:00
build-support fix spacing of bash scripts (#21760) 2024-09-19 14:09:42 -04:00
command [NET-1151 NET-11228] security: Add request normalization and header match options to prevent L7 intentions bypass (#21816) 2024-10-16 12:23:33 -04:00
connect Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
docs remove v2 tenancy, catalog, and mesh (#21592) 2024-09-05 08:50:46 -06:00
envoyextensions Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
grafana Adds grafana dashboards (#21806) 2024-10-09 13:30:28 -04:00
grpcmocks/proto-public v2tenancy: add optional LicenseFeature to type Registration struct (#20673) 2024-02-20 14:42:31 -06:00
internal sec: bump go and deps versions (#22084) 2025-01-21 11:32:08 -05:00
ipaddr [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
lib Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
logging Trigger the V1 Compat exported-services Controller when V1 Config Entries are Updated (#20456) 2024-02-02 15:30:04 -05:00
proto [NET-1151 NET-11228] security: Add request normalization and header match options to prevent L7 intentions bypass (#21816) 2024-10-16 12:23:33 -04:00
proto-public sec: bump go and deps versions (#22084) 2025-01-21 11:32:08 -05:00
sdk sec: bump go and deps versions (#22084) 2025-01-21 11:32:08 -05:00
sentinel Remove old build tags (#19128) 2023-10-10 10:58:06 -04:00
service_os Remove old build tags (#19128) 2023-10-10 10:58:06 -04:00
snapshot [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
test Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
test-integ Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
testing/deployer Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
testrpc feat(v2): add consul service and workloads to catalog (#20077) 2024-01-03 15:14:42 -05:00
tlsutil [Cloud][CC-6925] Updates to pushing server state (#19682) 2023-12-04 10:25:18 -05:00
tools/internal-grpc-proxy [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
troubleshoot Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
types [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
ui [NET-1151 NET-11228] security: Add request normalization and header match options to prevent L7 intentions bypass (#21816) 2024-10-16 12:23:33 -04:00
version docs: Consul DNS views on Kubernetes (#21802) 2024-10-14 12:38:23 -07:00
website docs: fix broken link (#21971) 2024-11-27 14:17:33 -07:00
.copywrite.hcl [DO NOT MERGE UNTIL EOY] update year in LICENSE and copywrite files (#19780) 2024-01-02 08:41:12 -08:00
.dockerignore Update the scripting 2018-06-14 21:42:47 -04:00
.gitignore chore: remove unintentionally committed consul-k8s submodule (#21833) 2024-10-16 14:36:04 +00:00
.go-version sec: bump go and deps versions (#22084) 2025-01-21 11:32:08 -05:00
.golangci.yml Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
.grpcmocks.yaml In-Memory gRPC (#19942) 2024-01-12 11:54:07 -05:00
.pre-commit-config.yaml unhack: add pre-commit guidelines (#19617) 2023-11-15 10:57:40 -06:00
CHANGELOG.md chore: Updated the changelogs for 1.20.2, 1.19.4, 1.18.6, 1.15.16 (#22093) 2025-01-22 15:09:42 +05:30
Dockerfile Added labels for redhat validation (#22047) 2025-01-03 12:51:39 +05:30
Dockerfile-windows Envoy Integration Test Windows (#18007) 2023-07-21 20:26:00 +05:30
LICENSE [DO NOT MERGE UNTIL EOY] update year in LICENSE and copywrite files (#19780) 2024-01-02 08:41:12 -08:00
Makefile Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
README.md Update README.md (#19413) 2023-10-31 08:45:47 -07:00
buf.work.yaml [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
go.mod Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
go.sum Upgrade to using hashicorp/go-metrics@v0.5.4 2025-01-24 16:33:52 -05:00
main.go [COMPLIANCE] License changes (#18443) 2023-08-11 09:12:13 -04:00
scan.hcl ci(security-scanner): add support for Red Hat UBI images and fix typo (#21912) 2024-11-04 14:52:01 -05:00

README.md

Consul logo Consul

License: BUSL-1.1 Docker Pulls Go Report Card

Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.

Consul provides several key features:

  • Multi-Datacenter - Consul is built to be datacenter aware, and can support any number of regions without complex configuration.

  • Service Mesh - Consul Service Mesh 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 with Transparent Proxy.

  • API Gateway - Consul API Gateway manages access to services within Consul Service Mesh, allow users to define traffic and authorization policies to services deployed within the mesh.

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

  • Dynamic App Configuration - An HTTP API that allows users to store indexed objects within Consul, for storing configuration parameters and application metadata.

Consul runs on Linux, macOS, FreeBSD, Solaris, and Windows and includes an optional browser based UI. 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:

Documentation

Full, comprehensive documentation is available on the Consul website: https://consul.io/docs

Contributing

Thank you for your interest in contributing! Please refer to CONTRIBUTING.md for guidance. For contributions specifically to the browser based UI, please refer to the UI's README.md for guidance.