/AWS-Managed-Services

Primary LanguageJavaScript

Welcome to your CDK TypeScript project!

This is a blank project for TypeScript development with CDK.

The cdk.json file tells the CDK Toolkit how to execute your app.

Useful commands

  • npm run build compile typescript to js
  • npm run watch watch for changes and compile
  • npm run test perform the jest unit tests
  • cdk deploy deploy this stack to your default AWS account/region
  • cdk diff compare deployed stack with current state
  • cdk synth emits the synthesized CloudFormation template

Architecture

This project's intention is to demostrate the use of the following AWS Managed Services:

  • CloudFormation
    • The use of the AWS CDK to create/organize stacks
    • Stack's dependencies
  • API Gateway
    • Lambda integration
    • Log Groups
  • Lambda (Node.js)
    • Bundle, memory, timeout ... configuration
    • Environment variables
    • Granting correct permissions
    • Invoked by API Gateway
    • Invoked by SQS
    • Invoked by S3
    • Invoked by another Lambda
    • Lambda with DLQ
  • DynamoDB
    • Single table design
    • Primary key concepts (Partition Key + Sort Key)
    • Query vs Scan
    • Time to live attributes
    • Provisioned vs on-demand capacity
    • Indexes: GSI, LSI, projections
  • S3
    • Bucket creation
    • Integration with Lambdas
    • Event notification
  • SQS
    • Dead letter queue (DLQ) configuration
  • CloudWatch Logs and X-Ray
    • Configuration in stacks and lambdas code
    • Log levels
  • Cognito
    • APIs authentication / authorization
    • Lambdas to interfere in the login process (triggers)
    • OAuth2
    • TODO: SAML
    • TODO: Google / Facebook integration

[Architecture

Instructions to get the environment ready

Node.js and NPM

Download the Node.js https://nodejs.org/en/download/

To double-check if Node.js was installed correctly:

node -v

To double-check if NPM was installed correctly:

npm -v

NestJS CLI

NestJS is a framework that simplifies the REST creation:

npm i -g @nestjs/cli

AWS CLI

Installation link: https://aws.amazon.com/cli/

aws --v
  • IAM user creation

Open the AWS Console -> IAM, add a user with "Programmatic access" and choose the "Administrator Access" policy.

Click "Next" till the last screen with the effective user creation.

Copy the new user's access credentials ("Access Key Id" and "Secret Access Key").

  • Configuring AWS CLI with the IAM user credentials

Type in the command:

aws configure
  • Parameter 1: Access Key ID
  • Parameter 2: Secret Access Key
  • Parameter 3: us-east-1
  • Parameter 4: JSON

AWS CDK

The AWS Cloud Development Kit (AWS CDK) will be used to build the code responsible for creating the AWS services infrastructure:

npm install -g aws-cdk
cdk --version

Docker

Docker images are used with the aws-cdk/aws-lambda-nodejs lib.

Download: https://www.docker.com/products/docker-desktop

To check if Docker was installed correctly:

docker -v

Visual Studio Code

Download the Visual Studio Code: https://code.visualstudio.com/

Extensions:

  • AWS Toolkit
  • AWS CDK

Postman

Postman can be used in order to test the API.

Download: https://www.postman.com/