Consul 1.21.0

We are pleased to announce the following Consul updates.

Release highlights

• Long term support (LTS) release: For Enterprise users, Consul v1.21 is an LTS release. These versions of Consul receive support for two years after their release, allowing for less frequent system upgrades and continued support through patches and fixes. For more information about this program, refer to Long term support.

• Simplified deployment architecture for Consul ESM: Consul External Service Monitor (ESM) no longer requires a Consul agent running on the same node. Instead, the ESM service uses a single outbound TCP connection to communicate directly with the Consul servers. Consul ESM no longer participates in gossip communication with the cluster as a result, which lowers its deployment and maintenance requirements at scale and makes it possible to run Consul in a wider variety of networks. For more information, refer to Consul External Service Monitor (ESM).

• Snapshot agent support for Google Cloud (GCP): On Enterprise deployments, Consul on Kubernetes supports a snapshot agent deployed as a sidecar can store snapshots locally or send snapshots to S3-compatible storage targets, including Amazon S3 and Azure Blob Storage. The latest release adds support for Google Cloud Storage. For more information about using the snapshot agent, refer to Backup and restore a Consul datacenter.

• OpenShift 4.16 support: Consul v1.21 includes improvements to support RedHat OpenShift clusters running OpenShift Container Platform version 4.16. To get started with Consul on OpenShift clusters, refer to Consul on RedHat OpenShift.

• Support for Kubernetes Pod Securities Admissions: Consul now supports Kubernetes Pod Securities Admissions, which were introduced in Kubernetes v1.21 as a replacement for PodSecurityPolicies. PodSecurityPolicies allowed operators to define minimum security requirements for Kubernetes pods. Consul's support includes the ability to manage and configure Kubernetes clusters with Pod Security Admissions on each namespace for improved security and flexibility.

• Documentation improvements: Consul v1.21 includes significant updates to the structure and content of the documentation. Highlights include a dedicated sequence on "Consul fundamentals" for new learners, the re-organization of usage documentation into Consul operations and service networking, and a conceptual realignment around the principles of north/south and east/west networking operations. For a detailed explanation of the documentation's new design, refer to the Consul information architecture and content strategy README on GitHub. Previous versions will retain the documentation that accompanied their release. To find documentation for an earlier release, use the dropdown on developer.hashicorp.com to select a specific version.

Upgrading

For more detailed information, please refer to the upgrade details page and the changelogs.

Known issues

There are no known issues at this time. These release notes are updated as issues are discovered.

Report issues on Github.

Changelogs

The changelogs for this major release version and any maintenance versions are listed below.

• 1.21.0