Skip to content

Commit 4cecc27

Browse files
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 <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * feat: Update content/influxdb/v2/reference/release-notes/influxdb.md Co-authored-by: Jason Stirnaman <[email protected]> * chore(influxdbv2): Revise release notes and bump version to 2.8.0. --------- Co-authored-by: Jason Stirnaman <[email protected]>
1 parent b9e4035 commit 4cecc27

File tree

3 files changed

+63
-4
lines changed

3 files changed

+63
-4
lines changed

PLATFORM_REFERENCE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ InfluxDB 3 Explorer:
5252
- Documentation: https://docs.influxdata.com/influxdb3/explorer/
5353

5454
Telegraf:
55-
- Documentation: https://docs.influxdata.com/telegraf/v1.36/
55+
- Documentation: https://docs.influxdata.com/telegraf/v1.37/
5656

5757
Chronograf:
5858
- Documentation: https://docs.influxdata.com/chronograf/v1.10/

content/influxdb/v2/reference/release-notes/influxdb.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,65 @@ menu:
88
weight: 101
99
---
1010

11+
## v2.8.0 {date="2025-12-12"}
12+
13+
### Features
14+
15+
- [5e204dc](https://github.com/influxdata/influxdb/commit/5e204dc): Add optional token hashing
16+
17+
#### Token hashing
18+
19+
Introduces token hashing.
20+
When activated, token hashing stores all API tokens as hashes on disk.
21+
While token hashing is a valuable security upgrade, care should be taken when upgrading and enabling token hashing.
22+
Use the [`use-hashed-tokens`](/influxdb/v2/reference/config-options/#use-hashed-tokens) configuration option to enable token hashing in {{< product-name >}}.
23+
24+
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.
25+
26+
Token hashing is optional and you can enable token hashing at any time after the upgrade.
27+
28+
#### How token hashing works
29+
30+
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.
31+
32+
On every startup with token hashing enabled, {{< product-name >}} migrates all unhashed tokens to hashed tokens and deletes the unhashed tokens.
33+
34+
With token hashing enabled, any new tokens are stored as hashed tokens.
35+
If you then disable token hashing, newly created tokens are stored unhashed, but existing tokens remain hashed on disk.
36+
37+
##### Hashed tokens erased when downgrading
38+
39+
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.
40+
41+
If token hashing is _never_ enabled, then it is possible to downgrade from v2.8.0 to v2.7.12 and earlier.
42+
43+
##### Recommended process
44+
45+
1. Upgrade InfluxDB.
46+
1. Initiate influxd shutdown.
47+
2. Wait for a clean shutdown.
48+
3. Upgrade influxd.
49+
4. Start influxd.
50+
2. Verify the upgrade is successful.
51+
3. Optional: Enable token hashing
52+
1. Initiate influxd shutdown.
53+
2. Wait for a clean shutdown.
54+
3. Do _one_ of the following:
55+
- Include the `--use-hashed-tokens` command line flag
56+
- Set the `INFLUXD_USE_HASHED_TOKENS=true` environment variable in your container environment
57+
- Set `use-hashed-tokens` to `true` in your configuration file
58+
4. Start influxd.
59+
60+
61+
### Bug Fixes
62+
63+
- [305e61d](https://github.com/influxdata/influxdb/commit/305e61d): Fix compilation on Alpine Linux
64+
65+
- [40a6332](https://github.com/influxdata/influxdb/commit/40a6332): Updates post-install for Linux package builds
66+
67+
- [1b83d2c](https://github.com/influxdata/influxdb/commit/1b83d2c): Chore: update to go 1.23.12 (2.7)
68+
- [40a6332](https://github.com/influxdata/influxdb/commit/40a6332): Updates post-install for Linux package builds
69+
1170
## v2.7.12 {date="2025-05-20"}
1271

1372
### Features

data/products.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -177,12 +177,12 @@ influxdb:
177177
versions:
178178
- v2
179179
- v1
180-
latest: v2.7
180+
latest: v2.8
181181
latest_patches:
182-
v2: 2.7.12
182+
v2: 2.8.0
183183
v1: 1.12.2
184184
latest_cli:
185-
v2: 2.7.5
185+
v2: 2.8.0
186186
detector_config:
187187
query_languages:
188188
InfluxQL:

0 commit comments

Comments
 (0)