New stack - Dynamodb atomic counter cdk-patterns#174

the-dynamodb-atomic-counter/README.md

@@ -2,9 +2,10 @@
 
 ![the dynamodb atomic counter](img/stack.png)
 
-This is a pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to design. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this. 
+This is a Serverless pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to software design or other needs. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this problem very cheaply. In addition, as this stack uses only DynamoDB and APIGateway, the response is very fast (in milliseconds).
 
-A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff)
+A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff).  
+I made changes to the original version to support multiple incremental keys, so you can use this to focus the incremental process for many systems on a single table and API.
 
 Some Useful References:
 
@@ -20,34 +21,47 @@ Some Useful References:
 * [TypeScript](typescript)
 * [Python](python)
 * [Csharp](csharp)
+* [Java](java)
 
 ## What's Included In This Pattern?
-This pattern covers the first half of Danilo Poccia's awesome [blog post](https://aws.amazon.com/blogs/aws/new-a-shared-file-system-for-your-lambda-functions/). After deployment you will have an API Gateway HTTP API where any url you hit gets directed to a Lambda Function that is integrated with EFS.
+This pattern implements an atomic counter using only DynamoDB and APIGateway.
 
-### VPC
-A VPC is bundled in this pattern because EFS requires it, this is using the default settings from CDK so if you want to put this in production you will have to review / refine this
+### DynamoDB Table
+A simple table with a hash key and an incremental field
 
-### EFS FileSystem
-A FileSystem is included in the above VPC with a removal policy of destroy. In a production system you probably would want to retain your storage on stack deletion.
+### API Gateway REST API
+This is configured with the AWS Integration method and  Request/Response integrations to transform the data.
 
-POSIX permissions are also setup for this File System
+## How Do I Test This Pattern?
 
-### Lambda Function
-A simple Python lambda function that interacts with the file system - storing, retrieving and deleting messages
+After deployment, the CDK will output a parameter like this:
 
-### API Gateway HTTP API
-This is configured with the Lambda Function as the default handler for any url you hit.
+```
+TheDynamodbAtomicCounterStack.apigwcounterurl = https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+```
 
-## How Do I Test This Pattern?
+So, just copy this URL and call this URL using the GET method through a browser, postman, curl or other http tool.
+
+## Adding new keys to increment
+
+If you want to add more keys to increment, it's very simple. Just use the DynamoDB console and add a new key.
+
+![the dynamodb atomic counter](img/img1.png)
+
+After that, you can call the two urls and use different incremental urls:
+```
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-bb
+```
+
+## Performance and concurrency testing
 
-Our deployed Lambda Function is acting as a shared message broker. It allows you to send messages to it which it stores in EFS, then you can retrieve all messages to read them or delete all messages after you have finished reading.
+API Response in less than 0.080s
 
-The Lambda Function will behave differently based on the RESTful verb you use:
+![the dynamodb atomic counter](img/img2.png)
 
-- GET - Retrieve messages
-- POST - Send a message (whatever you send in the body is the message)
-- DELETE - Deletes all stored messages
 
-The URL for the HTTP API to use these commands will be printed in the CloudFormation stack output after you deploy.
+Running the curl simultaneously on the same "dynamo key" and the numbers are not repeated
 
-Note - After deployment you may need to wait 60-90 seconds before the implementation works as expected. There are a lot of network configurations happening so you need to wait on propagation
+![the dynamodb atomic counter](img/img3.png)

the-dynamodb-atomic-counter/csharp/README.md

@@ -1,14 +1,100 @@
-# Welcome to your CDK C# project!
+# The DynamoDB Atomic Counter
 
-This is a blank project for C# development with CDK.
+![the dynamodb atomic counter](../img/stack.png)
 
-The `cdk.json` file tells the CDK Toolkit how to execute your app.
+This is a Serverless pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to software design or other needs. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this problem very cheaply. In addition, as this stack uses only DynamoDB and APIGateway, the response is very fast (in milliseconds).
 
-It uses the [.NET Core CLI](https://docs.microsoft.com/dotnet/articles/core/) to compile and execute your project.
+A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff).  
+I made changes to the original version to support multiple incremental keys, so you can use this to focus the incremental process for many systems on a single table and API.
 
