@aws-cdk/aws-rds

AWS RDS Construct Library

The aws-cdk-rds package contains Constructs for setting up RDS instances.

Supported:

• Clustered databases

Not supported:

• Instance databases
• Setting up from a snapshot

Starting a Clustered Database

To set up a clustered database (like Aurora), create an instance of DatabaseCluster. You must always launch a database in a VPC. Use the vpcPlacement attribute to control whether your instances will be launched privately or publicly:

const cluster = new DatabaseCluster(stack, 'Database', {
    engine: DatabaseClusterEngine.Aurora,
    masterUser: {
        username: 'admin',
        password: '7959866cacc02c2d243ecfe177464fe6',
    },
    instanceProps: {
        instanceType: new InstanceTypePair(InstanceClass.Burstable2, InstanceSize.Small),
        vpcPlacement: {
            subnetsToUse: ec2.SubnetType.Public,
        },
        vpc
    }
});

Your cluster will be empty by default. To add a default database upon construction, specify the defaultDatabaseName attribute.

Connecting

To control who can access the cluster, use the .connections attribute. RDS database have a default port, so you don't need to specify the port:

cluster.connections.allowFromAnyIpv4('Open to the world');

The endpoints to access your database will be available as the .clusterEndpoint and .readerEndpoint attributes:

const writeAddress = cluster.clusterEndpoint.socketAddress;   // "HOSTNAME:PORT"

Changelog

0.9.1 (2018-09-13)

Bug Fixes

• aws-cdk: Fix proxy support for account lookup (#693) (5468225), closes #645

Features

• aws-ec2 BREAKING: Move LoadBalancer to aws-elasticloadbalancing package (#705) (4bd1cf2)
• aws-serverless BREAKING: Rename @aws-cdk/aws-serverless to @aws-cdk/aws-sam (#704) (3a67d5d)
• aws-dynamodb: Support DynamoDB TTL (#691) (35b6206)
• aws-dynamodb: Support DynamoDB PITR (#701) (7a4d7b7)
• aws-ecr: Add support for ECR repositories (#697) (c6c09bf)
• aws-lambda: Add support for XRay Tracing (#675) (b4435cc)
• cfnspec: Add DeploymentPreference Patch for SAM Spec (#681) (#681) (f96c487)