From a39644200e6724ca5350390ec048e8393a602a17 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Fri, 21 Feb 2025 15:31:55 -0700 Subject: [PATCH 1/2] updated clustered upgrade, closes influxdata/DAR#479, closes influxdata/DAR#480 --- content/influxdb3/clustered/admin/upgrade.md | 6 +++ .../reference/release-notes/clustered.md | 53 +++++++++---------- 2 files changed, 30 insertions(+), 29 deletions(-) diff --git a/content/influxdb3/clustered/admin/upgrade.md b/content/influxdb3/clustered/admin/upgrade.md index aecdc3ed2..5b79d9eea 100644 --- a/content/influxdb3/clustered/admin/upgrade.md +++ b/content/influxdb3/clustered/admin/upgrade.md @@ -15,10 +15,16 @@ related: --- 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`](/influxdb3/clustered/install/set-up-cluster/configure-cluster/). +> [!Important] +> InfluxDB Clustered does not support downgrading. +> If you encounter an issue after upgrading, +> [contact InfluxData support](mailto:support@influxdata.com). + - [Version format](#version-format) - [Upgrade your InfluxDB Clustered version](#upgrade-your-influxdb-clustered-version) diff --git a/content/influxdb3/clustered/reference/release-notes/clustered.md b/content/influxdb3/clustered/reference/release-notes/clustered.md index 70bf67d09..c33a73018 100644 --- a/content/influxdb3/clustered/reference/release-notes/clustered.md +++ b/content/influxdb3/clustered/reference/release-notes/clustered.md @@ -10,17 +10,16 @@ menu: weight: 201 --- -{{% note %}} -## Checkpoint releases {.checkpoint} - -Some InfluxDB Clustered releases are checkpoint releases that introduce a -breaking change to an InfluxDB component. -When [upgrading InfluxDB Clustered](/influxdb3/clustered/admin/upgrade/), -**always upgrade to each checkpoint release first, before proceeding to newer versions**. - -Checkpoint releases are only made when absolutely necessary and are clearly -identified below with the icon. -{{% /note %}} +> [!Note] +> ## Checkpoint releases {.checkpoint} +> +> Some InfluxDB Clustered releases are checkpoint releases that introduce a +> breaking change to an InfluxDB component. +> When [upgrading InfluxDB Clustered](/influxdb3/clustered/admin/upgrade/), +> **always upgrade to each checkpoint release first, before proceeding to newer versions**. +> +> Checkpoint releases are only made when absolutely necessary and are clearly +> identified below with the icon. {{< release-toc >}} @@ -181,11 +180,10 @@ For customers who experience this bug when attempting to upgrade to ## 20240925-1257864 {date="2024-09-25" .checkpoint} -{{% warn %}} -This release has a number of bugs in it which make it unsuitable for customer use. -If you are currently running this version, please upgrade to -[20241024-1354148](#20241024-1354148). -{{% /warn %}} +> [!Caution] +> This release has a number of bugs in it which make it unsuitable for customer use. +> If you are currently running this version, please upgrade to +> [20241024-1354148](#20241024-1354148). ### Quickstart @@ -352,10 +350,9 @@ validation error when omitted. When the `admin` section is omitted, the `admin-token` `Secret` can be used instead to get started quickly. -{{% note %}} -We still highly recommend OAuth for production; however, this lets you run an -InfluxDB Cluster with out having to integrate with an identity provider.** -{{% /note %}} +> [!Note] +> We still highly recommend OAuth for production; however, this lets you run an +> InfluxDB Cluster with out having to integrate with an identity provider.** ### Upgrade notes @@ -680,11 +677,10 @@ Kubernetes scheduler's default behavior. For further details, please consult the - Fix gRPC reflection to only include services served by a particular listening port. - {{% note %}} - `arrow.flight.protocol.FlightService` is known to be missing in the - `iox-shared-querier`'s reflection service even though `iox-shared-querier` - does run that gRPC service. - {{% /note %}} + > [!Note] + > `arrow.flight.protocol.FlightService` is known to be missing in the + > `iox-shared-querier`'s reflection service even though `iox-shared-querier` + > does run that gRPC service. --- @@ -889,10 +885,9 @@ spec: ### Highlights -{{% warn %}} -**This release fixes a regression in the database engine that was introduced in -[20231115-746129](#20231115-746129).** -{{% /warn %}} +> ![Important] +> **This release fixes a regression in the database engine that was introduced in +> [20231115-746129](#20231115-746129).** ### Changes From ae32fa01f981623948f261c4ca57ea8e6b54de6d Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 24 Feb 2025 09:16:58 -0600 Subject: [PATCH 2/2] Update content/influxdb3/clustered/reference/release-notes/clustered.md --- .../influxdb3/clustered/reference/release-notes/clustered.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/influxdb3/clustered/reference/release-notes/clustered.md b/content/influxdb3/clustered/reference/release-notes/clustered.md index c33a73018..200496b09 100644 --- a/content/influxdb3/clustered/reference/release-notes/clustered.md +++ b/content/influxdb3/clustered/reference/release-notes/clustered.md @@ -351,8 +351,8 @@ When the `admin` section is omitted, the `admin-token` `Secret` can be used instead to get started quickly. > [!Note] -> We still highly recommend OAuth for production; however, this lets you run an -> InfluxDB Cluster with out having to integrate with an identity provider.** +> We recommend OAuth for production; however, the `admin-token` lets you run an +> InfluxDB Cluster without having to integrate with an identity provider.** ### Upgrade notes