aws-lambda-dynamoDB - AWS 解决方案构造

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

aws-lambda-dynamoDB

所有类都处于积极开发之中,并且在任何未来版本中都会受到非向后兼容的更改或删除。这些不受语义版本控制模型。这意味着,虽然您可以使用它们,但在升级到此软件包的较新版本时,您可能需要更新源代码。

注意: 为确保正确的功能,您项目中的 AWS 解决方案构造软件包和 AWS CDK 包必须是相同的版本。

语言 程序包
Python
aws_solutions_constructs.aws_lambda_dynamodb
TypeScript
@aws-solutions-constructs/aws-lambda-dynamodb
Java
software.amazon.awsconstructs.services.lambdadynamodb

Overview

此 AWS 解决方案构造实现具有最低权限权限的 AWS Lambda 函数和 Amazon DynamoDB 表。

以下是 TypeScript 中的最小可部署模式定义:

import { LambdaToDynamoDBProps, LambdaToDynamoDB } from '@aws-solutions-constructs/aws-lambda-dynamodb'; const props: LambdaToDynamoDBProps = { lambdaFunctionProps: { runtime: lambda.Runtime.NODEJS_14_X, // This assumes a handler function in lib/lambda/index.js code: lambda.Code.fromAsset(`${__dirname}/lambda`), handler: 'index.handler' } }; new LambdaToDynamoDB(this, 'test-lambda-dynamodb-stack', props);

Initializer

new LambdaToDynamoDB(scope: Construct, id: string, props: LambdaToDynamoDBProps);

参数

模式构建道具

名称 类型 描述
现在的兰姆道夫? lambda.Function Lambda 函数对象的现有实例,提供了这个和lambdaFunctionProps会导致错误。
Lambda 功能道具? lambda.FunctionProps 用户提供的可选属性,用于覆盖 Lambda 函数的默认属性。忽略,如果existingLambdaObj则会提供。
可发电道具? dynamodb.TableProps 用户提供的可选道具来覆盖 DynamoDB 表的默认道具
现有表格 J? dynamodb.Table DynamoDB 表对象的现有实例,提供了这个和dynamoTableProps会导致错误。
表权限? string 要授予 Lambda 函数的可选表权限。可指定下列选项之一:AllReadReadWrite,或者Write
表环境变量名? string 为 Lambda 函数设置的 DynamoDB 表环境变量的可选名称。
现有 VPC? ec2.IVpc 应在其中部署此模式的可选现有 VPC。在 VPC 中部署时,Lambda 函数将使用 VPC 中的 ENI 访问网络资源,并在 Amazon DynamoDB 的 VPC 中创建网关终端节点。如果提供了现有 VPC,则deployVpc属性不能true。此操作使用ec2.IVpc允许客户端使用ec2.Vpc.fromLookup()方法。
VPCPROP? ec2.VpcProps 用户提供的可选属性,用于覆盖新 VPC 的默认属性。enableDnsHostnamesenableDnsSupportnatGateways, 和subnetConfiguration是由模式设置的,所以这里提供的这些属性的任何值都将被覆盖。如果deployVpc不是true那么这个属性将被忽略。
部署 VPC? boolean 是否创 VPC 基于vpcProps来部署这种模式。将此设置为 true 将部署最小的、最私有的 VPC 来运行模式:
  • CDK 程序使用的每个可用区内有一个隔离子网

  • enableDnsHostnamesenableDnsSupport都将被设置为true

如果此属性为true,然后existingVpc则无法指定 。默认值为 false

模式属性

名称 类型 描述
动态表 dynamodb.Table 返回由模式创建的 DynamoDB 表的实例。
LambdaFunction lambda.Function 返回由模式创建的 Lambda 函数的实例。
VPC? ec2.IVpc 返回模式使用的 VPC 上的接口(如果有)。这可能是由模式创建的 VPC,也可以是提供给模式构造函数的 VPC。

默认设置

没有任何覆盖的此模式的开箱即用实现将设置以下默认值:

AWS Lambda 函数

  • 为 Lambda 函数配置有限权限访问 IAM 角色。

  • 使用节点 JS Lambda 函数保持活动状态,启用重复使用连接。

  • 启用 X-Ray 跟踪。

  • 设置环境变量:

    • DDB_TABLE_NAME (默认值)

    • AWS_NODEJS_CONNECTION_REUSE_ENABLED(用于节点 10.x 和更高版本的功能)

Amazon DynamoDB 表

  • 将 DynamoDB 表的计费模式设置为按需(按请求付费)。

  • 使用 AWS 托管的 KMS 密钥为 DynamoDB 表启用服务器端加密。

  • 为 DynamoDB 表创建名为 “id” 的分区键。

  • 删除 CloudFormation 堆栈时保留表。

  • 启用连续备份和时间点恢复。

Architecture

Diagram showing data flow from OpenSearch and Lambda to DynamoDB and CloudSearch.

GitHub

要查看此模式的代码、创建/查看问题和拉取请求等,请执行以下操作:
Circular icon with a graduation cap symbol representing education or learning.
@aws-解决方案结构/aw-拉姆达-发电机 b