Skip to content

Commit 1d290b1

Browse files
committed
docs(core): update README.md and example-pattern.json as requested
- Add detailed explanation of Lambda Managed Instances capabilities and benefits - Clarify AWS service branding and terminology throughout documentation - Remove redundant sections and consolidate infrastructure details - Update introductory description with more accurate service overview
1 parent 4cd51a5 commit 1d290b1

2 files changed

Lines changed: 9 additions & 32 deletions

File tree

lambda-managed-instances-cdk/README.md

Lines changed: 7 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Hello World on AWS Lambda Managed Instances
22

3-
This pattern demonstrates how to deploy a simple Hello World Lambda function running on Lambda Managed Instances using AWS CDK. Lambda Managed Instances provide predictable performance and reduced cold starts for your Lambda functions.
3+
This pattern demonstrates how to deploy a simple Hello World Lambda function running on AWS Lambda Managed Instances using AWS CDK. AWS Lambda Managed Instances enables you to run Lambda functions on EC2 instances while maintaining Lambda's operational simplicity. It fully manages infrastructure tasks including instance lifecycle, OS and runtime patching, routing, load balancing, and auto scaling.
44

55
Learn more about this pattern at Serverless Land Patterns: https://serverlessland.com/patterns/lambda-managed-instances-cdk
66

77
Important: this application uses various AWS services and there are costs associated with these services after the Free Tier usage - please see the [AWS Pricing page](https://aws.amazon.com/pricing/) for details. You are responsible for any AWS costs incurred. No warranty is implied in this example.
88

9-
**Note**: Lambda Managed Instances provision EC2 instances that are **NOT eligible for the AWS Free Tier**. These instances will incur charges immediately upon deployment, regardless of your Free Tier status.
9+
**Note**: AWS Lambda Managed Instances provision EC2 instances that are **NOT eligible for the AWS Free Tier**. These instances will incur charges immediately upon deployment, regardless of your Free Tier status.
1010

1111
## Requirements
1212

@@ -40,30 +40,7 @@ Important: this application uses various AWS services and there are costs associ
4040
4141
## How it works
4242
43-
This pattern demonstrates the deployment of a simple Lambda function on Lambda Managed Instances:
44-
45-
### Lambda Managed Instances
46-
[Lambda Managed Instances](https://docs.aws.amazon.com/lambda/latest/dg/lambda-managed-instances.html) provide:
47-
- Predictable performance with pre-warmed execution environments
48-
- Reduced cold start latency
49-
- Consistent execution characteristics
50-
- Better resource utilization for frequently invoked functions
51-
52-
The underlying EC2 infrastructure can be inspected using AWS CLI commands to understand how managed instances work (see "Inspecting Lambda Managed Instances Infrastructure" section below).
53-
54-
### Hello World Function
55-
The Lambda function is a simple Hello World implementation that:
56-
- Accepts an event with a name parameter
57-
- Returns a JSON response with a greeting message
58-
- Uses AWS Lambda PowerTools for efficient event logging
59-
- Demonstrates minimal Lambda function structure using the Handler type
60-
61-
### Amazon CloudWatch Log Group
62-
The pattern includes a dedicated CloudWatch log group with:
63-
- **Custom log group name**: `/demo/lambda/hello-world-managed-instances-cdk`
64-
- **Retention period**: 2 weeks (14 days) to manage storage costs
65-
- **Automatic cleanup**: Configured with `RemovalPolicy.DESTROY` to be deleted when the stack is destroyed
66-
- **Direct integration**: The Lambda function is configured to use this specific log group
43+
This pattern creates a capacity provider with VPC and security group configuration, then deploys a Node.js Lambda function (ARM64 architecture) that is associated with the capacity provider to run on managed EC2 instances. The function accepts an event with a name parameter and returns a greeting message, with execution logs captured in a dedicated CloudWatch log group.
6744
6845
## Testing
6946
@@ -132,9 +109,9 @@ Monitor the function execution through:
132109

133110
The stack outputs include the log group name for easy reference when setting up monitoring dashboards or log analysis tools.
134111

135-
## Inspecting Lambda Managed Instances Infrastructure
112+
## Inspecting AWS Lambda Managed Instances Infrastructure
136113

137-
Lambda Managed Instances provision EC2 instances behind the scenes to provide predictable performance. You can inspect this infrastructure using AWS CLI commands:
114+
AWS Lambda Managed Instances provision EC2 instances behind the scenes to run your Lambda functions. You can inspect this infrastructure using AWS CLI commands:
138115

139116
### View Capacity Provider Details
140117

@@ -163,7 +140,7 @@ This displays:
163140
- Launch times and subnet distribution
164141
- Private IP addresses within the VPC
165142

166-
**Note**: For a complete list of supported EC2 instance types for Lambda Managed Instances and their pricing, see the [AWS Lambda Pricing page](https://aws.amazon.com/lambda/pricing/).
143+
**Note**: For a complete list of supported EC2 instance types for AWS Lambda Managed Instances and their pricing, see the [AWS Lambda Pricing page](https://aws.amazon.com/lambda/pricing/).
167144

168145
### Understanding Instance Behavior
169146

@@ -183,7 +160,7 @@ The included test script (`./test-lambda.sh`) automatically inspects both the ca
183160

184161
## Regional Availability
185162

186-
This stack will deploy to your default AWS region. Before deploying, please verify that Lambda Managed Instances feature is available in your target region by using the [AWS capabilities explorer](https://builder.aws.com/build/capabilities/explore) or consulting the official [Lambda Managed Instances documentation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-managed-instances.html).
163+
This stack will deploy to your default AWS region. Before deploying, please verify that AWS Lambda Managed Instances feature is available in your target region by using the [AWS capabilities explorer](https://builder.aws.com/build/capabilities/explore) or consulting the official [AWS Lambda Managed Instances documentation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-managed-instances.html).
187164

188165
## Cleanup
189166

lambda-managed-instances-cdk/example-pattern.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@
77
"introBox": {
88
"headline": "How it works",
99
"text": [
10-
"This pattern demonstrates how to deploy a simple Hello World AWS Lambda function running on Lambda Managed Instances using AWS CDK.",
11-
"Lambda Managed Instances provide predictable performance and reduced cold starts for your Lambda functions by pre-warming execution environments.",
10+
"This pattern demonstrates how to deploy a simple Hello World AWS Lambda function running on AWS Lambda Managed Instances using AWS CDK.",
11+
"AWS Lambda Managed Instances enables you to run Lambda functions on EC2 instances while maintaining Lambda's operational simplicity. It fully manages infrastructure tasks including instance lifecycle, OS and runtime patching, routing, load balancing, and auto scaling.",
1212
"The Hello World function accepts an event with a name parameter and returns a simple JSON response with a greeting message."
1313
]
1414
},

0 commit comments

Comments
 (0)