Skip to content

De-emphasize RDS Proxy in RDI setup documentation#2807

Open
dimitarseykov-redis wants to merge 3 commits intoredis:mainfrom
dimitarseykov-redis:RDSC-4604-remove-RDS-Proxy-from-public-docs
Open

De-emphasize RDS Proxy in RDI setup documentation#2807
dimitarseykov-redis wants to merge 3 commits intoredis:mainfrom
dimitarseykov-redis:RDSC-4604-remove-RDS-Proxy-from-public-docs

Conversation

@dimitarseykov-redis
Copy link
Contributor

@dimitarseykov-redis dimitarseykov-redis commented Feb 19, 2026

Summary

This PR updates the RDI setup documentation to de-emphasize RDS Proxy and recommend the Lambda function approach instead.

Changes

Rationale

  • RDS Proxy is not recommended for RDI connections
  • Lambda function approach provides better failover handling
  • RDS Proxy doesn't work with PostgreSQL due to logical replication incompatibility
  • Some customers may still require RDS Proxy for specific use cases, so we keep it available but hidden

Related

Jira: RDSC-4604


Pull Request opened by Augment Code with guidance from the PR author


Note

Low Risk
Documentation-only updates that change recommended connectivity guidance for RDS/Aurora; low implementation risk but could affect user setup choices if instructions are inaccurate.

Overview
Updates the RDS/Aurora PrivateLink setup docs to de-emphasize RDS Proxy and recommend a Lambda-based failover approach for all engines.

Moves RDS Proxy instructions into an optional collapsed section with warnings (including PostgreSQL logical replication incompatibility), adjusts NLB target guidance to use either database IP or proxy IP, and adds a new Set up Lambda function connectivity section with Terraform-based deployment steps and links.

Written by Cursor Bugbot for commit b7f6578. This will update automatically on new commits. Configure here.

- Move RDS Proxy setup to optional collapsible section with warning
- Recommend Lambda function approach for all database types
- Add links to AWS docs and Redis Terraform solution
- Update NLB instructions to support both direct connection and RDS Proxy
- Reorder steps so ARNs are available before Lambda setup

RDS Proxy is no longer recommended but remains available for customers
who have specific requirements that necessitate it.
@dwdougherty dwdougherty added rc Redis Cloud docs rdi labels Feb 19, 2026
@cmilesb cmilesb self-requested a review February 20, 2026 18:33
{{<note>}}
For RDS PostgreSQL and Aurora PostgreSQL, skip this step and proceed directly to [Create network load balancer](#create-network-load-balancer-rds) and configure it to connect directly to your database IP address.
{{</note>}}
<details>
Copy link
Contributor

Choose a reason for hiding this comment

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

@dimitarseykov-redis - Do we really need to keep these instructions on the docs site? I think it may just be better to remove them unless you have some examples where using an RDS proxy would be better than a lambda function.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Some customers still insist on using RDS Proxy. That's why I suggest having it present in the docs, but hidden.


For more details on AWS PrivateLink, see [Share your services through AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html).

### Set up Lambda function connectivity {#setup-lambda-function}
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd like to write out the exact steps here if possible, especially if this is our preferred solution over the RDS proxy.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

added

- Add step-by-step instructions for deploying the aws-rds-lambda module
- Include prerequisites section with Terraform and AWS CLI requirements
- Add required variables table with descriptions and where to find each value
- Document how the Lambda failover mechanism works
- Add verification steps to confirm successful deployment
- Include options for full infrastructure deployment and manual setup
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

rc Redis Cloud docs rdi

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants