»Upgrades

You can specify the version and capacity when you create a cluster.

»Introduction

You can upgrade these attributes as new versions of Consul become available or as your networking needs evolve. Note that HashiCorp automatically updates your Consul clusters to fix common vulnerabilities and exposures (CVE). You cannot modify the cluster name, tier, or HashiCorp virtual network (HVN) after creating a cluster.

»Upgrade Consul Version and Tier

You can upgrade your HCP Consul cluster version up to the next higher major version using the HCP Terraform provider or the HCP interface. This topic describes how to use the HCP interface, refer to the HCP Terraform provider documentation for instructions on upgrading with Terraform.

1. If you have not already done so, log into the HashiCorp Cloud Platform and click Consul under the Services sidebar menu.
2. Choose Edit cluster from the ellipses menu for the cluster you want to upgrade.
3. Choose the new attributes and click Apply changes.

»About Cluster Versions

To safely and securely manage your Consul clusters, HCP Consul follows HashiCorp’s Support Period Policy.

• HCP Consul offers n-2 version support for bug fixes and CVEs via new minor releases, where n is the latest major release of Consul. You can identify a major release by a change in the first digit (X) or the second digit (Y) of the Consul version nomenclature (X.Y.Z). For example, if the latest release is 1.12.*, fixes will be available for versions 1.12.*, 1.11.*, and 1.10.*.
• HashiCorp will update HCP Consul clusters with CVE patches for clusters that fall within the n-2 version.
• HashiCorp recommends users to keep Consul clusters within two (2) major releases from the latest major release, this will ensure bug fixes and security patches are successfully applied to HCP managed Consul clusters.
• HashiCorp will continue to support Generally Available (GA) Consul releases up to two years from their release date. In some cases, HashiCorp may request users to upgrade to newer releases in order to resolve support requests.

»About Cluster Tiers

HCP Consul offers the following capacities and tiers:

Downgrading capacity is not supported. Refer to the Consul pricing page for additional information.