From 4cecc27be231513802cf9b3899e188a5e1f99af3 Mon Sep 17 00:00:00 2001 From: WeblWabl Date: Fri, 12 Dec 2025 17:07:48 -0600 Subject: [PATCH] feat: Add v2.8.0 release notes (#6623) * feat: Add v2.8.0 release notes * feat: add token hashing doc * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman * chore(influxdbv2): Revise release notes and bump version to 2.8.0. --------- Co-authored-by: Jason Stirnaman --- PLATFORM_REFERENCE.md | 2 +- .../v2/reference/release-notes/influxdb.md | 59 +++++++++++++++++++ data/products.yml | 6 +- 3 files changed, 63 insertions(+), 4 deletions(-) diff --git a/PLATFORM_REFERENCE.md b/PLATFORM_REFERENCE.md index a0fc31afe..5cec04113 100644 --- a/PLATFORM_REFERENCE.md +++ b/PLATFORM_REFERENCE.md @@ -52,7 +52,7 @@ InfluxDB 3 Explorer: - Documentation: https://docs.influxdata.com/influxdb3/explorer/ Telegraf: - - Documentation: https://docs.influxdata.com/telegraf/v1.36/ + - Documentation: https://docs.influxdata.com/telegraf/v1.37/ Chronograf: - Documentation: https://docs.influxdata.com/chronograf/v1.10/ diff --git a/content/influxdb/v2/reference/release-notes/influxdb.md b/content/influxdb/v2/reference/release-notes/influxdb.md index 2de95e4ce..94eaafcc7 100644 --- a/content/influxdb/v2/reference/release-notes/influxdb.md +++ b/content/influxdb/v2/reference/release-notes/influxdb.md @@ -8,6 +8,65 @@ menu: weight: 101 --- +## v2.8.0 {date="2025-12-12"} + +### Features + +- [5e204dc](https://github.com/influxdata/influxdb/commit/5e204dc): Add optional token hashing + +#### Token hashing + +Introduces token hashing. +When activated, token hashing stores all API tokens as hashes on disk. +While token hashing is a valuable security upgrade, care should be taken when upgrading and enabling token hashing. +Use the [`use-hashed-tokens`](/influxdb/v2/reference/config-options/#use-hashed-tokens) configuration option to enable token hashing in {{< product-name >}}. + +If you are upgrading from an earlier InfluxDB 2.x version, we recommend first upgrading to version 2.8.0 (or later), and then enabling hashed tokens as a separate step. + +Token hashing is optional and you can enable token hashing at any time after the upgrade. + +#### How token hashing works + +Upon upgrading to InfluxDB v2.8.0 or later from version 2.7.12 or earlier releases, the BoltDB schema is upgraded to add a new index bucket. + +On every startup with token hashing enabled, {{< product-name >}} migrates all unhashed tokens to hashed tokens and deletes the unhashed tokens. + +With token hashing enabled, any new tokens are stored as hashed tokens. +If you then disable token hashing, newly created tokens are stored unhashed, but existing tokens remain hashed on disk. + +##### Hashed tokens erased when downgrading + +Note that once token hashing is enabled, downgrading to a version earlier than 2.8.0 erases all API tokens due to the required schema downgrade. After downgrading, you'll need to create new tokens for your clients, even if you disable token hashing before you downgrade. Disabling token hashing **does not** unhash tokens stored in hashed form. + +If token hashing is _never_ enabled, then it is possible to downgrade from v2.8.0 to v2.7.12 and earlier. + +##### Recommended process + +1. Upgrade InfluxDB. + 1. Initiate influxd shutdown. + 2. Wait for a clean shutdown. + 3. Upgrade influxd. + 4. Start influxd. +2. Verify the upgrade is successful. +3. Optional: Enable token hashing + 1. Initiate influxd shutdown. + 2. Wait for a clean shutdown. + 3. Do _one_ of the following: + - Include the `--use-hashed-tokens` command line flag + - Set the `INFLUXD_USE_HASHED_TOKENS=true` environment variable in your container environment + - Set `use-hashed-tokens` to `true` in your configuration file + 4. Start influxd. + + +### Bug Fixes + +- [305e61d](https://github.com/influxdata/influxdb/commit/305e61d): Fix compilation on Alpine Linux + +- [40a6332](https://github.com/influxdata/influxdb/commit/40a6332): Updates post-install for Linux package builds + +- [1b83d2c](https://github.com/influxdata/influxdb/commit/1b83d2c): Chore: update to go 1.23.12 (2.7) +- [40a6332](https://github.com/influxdata/influxdb/commit/40a6332): Updates post-install for Linux package builds + ## v2.7.12 {date="2025-05-20"} ### Features diff --git a/data/products.yml b/data/products.yml index b9d9c1042..da3e30e52 100644 --- a/data/products.yml +++ b/data/products.yml @@ -177,12 +177,12 @@ influxdb: versions: - v2 - v1 - latest: v2.7 + latest: v2.8 latest_patches: - v2: 2.7.12 + v2: 2.8.0 v1: 1.12.2 latest_cli: - v2: 2.7.5 + v2: 2.8.0 detector_config: query_languages: InfluxQL: