cdk-lambda-apigateway's Introduction

Sample project for API Gateway and Lambda with CDK

To deploy without dependencies and CloudFormation limitation of Template body size(512k), create small API stacks for each Microservice or module.

Table of Contents

Deploy root-api stack
Deploy device-api stack
Deploy product-api stack

Prerequisites

npm install -g [email protected]

# install packages in the root folder
npm install
cdk bootstrap

Use the cdk command-line toolkit to interact with your project:

cdk deploy: deploys your app into an AWS account
cdk synth: synthesizes an AWS CloudFormation template for your app
cdk diff: compares your app with the deployed stack
cdk watch: deployment every time a file change is detected

CDK Stack

Stack	Time
root-api (24kb)	1m 30s
device-api (24kb)	1m 30s
product-api (20kb)	1m 30s
Total	4m 30s

Steps

Use the deploy-all.sh file if you want to deploy all stacks without prompt at a time.

Step 1: root-api

Create the root API and dummy method to import from device-api and product-api stacks.

cd root-api
cdk deploy

root-api/lib/root-api-stack.ts

Step 2: device-api

cd ../device-api
cdk deploy

device-api/lib/device-api-stack.ts

SSM parameter:

/cdk-lambda-apigateway/rest-api-id
/cdk-lambda-apigateway/root-resource-id

Step 3: product-api

cd ../product-api
cdk deploy

product-api/lib/product-api-stack.ts

SSM parameter:

/cdk-lambda-apigateway/rest-api-id
/cdk-lambda-apigateway/root-resource-id

Clean Up

clean-up.sh

Structure

├── app
│   └── hello.js
├── build.gradle
├── clean-up.sh
├── deploy-all.sh
├── device-api
│   ├── bin
│   │   └── index.ts
│   ├── cdk.json
│   ├── config.ts
│   ├── jest.config.js
│   └── lib
│       └── device-api-stack.ts
├── package-lock.json
├── package.json
├── product-api
│   ├── bin
│   │   └── index.ts
│   ├── cdk.json
│   ├── config.ts
│   ├── jest.config.js
│   └── lib
│       └── product-api-stack.ts
├── root-api
│   ├── bin
│   │   └── index.ts
│   ├── cdk.json
│   ├── config.ts
│   ├── jest.config.js
│   └── lib
│       └── root-api-stack.ts
├── screenshots
│   └── apigw.png
└── tsconfig.json

Reference

CloudFormation quotas
- Template body size: 512k
- Template body size in an Amazon S3: 1M

CDK Lib

API Gateway

cdk-lambda-apigateway's People

Contributors

Watchers

cdk-lambda-apigateway's Issues

Throttling support

HTTP API suport

https://constructs.dev/packages/@aws-cdk/aws-apigatewayv2-alpha/v/2.33.0-alpha.0?lang=typescript

import { HttpUrlIntegration, HttpLambdaIntegration } from '@aws-cdk/aws-apigatewayv2-integrations-alpha';

const getBooksIntegration = new HttpUrlIntegration('GetBooksIntegration', 'https://get-books-proxy.myproxy.internal');

declare const booksDefaultFn: lambda.Function;
const booksDefaultIntegration = new HttpLambdaIntegration('BooksIntegration', booksDefaultFn);

const httpApi = new apigwv2.HttpApi(this, 'HttpApi');

httpApi.addRoutes({
  path: '/books',
  methods: [ apigwv2.HttpMethod.GET ],
  integration: getBooksIntegration,
});
httpApi.addRoutes({
  path: '/books',
  methods: [ apigwv2.HttpMethod.ANY ],
  integration: booksDefaultIntegration,
});