Skip to content

RS 8.2.x release docs#3640

Merged
kaitlynmichael merged 42 commits into
release-rs-8.2.0from
DOC-6645
Jul 20, 2026
Merged

RS 8.2.x release docs#3640
kaitlynmichael merged 42 commits into
release-rs-8.2.0from
DOC-6645

Conversation

@rrelledge

@rrelledge rrelledge commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

These are drafts and this PR is still a work in progress.


Note

Low Risk
Documentation-only changes with no runtime or application code; main risk is factual accuracy of breaking changes and API behavior for operators upgrading to 8.2.

Overview
Adds Redis Software 8.2.x documentation, centered on 8.2.0-25 (July 2026) release notes and an 8.2.x index, covering highlights (database-scoped roles, CRUD auditing, FIPS 140-3), breaking changes, deprecations, limitations, and security/CVE lists.

Lifecycle and compatibility embeds now include 8.2 (bundled DB versions through 8.6, default 8.6), an 8.2.x upgrade-path column, 8.0 EOL July 2028, and supported-platform matrix changes (e.g. Amazon Linux 2 not on 8.2).

Security and access control expands materially: audit_settings (modes, username/IP filters, key-byte limits) replaces/deprecates db_conns_auditing; the audit-events guide is rewritten for connection + command (CRUD) auditing, JSON examples, validation errors, and audit_sink_* metrics. New guides cover disabling REST API Basic/Digest auth (control_plane_basic_authentication) and scoping db_member/db_viewer roles via resources. REST API objects add allow_modules_upload, gradual_sync_policy, and role resources.

Operations references clarify database availability (master shard + port binding; granular bdb_unavailable_* error codes) and add Prometheus redis_server_search_total_coord_dispatch_time_ms.

Reviewed by Cursor Bugbot for commit 7ddf53b. Bugbot is set up for automated code reviews on this repo. Configure here.

@rrelledge
rrelledge requested a review from yoavredis July 15, 2026 02:24
@rrelledge rrelledge self-assigned this Jul 15, 2026
@rrelledge rrelledge added do not merge yet rs Redis Software labels Jul 15, 2026
@CLAassistant

CLAassistant commented Jul 15, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@github-actions

github-actions Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

DOC-6645

@github-actions

github-actions Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Staging links:
https://redis.io/docs/staging/DOC-6645/integrate/prometheus-with-redis-enterprise/prometheus-metrics-definitions
https://redis.io/docs/staging/DOC-6645/operate/rs/7.22/installing-upgrading/product-lifecycle
https://redis.io/docs/staging/DOC-6645/operate/rs/7.22/installing-upgrading/upgrading/upgrade-cluster
https://redis.io/docs/staging/DOC-6645/operate/rs/7.22/references/metrics/prometheus-metrics-v2
https://redis.io/docs/staging/DOC-6645/operate/rs/7.22/references/upgrade-paths
https://redis.io/docs/staging/DOC-6645/operate/rs/7.4/installing-upgrading/product-lifecycle
https://redis.io/docs/staging/DOC-6645/operate/rs/7.4/installing-upgrading/upgrading/upgrade-cluster
https://redis.io/docs/staging/DOC-6645/operate/rs/7.4/references/upgrade-paths
https://redis.io/docs/staging/DOC-6645/operate/rs/7.8/installing-upgrading/product-lifecycle
https://redis.io/docs/staging/DOC-6645/operate/rs/7.8/installing-upgrading/upgrading/upgrade-cluster
https://redis.io/docs/staging/DOC-6645/operate/rs/7.8/references/upgrade-paths
https://redis.io/docs/staging/DOC-6645/operate/rs/installing-upgrading/product-lifecycle
https://redis.io/docs/staging/DOC-6645/operate/rs/installing-upgrading/product-lifecycle/
https://redis.io/docs/staging/DOC-6645/operate/rs/installing-upgrading/upgrading/upgrade-cluster
https://redis.io/docs/staging/DOC-6645/operate/rs/monitoring/db-availability/
https://redis.io/docs/staging/DOC-6645/operate/rs/monitoring/metrics_stream_engine/prometheus-metrics-v2
https://redis.io/docs/staging/DOC-6645/operate/rs/references/metrics/prometheus-metrics-v2
https://redis.io/docs/staging/DOC-6645/operate/rs/references/rest-api/objects/bdb/
https://redis.io/docs/staging/DOC-6645/operate/rs/references/rest-api/objects/bdb/audit_settings/
https://redis.io/docs/staging/DOC-6645/operate/rs/references/rest-api/objects/cluster/
https://redis.io/docs/staging/DOC-6645/operate/rs/references/rest-api/objects/role/
https://redis.io/docs/staging/DOC-6645/operate/rs/references/rest-api/requests/bdbs/availability/
https://redis.io/docs/staging/DOC-6645/operate/rs/references/upgrade-paths
https://redis.io/docs/staging/DOC-6645/operate/rs/release-notes/rs-8-2-releases/
https://redis.io/docs/staging/DOC-6645/operate/rs/release-notes/rs-8-2-releases/rs-8-2-0-25/
https://redis.io/docs/staging/DOC-6645/operate/rs/security/access-control/create-cluster-roles/
https://redis.io/docs/staging/DOC-6645/operate/rs/security/access-control/disable-basic-authentication/
https://redis.io/docs/staging/DOC-6645/operate/rs/security/audit-events/

