Project Name

ElastiServe

Description

This project leverages the power of AWS CDK (Cloud Development Kit) to streamline the deployment and management of a web application. By utilizing AWS CDK's capabilities, we can seamlessly package the web application source code, provision the required deployment infrastructure using AWS Elastic Beanstalk resources, and establish a robust CI/CD pipeline through AWS CDK Pipelines.

Prerequisites

Clone the Repository

   git clone <your-repo-link>
   cd <your-repo-directory>

• AWS Account and CLI: Set up your AWS Environment Link and ensure the CLI is installed.
• AWS CDK v2.7.0: Install the CDK. Refer to the Get Started with AWS CDK guide for more.
• GitHub Account: Create one if necessary at GitHub.

Connecting GitHub to CodePipeline

• To integrate AWS CodePipeline with your GitHub repository, you'll need to set up your previously created GitHub personal access token.

1. Store the GitHub Token in AWS Secrets Manager:

   • This token should be a plaintext secret (not JSON) in AWS Secrets Manager with the name github-token.

   • Execute the following command, making sure to replace GITHUB_ACCESS_TOKEN with your actual GitHub token and REGION with your AWS region:

     aws secretsmanager create-secret --name github-token --description "Github access token for cdk" --secret-string GITHUB_ACCESS_TOKEN --region REGION
     

   • Remember, always keep your GitHub access token confidential. Never expose it in your public repositories or elsewhere.

Deploy Web Application

1. Bootstrap CDK in Your Account

• If you're deploying with the AWS CDK for the first time in a specific account or region, you'll need to bootstrap it. If you're unsure about whether you've bootstrapped already, executing the command below will upgrade the bootstrap stack if needed:

  npx cdk bootstrap aws://ACCOUNT-NUMBER/REGION
  

  • You can retrieve your account number from the AWS Management Console and the Region name from the official Region list.

  • These bootstrap resources are contained within an AWS CloudFormation stack, typically named CDKToolkit. You can find it in the CloudFormation console.

2. Build and Deploy the CDK Application

• Once you've bootstrapped your account and region, you can build and deploy your CDK application.

  npm run build
  

Viewing Application Deployed in the Cloud

• After the pipeline finishes running through the final Pre-Prod stage, we can confirm that the service is up and running.

• We can find this URL by going to the Elastic Beanstalk service in the AWS Management Console, and look for the environment called MyWebAppEnvironment. Choose the URL to launch the web app.

Clean Up

• The benefit of using AWS CDK and CloudFormation for all infrastructure is that cleaning up AWS environment is easy. Run the following command inside the CDK application directory:

  cdk destroy
  

• We can verify the CdkPipelineStack stack was deleted by going to the AWS CloudFormation Management Console.

Conclusion

Congratulations! We have now learned how to deploy a non-containerized application in the cloud. We created a simple Node.js web application, and then we used AWS CDK to create deployment infrastructure(using AWS Elastic Beanstalk resources) and the CI/CD pipeline (using AWS CDK Pipelines)