Skip to content

RS: new Flex docs#2871

Merged
rrelledge merged 17 commits into
mainfrom
DOC-6284
Apr 15, 2026
Merged

RS: new Flex docs#2871
rrelledge merged 17 commits into
mainfrom
DOC-6284

Conversation

@rrelledge
Copy link
Copy Markdown
Collaborator

@rrelledge rrelledge commented Mar 9, 2026

Note

Low Risk
Low risk because changes are documentation-only, primarily new pages and link/wording updates; main risk is broken or inconsistent cross-references/aliases in the docs site.

Overview
Introduces a new Flex databases docs section (content/operate/rs/flex) with overview, get-started, deployment planning, and scaling guidance.

Updates the existing databases/flash pages to de-emphasize “Redis Flex” branding (rename to “Flex”), add banner callouts directing readers to the new Flex section, and refresh links/next-steps (including updated Kubernetes and metrics references) while keeping Auto Tiering information as legacy context.

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

@rrelledge rrelledge self-assigned this Mar 9, 2026
@rrelledge rrelledge added do not merge yet rs Redis Software labels Mar 9, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 9, 2026

DOC-6284

@jit-ci
Copy link
Copy Markdown

jit-ci Bot commented Mar 9, 2026

🛡️ Jit Security Scan Results

CRITICAL HIGH MEDIUM

✅ No security findings were detected in this PR


Security scan by Jit

@kaitlynmichael
Copy link
Copy Markdown
Contributor

@rrelledge the screenshot for the "create a database" step is really large. You could scale it down to half that size I think

Copy link
Copy Markdown

@cursor cursor Bot left a comment

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 and found 3 potential issues.

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

Comment thread content/operate/rs/flex/get-started.md Outdated
Comment thread content/operate/rs/flex/scale.md Outdated
Comment thread content/operate/rs/flex/scale.md Outdated
- Reduce infrastructure costs by combining high-speed RAM with cost-efficient flash storage

{{<note>}}
Flex does not replace long-term data persistence. For workloads that require durability and recovery across restarts or failures, use Redis persistence features like [AOF (Append-Only File)]({{< relref "/operate/oss_and_stack/management/persistence#append-only-file" >}}), [RDB snapshots]({{< relref "/operate/oss_and_stack/management/persistence#snapshotting" >}}), or both. For more information, see [Database persistence]({{< relref "/operate/rs/databases/configure/database-persistence" >}}).
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I suggest adding a dedicated "What Flex isn't" section with the wording similar to the doc: https://docs.google.com/document/d/1PuFejCooJpy_gs0MoM5Pf9MLS46x6gcNUmzYfPjIHik/edit?disco=AAABz_t08H0&tab=t.0

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This info is already included in a note in https://redis.io/docs/staging/DOC-6284/operate/rs/flex/#when-to-use-flex:

Note:
Flex does not replace long-term data persistence. For workloads that require durability and recovery across restarts or failures, use Redis persistence features like AOF (Append-Only File), RDB snapshots, or both. For more information, see Database persistence.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I agree the content is indeed present, In my opinion we should have an explicit and dedicated "When not to use Flex" - up to you, resolving this comment :)

Comment thread content/operate/rs/flex/_index.md
Comment thread content/operate/rs/flex/_index.md
@mich-elle-luna
Copy link
Copy Markdown
Collaborator

Thank you this is looking great

Comment thread content/operate/rs/flex/get-started.md
Comment thread content/operate/rs/flex/get-started.md
Comment thread content/operate/rs/flex/plan.md Outdated
Comment thread content/operate/rs/flex/plan.md
Comment thread content/operate/rs/flex/scale.md
Comment thread content/operate/rs/flex/scale.md
Comment thread content/operate/rs/flex/scale.md

You can add more shards to expand dataset capacity while maintaining the existing RAM-to-flash ratio. Throughput capacity also typically increases as a result of additional shards and infrastructure. This strategy is recommended when the dataset size and traffic are expected to grow together.

Before you increase the dataset capacity and add shards, you need to add more RAM and vCPUs to handle the increased number of shards.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Let's make it more explicit:
This increases capacity without adding CPU or RAM but may reduce RAM hit-rate and increase p99 latency; monitor metrics before and after the change.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This suggestion contradicts the statement: "you need to add more RAM and vCPUs to handle the increased number of shards."

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

It's saying the same thing and adding the "monitor metrics before and after".

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I think I'm still a little confused since your original comment said "without adding CPU or RAM," but the rough draft document said "you need to add more RAM and vCPUs".

Comment thread content/operate/rs/flex/scale.md
@rrelledge rrelledge requested a review from a team April 15, 2026 13:19
Copy link
Copy Markdown
Contributor

@andy-stark-redis andy-stark-redis left a comment

Choose a reason for hiding this comment

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

Some minor suggestions/questions but otherwise LGTM.

Comment thread content/operate/rs/databases/flash/_index.md Outdated
Comment thread content/operate/rs/flex/_index.md Outdated

## Flex and Auto Tiering

Flex replaces [Auto Tiering]({{< relref "/operate/rs/7.22/databases/auto-tiering" >}}) (formerly known as Redis on Flash). Redis Software selects the implementation based on your Redis version:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Dead link in staging but the path looks OK. Maybe it resolves in the full build?

Comment thread content/operate/rs/flex/get-started.md Outdated
@rrelledge rrelledge merged commit bc22b14 into main Apr 15, 2026
47 checks passed
@rrelledge rrelledge deleted the DOC-6284 branch April 15, 2026 17:01
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