Comment thread content/operate/rs/security/audit-events.md
Comment thread content/operate/rs/security/audit-events.md Outdated
Comment thread content/operate/rs/security/audit-events.md
Comment thread content/operate/rs/security/audit-events.md
Comment thread content/operate/rs/security/audit-events.md
Comment thread content/operate/rs/security/audit-events.md
Comment thread content/operate/rs/references/rest-api/objects/bdb/_index.md Outdated

@yoavredis yoavredis left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kaitlynmichael I've added comments for auditing, 10x

Comment thread content/operate/rs/security/audit-events.md

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit c8c9162. Configure here.

Comment thread content/operate/rs/release-notes/rs-8-2-releases/_index.md
@kaitlynmichael
kaitlynmichael requested a review from yoavredis July 20, 2026 14:50
@kaitlynmichael
kaitlynmichael changed the base branch from main to release-rs-8.2.0 July 20, 2026 14:55
@kaitlynmichael

Copy link
Copy Markdown
Contributor

Verified against product code at tag v8.2.0-25

Two release-note items that were previously flagged for SME confirmation are now resolved directly against the shipped GA build — no SME wait needed:

gradual-sync deprecations (RED-187556). Three params are marked deprecated in the code and are now listed in the note's Deprecations section:

  • gradual_src_mode, gradual_sync_mode, gradual_sync_max_shards_per_source → use gradual_sync_policy
  • Source: cnm-go/pkg/ccs/schema/bdb.go:110-112 (// Deprecated: use gradual_sync_policy instead.) and cnm/cnm/cli/rladmin/commands/help_commands.py:542-544,712-719.

old_password (DOC-6037 / RED-164478). Documented as a deprecation (accepted and ignored on POST/PUT), not the 400 rejection the ticket described — the rejection did not ship:

  • POST/PUT (AddUserPassword/ResetUserPassword) read only NewPassword; DELETE is the only handler that reads OldPassword. No DisallowUnknownFields/unknown-field rejection exists in the password code.
  • Source: cnm-go/pkg/app/cluster_api/internal/access/identity/handler/passwords.go.

Both TODO comments have been removed. Still open (awaiting release manager): FIPS/Azure Linux 3 download rows and compatibleOSSVersion confirmation against the GA build.

@kaitlynmichael
kaitlynmichael dismissed yoavredis’s stale review July 20, 2026 19:46

All comments in this review were addressed and resolved (see inline replies; commit fae54fb), and the audit page completed a full review cycle. Dismissing the stale change request to merge into the 8.2.0 release branch. Re-review welcome — any follow-up for the audit page is tracked in DOC-6650 or can be addressed on the release-rs-8.2.0 branch.

@kaitlynmichael
kaitlynmichael merged commit e830c1a into release-rs-8.2.0 Jul 20, 2026
78 checks passed
@kaitlynmichael
kaitlynmichael deleted the DOC-6645 branch July 20, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

rs Redis Software

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants