AWS CDK Framework Integration Test Suite

Run the full test suite with yarn integ.

See integ-runner package or yarn integ --help for detailed instructions.

Common Errors

Error: For this test you must provide your own HostedZoneId/HostedZoneName/DomainName

Some test cases require a publicly available domain name attached to a Amazon Route 53 Hosted Zone to work. These test cases need to add DNS records that are then retrieved via the public internet infrastructure. This can be a subdomain to an existing domain, but it must have a Hosted Zone configured and nameservers delegated to it.

If you haven't got one ready, see the Route 53 guide to manually create a hosted zone.

AWS CDK core team members, please check our team internal docs for guidance on how to configure domains for testing.

How to correctly run these tests

A) Each test needs exclusive access to the Hosted Zone.
You can only run one test at a time.

B) Must be run with --disable-update-workflow
The checked-in snapshot uses dummy values that will not deploy.

• Go to your Hosted Zone and write down the values for HostedZoneId, HostedZoneName and DomainName. All values must related to the same Hosted Zone.
• In your terminal run the following commands:

export HOSTED_ZONE_ID=your_hosted_zone_id
export HOSTED_ZONE_NAME=your_hosted_zone_name
export DOMAIN_NAME=your_domain_name

• Finally, in the same terminal run your specific test case with the update workflow disabled. For example:

yarn integ --disable-update-workflow aws-certificatemanager/test/integ.certificate-name