Skip to content

README.md

Latest commit

 

History

History
46 lines (33 loc) · 1.62 KB

README.md

File metadata and controls

46 lines (33 loc) · 1.62 KB

Guide to deploying Distributed Load Testing on AWS (DLT) using cdk

To support custom deployments of DLT, solution's IaC is developed with AWS CDK.

Pre-requisites

Following instructions for cdk deploy require docker engine running Make sure to run the docker login command for public.aws.ecr/v2 aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws/v2

Deploy primary stack

Time to deploy: ~ 10 minutes

# install dependencies
npm ci
npm run install:all

# bootstrap cdk environment
npx cdk bootstrap --profile {myProfile}

# deploy stack
npx cdk deploy DLTStack --profile {myProfile} --parameters AdminName={myAdmin} --parameters AdminEmail={myEmail}
  • myProfile - aws profile with required permissions to deploy in your account
  • myAdmin - username to login to DLT web portal
  • myEmail - email address to receive temporary login credentials

Deploy regional stack

Time to deploy: ~ 5 minutes

# bootstrap cdk environment
AWS_REGION={myRegion} npx cdk bootstrap --profile {myProfile}

AWS_REGION={myRegion} npx cdk deploy RegionalDLTStack --profile {myProfile} --parameters ScenariosBucket={myBucket} \
--parameters ScenariosTable={myTable} --parameters PrimaryStackRegion={myPrimaryRegion}
  • myRegion - aws region for deploying regional DLT stack, to perform load test from that region
  • myBucket - s3 bucket from primary stack output
  • myTable - dynamodb table from primary stack output
  • myPrimaryRegion - region of deployment for primary stack

Note: AWS_REGION={myRegion} can be prepended to cdk deploy to change region of deployment