Upgrade InfluxDB Clustered

Use Kubernetes to upgrade your InfluxDB Clustered version. The upgrade is carried out using in-place updates, ensuring minimal downtime. InfluxDB Clustered versioning is defined in the AppInstance CustomResourceDefinition (CRD) in your myinfluxdb.yml.

• Version format
• Upgrade your InfluxDB Clustered version

Version format

InfluxDB Clustered uses the YYYYMMDD-BUILD_NUMBER version format. For example, a version created on January 1, 2024 would have a version number similar to the following:

20240101-863513

Upgrade your InfluxDB Clustered version

1. Identify your current InfluxDB Clustered package version
2. Identify the version to upgrade to
3. Update your image to use a new package version
4. Apply the updated image

Identify your current InfluxDB Clustered package version

Use the following command to return the image Kubernetes uses to build your InfluxDB cluster:

kubectl get appinstances.kubecfg.dev influxdb -n influxdb -o jsonpath='{.spec.package.image}'

The package version number is at the end of the returned string (after influxdb:):

us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:PACKAGE_VERSION

Identify the version to upgrade to

All available InfluxDB Clustered package versions are provided in the InfluxDB Clustered release notes. Find the package version you want to upgrade to and copy the version number.

Checkpoint releases

Some InfluxDB Clustered releases are checkpoint releases that introduce a breaking change to an InfluxDB component. Checkpoint releases are only made when absolutely necessary and are clearly identified in the InfluxDB Clustered release notes.

When upgrading, always upgrade to each checkpoint release first, before proceeding to newer versions.

Update your image to use a new package version

In your myinfluxdb.yml, update the package version defined in spec.package.image to the version you want to upgrade to.

apiVersion: kubecfg.dev/v1alpha1
kind: AppInstance
# ...
spec:
  package:
    # ...
    image: us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:
PACKAGE_VERSION

Replace PACKAGE_VERSION with the version number to upgrade to.

Apply the updated image

Use the following command to apply the updated image configuration and upgrade your InfluxDB Cluster:

kubectl apply \
  --filename myinfluxdb.yml \
  --namespace influxdb