Define ApiGateway, Lambda and DynamoDB using AWS CDK
AWS has released a developer preview of **AWS CDK** during re:Invent 2018. A detailed description and the release informations can be found here: [AWS CDK Developer Preview](https://aws.amazon.com/blogs/developer/aws-cdk-developer-preview/). AWS CDK offers the possibility to define **Infrastructure as Code** in different programming languages, based on CloudFormation - a kind of compiler.The introductory session of re:Invent 2018:
Since I found some free time during the re:Invent, I have played around with this new software development framework - and the result is the following snippet. Here I create a very simple API with only one method implemented by a Lambda function that has permissions on a DynamoDB table. A very common scenario.
AWS CDK makes a very good impression and I am looking forward to further development. The api reference and the introductory tutorial helped me a lot while trying out CDK.
Example
#!/usr/bin/env node
import dynamodb = require('@aws-cdk/aws-dynamodb');
import lambda = require('@aws-cdk/aws-lambda');
import apigateway = require('@aws-cdk/aws-apigateway');
import iam = require('@aws-cdk/aws-iam');
import cdk = require('@aws-cdk/cdk');
class CdkStack extends cdk.Stack {
constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
super(parent, name, props);
// dynamodb table
const table = new dynamodb.Table(this, 'Table', {
tableName: 'MyBookTable',
readCapacity: 5,
writeCapacity: 5
});
table.addPartitionKey({ name: 'isbn', type: dynamodb.AttributeType.String });
table.addSortKey({ name: 'title', type: dynamodb.AttributeType.String });
// lambda role
const role = new iam.Role(this, 'LambdaExecutionRole', {
assumedBy: new iam.ServicePrincipal('lambda.amazonaws.com')
});
role.addToPolicy(new iam.PolicyStatement()
.addAction("dynamoDB:*")
.addResource(table.tableArn));
// lambda function
const apiFunction = new lambda.Function(this, 'ApiFunction', {
runtime: lambda.Runtime.NodeJS810,
handler: 'index.handler',
code: lambda.Code.asset('./lambda/apiFunction'),
role: role,
});
apiFunction.addEnvironment("DYNAMODB", table.tableArn);
// api
const api = new apigateway.LambdaRestApi(this, 'BookApi', {
handler: apiFunction,
proxy: false
});
const books = api.root.addResource('books');
books.addMethod('GET');
}
}
const app = new cdk.App();
new CdkStack(app, 'CdkStack');
app.run();
Quelle: Gist auf GitHub
Deploy
$ npm run build
$ cdk deploy
CdkStack: deploying...
Updated: lambda/apiFunction (zip)
CdkStack: creating CloudFormation changeset...
0/18 | 5:46:54 PM | CREATE_IN_PROGRESS | AWS::CDK::Metadata | CDKMetadata
0/18 | 5:46:54 PM | CREATE_IN_PROGRESS | AWS::DynamoDB::Table | Table (TableCD117FA1)
0/18 | 5:46:54 PM | CREATE_IN_PROGRESS | AWS::IAM::Role | MyApi/CloudWatchRole (MyApiCloudWatchRole2BEC1A9C)
0/18 | 5:46:54 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::RestApi | MyApi (MyApi49610EDF)
0/18 | 5:46:54 PM | CREATE_IN_PROGRESS | AWS::IAM::Role | LambdaExecutionRole (LambdaExecutionRoleD5C26073)
0/18 | 5:46:55 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::RestApi | MyApi (MyApi49610EDF) Resource creation Initiated
0/18 | 5:46:55 PM | CREATE_IN_PROGRESS | AWS::IAM::Role | MyApi/CloudWatchRole (MyApiCloudWatchRole2BEC1A9C) Resource creation Initiated
1/18 | 5:46:55 PM | CREATE_COMPLETE | AWS::ApiGateway::RestApi | MyApi (MyApi49610EDF)
1/18 | 5:46:55 PM | CREATE_IN_PROGRESS | AWS::IAM::Role | LambdaExecutionRole (LambdaExecutionRoleD5C26073) Resource creation Initiated
1/18 | 5:46:55 PM | CREATE_IN_PROGRESS | AWS::DynamoDB::Table | Table (TableCD117FA1) Resource creation Initiated
1/18 | 5:46:56 PM | CREATE_IN_PROGRESS | AWS::CDK::Metadata | CDKMetadata Resource creation Initiated
2/18 | 5:46:56 PM | CREATE_COMPLETE | AWS::CDK::Metadata | CDKMetadata
2/18 | 5:46:57 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Resource | MyApi/books (MyApibooks3B7A4845)
2/18 | 5:46:58 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Resource | MyApi/books (MyApibooks3B7A4845) Resource creation Initiated
3/18 | 5:46:58 PM | CREATE_COMPLETE | AWS::ApiGateway::Resource | MyApi/books (MyApibooks3B7A4845)
4/18 | 5:47:12 PM | CREATE_COMPLETE | AWS::IAM::Role | LambdaExecutionRole (LambdaExecutionRoleD5C26073)
5/18 | 5:47:12 PM | CREATE_COMPLETE | AWS::IAM::Role | MyApi/CloudWatchRole (MyApiCloudWatchRole2BEC1A9C)
5/18 | 5:47:16 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Account | MyApi/Account (MyApiAccount13882D84)
5/18 | 5:47:16 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Account | MyApi/Account (MyApiAccount13882D84) Resource creation Initiated
6/18 | 5:47:16 PM | CREATE_COMPLETE | AWS::ApiGateway::Account | MyApi/Account (MyApiAccount13882D84)
7/18 | 5:47:26 PM | CREATE_COMPLETE | AWS::DynamoDB::Table | Table (TableCD117FA1)
7/18 | 5:47:28 PM | CREATE_IN_PROGRESS | AWS::IAM::Policy | LambdaExecutionRole/DefaultPolicy (LambdaExecutionRoleDefaultPolicy6D69732F)
7/18 | 5:47:29 PM | CREATE_IN_PROGRESS | AWS::IAM::Policy | LambdaExecutionRole/DefaultPolicy (LambdaExecutionRoleDefaultPolicy6D69732F) Resource creation Initiated
8/18 | 5:47:37 PM | CREATE_COMPLETE | AWS::IAM::Policy | LambdaExecutionRole/DefaultPolicy (LambdaExecutionRoleDefaultPolicy6D69732F)
8/18 | 5:47:41 PM | CREATE_IN_PROGRESS | AWS::Lambda::Function | ApiFunction (ApiFunctionCE271BD4)
8/18 | 5:47:41 PM | CREATE_IN_PROGRESS | AWS::Lambda::Function | ApiFunction (ApiFunctionCE271BD4) Resource creation Initiated
9/18 | 5:47:42 PM | CREATE_COMPLETE | AWS::Lambda::Function | ApiFunction (ApiFunctionCE271BD4)
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.POST..books (ApiFunctionApiPermissionTestPOSTbooksD1708053)
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/POST (MyApibooksPOST4754AE3D)
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/GET (MyApibooksGETE904505A)
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.POST..books (ApiFunctionApiPermissionTestPOSTbooksD1708053) Resource creation Initiated
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/POST (MyApibooksPOST4754AE3D) Resource creation Initiated
9/18 | 5:47:44 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/GET (MyApibooksGETE904505A) Resource creation Initiated
9/18 | 5:47:45 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.GET..books (ApiFunctionApiPermissionTestGETbooks6367DD87)
10/18 | 5:47:45 PM | CREATE_COMPLETE | AWS::ApiGateway::Method | MyApi/books/POST (MyApibooksPOST4754AE3D)
11/18 | 5:47:45 PM | CREATE_COMPLETE | AWS::ApiGateway::Method | MyApi/books/GET (MyApibooksGETE904505A)
11/18 | 5:47:45 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.GET..books (ApiFunctionApiPermissionTestGETbooks6367DD87) Resource creation Initiated
11/18 | 5:47:47 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Deployment | MyApi/Deployment (MyApiDeploymentECB0D05Ea065860f692ff7ab36dc0964da566bd9)
11/18 | 5:47:48 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Deployment | MyApi/Deployment (MyApiDeploymentECB0D05Ea065860f692ff7ab36dc0964da566bd9) Resource creation Initiated
12/18 | 5:47:48 PM | CREATE_COMPLETE | AWS::ApiGateway::Deployment | MyApi/Deployment (MyApiDeploymentECB0D05Ea065860f692ff7ab36dc0964da566bd9)
12/18 | 5:47:50 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Stage | MyApi/DeploymentStage.prod (MyApiDeploymentStageprodE1054AF0)
12/18 | 5:47:51 PM | CREATE_IN_PROGRESS | AWS::ApiGateway::Stage | MyApi/DeploymentStage.prod (MyApiDeploymentStageprodE1054AF0) Resource creation Initiated
13/18 | 5:47:52 PM | CREATE_COMPLETE | AWS::ApiGateway::Stage | MyApi/DeploymentStage.prod (MyApiDeploymentStageprodE1054AF0)
13/18 | 5:47:54 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.POST..books (ApiFunctionApiPermissionPOSTbooks9952FDA4)
13/18 | 5:47:54 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.GET..books (ApiFunctionApiPermissionGETbooks65B610C0)
13/18 | 5:47:54 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.POST..books (ApiFunctionApiPermissionPOSTbooks9952FDA4) Resource creation Initiated
13/18 | 5:47:54 PM | CREATE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.GET..books (ApiFunctionApiPermissionGETbooks65B610C0) Resource creation Initiated
14/18 | 5:47:55 PM | CREATE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.POST..books (ApiFunctionApiPermissionTestPOSTbooksD1708053)
15/18 | 5:47:55 PM | CREATE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.GET..books (ApiFunctionApiPermissionTestGETbooks6367DD87)
16/18 | 5:48:04 PM | CREATE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.POST..books (ApiFunctionApiPermissionPOSTbooks9952FDA4)
17/18 | 5:48:04 PM | CREATE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.GET..books (ApiFunctionApiPermissionGETbooks65B610C0)
✅ CdkStack
Outputs:
CdkStack.MyApiEndpoint869ABE96 = https://9n19sozuck.execute-api.eu-central-1.amazonaws.com/prod/
Stack ARN:
arn:aws:cloudformation:eu-central-1:*************:stack/CdkStack/b929dc20-f441-11e8-bcbd-063afe18f80a
Quelle: Gist auf GitHub
Destroy
$ cdk destroy
Are you sure you want to delete: CdkStack (y/n)? y
CdkStack: destroying...
0 | 5:51:19 PM | DELETE_IN_PROGRESS | AWS::CloudFormation::Stack | CdkStack User Initiated
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.GET..books (ApiFunctionApiPermissionTestGETbooks6367DD87)
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::CDK::Metadata | CDKMetadata
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.GET..books (ApiFunctionApiPermissionGETbooks65B610C0)
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.POST..books (ApiFunctionApiPermissionPOSTbooks9952FDA4)
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Account | MyApi/Account (MyApiAccount13882D84)
0 | 5:51:21 PM | DELETE_IN_PROGRESS | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.POST..books (ApiFunctionApiPermissionTestPOSTbooksD1708053)
1 | 5:51:21 PM | DELETE_COMPLETE | AWS::ApiGateway::Account | MyApi/Account (MyApiAccount13882D84)
1 | 5:51:22 PM | DELETE_IN_PROGRESS | AWS::IAM::Role | MyApi/CloudWatchRole (MyApiCloudWatchRole2BEC1A9C)
2 | 5:51:23 PM | DELETE_COMPLETE | AWS::CDK::Metadata | CDKMetadata
3 | 5:51:23 PM | DELETE_COMPLETE | AWS::IAM::Role | MyApi/CloudWatchRole (MyApiCloudWatchRole2BEC1A9C)
4 | 5:51:31 PM | DELETE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.GET..books (ApiFunctionApiPermissionTestGETbooks6367DD87)
5 | 5:51:31 PM | DELETE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.Test.POST..books (ApiFunctionApiPermissionTestPOSTbooksD1708053)
6 | 5:51:31 PM | DELETE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.POST..books (ApiFunctionApiPermissionPOSTbooks9952FDA4)
7 | 5:51:32 PM | DELETE_COMPLETE | AWS::Lambda::Permission | ApiFunction/ApiPermission.GET..books (ApiFunctionApiPermissionGETbooks65B610C0)
7 | 5:51:33 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Stage | MyApi/DeploymentStage.prod (MyApiDeploymentStageprodE1054AF0)
8 | 5:51:33 PM | DELETE_COMPLETE | AWS::ApiGateway::Stage | MyApi/DeploymentStage.prod (MyApiDeploymentStageprodE1054AF0)
8 | 5:51:35 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Deployment | MyApi/Deployment (MyApiDeploymentECB0D05Ea065860f692ff7ab36dc0964da566bd9)
9 | 5:51:35 PM | DELETE_COMPLETE | AWS::ApiGateway::Deployment | MyApi/Deployment (MyApiDeploymentECB0D05Ea065860f692ff7ab36dc0964da566bd9)
9 | 5:51:36 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/GET (MyApibooksGETE904505A)
9 | 5:51:36 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Method | MyApi/books/POST (MyApibooksPOST4754AE3D)
10 | 5:51:36 PM | DELETE_COMPLETE | AWS::ApiGateway::Method | MyApi/books/GET (MyApibooksGETE904505A)
11 | 5:51:36 PM | DELETE_COMPLETE | AWS::ApiGateway::Method | MyApi/books/POST (MyApibooksPOST4754AE3D)
11 | 5:51:37 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::Resource | MyApi/books (MyApibooks3B7A4845)
11 | 5:51:38 PM | DELETE_IN_PROGRESS | AWS::Lambda::Function | ApiFunction (ApiFunctionCE271BD4)
12 | 5:51:38 PM | DELETE_COMPLETE | AWS::ApiGateway::Resource | MyApi/books (MyApibooks3B7A4845)
13 | 5:51:38 PM | DELETE_COMPLETE | AWS::Lambda::Function | ApiFunction (ApiFunctionCE271BD4)
13 | 5:51:39 PM | DELETE_IN_PROGRESS | AWS::ApiGateway::RestApi | MyApi (MyApi49610EDF)
13 | 5:51:39 PM | DELETE_IN_PROGRESS | AWS::IAM::Policy | LambdaExecutionRole/DefaultPolicy (LambdaExecutionRoleDefaultPolicy6D69732F)
14 | 5:51:39 PM | DELETE_COMPLETE | AWS::ApiGateway::RestApi | MyApi (MyApi49610EDF)
15 | 5:51:40 PM | DELETE_COMPLETE | AWS::IAM::Policy | LambdaExecutionRole/DefaultPolicy (LambdaExecutionRoleDefaultPolicy6D69732F)
15 | 5:51:41 PM | DELETE_IN_PROGRESS | AWS::IAM::Role | LambdaExecutionRole (LambdaExecutionRoleD5C26073)
15 | 5:51:41 PM | DELETE_IN_PROGRESS | AWS::DynamoDB::Table | Table (TableCD117FA1)
16 | 5:51:41 PM | DELETE_COMPLETE | AWS::IAM::Role | LambdaExecutionRole (LambdaExecutionRoleD5C26073)
16 Currently in progress: CdkStack, TableCD117FA1
✅ CdkStack: destroyed
Quelle: Gist auf GitHub