The aws-samples/aws-cdk-examples repository is a collection of example projects and code snippets demonstrating how to use the AWS Cloud Development Kit (CDK) to define cloud infrastructure as code. It covers various AWS services and common architectural patterns, providing developers with practical examples to learn from and adapt for their own projects.

Pros

• Comprehensive collection of examples covering many AWS services and use cases
• Well-organized structure with examples categorized by programming language
• Regularly updated to reflect the latest CDK features and best practices
• Includes both simple and complex examples, catering to different skill levels

Cons

• Some examples may become outdated as AWS services and CDK evolve
• Not all examples are available in every supported programming language
• Limited documentation within some example projects
• May require additional AWS knowledge to fully understand and implement certain examples

Code Examples

Here are a few short code examples from the repository:

1. Creating an S3 bucket with CDK (TypeScript):

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';

export class MyStack extends cdk.Stack {
  constructor(scope: cdk.App, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    new s3.Bucket(this, 'MyBucket', {
      versioned: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });
  }
}

2. Creating a Lambda function with CDK (Python):

from aws_cdk import (
    Stack,
    aws_lambda as _lambda,
)
from constructs import Construct

class MyStack(Stack):
    def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
        super().__init__(scope, construct_id, **kwargs)

        _lambda.Function(
            self, 'MyLambdaFunction',
            runtime=_lambda.Runtime.PYTHON_3_9,
            handler='index.handler',
            code=_lambda.Code.from_asset('lambda')
        )

3. Creating an API Gateway with CDK (JavaScript):

const cdk = require('aws-cdk-lib');
const apigateway = require('aws-cdk-lib/aws-apigateway');

class MyStack extends cdk.Stack {
  constructor(scope, id, props) {
    super(scope, id, props);

    new apigateway.RestApi(this, 'MyApi', {
      restApiName: 'My API Service',
      description: 'This service serves as an example API.',
    });
  }
}

Getting Started

To get started with the AWS CDK examples:

1. Clone the repository:

   git clone https://github.com/aws-samples/aws-cdk-examples.git
   

2. Navigate to the desired example directory:

   cd aws-cdk-examples/typescript/my-widget-service
   

3. Install dependencies:

   npm install
   

4. Deploy the stack:

   cdk deploy
   

Note: Make sure you have the AWS CDK CLI installed and configured with your AWS credentials before deploying.