This is a stable example. It should successfully build out of the box

This example is built on Construct Libraries marked "Stable" and does not have any infrastructure prerequisites to build.

This project is intended to be sample code only. Not for use in production.

This project will create the following in your AWS cloud environment:

• IAM group
• IAM user (added to the IAM group)
• S3 bucket
• DynamoDB table
• Lambda function that performs image classification via AWS Rekognition when new images are uploaded to the S3 bucket
• Roles and policies allowing appropriate access to these resources

Rekognition labels will be written to CloudWatch logs, a results folder in the S3 bucket, as well as the DynamoDB table.

This project was inspired by the AWS CDK workshop (https://cdkworkshop.com) and I highly recommend you go through that as well.

Requirements:

• git
• npm (node.js)
• python 3.x
• AWS access key & secret for AWS user with permissions to create resources listed above

First, you will need to install the AWS CDK:

$ sudo npm install -g aws-cdk

You can check the toolkit version with this command:

$ cdk --version

Next, you will want to create a project directory:

$ mkdir ~/cdk-samples

Now you are ready to create a virtualenv:

$ cd ~/cdk-samples
$ python3 -m venv .venv

Activate your virtualenv:

$ source .venv/bin/activate

Now you're ready to clone this repo and change to this sample directory:

$ git clone https://github.com/aws-samples/aws-cdk-examples.git
$ cd python/rekognition-lambda-s3-trigger

Install the required dependencies:

$ pip install -r requirements.txt

At this point you can now synthesize the CloudFormation template for this code.

$ cdk synth

If everything looks good, go ahead and deploy! This step will actually make changes to your AWS cloud environment.

$ cdk bootstrap
$ cdk deploy

Upload an image fie to the S3 bucket that was created by CloudFormation. The image will be automatically classified. Results can be found in DynamoDB, S3 bucket "results" folder, and CloudWatch logs for the Lambda function

To clean up, issue this command (this will NOT remove the DynamoDB table, CloudWatch logs, or S3 bucket -- you will need to do those manually) :

$ cdk destroy

To exit the virtualenv python environment:

$ deactivate

• cdk ls list all stacks in the app
• cdk synth emits the synthesized CloudFormation template
• cdk deploy deploy this stack to your default AWS account/region
• cdk diff compare deployed stack with current state
• cdk docs open CDK documentation

This code has been tested and verified to run with AWS CDK 1.100.0 (build d996c6d)