aws-docdb: support Serverless Cluster

[mazyu36]

Describe the feature

Amazon DocumentDB Serverless is now general available.
L1 Construct supports it, but L2 Construct doesn't yet.

https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-docdb-dbcluster.html#cfn-docdb-dbcluster-serverlessv2scalingconfiguration

Use Case

To use Serverless Cluster.

Proposed Solution

Support for ServerlessV2ScalingConfiguration in L2 construct.

However, since the instanceType property is required in the L2 DatabaseCluster construct, we cannot simply add a new property.

A possible solution would be to create a new L2 construct such as ServerlessCluster.

Other Information

No response

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

AWS CDK Library version (aws-cdk-lib)

all

AWS CDK CLI version

all

Environment details (OS name and version, etc.)

all

[pahud]

Hi @mazyu36

Yes this would be an awesome addition. I am not sure this requires a RFC but it would be great if we have a RFC for the team before writing the PR. I am reaching out to the team for input here.

[related-issues-bot-for-aws]

Hi @mazyu36,

Thanks for opening this issue! After reviewing the details, we found some other discussions that may be closely related:

Related Issues

• docdb: support for specifying storage type for Cluster #30165: Both issues address gaps in the DocumentDB L2 construct API where features available in CloudFormation are not yet exposed. While the current issue focuses on ServerlessV2ScalingConfiguration support for serverless clusters, docdb: support for specifying storage type for Cluster #30165 addresses storage type configuration. Both represent the same pattern of needing to expose specific CloudFormation properties in the DocumentDB L2 construct and potentially require similar implementation approaches with property additions or new constructs.

• DocumentDB level 2 constructs #6511: The current issue represents a specific feature extension to the DocumentDB L2 constructs that were initially developed as part of DocumentDB level 2 constructs #6511. Both issues aim to improve the developer experience when using DocumentDB with CDK. The serverless cluster support requested in the current issue can be considered a natural evolution of the L2 construct capabilities that began with DocumentDB level 2 constructs #6511, addressing newly released AWS features that weren't available when the original L2 constructs were designed.

This message was generated automatically to help connect related conversations and improve discoverability

Please react with 👍 or 👎 to let us know if this response was helpful!

Thank you for helping improve CDK! 🙌

[vishaalmehrishi]

@mazyu36 I have created a PR to add the serverless cluster support: #35574. I would appreciate it if you can take a look.

However, since the instanceType property is required in the L2 DatabaseCluster construct, we cannot simply add a new property.

I thought about this, then settled on making it optional. Loosening the constraint on a property is not a breaking change, and this also aligns with the current console experience of choosing between instance-backed or serverless clusters when creating a new cluster in the AWS console.

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.