generated from amazon-archives/__template_MIT-0
-
Notifications
You must be signed in to change notification settings - Fork 1k
SQL Lambda Tenant Isolation #2968
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
devops-arch-cloud
wants to merge
1
commit into
aws-samples:main
Choose a base branch
from
devops-arch-cloud:sqs-lambda-tenant-isolation-sam-py
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,61 @@ | ||
| # Lambda Tenant Isolation with SQS | ||
|
|
||
| This pattern demonstrate AWS Lambda's tenant isolation feature in Multi-tenant application. It uses single SQS for multi-tenant applucation and isolating messages using messagegroupid and invoking isolated lambda enviornments. | ||
|
|
||
| ## Key Features | ||
|
|
||
| - Tenant isolation at infrastructure level (no custom routing logic) | ||
| - Execution environments never shared between tenants | ||
| - Asynchronous invocation pattern | ||
| - Automatic tenant context propagation | ||
|
|
||
| Learn more about this pattern at [Serverless Land Patterns](https://serverlessland.com/patterns/sqs-lambda-tenant-isolation) | ||
|
|
||
| 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. | ||
|
|
||
|
|
||
| ## Architecture | ||
|
|
||
| ``` | ||
| SQS Queue → SQS Processor Lambda → Tenant-Isolated Lambda | ||
| (reads customer-id) (processes with tenant isolation) | ||
| ``` | ||
|
|
||
| ## Components | ||
|
|
||
| ### 1. SQS Processor (`sqs-processor/`) | ||
| - Triggered by SQS queue messages | ||
| - Extracts `customer-id` from message payload | ||
| - Invokes tenant-isolated Lambda asynchronously with `TenantId` parameter | ||
|
|
||
| ### 2. Tenant-Isolated Processor (`tenant-isolated-processor/`) | ||
| - Configured with tenant isolation mode enabled | ||
| - Processes requests in isolated execution environments per tenant | ||
| - Accesses tenant ID via `context.identity.tenant_id` | ||
|
|
||
| ## Message Format | ||
|
|
||
| ```json | ||
| { | ||
| "data": "your payload here" | ||
| } | ||
| ``` | ||
|
|
||
| ## Deployment | ||
|
|
||
| ```bash | ||
| sam build | ||
| sam deploy --guided | ||
| ``` | ||
|
|
||
| ## Testing | ||
|
|
||
| Send a message to the SQS queue: | ||
|
|
||
| ```bash | ||
| aws sqs send-message \ | ||
| --queue-url <QUEUE_URL> \ | ||
| --message-body '{"data": "test payload"}' | ||
| ``` | ||
|
|
||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,49 @@ | ||
| { | ||
| "title": "AWS Lambda Tenant Isolation with SQS", | ||
| "description": "Lambda Isolation feature", | ||
| "language": "", | ||
| "level": "200", | ||
| "framework": "AWS SAM", | ||
| "introBox": { | ||
| "headline": "How it works", | ||
| "text": [ | ||
| "This pattern demonstrate AWS Lambda's tenant isolation feature in Multi-tenant application." | ||
| ] | ||
| }, | ||
| "gitHub": { | ||
| "template": { | ||
| "repoURL": "https://github.com/aws-samples/serverless-patterns/tree/main/sqs-lambda-tenant-isolation-sam-py", | ||
| "templateURL": "serverless-patterns/sqs-lambda-tenant-isolation-sam-py", | ||
| "projectFolder": "sqs-lambda-tenant-isolation-sam-py" | ||
| } | ||
| }, | ||
| "resources": { | ||
| "bullets": [{ | ||
| "text": "AWS Lambda tenant isolation", | ||
| "link": "https://docs.aws.amazon.com/lambda/latest/dg/tenant-isolation.html" | ||
| } | ||
| ] | ||
| }, | ||
| "deploy": { | ||
| "text": ["sam build", "sam deploy --guided"] | ||
| }, | ||
| "testing": { | ||
| "text": ["See the GitHub repo for detailed testing instructions."] | ||
| }, | ||
| "cleanup": { | ||
| "text": ["Delete the stack: <code>sam delete</code>."] | ||
| }, | ||
| "authors": [{ | ||
| "name": "Mitesh Purohit", | ||
| "image": "", | ||
| "bio": "Sr Solution Architect, AWS", | ||
| "linkedin": "https://www.linkedin.com/in/mitup/" | ||
| }, | ||
| { | ||
| "name": "Ricardo Marques", | ||
| "image": "", | ||
| "bio": "Sr Serverless Specialist, AWS", | ||
| "linkedin": "https://www.linkedin.com/in/ricardo-marques-aws/" | ||
| } | ||
| ] | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| import json | ||
| import boto3 | ||
| import os | ||
|
|
||
| lambda_client = boto3.client('lambda') | ||
| TENANT_ISOLATED_FUNCTION = os.environ['TENANT_ISOLATED_FUNCTION_NAME'] | ||
|
|
||
| def handler(event, context): | ||
| for record in event['Records']: | ||
| body = json.loads(record['body']) | ||
|
|
||
| # Get message group ID from SQS attributes | ||
| attributes = record.get('attributes') or {} | ||
| message_group_id = attributes.get('MessageGroupId') | ||
|
|
||
| if not message_group_id: | ||
| print(f"Missing MessageGroupId in SQS record: {record}") | ||
| message_group_id = "default" | ||
|
|
||
| lambda_client.invoke( | ||
| FunctionName=TENANT_ISOLATED_FUNCTION, | ||
| InvocationType='Event', | ||
| Payload=json.dumps(body), | ||
| TenantId=message_group_id | ||
| ) | ||
|
|
||
| print(f"Invoked tenant-isolated function for messagegroup: {message_group_id}") | ||
|
|
||
| return {'statusCode': 200} |
1 change: 1 addition & 0 deletions
1
sqs-lambda-tenant-isolation-sam-py/sqs-processor/requirements.txt
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| boto3>=1.26.0 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| AWSTemplateFormatVersion: '2010-09-09' | ||
| Transform: AWS::Serverless-2016-10-31 | ||
| Description: Lambda Tenant Isolation Demo | ||
|
|
||
| Resources: | ||
| ProcessingQueue: | ||
| Type: AWS::SQS::Queue | ||
| Properties: | ||
| QueueName: tenant-isolation-queue | ||
| VisibilityTimeout: 300 | ||
|
|
||
| TenantIsolatedFunctionRole: | ||
| Type: AWS::IAM::Role | ||
| Properties: | ||
| AssumeRolePolicyDocument: | ||
| Version: '2012-10-17' | ||
| Statement: | ||
| - Effect: Allow | ||
| Principal: | ||
| Service: lambda.amazonaws.com | ||
| Action: sts:AssumeRole | ||
| ManagedPolicyArns: | ||
| - arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole | ||
|
|
||
| TenantIsolatedFunction: | ||
| Type: AWS::Serverless::Function | ||
| Properties: | ||
| FunctionName: tenant-isolated-processor | ||
| CodeUri: tenant-isolated-processor/ | ||
| Handler: index.handler | ||
| Runtime: python3.12 | ||
| Timeout: 120 | ||
| Role: !GetAtt TenantIsolatedFunctionRole.Arn | ||
| TenancyConfig: | ||
| TenantIsolationMode: PER_TENANT | ||
|
|
||
| SQSProcessorFunction: | ||
| Type: AWS::Serverless::Function | ||
| Properties: | ||
| FunctionName: sqs-processor | ||
| CodeUri: sqs-processor/ | ||
| Handler: index.handler | ||
| Runtime: python3.12 | ||
| Timeout: 60 | ||
| Environment: | ||
| Variables: | ||
| TENANT_ISOLATED_FUNCTION_NAME: !Ref TenantIsolatedFunction | ||
| Policies: | ||
| - Statement: | ||
| - Effect: Allow | ||
| Action: | ||
| - lambda:InvokeFunction | ||
| Resource: !GetAtt TenantIsolatedFunction.Arn | ||
| Events: | ||
| SQSEvent: | ||
| Type: SQS | ||
| Properties: | ||
| Queue: !GetAtt ProcessingQueue.Arn | ||
| BatchSize: 10 | ||
|
|
||
| Outputs: | ||
| QueueUrl: | ||
| Value: !Ref ProcessingQueue | ||
| QueueArn: | ||
| Value: !GetAtt ProcessingQueue.Arn | ||
| TenantIsolatedFunctionArn: | ||
| Value: !GetAtt TenantIsolatedFunction.Arn | ||
| SQSProcessorFunctionArn: | ||
| Value: !GetAtt SQSProcessorFunction.Arn |
16 changes: 16 additions & 0 deletions
16
sqs-lambda-tenant-isolation-sam-py/tenant-isolated-processor/index.py
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| import json | ||
|
|
||
| def handler(event, context): | ||
| tenant_id = context.tenant_id | ||
|
|
||
| print(f"Processing request for tenant: {tenant_id}") | ||
| print(f"Event data: {json.dumps(event)}") | ||
|
|
||
| # Process tenant-specific logic here | ||
| result = { | ||
| 'tenant_id': tenant_id, | ||
| 'message': 'Request processed successfully', | ||
| 'data': event | ||
| } | ||
|
|
||
| return result |
1 change: 1 addition & 0 deletions
1
sqs-lambda-tenant-isolation-sam-py/tenant-isolated-processor/requirements.txt
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| # No external dependencies required |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hello @devops-arch-cloud, can you please update your README.md to follow the template please?
https://github.com/aws-samples/serverless-patterns/tree/main/_pattern-model
Additionally
MessageGroupId