Skip to content
Percona Documentation

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

Upgrade Percona Everest using Helm

Percona Everest consistently delivers updates that includes bug fixes, security enhancements, and various improvements designed to optimize the overall performance of your database.

Before you upgrade

Note

  • Upgrade one minor release at a time to avoid unexpected issues. Start by updating to the latest patch release before moving on to the next minor release.
  • For a safe upgrade, we perform a pre-upgrade hook that runs a series of checks. You can disable this by setting upgrade.preflightChecks=false, but doing so means a safe upgrade cannot be assured.

Upgrade CRDs

In Helm v3, CRDs are not updated automatically during a Helm upgrade. You need to manually upgrade the CRDs.

To update the CRDs, run the following command:

VERSION=<Next version>
kubectl apply -k "https://github.com/percona/everest-operator/config/crd?ref=v$VERSION" --server-side

where,

Next version - A placeholder for the specific version of Everest. For example, you might replace <Next version> with 1.3.0.

Note

You may encounter an error due to conflicting field ownership, such as:

error: Apply failed with 1 conflict: conflict with  "helm" using apiextensions.k8s.io/v1: .spec.versions

This typically occurs when multiple tools (e.g., Helm and kubectl apply) manage the same Custom Resource Definition (CRD).

To resolve this, you can use the --force-conflicts flag when applying the CRD:

kubectl apply -k "https://github.com/percona/everest-operator/config/crd?ref=v$VERSION" --server-side --force-conflicts
This is generally safe when the CRDs originate from a trusted source, such as a verified Helm chart or operator.

Upgrade Helm releases

Warning

When using helm upgrade, specifying --set (or other equivalent flags) causes Helm to revert all other values to the defaults defined in the chart. To avoid this issue, either include the --reuse-values flag or provide the complete set of values, including those used during the installation.

To upgrade Percona Everest using Helm, run the following commands:

  1. Upgrade the Helm release for Everest (core components).

    helm upgrade everest-core percona/everest --namespace everest-system --version "$VERSION"

    where,

    VERSION is the Percona Everest version you wish to upgrade to.

  2. Upgrade the Helm release for the database namespace (if applicable):

    helm upgrade everest percona/everest-db-namespace --namespace <DB namespace> --version "$VERSION"

    where,

    VERSION is the Percona Everest version you wish to upgrade to.

    DB namespace is the namespace you wish to upgrade.