aws-lambda-dynamodb - AWS 解決方案建構

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

aws-lambda-dynamodb

所有類都在積極開發中,並且在任何未來版本中都會受到非向後兼容的更改或刪除。這些不受語義版本模型。這意味著,雖然您可以使用它們,但在升級到此軟件包的較新版本時,您可能需要更新源代碼。

請注意: 為了確保功能正確,專案中的 AWS 解決方案建構套件和 AWS CDK 套件必須是相同的版本。

語言 套件
Python
aws_solutions_constructs.aws_lambda_dynamodb
打字稿
@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.FunctionProps 選用的使用者提供的屬性來覆寫 Lambda 函數的預設屬性。忽略existingLambdaObj提供。
DynamoTable 道具? dynamodb.TableProps 選擇性的使用者提供的道具,用於覆寫 DynamoDB 表格的預設道具
現有的表格? 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()方法。
VPCProps? ec2.VpcProps 可選的使用者提供的屬性,用於覆寫新 VPC 的預設屬性。enableDnsHostnamesenableDnsSupportnatGateways,以及subnetConfiguration是由模式設置的,因此此處提供的屬性的任何值都將被覆蓋。如果deployVpc不是true那麼這個屬性將被忽略。
部署 vPC? boolean 是否建立新的 VPC 基於vpcProps來部署此模式。將其設置為 true 將部署最小,最私有的 VPC 來運行該模式:
  • CDK 程式使用的每個可用區域內有一個隔離子網路

  • enableDnsHostnamesenableDnsSupport都將設置為true

如果此屬性為true,然後existingVpc無法指定。預設為 false

模式性質

名稱 類型 描述
DynaMotion 表格 dynamodb.Table 傳回由樣式建立之 DynamoDB 表格的實體。
LambdaFunction lambda.Function 返回由模式創建的 Lambda 函數的實例。
vpc? ec2.IVpc 返回模式使用的 VPC 上的接口(如果有的話)。這可能是由模式或提供給模式構造函數的 VPC 創建的 VPC。

預設設設設定

此模式的開箱即用實現沒有任何覆蓋將設置以下默認值:

AWS Lambda 功能

  • 設定 Lambda 函數的有限權限存取 IAM 角色。

  • 為 NodeJS Lambda 函數啟用具有持續作用的連線重複使用。

  • 啟用 X-Ray 追蹤。

  • 設定環境變數:

    • DDB_TABLE_NAME (default)

    • 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-lambda-動態模式