Aurora

Source: src/AWS/RDS/Aurora.ts

Opinionated Aurora bring-up helper.

Aurora is the fast-start L2 for getting a working database online with one call. It creates a generated admin secret, DB subnet group, Aurora cluster, and a single writer instance by default. Optional readers, parameter groups, and an auto-wired RDS Proxy can be enabled as needs grow.

The return value intentionally exposes the underlying DB* resources so users can expand into the lower-level surface without rewriting the stack.

Creating a Database

const db = yield* AWS.RDS.Aurora("AppDb", {
  subnetIds: [privateSubnetA.subnetId, privateSubnetB.subnetId],
  securityGroupIds: [databaseSecurityGroup.groupId],
});

Scaling Out

const db = yield* AWS.RDS.Aurora("AppDb", {
  subnetIds: [privateSubnetA.subnetId, privateSubnetB.subnetId],
  securityGroupIds: [databaseSecurityGroup.groupId],
  readers: 2,
  proxy: true,
});

Querying from a Function

// the Data API is enabled by default (dataApi: true) — bind
// AWS.RDSData.ExecuteStatement to query without a VPC socket
const executeStatement = yield* AWS.RDSData.ExecuteStatement(db.cluster, {
  secret: db.secret,
  database: "app",
});
const result = yield* executeStatement({ sql: "SELECT 1" });