(aws cdk lib): CloudFormationDeployments missing in aws-cdk-lib

[dreamorosi]

General Issue

Unable to find CloudFormationDeployments from v1 (exported in 'aws-cdk/lib/api/cloudformation-deployments') in aws-cdk-lib (v2)

The Question

While writing some e2e tests for a library we are using CDK to provision different stacks for each suite to test the behaviour of our library in an actual Lambda execution environment. We are already able to do so using CDK v1 using something along the lines of:

import { App, Stack } from '@aws-cdk/core';
import { SdkProvider } from 'aws-cdk/lib/api/aws-auth';
import { CloudFormationDeployments } from 'aws-cdk/lib/api/cloudformation-deployments';

const integTestApp = new App();
const stack = new Stack(integTestApp, 'ExampleIntegTest');

// Add Constructs

const stackArtifact = integTestApp.synth().getStackByName(stack.stackName);
const sdkProvider = await SdkProvider.withAwsCliCompatibleDefaults({
  profile: process.env.AWS_PROFILE,
});
const cloudFormation = new CloudFormationDeployments({ sdkProvider });

await cloudFormation.deployStack({
  stack: stackArtifact,
});

We would like to migrate this to aws-cdk-lib (v2) to get the benefits of the newer version but we are unable to find SdkProvider and CloudFormationDeployments in the new version, could you confirm their presence and/or provide an alternative for v2?

CDK CLI Version

N/A

Framework Version

2.3.0

Node.js Version

N/A

OS

N/A

Language

Typescript

Language Version

N/A

Other information

Alternatively we have considered using the CloudFormation client from aws-sdk to deploy the synthesised template but in doing so we would lose the hotswap feature which we are using while writing the tests to iterate faster.

[peterwoodworth]

Hey @dreamorosi,

It seems to me that this is intentional. This PR was merged for v2 which will prevent "deep imports". That is - only explicitly defined exports can be imported by the user. This isn't explicitly exported, so this class cannot be imported

I'm not sure if that is something we'd want to expose to the user, but let me know if you'd be interested in that 🙂

[dreamorosi]

@peterwoodworth thanks for the quick reply.

Just to clarify, are CloudFormationDeployments and SdkProvider supposed to be present at all in aws-cdk-lib?? I've tried to look for that class using grep while having aws-cdk-lib installed and couldn't find them, exported or not.

In any case our use case would really benefit from having these two classes exposed in v2. I know this might fall under this RFC but there's evidence that other Customers are already relying on these classes from v1 (evidence 1, evidence 2) so while I understand that the discussion about CDK programmatic usage is a large one I'm only kindly asking to consider exposing in v2 something that was already available in v1 as an interim solution.

[peterwoodworth]

Just to clarify, are CloudFormationDeployments and SdkProvider supposed to be present at all in aws-cdk-lib?

Currently, these classes are not exposed to the user in v2.

Thank you for your request and your reasoning, it's much appreciated 🙂