Deploy Resoto to Amazon Web Services
We provide a CDK construct to simplify the deployment of Resoto to AWS.
The Resoto web installer is the easiest way to get a production-grade setup, whereas the CDK construct is a bit more involved but gives you more control over the setup and does not require you to send us your cloud credentials.
- AWS account with IAM role permissions
- AWS command-line interface
Run the following commands in the terminal:
$ git clone firstname.lastname@example.org:someengineering/resoto-cdk.git
$ cd resoto-cdk
$ npm ci
Then, deploy Resoto with the following command:
$ npm run cdk deploy -- --parameters ResotoTag=edgenote
If this is your first CDK deployment, you will need to bootstrap your AWS account. You can do so with the following command:
$ npm run cdk bootstrapinfo
It is possible to override the default CloudFormation parameter values:
$ npm run cdk deploy -- --parameters ResotoTag=edge --parameters MngInstanceType=t3.large
Parameter Description Default Value
The Resoto image tag to use
The maximum number of instances in the k8s managed node group
The minimum number of instances in the k8s managed node group
The desired number of instances in the k8s managed node group
The instance type of the k8s managed node group
Confirm the deployment. This will trigger CDK to create an EKS cluster and install the Resoto Helm chart.info
The deployment will take approximately 30 minutes. You can follow the progress in the terminal.
Once deployment is complete, you will see output similar to the following:
ResotoEKS.ResotoEKSConfigCommandXXXX = aws eks update-kubeconfig ...
ResotoEKS.ResotoPskSecret = kubectl get secrets ...
ResotoEKS.ResotoUI = https://a3xxxxxx.us-east-1.elb.amazonaws.com:8900
The value of
ResotoEKS.ResotoEKSConfigCommandXXXXin Outputs is a command to configure
kubectlto connect to the EKS cluster. Copy the command and paste it into your terminal.
Removing the Resoto Deployment
To remove the Resoto deployment and all associated resources, run the following command in the terminal:
$ cdk destroy
Removing the Resoto stack will also delete all data stored in the Resoto database.