Add new construct AmplifyDatabaseCluster

[dpilch]

Description of changes

Add new package @aws-amplify/database-construct with new construct AmplifyDatabaseCluster for creating an Aurora database cluster. The final naming and API has not been decided.

AmplifyDatabaseClusterProps

export type AmplifyDatabaseClusterProps = {
  dbType: 'POSTGRES' // `MYSQL` will come later
};

Resources

The resources property will contain the resources created by the L3 construct.

import { ISecret } from 'aws-cdk-lib/secrets-manager';
import { IDatabaseCluster } from 'aws-cdk-lib/rds';

export interface AmplifyDatabaseResources {
    readonly consoleSecret: ISecret;
    readonly dataApiSecret: ISecret;
    readonly databaseCluster: IDatabaseCluster;
}

• resources.consoleSecret - Secrets manager secret.
• resources.dataApiSecret - Secrets manager secret.
• resources.databaseCluster - Aurora cluster.

Datasource Strategy

The datasourceStrategy property will contain the datasource strategy to be passed to the Amplify GraphQL API construct. The datasource strategy is currently using SQLLambdaModelDataSourceStrategy for the PoC, but will change in the future.

Usage

import { AmplifyDatabaseCluster } from '@aws-amplify/database-construct';
import { AmplifyGraphQLAPI } from '@aws-amplify/graphql-api-construct';

const databaseCluster = new AmplifyDatabaseCluster({
  dbType: 'POSTGRES',
});

const dbManager = AmplifyDatabaseManager({
  // will get information needed from databaseCluster.resources
  databaseCluster,
});

// out of scope. but will looks something like this
dbManager.sqlStatment('create Todo table sql statement');

const schema = `
  type Todo @model {
    content: String
  }
`;

new AmplifyGraphQLAPI({
  definition: AmplifyGraphqlDefinition.fromString(
    // graphql schema needs to match databaseCluster sql schema
    // gen 2 will provide compile time type checking
    schema,
    databaseCluster.dataSourceStrategy
  ),
});

CDK / CloudFormation Parameters Changed

See description above. No change to GraphQL API construct yet.

Issue #, if available

N/A

Description of how you validated changes

• Unit tests
• E2E tests: https://us-east-1.console.aws.amazon.com/codesuite/codebuild/594813022831/projects/amplify-category-api-e2e-workflow/batch/amplify-category-api-e2e-workflow:d00bd1c6-33e6-4770-83db-a4739c264365?region=us-east-1

Checklist

• PR description included
• yarn test passes
• E2E test run linked
• Tests are changed or added

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.