-## Useful commands
+Some Useful References:
+
+| Author        | Link           |
+| ------------- | ------------- |
+| AWS Docs | [Increment an Atomic Counter](https://docs.amazonaws.cn/en_us/amazondynamodb/latest/developerguide/GettingStarted.NodeJs.03.html#GettingStarted.NodeJs.03.04) |
+| A Cloud Guru | [DynamoDB Atomic Counters](https://acloudguru.com/blog/engineering/dynamodb-atomic-counters) |
+
+
+## What's Included In This Pattern?
+This pattern implements an atomic counter using only DynamoDB and APIGateway.
+
+### DynamoDB Table
+A simple table with a hash key and an incremental field
+
+### API Gateway REST API
+This is configured with the AWS Integration method and  Request/Response integrations to transform the data.
+
+## How Do I Test This Pattern?
+
+After deployment, the CDK will output a parameter like this:
+
+```
+TheDynamodbAtomicCounterStack.apigwcounterurl = https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+```
+
+So, just copy this URL and call this URL using the GET method through a browser, postman, curl or other http tool.
+
+## Adding new keys to increment
+
+If you want to add more keys to increment, it's very simple. Just use the DynamoDB console and add a new key.
+
+![the dynamodb atomic counter](../img/img1.png)
+
+After that, you can call the two urls and use different incremental urls:
+```
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-bb
+```
+
+## Performance and concurrency testing
+
+API Response in less than 0.080s
+
+![the dynamodb atomic counter](../img/img2.png)
+
+
+Running the curl simultaneously on the same "dynamo key" and the numbers are not repeated
+
+![the dynamodb atomic counter](../img/img3.png)
+
+# Useful commands
 
 * `dotnet build src` compile this app
 * `cdk deploy`       deploy this stack to your default AWS account/region
 * `cdk diff`         compare deployed stack with current state
-* `cdk synth`        emits the synthesized CloudFormation template
+* `cdk synth`        emits the synthesized CloudFormation template
+
+## Deploy with AWS Cloud9
+
+* Create an **Ubuntu** AWS Cloud9 EC2 development environment
+* Add the Microsoft repository
+    ```
+    wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
+    ```
+    ```
+    sudo dpkg -i packages-microsoft-prod.deb
+    ```
+* Install the .NET Core SDK
+    ```
+    sudo apt-get update; \
+    sudo apt-get install -y apt-transport-https && \
+    sudo apt-get update && \
+    sudo apt-get install -y dotnet-sdk-3.1
+    ```
+* Clone the CDK Patterns repo
+    ```
+    git clone https://github.com/cdk-patterns/serverless.git
+    ```
+* Change directory
+    ```
+    cd serverless/the-scalable-webhook/csharp
+    ```
+* Build the project to see if .NET Core has been setup correctly (optional)
+    ```
+    dotnet build src
+    ```
+* Deploy the stack
+    ```
+    cdk deploy
+    ```

the-dynamodb-atomic-counter/java/README.md

@@ -1,10 +1,62 @@
-# Welcome to your CDK Java project!
+# The DynamoDB Atomic Counter
 
-This is a blank project for Java development with CDK.
+![the dynamodb atomic counter](../img/stack.png)
 
-The `cdk.json` file tells the CDK Toolkit how to execute your app.
+This is a Serverless pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to software design or other needs. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this problem very cheaply. In addition, as this stack uses only DynamoDB and APIGateway, the response is very fast (in milliseconds).
 
-It is a [Maven](https://maven.apache.org/) based project, so you can open this project with any Maven compatible Java IDE to build and run tests.
+A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff).  
+I made changes to the original version to support multiple incremental keys, so you can use this to focus the incremental process for many systems on a single table and API.
+
+Some Useful References:
+
+| Author        | Link           |
+| ------------- | ------------- |
+| AWS Docs | [Increment an Atomic Counter](https://docs.amazonaws.cn/en_us/amazondynamodb/latest/developerguide/GettingStarted.NodeJs.03.html#GettingStarted.NodeJs.03.04) |
+| A Cloud Guru | [DynamoDB Atomic Counters](https://acloudguru.com/blog/engineering/dynamodb-atomic-counters) |
+
+
+## What's Included In This Pattern?
+This pattern implements an atomic counter using only DynamoDB and APIGateway.
+
+### DynamoDB Table
+A simple table with a hash key and an incremental field
+
+### API Gateway REST API
+This is configured with the AWS Integration method and  Request/Response integrations to transform the data.
+
+## How Do I Test This Pattern?
+
+After deployment, the CDK will output a parameter like this:
+
+```
+TheDynamodbAtomicCounterStack.apigwcounterurl = https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+```
+
+So, just copy this URL and call this URL using the GET method through a browser, postman, curl or other http tool.
+
+## Adding new keys to increment
+
+If you want to add more keys to increment, it's very simple. Just use the DynamoDB console and add a new key.
+
+![the dynamodb atomic counter](../img/img1.png)
+
+After that, you can call the two urls and use different incremental urls:
+```
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-bb
+```
+
+## Performance and concurrency testing
+
+API Response in less than 0.080s
+
+![the dynamodb atomic counter](../img/img2.png)
+
+
+Running the curl simultaneously on the same "dynamo key" and the numbers are not repeated
+
+![the dynamodb atomic counter](../img/img3.png)
 
 ## Useful commands
 
@@ -14,5 +66,3 @@ It is a [Maven](https://maven.apache.org/) based project, so you can open this p
  * `cdk deploy`      deploy this stack to your default AWS account/region
  * `cdk diff`        compare deployed stack with current state
  * `cdk docs`        open CDK documentation
-
-Enjoy!

the-dynamodb-atomic-counter/python/README.md

@@ -1,9 +1,64 @@
+# The DynamoDB Atomic Counter
 
-# Welcome to your CDK Python project!
+![the dynamodb atomic counter](../img/stack.png)
 
-This is a blank project for Python development with CDK.
+This is a Serverless pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to software design or other needs. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this problem very cheaply. In addition, as this stack uses only DynamoDB and APIGateway, the response is very fast (in milliseconds).
 
-The `cdk.json` file tells the CDK Toolkit how to execute your app.
+A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff).  
+I made changes to the original version to support multiple incremental keys, so you can use this to focus the incremental process for many systems on a single table and API.
+
+Some Useful References:
+
+| Author        | Link           |
+| ------------- | ------------- |
+| AWS Docs | [Increment an Atomic Counter](https://docs.amazonaws.cn/en_us/amazondynamodb/latest/developerguide/GettingStarted.NodeJs.03.html#GettingStarted.NodeJs.03.04) |
+| A Cloud Guru | [DynamoDB Atomic Counters](https://acloudguru.com/blog/engineering/dynamodb-atomic-counters) |
+
+
+## What's Included In This Pattern?
+This pattern implements an atomic counter using only DynamoDB and APIGateway.
+
+### DynamoDB Table
+A simple table with a hash key and an incremental field
+
+### API Gateway REST API
+This is configured with the AWS Integration method and  Request/Response integrations to transform the data.
+
+## How Do I Test This Pattern?
+
+After deployment, the CDK will output a parameter like this:
+
+```
+TheDynamodbAtomicCounterStack.apigwcounterurl = https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+```
+
+So, just copy this URL and call this URL using the GET method through a browser, postman, curl or other http tool.
+
+## Adding new keys to increment
+
+If you want to add more keys to increment, it's very simple. Just use the DynamoDB console and add a new key.
+
+![the dynamodb atomic counter](../img/img1.png)
+
+After that, you can call the two urls and use different incremental urls:
+```
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-bb
+```
+
+## Performance and concurrency testing
+
+API Response in less than 0.080s
+
+![the dynamodb atomic counter](../img/img2.png)
+
+
+Running the curl simultaneously on the same "dynamo key" and the numbers are not repeated
+
+![the dynamodb atomic counter](../img/img3.png)
+
+# CDK Useful Commands
 
 This project is set up like a standard Python project.  The initialization
 process also creates a virtualenv within this project, stored under the `.venv`

the-dynamodb-atomic-counter/typescript/README.md

@@ -1,8 +1,62 @@
-# Welcome to your CDK TypeScript project!
+# The DynamoDB Atomic Counter
 
-This is a blank project for TypeScript development with CDK.
+![the dynamodb atomic counter](../img/stack.png)
 
-The `cdk.json` file tells the CDK Toolkit how to execute your app.
+This is a Serverless pattern that implements an Atomic counter using only ApiGateway and DynamoDB. In many cases, we can use UUID to identify the key, but there are situations where we need an incremental and unique number due to software design or other needs. In this case, we must ensure that the number will be unique and won't be repeated, so this stack can solve this problem very cheaply. In addition, as this stack uses only DynamoDB and APIGateway, the response is very fast (in milliseconds).
+
+A special thanks to Vikas Solegaonkar for sharing this link [Simple Atomic Counter with DynamoDB and API Gateway](https://itnext.io/simple-atomic-counter-with-dynamodb-and-api-gateway-e72115c209ff).  
+I made changes to the original version to support multiple incremental keys, so you can use this to focus the incremental process for many systems on a single table and API.
+
+Some Useful References:
+
+| Author        | Link           |
+| ------------- | ------------- |
+| AWS Docs | [Increment an Atomic Counter](https://docs.amazonaws.cn/en_us/amazondynamodb/latest/developerguide/GettingStarted.NodeJs.03.html#GettingStarted.NodeJs.03.04) |
+| A Cloud Guru | [DynamoDB Atomic Counters](https://acloudguru.com/blog/engineering/dynamodb-atomic-counters) |
+
+
+## What's Included In This Pattern?
+This pattern implements an atomic counter using only DynamoDB and APIGateway.
+
+### DynamoDB Table
+A simple table with a hash key and an incremental field
+
+### API Gateway REST API
+This is configured with the AWS Integration method and  Request/Response integrations to transform the data.
+
+## How Do I Test This Pattern?
+
+After deployment, the CDK will output a parameter like this:
+
+```
+TheDynamodbAtomicCounterStack.apigwcounterurl = https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+```
+
+So, just copy this URL and call this URL using the GET method through a browser, postman, curl or other http tool.
+
+## Adding new keys to increment
+
+If you want to add more keys to increment, it's very simple. Just use the DynamoDB console and add a new key.
+
+![the dynamodb atomic counter](../img/img1.png)
+
+After that, you can call the two urls and use different incremental urls:
+```
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-aa
+
+https://q0nl7897m3.execute-api.us-east-1.amazonaws.com/prod/counter?systemKey=system-bb
+```
+
+## Performance and concurrency testing
+
+API Response in less than 0.080s
+
+![the dynamodb atomic counter](../img/img2.png)
+
+
+Running the curl simultaneously on the same "dynamo key" and the numbers are not repeated
+
+![the dynamodb atomic counter](../img/img3.png)
 
 ## Useful commands