← Blog 02. Dezember 2018 · Amazon Web Services · AWS CDK · Snippets

Define ApiGateway, Lambda and DynamoDB using AWS CDK

AWS CDK VSCode 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