github.com/hashicorp/consul
v1.22.7
#70 most downloaded on Go modules
hashicorp/consul
What this package is like to depend on
Last release 4 days ago
20 Aug 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 229 of 233 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
12201 releases · first in 2013
470 releases in the last 12 months
see the full history below
Release timeline
12201 releases · Jan 2023 to Aug 2026Releases
latest 60 of 12201-
v1.22.722 Apr 2026Release notes
Open source →SECURITY:
- security: update google.golang.org/grpc to fix CVE-2026-33186 [GH-23379]
- security: upgrade go.opentelemetry.io/otel to 1.42.0 to remediate CVE-2026-24051 (Path Hijacking / Untrusted Search Paths on macOS). [GH-23387]
- test-sds-server: bump github.com/hashicorp/consul to v1.22.5 in integration test module to align with the CVE-2026-2808 fixed release line. [GH-23437]
- ui: (Enterprise only) Backport Rollup update to 2.80.0 for release/1.21.x to address CVE-2026-27606 (SECVULN-38912).
IMPROVEMENTS:
- acl: Addition of TokenNameFormat field to auth-method and parse the same for token name [GH-23444]
- discovery-chain: removes the use of hashstructure_v2 ([github.com/mitchellh/hashstructure/v2] from compiled discovery chain hashing and replaces it with explicit custom hash implementations. [GH-23393]
- ui: removed consul docs website related code as it is being maintained in a separate internal repository. [GH-23398]
BUG FIXES:
- api-gateway: fix HTTPRoute PathPrefix routing to preserve the original request path when
replacePrefixMatchis not configured [GH-23390]
Release notes
Open source →SECURITY:
- security: update google.golang.org/grpc to fix CVE-2026-33186 [GH-23379]
- security: upgrade go.opentelemetry.io/otel to 1.42.0 to remediate CVE-2026-24051 (Path Hijacking / Untrusted Search Paths on macOS). [GH-23387]
- test-sds-server: bump github.com/hashicorp/consul to v1.22.5 in integration test module to align with the CVE-2026-2808 fixed release line. [GH-23437]
- ui: (Enterprise only) Backport Rollup update to 2.80.0 for release/1.21.x to address CVE-2026-27606 (SECVULN-38912). [GH-23359]
IMPROVEMENTS:
- acl: Addition of TokenNameFormat field to auth-method and parse the same for token name [GH-23444]
- discovery-chain: removes the use of hashstructure_v2 ([github.com/mitchellh/hashstructure/v2] from compiled discovery chain hashing and replaces it with explicit custom hash implementations. [GH-23393]
- ui: removed consul docs website related code as it is being maintained in a separate internal repository. [GH-23398]
BUG FIXES:
- api-gateway: fix HTTPRoute PathPrefix routing to preserve the original request path when
replacePrefixMatchis not configured [GH-23390]
-
v1.22.625 Mar 2026Release notes
Open source →SECURITY:
- security: upgrade envoy version to 1.35.9 and 1.34.13 [GH-23372]
- security: update google.golang.org/grpc to fix CVE-2026-33186 [GH-23379]
- security: upgrade go version to 1.25.8 [GH-23322]
- security: bump golang.org/x/* dependencies to align with consul-enterprise and address security vulnerabilities. [GH-23322]
IMPROVEMENTS:
- api-gateway: Add support to disable traffic with weight 0 in services for HTTPRoute backends, allowing explicit zero-weight backends to be excluded from traffic. [GH-23216]
- ui: Fixed Consul UI to work in non-secure environments by enabling Ember Data's UUID polyfill for crypto.randomUUID. [GH-23341]
- ui: Fixed Consul UI services page navigation by ensuring route transitions trigger the expected model hook behavior after Ember upgrade. [GH-23271]
- ui: Replaced deprecated SideNav component with AppSideNav for improved navigation structure. [GH-23289]
-
v1.22.526 Feb 2026Release notes
Open source →SECURITY:
- security: upgrade go version to 1.25.7 [GH-23204]
- dockerfile: update the Consul build Go base image to
alpine3.23[GH-23194] - connect: Migrate to aws-sdk-go-v2 from aws-sdk-go (v1). Also updated consul-awsauth and go-secure-stdlib/awsutil dependencies to their v2 versions. [GH-23109]
- security: Configure HTTP server timeouts to prevent Slowloris denial-of-service attacks on agent HTTP endpoints and pprof endpoints. [GH-22739]
- security: Patched Vault CA provider to prevent arbitrary file reads via Kubernetes, JWT, and AppRole methods. [GH-23249]
- security: Introduced debounce timing for synchronization operations within federationStateAntiEntropySync. [GH-23196]
IMPROVEMENTS:
- api-gateway: Fixed "duplicate matcher" errors in Envoy when using multiple file-system certificates on a single TLS listener. The certificates are now consolidated into a single filter chain, allowing Envoy to select the correct one. [GH-23212]
- agent: Fix vault provider failure when signing intermediate CA with isCA=true in CSR [GH-23202]
- cli: Added
--aws-iam-endpointflag toconsul logincommand for AWS IAM auth method to support custom IAM endpoint configuration [GH-23109] - docs: Refreshed the security documentation to include the new HTTP server timeout defaults and relevant configuration options. [GH-23246]
- api: Cancel context check for watches cache fetch to stop execution when manager deregisters the watch. [GH-23157]
Release notes
Open source →SECURITY:
- security: upgrade go version to 1.25.7 [GH-23204]
- dockerfile: the Consul build Go base image to
alpine3.23[GH-23194] - connect: Migrate to aws-sdk-go-v2 from aws-sdk-go (v1). Also updated consul-awsauth and go-secure-stdlib/awsutil dependencies to their v2 versions. [GH-23109]
- security: Configure HTTP server timeouts to prevent Slowloris denial-of-service attacks on agent HTTP endpoints and pprof endpoints. [GH-22739]
- security: Patched Vault CA provider to prevent arbitrary file reads via Kubernetes, JWT, and AppRole methods. [GH-23249]
- security: Introduced debounce timing for synchronization operations within federationStateAntiEntropySync. [GH-23196]
IMPROVEMENTS:
- api-gateway: Fixed "duplicate matcher" errors in Envoy when using multiple file-system certificates on a single TLS listener. The certificates are now consolidated into a single filter chain, allowing Envoy to select the correct one. [GH-23212]
- agent: Fix vault provider failure when signing intermediate CA with isCA=true in CSR [GH-23202]
- cli: Added
--aws-iam-endpointflag toconsul logincommand for AWS IAM auth method to support custom IAM endpoint configuration [GH-23109] - docs: Refreshed the security documentation to include the new HTTP server timeout defaults and relevant configuration options. [GH-23246]
- api: Cancel context check for watches cache fetch to stop execution when manager deregisters the watch. [GH-23157]
-
v1.22.418 Feb 2026Release notes
Open source →WITHDRAWN - This release has been retracted from public distribution due to critical issues. Please use 1.22.5 or remain on 1.22.3.
-
v1.22.314 Jan 2026Release notes
Open source → -
v1.22.217 Dec 2025Nothing published for this version
-
v1.22.126 Nov 2025Release notes
Open source →SECURITY:
- connect: Upgrade envoy version to 1.35.6 [GH-23056]
- security: Updated
golang.org/x/cryptofrom v0.42.0 to v0.44.0. This resolves GO-2025-4116
IMPROVEMENTS:
- ui: Removed ember-route-action-helper and migrated all {{route-action}} usages to explicit route/controller logic. [GH-23004]
- ui: Replaced
reopen()calls with direct property assignment and subclassing to resolve Ember component reopen deprecation warnings [GH-22971] - ui: removed deprecated Route#renderTemplate usage by introducing DebugLayout component and controller-based conditional rendering for docs routes [GH-22978]
- ui: resolved multiple Ember deprecations:
- Removed mutation-after-consumption warnings in Outlet by staging state updates outside the render pass
- Replaced deprecated Route#replaceWith/transitionTo usage with RouterService in affected routes
- Avoided mutating objects produced by {{hash}} (setting-on-hash) by switching to tracked POJOs [GH-23010]
BUG FIXES:
- acl: fixed a bug where ACL policy replication in WANfed is impacted when primaryDC is inconsistent [GH-22954]
- xds: fix RBAC failure in upstream service when there are more than one downstream exported service with same name but different peer [GH-23049]
- xds: fix bug where Using replacePrefixMatch: "/" results in double slashes (//path) and Using replacePrefixMatch: "" does not strip the prefix at all (e.g., mapping /v1/dashboard → /dashboard) resulting in 301 and 404 errors respectively [GH-23035]
-
v1.22.027 Oct 2025Release notes
Open source →SECURITY:
- connect: Upgrade Consul's bundled Envoy version to 1.35.3 and remove support for 1.31.10. This update also includes a fix to prevent Envoy (v1.35+) startup failures by only configuring the TLS transport socket when the CA bundle is present. [GH-22824]
- security: Adding warning when remote/local script checks are enabled without enabling ACL's [GH-22877]
- security: Improved validation of the Content-Length header in the Consul KV endpoint to prevent potential denial of service attacksCVE-2025-11374 [GH-22916]
- security: adding a maximum Content-Length on the event endpoint to fix denial-of-service (DoS) attacks. This resolves CVE-2025-11375. [GH-22836]
- security: breaking change - adding a key name validation on the key/value endpoint along side with the DisableKVKeyValidation config to disable/enable it to fix path traversal attacks on misconfigured or missing ACL policies. [GH-22850]
FEATURES:
- Added support to register a service in consul with multiple ports [GH-22769]
- agent: Added IsDualStack utility function to detect if the agent is configured for both IPv4 and IPv6 (dual-stack mode) based on its bind address retrieved from "agent/self" API. [GH-22741]
- install: Updated license information displayed during post-install
- ipv6: addtition of ip6tables changes for ipv6 and dual stack support [GH-22787]
- oidc: add client authentication using JWT assertion and PKCE. default PKCE is enabled. [GH-22732]
IMPROVEMENTS:
- security: Upgrade golang to 1.25.3. [GH-22926]
- ui: Fixes computed property override issues currently occurring and in some cases pre-emptively as this has been deprecated in ember v4 [GH-22947]
- ui: removes send action instances as part of https://deprecations.emberjs.com/id/ember-component-send-action/ [GH-22938]
- ui: replaced ember partials with components as an incremental step to upgrade to ember v4 [GH-22888]
- api: Added a new API (/v1/operator/utilization) to support enterprise API for Manual Snapshot Reporting [GH-22837]
- cmd: Added new subcommand
consul operator utilization [-today-only] [-message] [-y]to generate a bundle with census utilization snapshot. Main flow is implemented in consul-enterprise http: Added a new API Handler for/v1/operator/utilization. Core functionality to be implemented in consul-enterprise agent: Always enabled census metrics collection with configurable option to export it to Hashicorp Reporting [GH-22843] - cli:
snapshot agentnow supports authenticating to Azure Blob Storage using Azure Managed Service Identities (MSI). [GH-11171] - command: connect envoy bootstrap defaults to 127.0.0.1 in IPv4-only environment and to ::1 in IPv6/DualStack environment. [GH-22763]
- connect: default upstream.local_bind_address to ::1 for IPv6 agent bind address [GH-22773]
- proxy: default proxy.local_service_address to ::1 for IPv6 agent bind address [GH-22772]
- ui: Improved accessibility features in the Consul UI to enhance usability for users with disabilities [GH-22770]
- ui: Replace yarn with pnpm for package management [GH-22790]
- ui: auth method config values were overflowing. This PR fixes the issue and adds word break for table elements with large content. [GH-22813]
BUG FIXES:
- ui: Allow FQDN to be displayed in the Consul web interface. [GH-22779]
- ui: fixes the issue where namespaces where disappearing and Welcome to Namespace screen showed up after tab switching [GH-22789]
- ui: fixes the issue where when doing deletes of multiple tokens or policies, the three dots on the right hand side stops responding after the first delete. [GH-22752]
- cmd: Fix
consul operator utilization --helpto show only available options without extra parameters. [GH-22912]
-
v1.22.0-rc215 Oct 2025 pre-releaseRelease notes
Open source →SECURITY:
- security: Adding warning when remote/local script checks are enabled without enabling ACL's [GH-22877]
- security: Improved validation of the Content-Length header in the Consul KV endpoint to prevent potential denial of service attacksCVE-2025-11374 [GH-22916]
- security: adding a maximum Content-Length on the event endpoint to fix denial-of-service (DoS) attacks. This resolves CVE-2025-11375. [GH-22836]
- security: breaking change - adding a key name validation on the key/value endpoint along side with the DisableKVKeyValidation config to disable/enable it to fix path traversal attacks on misconfigured or missing ACL policies. [GH-22850]
BUG FIXES:
- cmd: Fix
consul operator utilization --helpto show only available options without extra parameters. [GH-22912]
-
v1.22.0-rc130 Sep 2025 pre-releaseRelease notes
Open source →SECURITY:
- connect: Upgrade Consul's bundled Envoy version to 1.35.3 and remove support for 1.31.10. This update also includes a fix to prevent Envoy (v1.35+) startup failures by only configuring the TLS transport socket when the CA bundle is present. [GH-22824]
FEATURES:
- Added support to register a service in consul with multiple ports [GH-22769]
- agent: Added IsDualStack utility function to detect if the agent is configured for both IPv4 and IPv6 (dual-stack mode) based on its bind address retrieved from "agent/self" API. [GH-22741]
- install: Updated license information displayed during post-install
- ipv6: addtition of ip6tables changes for ipv6 and dual stack support [GH-22787]
- oidc: add client authentication using JWT assertion and PKCE. default PKCE is enabled. [GH-22732]
IMPROVEMENTS:
- api: Added a new API (/v1/operator/utilization) to support enterprise API for Manual Snapshot Reporting [GH-22837]
- cmd: Added new subcommand
consul operator utilization [-today-only] [-message] [-y]to generate a bundle with census utilization snapshot. Main flow is implemented in consul-enterprise http: Added a new API Handler for/v1/operator/utilization. Core functionality to be implemented in consul-enterprise agent: Always enabled census metrics collection with configurable option to export it to Hashicorp Reporting [GH-22843] - cli:
snapshot agentnow supports authenticating to Azure Blob Storage using Azure Managed Service Identities (MSI). [GH-11171] - command: connect envoy bootstrap defaults to 127.0.0.1 in IPv4-only environment and to ::1 in IPv6/DualStack environment. [GH-22763]
- connect: default upstream.local_bind_address to ::1 for IPv6 agent bind address [GH-22773]
- proxy: default proxy.local_service_address to ::1 for IPv6 agent bind address [GH-22772]
- ui: Improved accessibility features in the Consul UI to enhance usability for users with disabilities [GH-22770]
- ui: Replace yarn with pnpm for package management [GH-22790]
- ui: auth method config values were overflowing. This PR fixes the issue and adds word break for table elements with large content. [GH-22813]
BUG FIXES:
- ui: Allow FQDN to be displayed in the Consul web interface. [GH-22779]
- ui: fixes the issue where namespaces where disappearing and Welcome to Namespace screen showed up after tab switching [GH-22789]
- ui: fixes the issue where when doing deletes of multiple tokens or policies, the three dots on the right hand side stops responding after the first delete. [GH-22752]
-
v1.21.521 Sep 2025Release notes
Open source →SECURITY:
- Migrate transitive dependency from archived
mitchellh/mapstructuretogo-viper/mapstructureto v2 to address CVE-2025-52893. [GH-22581] - agent: Add the KV Validations to block path traversal allowing access to unauthorized endpoints. [GH-22682]
- agent: Fix a security vulnerability to filter out anonymous tokens along with empty tokens when setting the Results-Filtered-By-ACLs header [GH-22534]
- agent: Fix a security vulnerability where the attacker could read agent’s TLS certificate and private key by using the group ID that the Consul agent runs as. [GH-22626]
- api: add charset in all applicable content-types. [GH-22598]
- connect: Upgrade envoy version to 1.34.7 [GH-22735]
- security: Fix GHSA-65rg-554r-9j5x (CVE-2024-48908) by upgrading lycheeverse/lychee-action. [GH-22667]
- security: Fix a security vulnerability where the attacker could bypass authentication by passing url params as there was no validation on them. [GH-22612]
- security: perform constant time compare for sensitive values. [GH-22537]
- security: upgrade go version to 1.25.0 [GH-22652]
- security:: (Enterprise only) fix nil pointer dereference.
- security:: (Enterprise only) fix potential race condition in partition CRUD.
- security:: (Enterprise only) perform constant time compare for sensitive values.
FEATURES:
- config: Add new parameter
max_request_headers_kbto configure maximum header size for requests from downstream to upstream [GH-22604] - config: Handle a new parameter
max_request_headers_kbto configure maximum header size for requests from downstream to upstream in API Gateway config and proxy-defaults [GH-22679] - config: Handle a new parameter
max_request_headers_kbto configure maximum header size for requests from downstream to upstream in Mesh Gateway via service-defaults and proxy-defaults [GH-22722] - config: Handle a new parameter
max_request_headers_kbto configure maximum header size for requests from downstream to upstream in Terminating Gateway service-defaults and proxy-defaults [GH-22680]
IMPROVEMENTS:
- cli: add troubleshoot ports in debug command. A ports.json file is created, which lists the open or closed ports on the host where the command is executed. [GH-22624]
BUG FIXES:
- agent: Don't show admin partition during errors [GH-11154]
- Migrate transitive dependency from archived
-
v1.21.413 Aug 2025Release notes
Open source →SECURITY:
- security: Update Go to 1.23.12 to address CVE-2025-47906 [GH-22547]
IMPROVEMENTS:
- ui: Replaced internal code editor with HDS (HashiCorp Design System) code editor and code block components for improved accessibility and maintainability across the Consul UI. [GH-22513]
BUG FIXES:
- cli: capture pprof when ACL is enabled and a token with operator:read is used, even if enable_debug config is not explicitly set. [GH-22552]
-
v1.21.319 Jul 2025Release notes
Open source →IMPROVEMENTS:
- ui: Improved display and handling of IPv6 addresses for better readability and usability in the Consul web interface. [GH-22468]
BUG FIXES:
-
v1.21.218 Jun 2025Release notes
Open source →SECURITY:
- security: Upgrade UBI base image version to address CVE CVE-2025-4802 CVE-2024-40896 CVE-2024-12243 CVE-2025-24528 CVE-2025-3277 CVE-2024-12133 CVE-2024-57970 CVE-2025-31115 [GH-22409]
- cli: update tls ca and cert create to reduce excessive file perms for generated public files [GH-22286]
- connect: Added non default namespace and partition checks to ConnectCA CSR requests. [GH-22376]
- security: Upgrade Go to 1.23.10. [GH-22412]
IMPROVEMENTS:
- config: Warn about invalid characters in
datacenterresulting in non-generation of X.509 certificates when using external CA for agent TLS communication. [GH-22382] - connect: Use net.JoinHostPort for host:port formatting to handle IPv6. [GH-22359]
BUG FIXES:
- http: return a clear error when both Service.Service and Service.ID are missing during catalog registration [GH-22381]
- license: (Enterprise only) Fixed issue where usage metrics are not written to the snapshot to export the license data. [GH-10668]
- wan-federation: Fixed an issue where advertised IPv6 addresses were causing WAN federation to fail. [GH-22226]
-
v1.21.123 May 2025Release notes
Open source →FEATURES:
- xds: Extend LUA Script support for API Gateway [GH-22321]
- xds: Added a configurable option to disable XDS session load balancing, intended for scenarios where an external load balancer is used in front of Consul servers, making internal load balancing unnecessary.
IMPROVEMENTS:
- http: Add peer query param on catalog service API [GH-22189]
-
v1.21.006 May 2025Release notes
Open source →- Enhancement: Added support for Consul Session to update the state of a Health Check, allowing for more dynamic and responsive health monitoring within the Consul ecosystem. This feature enables sessions to directly influence health check statuses, improving the overall reliability and accuracy of service health assessments.
-
v1.21.0-rc218 Apr 2025 pre-releaseNothing published for this version
-
v1.21.0-rc106 Mar 2025 pre-releaseNothing published for this version
-
v1.20.624 Apr 2025Nothing published for this version
-
v1.20.511 Mar 2025Nothing published for this version
-
v1.20.420 Feb 2025Nothing published for this version
-
v1.20.313 Feb 2025Release notes
Open source →SECURITY:
- Upgrade Go to use v1.22.11 and bump Go X-Repositories to latest. This addresses CVE CVE-2024-45341 and CVE-2024-45336 [GH-22084]
- Upgrade Go to use v1.22.12 and bump Go X-Repositories to latest. This addresses CVE CVE-2025-22866 [GH-22132]
IMPROVEMENTS:
- connect: update supported envoy versions to 1.33.0, 1.32.3 [GH-22138]
- metadata: memoize the parsed build versions [GH-22113]
BUG FIXES:
- Fixed logging error while building for OpenBSD OS [GH-22120] [GH-22120]
- api-gateway: Fixed TLS configuration to properly enforce listener TLS versions and cipher suites [GH-21984]
- aws-auth: Fix bug where calls to AWS IAM and STS services error out due to URL with multiple trailing slashes. [GH-22109]
-
v1.20.203 Jan 2025Release notes
Open source →SECURITY:
- Removed ability to use bexpr to filter results without ACL read on endpoint [GH-21950]
- Resolved issue where hcl would allow duplicates of the same key in acl policy configuration. [GH-21908]
- Update
github.com/golang-jwt/jwt/v4to v4.5.1 to address GHSA-29wx-vh33-7x7r. [GH-21951] - Update
golang.org/x/cryptoto v0.31.0 to address GO-2024-3321. [GH-22001] - Update
golang.org/x/netto v0.33.0 to address GO-2024-3333. [GH-22021] - Update
registry.access.redhat.com/ubi9-minimalimage to 9.5 to address CVE-2024-3596,CVE-2024-2511,CVE-2024-26458. [GH-22011] - api: Enforces strict content-type header validation to protect against XSS vulnerability. [GH-21930] FEATURES:
- docs: added the docs for the grafana dashboards [GH-21795] BUG FIXES:
- proxycfg: fix a bug where peered upstreams watches are canceled even when another target needs it. [GH-21871]
- state: ensure that identical manual virtual IP updates result in not bumping the modify indexes [GH-21909]
-
v1.20.129 Oct 2024Release notes
Open source →BREAKING CHANGES:
- mesh: Enable Envoy
HttpConnectionManager.normalize_pathby default on inbound traffic to mesh proxies. This resolves CVE-2024-10005. [GH-21816]
SECURITY:
- mesh: Add
containsandignoreCaseto L7 Intentions HTTP header matching criteria to support configuration resilient to variable casing and multiple values. This resolves CVE-2024-10006. [GH-21816] - mesh: Add
http.incoming.requestNormalizationto Mesh configuration entry to support inbound service traffic request normalization. This resolves CVE-2024-10005 and CVE-2024-10006. [GH-21816]
IMPROVEMENTS:
- api: remove dependency on proto-public, protobuf, and grpc [GH-21780]
- snapshot agent: (Enterprise only) Implement Service Principal Auth for snapshot agent on azure.
- xds: configures Envoy to load balance over all instances of an external service configured with hostnames when "envoy_dns_discovery_type" is set to "STRICT_DNS" [GH-21655]
- mesh: Enable Envoy
-
v1.20.014 Oct 2024Release notes
Open source →SECURITY:
- Explicitly set 'Content-Type' header to mitigate XSS vulnerability. [GH-21704]
- Implement HTML sanitization for user-generated content to prevent XSS attacks in the UI. [GH-21711]
- UI: Remove codemirror linting due to package dependency [GH-21726]
- Upgrade Go to use 1.22.7. This addresses CVE CVE-2024-34155 [GH-21705]
- Upgrade to support aws/aws-sdk-go
v1.55.5 or higher. This resolves CVEs CVE-2020-8911 and CVE-2020-8912. [GH-21684] - ui: Pin a newer resolution of Braces [GH-21710]
- ui: Pin a newer resolution of Codemirror [GH-21715]
- ui: Pin a newer resolution of Markdown-it [GH-21717]
- ui: Pin a newer resolution of ansi-html [GH-21735]
FEATURES:
- grafana: added the dashboards service-to-service dashboard, service dashboard, and consul dataplane dashboard [GH-21806]
- server: remove v2 tenancy, catalog, and mesh experiments [GH-21592]
IMPROVEMENTS:
- security: upgrade ubi base image to 9.4 [GH-21750]
- connect: Add Envoy 1.31 and 1.30 to support matrix [GH-21616]
BUG FIXES:
- jwt-provider: change dns lookup family from the default of AUTO which would prefer ipv6 to ALL if LOGICAL_DNS is used or PREFER_IPV4 if STRICT_DNS is used to gracefully handle transitions to ipv6. [GH-21703]
-
v1.20.0-rc1.0.20240920145346-0330d42a79eb20 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-rc120 Sep 2024 pre-releaseRelease notes
Open source →SECURITY:
- Explicitly set 'Content-Type' header to mitigate XSS vulnerability. [GH-21704]
- Implement HTML sanitization for user-generated content to prevent XSS attacks in the UI. [GH-21711]
- UI: Remove codemirror linting due to package dependency [GH-21726]
- Upgrade Go to use 1.22.7. This addresses CVE CVE-2024-34155 [GH-21705]
- Upgrade to support aws/aws-sdk-go
v1.55.5 or higher. This resolves CVEs CVE-2020-8911 and CVE-2020-8912. [GH-21684] - ui: Pin a newer resolution of Braces [GH-21710]
- ui: Pin a newer resolution of Codemirror [GH-21715]
- ui: Pin a newer resolution of Markdown-it [GH-21717]
- ui: Pin a newer resolution of ansi-html [GH-21735]
FEATURES:
- server: remove v2 tenancy, catalog, and mesh experiments [GH-21592]
IMPROVEMENTS:
- security: upgrade ubi base image to 9.4 [GH-21750]
- connect: Add Envoy 1.31 and 1.30 to support matrix [GH-21616]
BUG FIXES:
- jwt-provider: change dns lookup family from the default of AUTO which would prefer ipv6 to ALL if LOGICAL_DNS is used or PREFER_IPV4 if STRICT_DNS is used to gracefully handle transitions to ipv6. [GH-21703]
-
v1.19.227 Aug 2024Release notes
Open source →SECURITY:
- ui: Upgrade modules with d3-color as a dependency to address denial of service issue in d3-color < 3.1.0 [GH-21588]
IMPROVEMENTS:
- Use Envoy's default for a route's validate_clusters option, which is false. This fixes a case where non-existent clusters could cause a route to no longer route to any of its backends, including existing ones. [GH-21587]
BUG FIXES:
- api-gateway: (Enterprise only) ensure clusters are properly created for JWT providers with a remote URI for the JWKS endpoint [GH-21604]
-
v1.19.111 Jul 2024Release notes
Open source →SECURITY:
- Upgrade envoy module dependencies to version 1.27.7, 1.28.5 and 1.29.7 or higher to resolve CVE-2024-39305 [GH-21524]
- Upgrade go version to 1.22.5 to address CVE-2024-24791 [GH-21507]
- Upgrade go-retryablehttp to address CVE-2024-6104 [GH-21384]
- agent: removed reflected cross-site scripting vulnerability [GH-21342]
- ui: Pin and namespace sub-module dependencies related to the Consul UI [GH-21378]
IMPROVEMENTS:
- mesh: update supported envoy version 1.29.5 in addition to 1.28.4, 1.27.6. [GH-21277]
BUG FIXES:
- core: Fix multiple incorrect type conversion for potential overflows [GH-21251]
- core: Fix panic runtime error on AliasCheck [GH-21339]
- dns: Fix a regression where DNS SRV questions were returning duplicate hostnames instead of encoded IPs. This affected Nomad integrations with Consul. [GH-21361]
- dns: Fix a regression where DNS tags using the standard lookup syntax,
tag.name.service.consul, were being disregarded. [GH-21361] - dns: Fixes a spam log message "Failed to parse TTL for prepared query..." that was always being logged on each prepared query evaluation. [GH-21381]
- terminating-gateway: (Enterprise Only) Fixed issue where enterprise metadata applied to linked services was the terminating-gateways enterprise metadata and not the linked services enterprise metadata. [GH-21382]
- txn: Fix a bug where mismatched Consul server versions could result in undetected data loss for when using newer Transaction verbs. [GH-21519]
-
v1.19.012 Jun 2024Release notes
Open source →BREAKING CHANGES:
- telemetry: State store usage metrics with a double
consulelement in the metric name have been removed. Please use the same metric without the secondconsulinstead. As an example instead ofconsul.consul.state.config_entriesuseconsul.state.config_entries[GH-20674]
SECURITY:
- Upgrade to support Envoy
1.27.5 and 1.28.3. This resolves CVE CVE-2024-32475 (auto_sni). [GH-21017] - Upgrade to support k8s.io/apimachinery
v0.18.7 or higher. This resolves CVE CVE-2020-8559. [GH-21017]
FEATURES:
- dns: queries now default to a refactored DNS server that is v1 and v2 Catalog compatible.
Use
v1dnsin theexperimentsagent config to disable. The legacy server will be removed in a future release of Consul. See the Consul 1.19.x Release Notes for removed DNS features. [GH-20715] - gateways: api-gateway can leverage listener TLS certificates available on the gateway's local filesystem by specifying the public certificate and private key path in the new file-system-certificate configuration entry [GH-20873]
IMPROVEMENTS:
- dns: new version was not supporting partition or namespace being set to 'default' in CE version. [GH-21230]
- mesh: update supported envoy version 1.29.4 in addition to 1.28.3, 1.27.5, 1.26.8. [GH-21142]
- upgrade go version to v1.22.4. [GH-21265]
- Upgrade
github.com/envoyproxy/go-control-planeto 0.12.0. [GH-20973] - dns: DNS-over-grpc when using
consul-dataplanenow accepts partition, namespace, token as metadata to default those query parameters.consul-dataplanev1.5+ will send this information automatically. [GH-20899] - snapshot: Add
consul snapshot decodeCLI command to output a JSON object stream of all the snapshots data. [GH-20824] - telemetry: Add
telemetry.disable_per_tenancy_usage_metricsin agent configuration to disable setting tenancy labels on usage metrics. This significantly decreases CPU utilization in clusters with many admin partitions or namespaces. - telemetry: Improved the performance usage metrics emission by not outputting redundant metrics. [GH-20674]
DEPRECATIONS:
- snapshot agent: (Enterprise only) Top level single snapshot destinations
local_storage,aws_storage,azure_blob_storage, andgoogle_storagein snapshot agent configuration files are now deprecated. Use thebackup_destinationsconfig object instead.
BUG FIXES:
- docs: Consul DNS Forwarding configuration for OpenShift update for Resolve Consul DNS Requests in Kubernetes [GH-20439]
- hcp: fix error logs when failing to push metrics [GH-20514]
- streaming: Handle ACL errors consistently when blocking query timeout is reached. [GH-20876]
- telemetry: State store usage metrics with a double
-
v1.18.216 May 2024Release notes
Open source →Enterprise LTS: Consul Enterprise 1.18 is a Long-Term Support (LTS) release.
SECURITY:
- Bump Dockerfile base image to
alpine:3.19. [GH-20897] - Update
vault/apito v1.12.2 to address CVE-2024-28180 (removes indirect dependency on impactedgo-jose.v2) [GH-20910] - Upgrade Go to use 1.21.10. This addresses CVEs CVE-2024-24787 and CVE-2024-24788 [GH-21074]
- Upgrade to support Envoy
1.26.8, 1.27.4, 1.27.5, 1.28.2 and 1.28.3. This resolves CVEs CVE-2024-27919 (http2). [GH-20956] and CVE-2024-32475 (auto_sni). [GH-21030] - Upgrade to support k8s.io/apimachinery
v0.18.7 or higher. This resolves CVE CVE-2020-8559. [GH-21034] - Upgrade to use Go
1.21.9. This resolves CVE CVE-2023-45288 (http2). [GH-20956] - Upgrade to use golang.org/x/net
v0.24.0. This resolves CVE CVE-2023-45288 (x/net). [GH-20956]
IMPROVEMENTS:
- gateways: service defaults configuration entries can now be used to set default upstream limits for mesh-gateways [GH-20945]
- connect: Add ability to disable Auto Host Header Rewrite on Terminating Gateway at the service level [GH-20802]
BUG FIXES:
- dns: fix a bug with sameness group queries in DNS where responses did not respect
DefaultForFailover. DNS requests against sameness groups without this field set will now error as intended. - error running consul server in 1.18.0: failed to configure SCADA provider user's home directory path: $HOME is not defined [GH-20926]
- server: fix Ent snapshot restore on CE when CE downgrade is enabled [GH-20977]
- xds: Make TCP external service registered with terminating gateway reachable from peered cluster [GH-19881]
- Bump Dockerfile base image to
-
v1.18.126 Mar 2024Release notes
Open source →Enterprise LTS: Consul Enterprise 1.18 is a Long-Term Support (LTS) release.
BREAKING CHANGES:
- ui: Adds a "Link to HCP Consul Central" modal with integration to side-nav and link to HCP banner. There will be an option to disable the Link to HCP banner from the UI in a follow-up release. [GH-20474]
SECURITY:
- Update
google.golang.org/protobufto v1.33.0 to address CVE-2024-24786. [GH-20801] - Update the Consul Build Go base image to
alpine3.19. This resolves CVEs CVE-2023-52425 CVE-2023-52426 [GH-20812] - Upgrade to use Go
1.21.8. This resolves CVEs CVE-2024-24783 (crypto/x509). CVE-2023-45290 (net/http). CVE-2023-45289 (net/http,net/http/cookiejar). CVE-2024-24785 (html/template). CVE-2024-24784 (net/mail). [GH-20812]
IMPROVEMENTS:
- api: Randomize the returned server list for the WatchServers gRPC endpoint. [GH-20866]
- partitions: (Enterprise only) Allow disabling of Gossip per Partition [GH-20669]
- snapshot agent: (Enterprise only) Add support for multiple snapshot destinations using the
backup_destinationsconfig file object. - xds: Improved the performance of xDS server side load balancing. Its slightly improved in Consul CE with drastic CPU usage reductions in Consul Enterprise. [GH-20672]
BUG FIXES:
- audit-logs: (Enterprise Only) Fixes non ASCII characters in audit logs because of gzip. [GH-20345]
- connect: Fix issue where Consul-dataplane xDS sessions would not utilize the streaming backend for wan-federated queries. [GH-20868]
- connect: Fix potential goroutine leak in xDS stream handling. [GH-20866]
- connect: Fix xDS deadlock that could result in proxies being unable to start. [GH-20867]
- ingress-gateway: (Enterprise Only) Fix a bug where on update, Ingress Gateways lost all upstreams for listeners with wildcard services in a different namespace.
-
v1.18.026 Feb 2024Release notes
Open source →BREAKING CHANGES:
- config-entries: Allow disabling request and idle timeouts with negative values in service router and service resolver config entries. [GH-19992]
- telemetry: Adds fix to always use the value of
telemetry.disable_hostnamewhen determining whether to prefix gauge-type metrics with the hostname of the Consul agent. Previously, if only the default metric sink was enabled, this configuration was ignored and always treated astrue, even though its default value isfalse. [GH-20312]
SECURITY:
- Update
golang.org/x/cryptoto v0.17.0 to address CVE-2023-48795. [GH-20023] - connect: Update supported envoy versions to 1.24.12, 1.25.11, 1.26.6, 1.27.2 to address CVE-2023-44487 [GH-19306]
- mesh: Update Envoy versions to 1.28.1, 1.27.3, and 1.26.7 to address CVE-2024-23324, CVE-2024-23325, CVE-2024-23322, CVE-2024-23323, CVE-2024-23327, CVE-2023-44487, GH-20589], CVE-2023-44487, and [GH-19879]
FEATURES:
- acl: add policy bindtype to binding rules. [GH-19499]
- agent: Introduces a new agent config default_intention_policy to decouple the default intention behavior from ACLs [GH-20544]
- agent: (Enterprise Only) Add fault injection filter support for Consul Service Mesh
- cloud: Adds new API/CLI to initiate and manage linking a Consul cluster to HCP Consul Central [GH-20312]
- dns: adds experimental support for a refactored DNS server that is v1 and v2 Catalog compatible.
Use
v2dnsin theexperimentsagent config to enable. It will automatically be enabled when using theresource-apis(Catalog v2) experiment. The new DNS implementation will be the default in Consul 1.19. See the Consul 1.18.x Release Notes for deprecated DNS features. [GH-20643] - ui: Added a banner to let users link their clusters to HCP [GH-20275]
- ui: Adds a redirect and warning message around unavailable UI with V2 enabled [GH-20359]
- ui: adds V2CatalogEnabled to config that is passed to the ui [GH-20353]
- v2: prevent use of the v2 experiments in secondary datacenters for now [GH-20299]
IMPROVEMENTS:
- cloud: unconditionally add Access-Control-Expose-Headers HTTP header [GH-20220]
- connect: Replace usage of deprecated Envoy field
envoy.config.core.v3.HeaderValueOption.append. [GH-20078] - connect: Replace usage of deprecated Envoy fields
envoy.config.route.v3.HeaderMatcher.safe_regex_matchandenvoy.type.matcher.v3.RegexMatcher.google_re2. [GH-20013] - docs: add Link API documentation [GH-20308]
- resource: lowercase names enforced for v2 resources only. [GH-19218]
BUG FIXES:
- dns: SERVFAIL when resolving not found PTR records. [GH-20679]
- raft: Fix panic during downgrade from enterprise to oss. [GH-19311]
- server: Ensure controllers are automatically restarted on internal stream errors. [GH-20642]
- server: Ensure internal streams are properly terminated on snapshot restore. [GH-20642]
- snapshot-agent: (Enterprise only) Fix a bug with static AWS credentials where one of the key id or secret key is provided via config file and the other is provided via an environment variable.
-
v1.18.0-rc106 Feb 2024 pre-releaseNothing published for this version
-
v1.17.426 Mar 2024Release notes
Open source →SECURITY:
- Update
google.golang.org/protobufto v1.33.0 to address CVE-2024-24786. [GH-20801] - Update the Consul Build Go base image to
alpine3.19. This resolves CVEs CVE-2023-52425 CVE-2023-52426 [GH-20812] - Upgrade to use Go
1.21.8. This resolves CVEs CVE-2024-24783 (crypto/x509). CVE-2023-45290 (net/http). CVE-2023-45289 (net/http,net/http/cookiejar). CVE-2024-24785 (html/template). CVE-2024-24784 (net/mail). [GH-20812]
IMPROVEMENTS:
- api: Randomize the returned server list for the WatchServers gRPC endpoint. [GH-20866]
- snapshot agent: (Enterprise only) Add support for multiple snapshot destinations using the
backup_destinationsconfig file object.
BUG FIXES:
- connect: Fix issue where Consul-dataplane xDS sessions would not utilize the streaming backend for wan-federated queries. [GH-20868]
- connect: Fix potential goroutine leak in xDS stream handling. [GH-20866]
- connect: Fix xDS deadlock that could result in proxies being unable to start. [GH-20867]
- dns: SERVFAIL when resolving not found PTR records. [GH-20679]
- ingress-gateway: (Enterprise Only) Fix a bug where on update, Ingress Gateways lost all upstreams for listeners with wildcard services in a different namespace.
- snapshot-agent: (Enterprise only) Fix a bug with static AWS credentials where one of the key id or secret key is provided via config file and the other is provided via an environment variable.
- Update
-
v1.17.313 Feb 2024Release notes
Open source →SECURITY:
- mesh: Update Envoy versions to 1.27.3 and 1.26.7 to address CVE-2024-23324, CVE-2024-23325, CVE-2024-23322, CVE-2024-23323, CVE-2024-23327, and CVE-2023-44487 [GH-20587]
FEATURES:
- cli: Adds new command
exported-servicesto list all services exported and their consumers. Refer to the CLI docs for more information. [GH-20331]
IMPROVEMENTS:
- ProxyCfg: avoid setting a watch on
Internal.ServiceDumpwhen mesh gateway is not used. [GH-20168] - ProxyCfg: only return the nodes list when querying the
Internal.ServiceDumpwatch from proxycfg [GH-20168] - Upgrade to use Go 1.21.7. [GH-20545]
- api: add a new api(/v1/exported-services) to list all the exported service and their consumers. [GH-20015]
- connect: Add
CaseInsensitiveflag to service-routers that allows paths and path prefixes to ignore URL upper and lower casing. [GH-19647]
BUG FIXES:
- audit-logs: (Enterprise Only) Fixes non ASCII characters in audit logs because of gzip. [GH-20345]
- connect: Fix issue where re-persisting existing proxy-defaults using
httpprotocol fails with a protocol-mismatch error. [GH-20481] - connect: Fix regression with SAN matching on terminating gateways GH-20360 [GH-20417]
- connect: Remove code coupling where the xDS capacity controller could negatively affect raft autopilot performance. [GH-20511]
- logging: add /api prefix to v2 resource endpoint logs [GH-20352]
- mesh: Fix bug where envoy extensions could not be configured with "permissive" mTLS mode. Note that envoy extensions currently do not apply to non-mTLS traffic in permissive mode. [GH-20406]
-
v1.17.222 Jan 2024Release notes
Open source →KNOWN ISSUES:
- connect: Consul versions 1.17.2 and 1.16.5 perform excessively strict TLS SAN verification on terminating gateways, which prevents connections outside of the mesh to upstream services. Terminating gateway users are advised to avoid deploying these Consul versions. A fix will be present in a future release of Consul 1.17.3 and 1.16.6. [GH-20360]
SECURITY:
- Upgrade OpenShift container images to use
ubi9-minimal:9.3as the base image. [GH-20014]
IMPROVEMENTS:
- connect: Remove usage of deprecated Envoy field
match_subject_alt_namesin favor ofmatch_typed_subject_alt_names. [GH-19954] - connect: replace usage of deprecated Envoy field
envoy.config.router.v3.WeightedCluster.total_weight. [GH-20011] - xds: Replace usage of deprecated Envoy field
envoy.config.cluster.v3.Cluster.http_protocol_options[GH-20010] - xds: remove usages of deprecated Envoy fields:
envoy.config.cluster.v3.Cluster.http2_protocol_options,envoy.config.bootstrap.v3.Admin.access_log_path[GH-19940] - xds: replace usage of deprecated Envoy field
envoy.extensions.filters.http.lua.v3.Lua.inline_code[GH-20012]
DEPRECATIONS:
- cli: Deprecate the
-admin-access-log-pathflag fromconsul connect envoycommand in favor of:-admin-access-log-config. [GH-19943]
BUG FIXES:
- prepared-query: (Enterprise-only) Fix issue where sameness-group failover targets to peers would attempt to query data from the default partition, rather than the sameness-group's partition always.
- ui: update token list on Role details page to show only linked tokens [GH-19912]
-
v1.17.112 Dec 2023Release notes
Open source →SECURITY:
- Update
github.com/golang-jwt/jwt/v4to v4.5.0 to address PRISMA-2022-0270. [GH-19705] - Upgrade to use Go 1.20.12. This resolves CVEs
CVE-2023-45283: (
path/filepath) recognize ??\ as a Root Local Device path prefix (Windows) CVE-2023-45284: recognize device names with trailing spaces and superscripts (Windows) CVE-2023-39326: (net/http) limit chunked data overhead CVE-2023-45285: (cmd/go) go get may unexpectedly fallback to insecure git [GH-19840] - connect: update supported envoy versions to 1.24.12, 1.25.11, 1.26.6, 1.27.2 to address CVE-2023-44487 [GH-19274]
FEATURES:
- acl: Adds nomad client templated policy [GH-19827]
- cli: Adds new subcommand
peering exported-servicesto list services exported to a peer . Refer to the CLI docs for more information. [GH-19821]
IMPROVEMENTS:
- mesh: parse the proxy-defaults protocol when write the config-entry to avoid parsing it when compiling the discovery chain. [GH-19829]
- wan-federation: use a hash to diff config entries when replicating in the secondary DC to avoid unnecessary writes.. [GH-19795]
- Replaces UI Side Nav with Helios Design System Side Nav. Adds dc/partition/namespace searching in Side Nav. [GH-19342]
- acl: add api-gateway templated policy [GH-19728]
- acl: add templated policy descriptions [GH-19735]
- api: Add support for listing ACL tokens by service name when using templated policies. [GH-19666]
- cli: stop simultaneous usage of -templated-policy and -templated-policy-file when creating a role or token. [GH-19389]
- cloud: push additional server TLS metadata to HCP [GH-19682]
- connect: Default
stats_flush_intervalto 60 seconds when using the Consul Telemetry Collector, unless custom stats sink are present or an explicit flush interval is configured. [GH-19663] - metrics: increment consul.client.rpc.failed if RPC fails because no servers are accessible [GH-19721]
- metrics: modify consul.client.rpc metric to exclude internal retries for consistency with consul.client.rpc.exceeded and consul.client.rpc.failed [GH-19721]
- ui: move nspace and partitions requests into their selector menus [GH-19594]
BUG FIXES:
- CLI: fix a panic when deleting a non existing policy by name. [GH-19679]
- Mesh Gateways: Fix a bug where replicated and peered mesh gateways with hostname-based WAN addresses fail to initialize. [GH-19268]
- ca: Fix bug with Vault CA provider where renewing a retracted token would cause retries in a tight loop, degrading performance. [GH-19285]
- ca: Fix bug with Vault CA provider where token renewal goroutines could leak if CA failed to initialize. [GH-19285]
- connect: Solves an issue where two upstream services with the same name in different namespaces were not getting routed to correctly by API Gateways. [GH-19860]
- federation: (Enterprise Only) Fixed an issue where namespace reconciliation could result into the secondary having dangling instances of namespaces marked for deletion
- ui: clear peer on home logo link [GH-19549]
- ui: fix being able to view peered services from non-default namnespaces [GH-19586]
- ui: stop manually reconciling services if peering is enabled [GH-19907]
- wan-federation: Fix a bug where servers wan-federated through mesh-gateways could crash due to overlapping LAN IP addresses. [GH-19503]
- xds: Add configurable
xds_fetch_timeout_msoption to proxy registrations that allows users to prevent endpoints from dropping when they have proxies with a large number of upstreams. [GH-19871] - xds: ensure child resources are re-sent to Envoy when the parent is updated even if the child already has pending updates. [GH-19866]
- Update
-
v1.17.003 Nov 2023Release notes
Open source →BREAKING CHANGES:
- api: RaftLeaderTransfer now requires an id string. An empty string can be specified to keep the old behavior. [GH-17107]
- audit-logging: (Enterprise only) allowing timestamp based filename only on rotation. initially the filename will be just file.json [GH-18668]
DEPRECATIONS:
- cli: Deprecate the
-admin-access-log-pathflag fromconsul connect envoycommand in favor of:-admin-access-log-config. [GH-15946]
SECURITY:
- Update
golang.org/x/netto v0.17.0 to address CVE-2023-39325 / CVE-2023-44487(x/net/http2). [GH-19225] - Upgrade Go to 1.20.10.
This resolves vulnerability CVE-2023-39325
/ CVE-2023-44487(
net/http). [GH-19225] - Upgrade
google.golang.org/grpcto 1.56.3. This resolves vulnerability CVE-2023-44487. [GH-19414] - connect: update supported envoy versions to 1.24.12, 1.25.11, 1.26.6, 1.27.2 to address CVE-2023-44487 [GH-19275]
FEATURE PREVIEW: Catalog v2
This release provides the ability to preview Consul's v2 Catalog and Resource API if enabled. The new model supports multi-port application deployments with only a single Envoy proxy. Note that the v1 and v2 catalogs are not cross compatible, and not all Consul features are available within this v2 feature preview. See the v2 Catalog and Resource API documentation for more information. The v2 Catalog and Resources API should be considered a feature preview within this release and should not be used in production environments.
Limitations
- The v2 catalog API feature preview does not support connections with client agents. As a result, it is only available for Kubernetes deployments, which use Consul dataplanes instead of client agents.
- The v1 and v2 catalog APIs cannot run concurrently.
- The Consul UI does not support multi-port services or the v2 catalog API in this release.
- HCP Consul does not support multi-port services or the v2 catalog API in this release.
Significant Pull Requests
- [Catalog resource controllers]
- [Mesh resource controllers]
- [Auth resource controllers]
- [V2 Protobufs]
FEATURES:
- Support custom watches on the Consul Controller framework. [GH-18439]
- Windows: support consul connect envoy command on Windows [GH-17694]
- acl: Add BindRule support for templated policies. Add new BindType: templated-policy and BindVar field for templated policy variables. [GH-18719]
- acl: Add new
acl.tokens.dnsconfig field which specifies the token used implicitly during dns checks. [GH-17936] - acl: Added ACL Templated policies to simplify getting the right ACL token. [GH-18708]
- acl: Adds a new ACL rule for workload identities [GH-18769]
- acl: Adds workload identity templated policy [GH-19077]
- api-gateway: Add support for response header modifiers on http-route configuration entry [GH-18646]
- api-gateway: add retry and timeout filters [GH-18324]
- cli: Add
bind-varflag toconsul acl binding-rulefor templated policy variables. [GH-18719] - cli: Add
consul acl templated-policycommands to read, list and preview templated policies. [GH-18816] - config-entry(api-gateway): (Enterprise only) Add GatewayPolicy to APIGateway Config Entry listeners
- config-entry(api-gateway): (Enterprise only) Add JWTFilter to HTTPRoute Filters
- dataplane: Allow getting bootstrap parameters when using V2 APIs [GH-18504]
- gateway: (Enterprise only) Add JWT authentication and authorization to APIGateway Listeners and HTTPRoutes.
- mesh: (Enterprise only) Adds rate limiting config to service-defaults [GH-18583]
- xds: Add a built-in Envoy extension that appends OpenTelemetry Access Logging (otel-access-logging) to the HTTP Connection Manager filter. [GH-18336]
- xds: Add support for patching outbound listeners to the built-in Envoy External Authorization extension. [GH-18336]
IMPROVEMENTS:
- raft: upgrade raft-wal library version to 0.4.1. [GH-19314]
- xds: Use downstream protocol when connecting to local app [GH-18573]
- Windows: Integration tests for Consul Windows VMs [GH-18007]
- acl: Use templated policy to generate synthetic policies for tokens/roles with node and/or service identities [GH-18813]
- api: added
CheckRegisterOptsto Agent API [GH-18943] - api: added
Tokenfield toServiceRegisterOptstype in Agent API [GH-18983] - ca: Vault CA provider config no longer requires root_pki_path for secondary datacenters [GH-17831]
- cli: Added
-templated-policy,-templated-policy-file,-replace-templated-policy,-append-templated-policy,-replace-templated-policy-file,-append-templated-policy-fileand-varflags for creating or updating tokens/roles. [GH-18708] - config: Add new
tls.defaults.verify_server_hostnameconfiguration option. This specifies the default value for any interfaces that support theverify_server_hostnameoption. [GH-17155] - connect: update supported envoy versions to 1.24.10, 1.25.9, 1.26.4, 1.27.0 [GH-18300]
- ui: Use Community verbiage [GH-18560]
BUG FIXES:
- api: add custom marshal/unmarshal for ServiceResolverConfigEntry.RequestTimeout so config entries that set this field can be read using the API. [GH-19031]
- ca: ensure Vault CA provider respects Vault Enterprise namespace configuration. [GH-19095]
- catalog api: fixes a bug with catalog api where filter query parameter was not working correctly for the
/v1/catalog/servicesendpoint [GH-18322] - connect: (Enterprise only) Fix bug where incorrect service-defaults entries were fetched to determine an upstream's protocol whenever the upstream did not explicitly define the namespace / partition. When this bug occurs, upstreams would use the protocol from a service-default entry in the default namespace / partition, rather than their own namespace / partition.
- connect: Fix bug where uncleanly closed xDS connections would influence connection balancing for too long and prevent envoy instances from starting. Two new configuration fields
performance.grpc_keepalive_timeoutandperformance.grpc_keepalive_intervalnow exist to allow for configuration on how often these dead connections will be cleaned up. [GH-19339] - dev-mode: Fix dev mode has new line in responses. Now new line is added only when url has pretty query parameter. [GH-18367]
- dns: (Enterprise only) Fix bug where sameness group queries did not correctly inherit the agent's partition.
- docs: fix list of telemetry metrics [GH-17593]
- gateways: Fix a bug where a service in a peered datacenter could not access an external node service through a terminating gateway [GH-18959]
- server: (Enterprise Only) Fixed an issue where snake case keys were rejected when configuring the control-plane-request-limit config entry
- telemetry: emit consul version metric on a regular interval. [GH-6876]
- tlsutil: Default setting of ServerName field in outgoing TLS configuration for checks now handled by crypto/tls. [GH-17481]
-
v1.17.0-rc106 Oct 2023 pre-releaseRelease notes
Open source →BREAKING CHANGES:
- api: RaftLeaderTransfer now requires an id string. An empty string can be specified to keep the old behavior. [GH-17107]
- audit-logging: (Enterprise only) allowing timestamp based filename only on rotation. initially the filename will be just file.json [GH-18668]
FEATURE PREVIEW: Catalog v2
This release provides the ability to preview Consul's v2 Catalog and Resource API if enabled. The new model supports multi-port application deployments with only a single Envoy proxy. Note that the v1 and v2 catalogs are not cross compatible, and not all Consul features are available within this v2 feature preview. See the v2 Catalog and Resource API documentation for more information. The v2 Catalog and Resources API should be considered a feature preview within this release and should not be used in production environments.
Limitations
- The v2 catalog API feature preview does not support connections with client agents. As a result, it is only available for Kubernetes deployments, which use Consul dataplanes instead of client agents.
- The v1 and v2 catalog APIs cannot run concurrently.
- The Consul UI does not support multi-port services or the v2 catalog API in this release.
- HCP Consul does not support multi-port services or the v2 catalog API in this release.
- The v2 API only supports transparent proxy mode where services that have permissions to connect to each other can use Kube DNS to connect.
Known Issues
- When using the v2 API with transparent proxy, Kubernetes pods cannot use L7 liveness, readiness, or startup probes.
Significant Pull Requests
- [Catalog resource controllers]
- [Mesh resource controllers]
- [Auth resource controllers]
- [V2 Protobufs]
FEATURES:
- Support custom watches on the Consul Controller framework. [GH-18439]
- Windows: support consul connect envoy command on Windows [GH-17694]
- acl: Add BindRule support for templated policies. Add new BindType: templated-policy and BindVar field for templated policy variables. [GH-18719]
- acl: Add new
acl.tokens.dnsconfig field which specifies the token used implicitly during dns checks. [GH-17936] - acl: Added ACL Templated policies to simplify getting the right ACL token. [GH-18708]
- acl: Adds a new ACL rule for workload identities [GH-18769]
- api-gateway: Add support for response header modifiers on http-route configuration entry [GH-18646]
- api-gateway: add retry and timeout filters [GH-18324]
- cli: Add
bind-varflag toconsul acl binding-rulefor templated policy variables. [GH-18719] - cli: Add
consul acl templated-policycommands to read, list and preview templated policies. [GH-18816] - config-entry(api-gateway): (Enterprise only) Add GatewayPolicy to APIGateway Config Entry listeners
- config-entry(api-gateway): (Enterprise only) Add JWTFilter to HTTPRoute Filters
- dataplane: Allow getting bootstrap parameters when using V2 APIs [GH-18504]
- gateway: (Enterprise only) Add JWT authentication and authorization to APIGateway Listeners and HTTPRoutes.
- mesh: (Enterprise only) Adds rate limiting config to service-defaults [GH-18583]
- xds: Add a built-in Envoy extension that appends OpenTelemetry Access Logging (otel-access-logging) to the HTTP Connection Manager filter. [GH-18336]
- xds: Add support for patching outbound listeners to the built-in Envoy External Authorization extension. [GH-18336]
IMPROVEMENTS:
- xds: Use downstream protocol when connecting to local app [GH-18573]
- Windows: Integration tests for Consul Windows VMs [GH-18007]
- acl: Use templated policy to generate synthetic policies for tokens/roles with node and/or service identities [GH-18813]
- api: added
CheckRegisterOptsto Agent API [GH-18943] - api: added
Tokenfield toServiceRegisterOptstype in Agent API [GH-18983] - ca: Vault CA provider config no longer requires root_pki_path for secondary datacenters [GH-17831]
- cli: Added
-templated-policy,-templated-policy-file,-replace-templated-policy,-append-templated-policy,-replace-templated-policy-file,-append-templated-policy-fileand-varflags for creating or updating tokens/roles. [GH-18708] - config: Add new
tls.defaults.verify_server_hostnameconfiguration option. This specifies the default value for any interfaces that support theverify_server_hostnameoption. [GH-17155] - connect: update supported envoy versions to 1.24.10, 1.25.9, 1.26.4, 1.27.0 [GH-18300]
- ui: Use Community verbiage [GH-18560]
BUG FIXES:
- api: add custom marshal/unmarshal for ServiceResolverConfigEntry.RequestTimeout so config entries that set this field can be read using the API. [GH-19031]
- dev-mode: Fix dev mode has new line in responses. Now new line is added only when url has pretty query parameter. [GH-18367]
- telemetry: emit consul version metric on a regular interval. [GH-6876]
- tlsutil: Default setting of ServerName field in outgoing TLS configuration for checks now handled by crypto/tls. [GH-17481]
-
v1.16.726 Mar 2024Release notes
Open source →SECURITY:
- Update
google.golang.org/protobufto v1.33.0 to address CVE-2024-24786. [GH-20801] - Update the Consul Build Go base image to
alpine3.19. This resolves CVEs CVE-2023-52425 CVE-2023-52426 [GH-20812] - Upgrade to use Go
1.21.8. This resolves CVEs CVE-2024-24783 (crypto/x509). CVE-2023-45290 (net/http). CVE-2023-45289 (net/http,net/http/cookiejar). CVE-2024-24785 (html/template). CVE-2024-24784 (net/mail). [GH-20812]
IMPROVEMENTS:
- api: Randomize the returned server list for the WatchServers gRPC endpoint. [GH-20866]
- snapshot agent: (Enterprise only) Add support for multiple snapshot destinations using the
backup_destinationsconfig file object.
BUG FIXES:
- connect: Fix issue where Consul-dataplane xDS sessions would not utilize the streaming backend for wan-federated queries. [GH-20868]
- connect: Fix potential goroutine leak in xDS stream handling. [GH-20866]
- connect: Fix xDS deadlock that could result in proxies being unable to start. [GH-20867]
- ingress-gateway: (Enterprise Only) Fix a bug where on update, Ingress Gateways lost all upstreams for listeners with wildcard services in a different namespace.
- snapshot-agent: (Enterprise only) Fix a bug with static AWS credentials where one of the key id or secret key is provided via config file and the other is provided via an environment variable.
- Update
-
v1.16.613 Feb 2024Release notes
Open source →SECURITY:
- mesh: Update Envoy version to 1.26.7 to address CVE-2024-23324, CVE-2024-23325, CVE-2024-23322, CVE-2024-23323, CVE-2024-23327, and CVE-2023-44487 [GH-20586]
IMPROVEMENTS:
- ProxyCfg: avoid setting a watch on
Internal.ServiceDumpwhen mesh gateway is not used. [GH-20168] - ProxyCfg: only return the nodes list when querying the
Internal.ServiceDumpwatch from proxycfg [GH-20168] - Upgrade to use Go 1.21.7. [GH-20545]
BUG FIXES:
- audit-logs: (Enterprise Only) Fixes non ASCII characters in audit logs because of gzip. [GH-20345]
- connect: Fix issue where re-persisting existing proxy-defaults using
httpprotocol fails with a protocol-mismatch error. [GH-20481] - connect: Fix regression with SAN matching on terminating gateways GH-20360 [GH-20417]
- connect: Remove code coupling where the xDS capacity controller could negatively affect raft autopilot performance. [GH-20511]
- mesh: Fix bug where envoy extensions could not be configured with "permissive" mTLS mode. Note that envoy extensions currently do not apply to non-mTLS traffic in permissive mode. [GH-20406]
-
v1.16.518 Jan 2024Release notes
Open source →KNOWN ISSUES:
- connect: Consul versions 1.17.2 and 1.16.5 perform excessively strict TLS SAN verification on terminating gateways, which prevents connections outside of the mesh to upstream services. Terminating gateway users are advised to avoid deploying these Consul versions. A fix will be present in a future release of Consul 1.17.3 and 1.16.6 [GH-20360].
SECURITY:
- Update RSA key generation to use a key size of at least 2048 bits. [GH-20112]
- Upgrade OpenShift container images to use
ubi9-minimal:9.3as the base image. [GH-20014]
IMPROVEMENTS:
- Upgrade to use Go 1.21.6. [GH-20062]
- connect: Remove usage of deprecated Envoy field
match_subject_alt_namesin favor ofmatch_typed_subject_alt_names. [GH-19954] - connect: replace usage of deprecated Envoy field
envoy.config.router.v3.WeightedCluster.total_weight. [GH-20011] - xds: Replace usage of deprecated Envoy field
envoy.config.cluster.v3.Cluster.http_protocol_options[GH-20010] - xds: remove usages of deprecated Envoy fields:
envoy.config.cluster.v3.Cluster.http2_protocol_options,envoy.config.bootstrap.v3.Admin.access_log_path[GH-19940] - xds: replace usage of deprecated Envoy field
envoy.extensions.filters.http.lua.v3.Lua.inline_code[GH-20012]
BUG FIXES:
- prepared-query: (Enterprise-only) Fix issue where sameness-group failover targets to peers would attempt to query data from the default partition, rather than the sameness-group's partition always.
- ui: update token list on Role details page to show only linked tokens [GH-19912]
-
v1.16.412 Dec 2023Release notes
Open source →SECURITY:
- Update
github.com/golang-jwt/jwt/v4to v4.5.0 to address PRISMA-2022-0270. [GH-19705] - Upgrade to use Go 1.20.12. This resolves CVEs
CVE-2023-45283: (
path/filepath) recognize ??\ as a Root Local Device path prefix (Windows) CVE-2023-45284: recognize device names with trailing spaces and superscripts (Windows) CVE-2023-39326: (net/http) limit chunked data overhead CVE-2023-45285: (cmd/go) go get may unexpectedly fallback to insecure git [GH-19840]
IMPROVEMENTS:
- mesh: parse the proxy-defaults protocol when write the config-entry to avoid parsing it when compiling the discovery chain. [GH-19829]
- wan-federation: use a hash to diff config entries when replicating in the secondary DC to avoid unnecessary writes.. [GH-19795]
- cli: Adds cli support for checking TCP connection for ports. If -ports flag is not given, it will check for default ports of consul listed here - https://developer.hashicorp.com/consul/docs/install/ports [GH-18329]
- cloud: push additional server TLS metadata to HCP [GH-19682]
- connect: Default
stats_flush_intervalto 60 seconds when using the Consul Telemetry Collector, unless custom stats sink are present or an explicit flush interval is configured. [GH-19663] - metrics: increment consul.client.rpc.failed if RPC fails because no servers are accessible [GH-19721]
- metrics: modify consul.client.rpc metric to exclude internal retries for consistency with consul.client.rpc.exceeded and consul.client.rpc.failed [GH-19721]
BUG FIXES:
- CLI: fix a panic when deleting a non existing policy by name. [GH-19679]
- connect: Solves an issue where two upstream services with the same name in different namespaces were not getting routed to correctly by API Gateways. [GH-19860]
- federation: (Enterprise Only) Fixed an issue where namespace reconciliation could result into the secondary having dangling instances of namespaces marked for deletion
- ui: only show hcp link if url is present [GH-19443]
- wan-federation: Fix a bug where servers wan-federated through mesh-gateways could crash due to overlapping LAN IP addresses. [GH-19503]
- xds: Add configurable
xds_fetch_timeout_msoption to proxy registrations that allows users to prevent endpoints from dropping when they have proxies with a large number of upstreams. [GH-19871] - xds: ensure child resources are re-sent to Envoy when the parent is updated even if the child already has pending updates. [GH-19866]
- Update
-
v1.16.331 Oct 2023Release notes
Open source →SECURITY:
- Update
golang.org/x/netto v0.17.0 to address CVE-2023-39325 / CVE-2023-44487(x/net/http2). [GH-19225] - Upgrade Go to 1.20.10.
This resolves vulnerability CVE-2023-39325
/ CVE-2023-44487(
net/http). [GH-19225] - Upgrade
google.golang.org/grpcto 1.56.3. This resolves vulnerability CVE-2023-44487. [GH-19414] - connect: update supported envoy versions to 1.24.12, 1.25.11, 1.26.6 to address CVE-2023-44487 [GH-19273]
BUG FIXES:
- Mesh Gateways: Fix a bug where replicated and peered mesh gateways with hostname-based WAN addresses fail to initialize. [GH-19268]
- api-gateway: fix matching for different hostnames on the same listener [GH-19120]
- api: add custom marshal/unmarshal for ServiceResolverConfigEntry.RequestTimeout so config entries that set this field can be read using the API. [GH-19031]
- ca: Fix bug with Vault CA provider where renewing a retracted token would cause retries in a tight loop, degrading performance. [GH-19285]
- ca: Fix bug with Vault CA provider where token renewal goroutines could leak if CA failed to initialize. [GH-19285]
- ca: ensure Vault CA provider respects Vault Enterprise namespace configuration. [GH-19095]
- catalog api: fixes a bug with catalog api where filter query parameter was not working correctly for the
/v1/catalog/servicesendpoint [GH-18322] - connect: Fix bug where uncleanly closed xDS connections would influence connection balancing for too long and prevent envoy instances from starting. Two new configuration fields
performance.grpc_keepalive_timeoutandperformance.grpc_keepalive_intervalnow exist to allow for configuration on how often these dead connections will be cleaned up. [GH-19339] - dns: (Enterprise only) Fix bug where sameness group queries did not correctly inherit the agent's partition.
- gateways: Fix a bug where a service in a peered datacenter could not access an external node service through a terminating gateway [GH-18959]
- server: (Enterprise Only) Fixed an issue where snake case keys were rejected when configuring the control-plane-request-limit config entry
- Update
-
v1.16.219 Sep 2023Release notes
Open source →SECURITY:
- Upgrade to use Go 1.20.8. This resolves CVEs
CVE-2023-39320 (
cmd/go), CVE-2023-39318 (html/template), CVE-2023-39319 (html/template), CVE-2023-39321 (crypto/tls), and CVE-2023-39322 (crypto/tls) [GH-18742]
IMPROVEMENTS:
- Adds flag -append-filename (which works on values version, dc, node and status) to consul snapshot save command. Adding the flag -append-filename version,dc,node,status will add consul version, consul datacenter, node name and leader/follower (status) in the file name given in the snapshot save command before the file extension. [GH-18625]
- Reduce the frequency of metric exports from Consul to HCP from every 10s to every 1m [GH-18584]
- api: Add support for listing ACL tokens by service name. [GH-18667]
- checks: It is now possible to configure agent TCP checks to use TLS with
optional server SNI and mutual authentication. To use TLS with a TCP check, the
check must enable the
tcp_use_tlsboolean. By default the agent will use the TLS configuration in thetls.defaultstanza. [GH-18381] - command: Adds -since flag in consul debug command which internally calls hcdiag for debug information in the past. [GH-18797]
- log: Currently consul logs files like this consul-{timestamp}.log. This change makes sure that there is always consul.log file with the latest logs in it. [GH-18617]
BUG FIXES:
- Inherit locality from services when registering sidecar proxies. [GH-18437]
- UI : Nodes list view was breaking for synthetic-nodes. Fix handles non existence of consul-version meta for node. [GH-18464]
- api: Fix
/v1/agent/selfnot returning latest configuration [GH-18681] - ca: Vault provider now cleans up the previous Vault issuer and key when generating a new leaf signing certificate [GH-18779] [GH-18773]
- check: prevent go routine leakage when existing Defercheck of same check id is not nil [GH-18558]
- connect: Fix issue where Envoy endpoints would not populate correctly after a snapshot restore. [GH-18636]
- gateways: Fix a bug where gateway to service mappings weren't being cleaned up properly when externally registered proxies were being deregistered. [GH-18831]
- telemetry: emit consul version metric on a regular interval. [GH-18724]
- Upgrade to use Go 1.20.8. This resolves CVEs
CVE-2023-39320 (
-
v1.16.105 Aug 2023Release notes
Open source →KNOWN ISSUES:
- connect: Consul versions 1.16.0 and 1.16.1 may have issues when a snapshot restore is performed and the servers are hosting xDS streams. When this bug triggers, it will cause Envoy to incorrectly populate upstream endpoints. This bug only impacts agent-less service mesh and should be fixed in Consul 1.16.2 by GH-18636.
SECURITY:
- Update
golang.org/x/netto v0.13.0 to address CVE-2023-3978. [GH-18358] - Upgrade golang.org/x/net to address CVE-2023-29406 [GH-18186]
- Upgrade to use Go 1.20.6.
This resolves CVE-2023-29406(
net/http) for uses of the standard library. A separate change updates dependencies ongolang.org/x/netto use0.12.0. [GH-18190] - Upgrade to use Go 1.20.7.
This resolves vulnerability CVE-2023-29409(
crypto/tls). [GH-18358]
FEATURES:
- cli:
consul memberscommand uses-filterexpression to filter members based on bexpr. [GH-18223] - cli:
consul operator raft list-peerscommand shows the number of commits each follower is trailing the leader by to aid in troubleshooting. [GH-17582] - cli:
consul watchcommand uses-filterexpression to filter response from checks, services, nodes, and service. [GH-17780] - reloadable config: Made enable_debug config reloadable and enable pprof command to work when config toggles to true [GH-17565]
- ui: consul version is displayed in nodes list with filtering and sorting based on versions [GH-17754]
IMPROVEMENTS:
- Fix some typos in metrics docs [GH-18080]
- acl: added builtin ACL policy that provides global read-only access (builtin/global-read-only) [GH-18319]
- acl: allow for a single slash character in policy names [GH-18319]
- connect: Add capture group labels from Envoy cluster FQDNs to Envoy exported metric labels [GH-17888]
- connect: Improve transparent proxy support for virtual services and failovers. [GH-17757]
- connect: update supported envoy versions to 1.23.12, 1.24.10, 1.25.9, 1.26.4 [GH-18303]
- debug: change default setting of consul debug command. now default duration is 5ms and default log level is 'TRACE' [GH-17596]
- extensions: Improve validation and error feedback for
property-overridebuiltin Envoy extension [GH-17759] - hcp: Add dynamic configuration support for the export of server metrics to HCP. [GH-18168]
- hcp: Removes requirement for HCP to provide a management token [GH-18140]
- http: GET API
operator/usageendpoint now returns node count cli:consul operator usagecommand now returns node count [GH-17939] - mesh: Expose remote jwks cluster configuration through jwt-provider config entry [GH-17978]
- mesh: Stop jwt providers referenced by intentions from being deleted. [GH-17755]
- ui: the topology view now properly displays services with mixed connect and non-connect instances. [GH-13023]
- xds: Explicitly enable WebSocket connection upgrades in HTTP connection manager [GH-18150]
BUG FIXES:
- Fix a bug that wrongly trims domains when there is an overlap with DC name. [GH-17160]
- api-gateway: fix race condition in proxy config generation when Consul is notified of the bound-api-gateway config entry before it is notified of the api-gateway config entry. [GH-18291]
- api: Fix client deserialization errors by marking new Enterprise-only prepared query fields as omit empty [GH-18184]
- ca: Fixes a Vault CA provider bug where updating RootPKIPath but not IntermediatePKIPath would not renew leaf signing certificates [GH-18112]
- connect/ca: Fixes a bug preventing CA configuration updates in secondary datacenters [GH-17846]
- connect: (Enterprise only) Fix bug where intentions referencing sameness groups would not always apply to members properly.
- connect: Fix incorrect protocol config merging for transparent proxy implicit upstreams. [GH-17894]
- connect: Removes the default health check from the
consul connect envoycommand when starting an API Gateway. This health check would always fail. [GH-18011] - connect: fix a bug with Envoy potentially starting with incomplete configuration by not waiting enough for initial xDS configuration. [GH-18024]
- gateway: Fixes a bug where envoy would silently reject RSA keys that are smaller than 2048 bits, we now reject those earlier in the process when we validate the certificate. [GH-17911]
- http: fixed API endpoint
PUT /acl/token/:AccessorID(update token), no longer requiresAccessorIDin the request body. Web UI can now update tokens. [GH-17739] - mesh: (Enterprise Only) Require that
jwt-providerconfig entries are created in thedefaultnamespace. [GH-18325] - snapshot: fix access denied and handle is invalid when we call snapshot save on windows - skip sync() for folders in windows in https://github.com/rboyer/safeio/pull/3 [GH-18302]
- xds: Prevent partial application of non-Required Envoy extensions in the case of failure. [GH-18068]
-
v1.16.026 Jun 2023Release notes
Open source →KNOWN ISSUES:
- connect: Consul versions 1.16.0 and 1.16.1 may have issues when a snapshot restore is performed and the servers are hosting xDS streams. When this bug triggers, it will cause Envoy to incorrectly populate upstream endpoints. This bug only impacts agent-less service mesh and should be fixed in Consul 1.16.2 by GH-18636.
BREAKING CHANGES:
- api: The
/v1/health/connect/and/v1/health/ingress/endpoints now immediately return 403 "Permission Denied" errors whenever a token with insufficientservice:readpermissions is provided. Prior to this change, the endpoints returned a success code with an empty result list when a token with insufficient permissions was provided. [GH-17424] - peering: Removed deprecated backward-compatibility behavior.
Upstream overrides in service-defaults will now only apply to peer upstreams when the
peerfield is provided. Visit the 1.16.x upgrade instructions for more information. [GH-16957]
SECURITY:
- Bump Dockerfile base image to
alpine:3.18. [GH-17719] - audit-logging: (Enterprise only) limit
v1/operator/audit-hashendpoint to ACL token withoperator:readprivileges.
FEATURES:
- api: (Enterprise only) Add
POST /v1/operator/audit-hashendpoint to calculate the hash of the data used by the audit log hash function and salt. - cli: (Enterprise only) Add a new
consul operator audit hashcommand to retrieve and compare the hash of the data used by the audit log hash function and salt. - cli: Adds new command -
consul services export- for exporting a service to a peer or partition [GH-15654] - connect: (Consul Enterprise only) Implement order-by-locality failover.
- mesh: Add new permissive mTLS mode that allows sidecar proxies to forward incoming traffic unmodified to the application. This adds
AllowEnablingPermissiveMutualTLSsetting to the mesh config entry and theMutualTLSModesetting to proxy-defaults and service-defaults. [GH-17035] - mesh: Support configuring JWT authentication in Envoy. [GH-17452]
- server: (Enterprise Only) added server side RPC requests IP based read/write rate-limiter. [GH-4633]
- server: (Enterprise Only) allow automatic license utilization reporting. [GH-5102]
- server: added server side RPC requests global read/write rate-limiter. [GH-16292]
- xds: Add
property-overridebuilt-in Envoy extension that directly patches Envoy resources. [GH-17487] - xds: Add a built-in Envoy extension that inserts External Authorization (ext_authz) network and HTTP filters. [GH-17495]
- xds: Add a built-in Envoy extension that inserts Wasm HTTP filters. [GH-16877]
- xds: Add a built-in Envoy extension that inserts Wasm network filters. [GH-17505]
IMPROVEMENTS:
-
- api: Support filtering for config entries. [GH-17183]
-
- cli: Add
-filteroption toconsul config listfor filtering config entries. [GH-17183]
- cli: Add
- agent: remove agent cache dependency from service mesh leaf certificate management [GH-17075]
- api: Enable setting query options on agent force-leave endpoint. [GH-15987]
- audit-logging: (Enterprise only) enable error response and request body logging
- ca: automatically set up Vault's auto-tidy setting for tidy_expired_issuers when using Vault as a CA provider. [GH-17138]
- ca: support Vault agent auto-auth config for Vault CA provider using AliCloud authentication. [GH-16224]
- ca: support Vault agent auto-auth config for Vault CA provider using AppRole authentication. [GH-16259]
- ca: support Vault agent auto-auth config for Vault CA provider using Azure MSI authentication. [GH-16298]
- ca: support Vault agent auto-auth config for Vault CA provider using JWT authentication. [GH-16266]
- ca: support Vault agent auto-auth config for Vault CA provider using Kubernetes authentication. [GH-16262]
- command: Adds ACL enabled to status output on agent startup. [GH-17086]
- command: Allow creating ACL Token TTL with greater than 24 hours with the -expires-ttl flag. [GH-17066]
- connect: (Enterprise Only) Add support for specifying "Partition" and "Namespace" in Prepared Queries failover rules.
- connect: update supported envoy versions to 1.23.10, 1.24.8, 1.25.7, 1.26.2 [GH-17546]
- connect: update supported envoy versions to 1.23.8, 1.24.6, 1.25.4, 1.26.0 [GH-5200]
- fix metric names in /docs/agent/telemetry [GH-17577]
- gateway: Change status condition reason for invalid certificate on a listener from "Accepted" to "ResolvedRefs". [GH-17115]
- http: accept query parameters
datacenter,ap(enterprise-only), andnamespace(enterprise-only). Both short-hand and long-hand forms of these query params are now supported via the HTTP API (dc/datacenter, ap/partition, ns/namespace). [GH-17525] - systemd: set service type to notify. [GH-16845]
- ui: Update alerts to Hds::Alert component [GH-16412]
- ui: Update to use Hds::Toast component to show notifications [GH-16519]
- ui: update from <button> and <a> to design-system-components button Hds::Button [GH-16251]
- ui: update typography to styles from hds [GH-16577]
BUG FIXES:
- Fix a race condition where an event is published before the data associated is commited to memdb. [GH-16871]
- connect: Fix issue where changes to service exports were not reflected in proxies. [GH-17775]
- gateways: (Enterprise only) Fixed a bug in API gateways where gateway configuration objects in non-default partitions did not reconcile properly. [GH-17581]
- gateways: Fixed a bug in API gateways where binding a route that only targets a service imported from a peer results in the programmed gateway having no routes. [GH-17609]
- gateways: Fixed a bug where API gateways were not being taken into account in determining xDS rate limits. [GH-17631]
- namespaces: (Enterprise only) fixes a bug where agent health checks stop syncing for all services on a node if the namespace of any service has been removed from the server.
- namespaces: (Enterprise only) fixes a bug where namespaces are stuck in a deferred deletion state indefinitely under some conditions. Also fixes the Consul query metadata present in the HTTP headers of the namespace read and list endpoints.
- peering: Fix a bug that caused server agents to continue cleaning up peering resources even after loss of leadership. [GH-17483]
- peering: Fixes a bug where the importing partition was not added to peered failover targets, which causes issues when the importing partition is a non-default partition. [GH-16673]
- ui: fixes ui tests run on CI [GH-16428]
- xds: Fixed a bug where modifying ACLs on a token being actively used for an xDS connection caused all xDS updates to fail. [GH-17566]
-
v1.16.0-rc110 Jun 2023 pre-releaseRelease notes
Open source →BREAKING CHANGES:
- api: The
/v1/health/connect/and/v1/health/ingress/endpoints now immediately return 403 "Permission Denied" errors whenever a token with insufficientservice:readpermissions is provided. Prior to this change, the endpoints returned a success code with an empty result list when a token with insufficient permissions was provided. [GH-17424] - peering: Removed deprecated backward-compatibility behavior.
Upstream overrides in service-defaults will now only apply to peer upstreams when the
peerfield is provided. Visit the 1.16.x upgrade instructions for more information. [GH-16957]
SECURITY:
- audit-logging: (Enterprise only) limit
v1/operator/audit-hashendpoint to ACL token withoperator:readprivileges.
FEATURES:
- api: (Enterprise only) Add
POST /v1/operator/audit-hashendpoint to calculate the hash of the data used by the audit log hash function and salt. - cli: (Enterprise only) Add a new
consul operator audit hashcommand to retrieve and compare the hash of the data used by the audit log hash function and salt. - cli: Adds new command -
consul services export- for exporting a service to a peer or partition [GH-15654] - connect: (Consul Enterprise only) Implement order-by-locality failover.
- mesh: Add new permissive mTLS mode that allows sidecar proxies to forward incoming traffic unmodified to the application. This adds
AllowEnablingPermissiveMutualTLSsetting to the mesh config entry and theMutualTLSModesetting to proxy-defaults and service-defaults. [GH-17035] - mesh: Support configuring JWT authentication in Envoy. [GH-17452]
- server: (Enterprise Only) added server side RPC requests IP based read/write rate-limiter. [GH-4633]
- server: (Enterprise Only) allow automatic license utilization reporting. [GH-5102]
- server: added server side RPC requests global read/write rate-limiter. [GH-16292]
- xds: Add
property-overridebuilt-in Envoy extension that directly patches Envoy resources. [GH-17487] - xds: Add a built-in Envoy extension that inserts External Authorization (ext_authz) network and HTTP filters. [GH-17495]
- xds: Add a built-in Envoy extension that inserts Wasm HTTP filters. [GH-16877]
- xds: Add a built-in Envoy extension that inserts Wasm network filters. [GH-17505]
IMPROVEMENTS:
-
- api: Support filtering for config entries. [GH-17183]
-
- cli: Add
-filteroption toconsul config listfor filtering config entries. [GH-17183]
- cli: Add
- api: Enable setting query options on agent force-leave endpoint. [GH-15987]
- audit-logging: (Enterprise only) enable error response and request body logging [GH-5669]
- audit-logging: (Enterprise only) enable error response and request body logging
- ca: automatically set up Vault's auto-tidy setting for tidy_expired_issuers when using Vault as a CA provider. [GH-17138]
- ca: support Vault agent auto-auth config for Vault CA provider using AliCloud authentication. [GH-16224]
- ca: support Vault agent auto-auth config for Vault CA provider using AppRole authentication. [GH-16259]
- ca: support Vault agent auto-auth config for Vault CA provider using Azure MSI authentication. [GH-16298]
- ca: support Vault agent auto-auth config for Vault CA provider using JWT authentication. [GH-16266]
- ca: support Vault agent auto-auth config for Vault CA provider using Kubernetes authentication. [GH-16262]
- command: Adds ACL enabled to status output on agent startup. [GH-17086]
- command: Allow creating ACL Token TTL with greater than 24 hours with the -expires-ttl flag. [GH-17066]
- connect: (Enterprise Only) Add support for specifying "Partition" and "Namespace" in Prepared Queries failover rules.
- connect: update supported envoy versions to 1.23.10, 1.24.8, 1.25.7, 1.26.2 [GH-17546]
- connect: update supported envoy versions to 1.23.8, 1.24.6, 1.25.4, 1.26.0 [GH-5200]
- fix metric names in /docs/agent/telemetry [GH-17577]
- gateway: Change status condition reason for invalid certificate on a listener from "Accepted" to "ResolvedRefs". [GH-17115]
- http: accept query parameters
datacenter,ap(enterprise-only), andnamespace(enterprise-only). Both short-hand and long-hand forms of these query params are now supported via the HTTP API (dc/datacenter, ap/partition, ns/namespace). [GH-17525] - systemd: set service type to notify. [GH-16845]
- ui: Update alerts to Hds::Alert component [GH-16412]
- ui: Update to use Hds::Toast component to show notifications [GH-16519]
- ui: update from <button> and <a> to design-system-components button Hds::Button [GH-16251]
- ui: update typography to styles from hds [GH-16577]
BUG FIXES:
- Fix a race condition where an event is published before the data associated is commited to memdb. [GH-16871]
- gateways: (Enterprise only) Fixed a bug in API gateways where gateway configuration objects in non-default partitions did not reconcile properly. [GH-17581]
- gateways: Fixed a bug in API gateways where binding a route that only targets a service imported from a peer results in the programmed gateway having no routes. [GH-17609]
- gateways: Fixed a bug where API gateways were not being taken into account in determining xDS rate limits. [GH-17631]
- peering: Fixes a bug where the importing partition was not added to peered failover targets, which causes issues when the importing partition is a non-default partition. [GH-16673]
- ui: fixes ui tests run on CI [GH-16428]
- xds: Fixed a bug where modifying ACLs on a token being actively used for an xDS connection caused all xDS updates to fail. [GH-17566]
- api: The
-
v1.15.1126 Mar 2024Release notes
Open source →Enterprise LTS: Consul Enterprise 1.15 is a Long-Term Support (LTS) release.
SECURITY:
- Update
google.golang.org/protobufto v1.33.0 to address CVE-2024-24786. [GH-20801]
IMPROVEMENTS:
- api: Randomize the returned server list for the WatchServers gRPC endpoint. [GH-20866]
BUG FIXES:
- connect: Fix issue where Consul-dataplane xDS sessions would not utilize the streaming backend for wan-federated queries. [GH-20868]
- connect: Fix potential goroutine leak in xDS stream handling. [GH-20866]
- connect: Fix xDS deadlock that could result in proxies being unable to start. [GH-20867]
- ingress-gateway: (Enterprise Only) Fix a bug where on update, Ingress Gateways lost all upstreams for listeners with wildcard services in a different namespace.
- snapshot-agent: (Enterprise only) Fix a bug with static AWS credentials where one of the key id or secret key is provided via config file and the other is provided via an environment variable.
- Update
-
v1.15.1013 Feb 2024Release notes
Open source →SECURITY:
- mesh: Update Envoy versions to 1.28.1, 1.27.3, and 1.26.7 to address CVE-2024-23324, CVE-2024-23325, CVE-2024-23322, CVE-2024-23323, CVE-2024-23327, and CVE-2023-44487 [GH-20590]
IMPROVEMENTS:
- ProxyCfg: avoid setting a watch on
Internal.ServiceDumpwhen mesh gateway is not used. [GH-20168] - ProxyCfg: only return the nodes list when querying the
Internal.ServiceDumpwatch from proxycfg [GH-20168] - Upgrade to use Go 1.21.7. [GH-20545]
- mesh: update supported envoy version 1.28.0 in addition to 1.27.2, 1.26.6 to support LTS release [GH-20323]
BUG FIXES:
- audit-logs: (Enterprise Only) Fixes non ASCII characters in audit logs because of gzip. [GH-20345]
- connect: Fix issue where re-persisting existing proxy-defaults using
httpprotocol fails with a protocol-mismatch error. [GH-20481] - connect: Remove code coupling where the xDS capacity controller could negatively affect raft autopilot performance. [GH-20511]
-
v1.15.922 Jan 2024Release notes
Open source →SECURITY:
- Update RSA key generation to use a key size of at least 2048 bits. [GH-20112]
- Upgrade OpenShift container images to use
ubi9-minimal:9.3as the base image. [GH-20014]
IMPROVEMENTS:
- Upgrade to use Go 1.21.6. [GH-20062]
BUG FIXES:
- ui: update token list on Role details page to show only linked tokens [GH-19912]
-
v1.15.812 Dec 2023Release notes
Open source →SECURITY:
- Update
github.com/golang-jwt/jwt/v4to v4.5.0 to address PRISMA-2022-0270. [GH-19705] - Upgrade to use Go 1.20.12. This resolves CVEs
CVE-2023-45283: (
path/filepath) recognize ??\ as a Root Local Device path prefix (Windows) CVE-2023-45284: recognize device names with trailing spaces and superscripts (Windows) CVE-2023-39326: (net/http) limit chunked data overhead CVE-2023-45285: (cmd/go) go get may unexpectedly fallback to insecure git [GH-19840]
IMPROVEMENTS:
- mesh: parse the proxy-defaults protocol when write the config-entry to avoid parsing it when compiling the discovery chain. [GH-19829]
- wan-federation: use a hash to diff config entries when replicating in the secondary DC to avoid unnecessary writes.. [GH-19795]
- cli: Adds cli support for checking TCP connection for ports. If -ports flag is not given, it will check for default ports of consul listed here - https://developer.hashicorp.com/consul/docs/install/ports [GH-18329]
- connect: Default
stats_flush_intervalto 60 seconds when using the Consul Telemetry Collector, unless custom stats sink are present or an explicit flush interval is configured. [GH-19663] - metrics: increment consul.client.rpc.failed if RPC fails because no servers are accessible [GH-19721]
- metrics: modify consul.client.rpc metric to exclude internal retries for consistency with consul.client.rpc.exceeded and consul.client.rpc.failed [GH-19721]
BUG FIXES:
- CLI: fix a panic when deleting a non existing policy by name. [GH-19679]
- connect: Solves an issue where two upstream services with the same name in different namespaces were not getting routed to correctly by API Gateways. [GH-19860]
- federation: (Enterprise Only) Fixed an issue where namespace reconciliation could result into the secondary having dangling instances of namespaces marked for deletion
- ui: only show back-to-hcp link when url is present [GH-19444]
- wan-federation: Fix a bug where servers wan-federated through mesh-gateways could crash due to overlapping LAN IP addresses. [GH-19503]
- xds: Add configurable
xds_fetch_timeout_msoption to proxy registrations that allows users to prevent endpoints from dropping when they have proxies with a large number of upstreams. [GH-19871] - xds: ensure child resources are re-sent to Envoy when the parent is updated even if the child already has pending updates. [GH-19866]
- Update
-
v1.15.731 Oct 2023Release notes
Open source →SECURITY:
- Update
golang.org/x/netto v0.17.0 to address CVE-2023-39325 / CVE-2023-44487(x/net/http2). [GH-19225] - Upgrade Go to 1.20.10.
This resolves vulnerability CVE-2023-39325
/ CVE-2023-44487(
net/http). [GH-19225] - Upgrade
google.golang.org/grpcto 1.56.3. This resolves vulnerability CVE-2023-44487. [GH-19414] - connect: update supported envoy versions to 1.24.12, 1.25.11 to address CVE-2023-44487 [GH-19272]
BUG FIXES:
- Mesh Gateways: Fix a bug where replicated and peered mesh gateways with hostname-based WAN addresses fail to initialize. [GH-19268]
- api: add custom marshal/unmarshal for ServiceResolverConfigEntry.RequestTimeout so config entries that set this field can be read using the API. [GH-19031]
- ca: Fix bug with Vault CA provider where renewing a retracted token would cause retries in a tight loop, degrading performance. [GH-19285]
- ca: Fix bug with Vault CA provider where token renewal goroutines could leak if CA failed to initialize. [GH-19285]
- ca: ensure Vault CA provider respects Vault Enterprise namespace configuration. [GH-19095]
- catalog api: fixes a bug with catalog api where filter query parameter was not working correctly for the
/v1/catalog/servicesendpoint [GH-18322] - connect: Fix bug where uncleanly closed xDS connections would influence connection balancing for too long and prevent envoy instances from starting. Two new configuration fields
performance.grpc_keepalive_timeoutandperformance.grpc_keepalive_intervalnow exist to allow for configuration on how often these dead connections will be cleaned up. [GH-19339] - gateways: Fix a bug where a service in a peered datacenter could not access an external node service through a terminating gateway [GH-18959]
- Update
-
v1.15.619 Sep 2023Release notes
Open source →SECURITY:
- Upgrade to use Go 1.20.8. This resolves CVEs
CVE-2023-39320 (
cmd/go), CVE-2023-39318 (html/template), CVE-2023-39319 (html/template), CVE-2023-39321 (crypto/tls), and CVE-2023-39322 (crypto/tls) [GH-18742]
IMPROVEMENTS:
- Adds flag -append-filename (which works on values version, dc, node and status) to consul snapshot save command. Adding the flag -append-filename version,dc,node,status will add consul version, consul datacenter, node name and leader/follower (status) in the file name given in the snapshot save command before the file extension. [GH-18625]
- Reduce the frequency of metric exports from Consul to HCP from every 10s to every 1m [GH-18584]
- api: Add support for listing ACL tokens by service name. [GH-18667]
- command: Adds -since flag in consul debug command which internally calls hcdiag for debug information in the past. [GH-18797]
- log: Currently consul logs files like this consul-{timestamp}.log. This change makes sure that there is always consul.log file with the latest logs in it. [GH-18617]
BUG FIXES:
- api: Fix
/v1/agent/selfnot returning latest configuration [GH-18681] - ca: Vault provider now cleans up the previous Vault issuer and key when generating a new leaf signing certificate [GH-18779] [GH-18773]
- check: prevent go routine leakage when existing Defercheck of same check id is not nil [GH-18558]
- gateways: Fix a bug where gateway to service mappings weren't being cleaned up properly when externally registered proxies were being deregistered. [GH-18831]
- telemetry: emit consul version metric on a regular interval. [GH-18724]
- Upgrade to use Go 1.20.8. This resolves CVEs
CVE-2023-39320 (
-
v1.15.505 Aug 2023Release notes
Open source →SECURITY:
- Update
golang.org/x/netto v0.13.0 to address CVE-2023-3978. [GH-18358] - Upgrade golang.org/x/net to address CVE-2023-29406 [GH-18186]
- Upgrade to use Go 1.20.6.
This resolves CVE-2023-29406(
net/http) for uses of the standard library. A separate change updates dependencies ongolang.org/x/netto use0.12.0. [GH-18190] - Upgrade to use Go 1.20.7.
This resolves vulnerability CVE-2023-29409(
crypto/tls). [GH-18358]
FEATURES:
- cli:
consul memberscommand uses-filterexpression to filter members based on bexpr. [GH-18223] - cli:
consul watchcommand uses-filterexpression to filter response from checks, services, nodes, and service. [GH-17780] - reloadable config: Made enable_debug config reloadable and enable pprof command to work when config toggles to true [GH-17565]
IMPROVEMENTS:
- Fix some typos in metrics docs [GH-18080]
- acl: added builtin ACL policy that provides global read-only access (builtin/global-read-only) [GH-18319]
- acl: allow for a single slash character in policy names [GH-18319]
- connect: Add capture group labels from Envoy cluster FQDNs to Envoy exported metric labels [GH-17888]
- connect: update supported envoy versions to 1.22.11, 1.23.12, 1.24.10, 1.25.9 [GH-18304]
- hcp: Add dynamic configuration support for the export of server metrics to HCP. [GH-18168]
- hcp: Removes requirement for HCP to provide a management token [GH-18140]
- xds: Explicitly enable WebSocket connection upgrades in HTTP connection manager [GH-18150]
BUG FIXES:
- Fix a bug that wrongly trims domains when there is an overlap with DC name. [GH-17160]
- api-gateway: fix race condition in proxy config generation when Consul is notified of the bound-api-gateway config entry before it is notified of the api-gateway config entry. [GH-18291]
- connect/ca: Fixes a bug preventing CA configuration updates in secondary datacenters [GH-17846]
- connect: Fix incorrect protocol config merging for transparent proxy implicit upstreams. [GH-17894]
- connect: Removes the default health check from the
consul connect envoycommand when starting an API Gateway. This health check would always fail. [GH-18011] - connect: fix a bug with Envoy potentially starting with incomplete configuration by not waiting enough for initial xDS configuration. [GH-18024]
- snapshot: fix access denied and handle is invalid when we call snapshot save on windows - skip sync() for folders in windows in https://github.com/rboyer/safeio/pull/3 [GH-18302]
- Update
-
v1.15.423 Jun 2023Release notes
Open source →FEATURES:
- cli:
consul operator raft list-peerscommand shows the number of commits each follower is trailing the leader by to aid in troubleshooting. [GH-17582] - server: (Enterprise Only) allow automatic license utilization reporting. [GH-5102]
IMPROVEMENTS:
- connect: update supported envoy versions to 1.22.11, 1.23.9, 1.24.7, 1.25.6 [GH-17545]
- debug: change default setting of consul debug command. now default duration is 5ms and default log level is 'TRACE' [GH-17596]
- fix metric names in /docs/agent/telemetry [GH-17577]
- gateway: Change status condition reason for invalid certificate on a listener from "Accepted" to "ResolvedRefs". [GH-17115]
- systemd: set service type to notify. [GH-16845]
BUG FIXES:
- cache: fix a few minor goroutine leaks in leaf certs and the agent cache [GH-17636]
- docs: fix list of telemetry metrics [GH-17593]
- gateways: (Enterprise only) Fixed a bug in API gateways where gateway configuration objects in non-default partitions did not reconcile properly. [GH-17581]
- gateways: Fixed a bug in API gateways where binding a route that only targets a service imported from a peer results in the programmed gateway having no routes. [GH-17609]
- gateways: Fixed a bug where API gateways were not being taken into account in determining xDS rate limits. [GH-17631]
- http: fixed API endpoint
PUT /acl/token/:AccessorID(update token), no longer requiresAccessorIDin the request body. Web UI can now update tokens. [GH-17739] - namespaces: (Enterprise only) fixes a bug where agent health checks stop syncing for all services on a node if the namespace of any service has been removed from the server.
- namespaces: (Enterprise only) fixes a bug where namespaces are stuck in a deferred deletion state indefinitely under some conditions. Also fixes the Consul query metadata present in the HTTP headers of the namespace read and list endpoints.
- peering: Fix a bug that caused server agents to continue cleaning up peering resources even after loss of leadership. [GH-17483]
- xds: Fixed a bug where modifying ACLs on a token being actively used for an xDS connection caused all xDS updates to fail. [GH-17566]
- cli:
-
v1.15.301 Jun 2023Release notes
Open source →BREAKING CHANGES:
- extensions: The Lua extension now targets local proxy listeners for the configured service's upstreams, rather than remote downstream listeners for the configured service, when ListenerType is set to outbound in extension configuration. See CVE-2023-2816 changelog entry for more details. [GH-17415]
SECURITY:
- Update to UBI base image to 9.2. [GH-17513]
- Upgrade golang.org/x/net to address CVE-2022-41723 [GH-16754]
- Upgrade to use Go 1.20.4.
This resolves vulnerabilities CVE-2023-24537(
go/scanner), CVE-2023-24538(html/template), CVE-2023-24534(net/textproto) and CVE-2023-24536(mime/multipart). Also,golang.org/x/nethas been updated to v0.7.0 to resolve CVEs CVE-2022-41721 , CVE-2022-27664 and [CVE-2022-41723 ](https://github.com/advisories/GHSA-vvpx-j8f3-3w6h .) [GH-17240] - extensions: Disable remote downstream proxy patching by Envoy Extensions other than AWS Lambda. Previously, an operator with service:write ACL permissions for an upstream service could modify Envoy proxy config for downstream services without equivalent permissions for those services. This issue only impacts the Lua extension. [CVE-2023-2816] [GH-17415]
FEATURES:
- hcp: Add new metrics sink to collect, aggregate and export server metrics to HCP in OTEL format. [GH-17460]
IMPROVEMENTS:
- Fixes a performance issue in Raft where commit latency can increase by 100x or more when under heavy load. For more details see https://github.com/hashicorp/raft/pull/541. [GH-17081]
- agent: add a configurable maximimum age (default: 7 days) to prevent servers re-joining a cluster with stale data [GH-17171]
- agent: add new metrics to track cpu disk and memory usage for server hosts (defaults to: enabled) [GH-17038]
- connect: update supported envoy versions to 1.22.11, 1.23.8, 1.24.6, 1.25.4 [GH-16889]
- envoy: add
MaxEjectionPercentandBaseEjectionTimeto passive health check configs. [GH-15979] - hcp: Add support for linking existing Consul clusters to HCP management plane. [GH-16916]
- logging: change snapshot log header from
agent.server.snapshottoagent.server.raft.snapshot[GH-17236] - peering: allow re-establishing terminated peering from new token without deleting existing peering first. [GH-16776]
- peering: gRPC queries for TrustBundleList, TrustBundleRead, PeeringList, and PeeringRead now support blocking semantics, reducing network and CPU demand. The HTTP APIs for Peering List and Read have been updated to support blocking. [GH-17426]
- raft: Remove expensive reflection from raft/mesh hot path [GH-16552]
- xds: rename envoy_hcp_metrics_bind_socket_dir to envoy_telemetry_collector_bind_socket_dir to remove HCP naming references. [GH-17327]
BUG FIXES:
- Fix an bug where decoding some Config structs with unset pointer fields could fail with
reflect: call of reflect.Value.Type on zero Value. [GH-17048] - acl: (Enterprise only) Check permissions in correct partition/namespace when resolving service in non-default partition/namespace
- acl: Fix an issue where the anonymous token was synthesized in non-primary datacenters which could cause permission errors when federating clusters with ACL replication enabled. [GH-17231]
- acls: Fix ACL bug that can result in sidecar proxies having incorrect endpoints.
- connect: Fix multiple inefficient behaviors when querying service health. [GH-17241]
- gateways: Fix an bug where targeting a virtual service defined by a service-resolver was broken for HTTPRoutes. [GH-17055]
- grpc: ensure grpc resolver correctly uses lan/wan addresses on servers [GH-17270]
- namespaces: adjusts the return type from HTTP list API to return the
apimodule representation of a namespace. This fixes an error with theconsul namespace listcommand when a namespace has a deferred deletion timestamp. - peering: Fix issue where modifying the list of exported services did not correctly replicate changes for services that exist in a non-default namespace. [GH-17456]
- peering: Fix issue where peer streams could incorrectly deregister services in various scenarios. [GH-17235]
- peering: ensure that merged central configs of peered upstreams for partitioned downstreams work [GH-17179]
- xds: Fix possible panic that can when generating clusters before the root certificates have been fetched. [GH-17185]
-
v1.15.230 Mar 2023Release notes
Open source →FEATURES:
- xds: Allow for configuring connect proxies to send service mesh telemetry to an HCP metrics collection service. [GH-16585]
BUG FIXES:
- audit-logging: (Enterprise only) Fix a bug where
/agent/monitorand/agent/metricsendpoints return aStreaming not supportederror when audit logs are enabled. This also fixes the delay receiving logs when runningconsul monitoragainst an agent with audit logs enabled. [GH-16700] - ca: Fixes a bug where updating Vault CA Provider config would cause TLS issues in the service mesh [GH-16592]
- cache: revert cache refactor which could cause blocking queries to never return [GH-16818]
- gateway: (Enterprise only) Fix bug where namespace/partition would fail to unmarshal for TCPServices. [GH-16781]
- gateway: (Enterprise only) Fix bug where namespace/partition would fail to unmarshal. [GH-16651]
- gateway: (Enterprise only) Fix bug where parent refs and service refs for a route in the same namespace as the route would fallback to the default namespace if the namespace was not specified in the configuration rather than falling back to the routes namespace. [GH-16789]
- gateway: (Enterprise only) Fix bug where routes defined in a different namespace than a gateway would fail to register. [GH-16677].
- gateways: Adds validation to ensure the API Gateway has a listener defined when created [GH-16649]
- gateways: Fixes a bug API gateways using HTTP listeners were taking upwards of 15 seconds to get configured over xDS. [GH-16661]
- peering: (Consul Enterprise only) Fix issue where connect-enabled services with peer upstreams incorrectly required
service:writeaccess in thedefaultnamespace to query data, which was too restrictive. Now havingservice:writeto any namespace is sufficient to query the peering data. - peering: (Consul Enterprise only) Fix issue where resolvers, routers, and splitters referencing peer targets may not work correctly for non-default partitions and namespaces. Enterprise customers leveraging peering are encouraged to upgrade both servers and agents to avoid this problem.
- peering: Fix issue resulting in prepared query failover to cluster peers never un-failing over. [GH-16729]
- peering: Fixes a bug that can lead to peering service deletes impacting the state of local services [GH-16570]
- peering: Fixes a bug where the importing partition was not added to peered failover targets, which causes issues when the importing partition is a non-default partition. [GH-16675]
- raft_logstore: Fixes a bug where restoring a snapshot when using the experimental WAL storage backend causes a panic. [GH-16647]
- ui: fix PUT token request with adding missed AccessorID property to requestBody [GH-16660]
- ui: fix rendering issues on Overview and empty-states by addressing isHTMLSafe errors [GH-16574]
-
v1.15.107 Mar 2023Release notes
Open source →IMPROVEMENTS:
- cli: added
-append-policy-id,-append-policy-name,-append-role-name, and-append-role-idflags to theconsul token updatecommand. These flags allow updates to a token's policies/roles without having to override them completely. [GH-16288] - cli: added
-append-service-identityand-append-node-identityflags to theconsul token updatecommand. These flags allow updates to a token's node identities/service identities without having to override them. [GH-16506] - connect: Bump Envoy 1.22.5 to 1.22.7, 1.23.2 to 1.23.4, 1.24.0 to 1.24.2, add 1.25.1, remove 1.21.5 [GH-16274]
- mesh: Add ServiceResolver RequestTimeout for route timeouts to make request timeouts configurable [GH-16495]
- ui: support filtering API gateways in the ui and displaying their documentation links [GH-16508]
DEPRECATIONS:
- cli: Deprecate the
-merge-node-identitesand-merge-service-identitiesflags from theconsul token updatecommand in favor of:-append-node-identityand-append-service-identity. [GH-16506] - cli: Deprecate the
-merge-policiesand-merge-rolesflags from theconsul token updatecommand in favor of:-append-policy-id,-append-policy-name,-append-role-name, and-append-role-id. [GH-16288]
BUG FIXES:
- cli: Fixes an issue with
consul connect envoywhere a log to STDOUT could malform JSON when used with-bootstrap. [GH-16530] - cli: Fixes an issue with
consul connect envoywhere grpc-disabled agents were not error-handled correctly. [GH-16530] - cli: ensure acl token read -self works [GH-16445]
- cli: fix panic read non-existent acl policy [GH-16485]
- gateways: fix HTTPRoute bug where service weights could be less than or equal to 0 and result in a downstream envoy protocol error [GH-16512]
- gateways: fix HTTPRoute bug where services with a weight not divisible by 10000 are never registered properly [GH-16531]
- mesh: Fix resolution of service resolvers with subsets for external upstreams [GH-16499]
- proxycfg: ensure that an irrecoverable error in proxycfg closes the xds session and triggers a replacement proxycfg watcher [GH-16497]
- proxycfg: fix a bug where terminating gateways were not cleaning up deleted service resolvers for their referenced services [GH-16498]
- ui: Fix issue with lists and filters not rendering properly [GH-16444]
- cli: added