添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

完成此示例大约需要 20 分钟。

此示例向您展示如何使用 JavaScript 逻辑来创建执行此用例的解决方案。例如,您将学习如何使用 Lambda 函数读取数据库以确定哪些员工已达到入职一周年纪念日、如何处理数据以及如何发送短信。然后,您将学习如何使用 API Gateway 通过 Rest 端点调用此 AWS Lambda 函数。例如,您可以使用以下 curl 命令调用 Lambda 函数:

curl -XGET "https://xxxxqjko1o3.execute-api.us-east-1.amazonaws.com/cronstage/employee"

本 AWS 教程使用名为 Employee 的 Amazon DynamoDB 表,其中包含这些字段。

设置项目环境以运行这些 Node TypeScript 示例,并安装所需的模块 AWS SDK for JavaScript 和第三方模块。按照上的说明进行操作 GitHub

使用用户凭证创建共享配置文件。有关提供共享凭据文件的更多信息,请参阅 工具参考指南中的共享配置AWS SDKs和 凭据文件

创建 AWS 资源

本教程要求具有以下资源:

一个名为 Employee 的 Amazon DynamoDB 表,其键名为 Id ,其字段如上图所示。请务必输入正确的数据,包括要用来测试此使用案例的有效手机号。有关更多信息,请参阅 创建表

具有执行 Lambda 函数的附加权限的IAM角色。

一个用于托管 Lambda 函数的 Amazon S3 存储桶。

您可以手动创建这些资源,但我们建议 AWS CloudFormation 按照本教程中的说明使用配置这些资源。

使用创建 AWS 资源 AWS CloudFormation

AWS CloudFormation 使您能够以可预测的方式重复创建和配置 AWS 基础架构部署。有关的更多信息 AWS CloudFormation,请参阅《 AWS CloudFormation 用户指南》

要使用以下方法创建 AWS CloudFormation 堆栈 AWS CLI:

  1. 按照《 AWS CLI AWS CLI 用户指南 》中的说明进行安装和配置。

  2. 在项目文件夹的根目录 setup.yaml 中创建一个名为的文件,然后将 此处 的内容复制 GitHub到该文件中。

    注意

    该 AWS CloudFormation 模板是使用 此处 AWS CDK 提供的模板生成的 GitHub 。有关更多信息 AWS CDK,请参阅《 AWS Cloud Development Kit (AWS CDK) 开发人员指南》

  3. 从命令行运行以下命令,替换 STACK_NAME 为堆栈使用唯一的名称。

    重要

    堆栈名称在 AWS 区域和 AWS 账户中必须是唯一的。您最多可指定 128 个字符,支持数字和连字符。

    aws cloudformation create-stack --stack-name STACK_NAME --template-body file://setup.yaml --capabilities CAPABILITY_IAM

    有关 create-stack 命令参数的更多信息,请参阅 AWS CLI 命令参考指南 AWS CloudFormation 用户指南

  4. 接下来,按照 填充表 过程填充表。

    要填充表,请先创建一个名为 libs 的目录,然后在其中创建一个名为 dynamoClient.js 的文件,再将下面的内容粘贴到其中。

    const { DynamoDBClient } = require ( "@aws-sdk/client-dynamodb" ); // Set the AWS Region. const REGION = "REGION"; // e.g. "us-east-1" // Create an Amazon Lambda service client object. const dynamoClient = new DynamoDBClient({region:REGION}); module.exports = { dynamoClient };

    此代码可从此处获得 GitHub。

    接下来,在项目文件夹的根目录populate-table.js中创建一个名为的文件,然后将此处的内容复制 GitHub到其中。对于其中一项,将 phone 属性的值替换为 E.164 格式的有效手机号码,将 startDate 的值替换为今天的日期。

    在命令行处,运行以下命令。

    node populate-table.js
    const { BatchWriteItemCommand } = require ( "aws-sdk/client-dynamodb" ); const {dynamoClient} = require ( "./libs/dynamoClient" ); // Set the parameters. export const params = { RequestItems: { Employees: [ PutRequest: { Item: { id: { N: "1" }, firstName: { S: "Bob" }, phone: { N: "155555555555654" }, startDate: { S: "2019-12-20" }, PutRequest: { Item: { id: { N: "2" }, firstName: { S: "Xing" }, phone: { N: "155555555555653" }, startDate: { S: "2019-12-17" }, PutRequest: { Item: { id: { N: "55" }, firstName: { S: "Harriette" }, phone: { N: "155555555555652" }, startDate: { S: "2019-12-19" }, export const run = async () => { try { const data = await dbclient.send(new BatchWriteItemCommand(params)); console.log("Success", data); } catch (err) { console.log("Error", err); run();

    此代码可从 此处获 得 GitHub。

    创建 AWS Lambda 函数

    正在配置 SDK

    libs 目录中,创建名为 snsClient.js lambdaClient.js 的文件,并将以下内容分别粘贴到这些文件中。

    const { SNSClient } = require("@aws-sdk/client-sns"); // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon SNS service client object. const snsClient = new SNSClient( { region: REGION }); module.exports = { snsClient };

    Replace(替换) REGION 与该 AWS 地区合作。此代码可从 此处获 得 GitHub。

    const { LambdaClient } = require("@aws-sdk/client-lambda"); // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Lambda service client object. const lambdaClient = new LambdaClient( { region: REGION }); module.exports = { lambdaClient };

    Replace(替换) REGION 与该 AWS 地区合作。此代码可从 此处获 得 GitHub。

    首先,导入所需的 AWS SDK for JavaScript (v3) 模块和命令。然后计算今天的日期并将其分配给一个参数。然后,为 ScanCommand 创建参数。Replace(替换) TABLE_NAME 使用您在本示例 创建 AWS 资源 部分中创建的表的名称。

    下面的代码段演示了此步骤。(有关完整示例,请参阅 捆绑 Lambda 函数 。)

    const { ScanCommand } = require("@aws-sdk/client-dynamodb"); const { PublishCommand } = require("@aws-sdk/client-sns"); const { snsClient } = require("./libs/snsClient"); const { dynamoClient } = require("./libs/dynamoClient"); // Get today's date. const today = new Date(); const dd = String(today.getDate()).padStart(2, "0"); const mm = String(today.getMonth() + 1).padStart(2, "0"); //January is 0! const yyyy = today.getFullYear(); const date = `${yyyy}-${mm}-${dd}`; // Set the parameters for the ScanCommand method. const params = { // Specify which items in the results are returned. FilterExpression: "startDate = :topic", // Define the expression attribute value, which are substitutes for the values you want to compare. ExpressionAttributeValues: { ":topic": { S: date }, // Set the projection expression, which are the attributes that you want. ProjectionExpression: "firstName, phone", TableName: "Employees",

    扫描 DynamoDB 表

    首先,创建一个名为 async/await 函数sendText,用于使用 Amazon 发布短信。SNS PublishCommand然后,添加一个 try 块模式,用于扫描 DynamoDB 表中是否有工作周年纪念日在今天的员工,然后调用 sendText 函数向这些员工发送短信。如果发生错误,则将调用 catch 块。

    下面的代码段演示了此步骤。(有关完整示例,请参阅捆绑 Lambda 函数。)

    // Helper function to send message using Amazon SNS. exports.handler = async () => { // Helper function to send message using Amazon SNS. async function sendText(textParams) { try { await snsClient.send(new PublishCommand(textParams)); console.log("Message sent"); } catch (err) { console.log("Error, message not sent ", err); try { // Scan the table to identify employees with work anniversary today. const data = await dynamoClient.send(new ScanCommand(params)); for (const element of data.Items) { const textParams = { PhoneNumber: element.phone.N, Message: `Hi ${element.firstName.S}; congratulations on your work anniversary!`, // Send message using Amazon SNS. sendText(textParams); } catch (err) { console.log("Error, could not scan table ", err);

    捆绑 Lambda 函数

    本主题介绍如何将本示例的模块mylambdafunction.ts和必需的 AWS SDK for JavaScript 模块捆绑到名index.js为的捆绑文件中。

    1. 如果您尚未安装 Webpack,请按照本示例中的完成先决条件任务部分进行安装。

      注意

      有关 Webpack 的信息,请参阅将应用程序与 webpack 捆绑在一起

    2. 在命令行中运行以下命令,将本示例 JavaScript 的捆绑到名为的文件中<index.js>

      webpack mylambdafunction.ts --mode development --target node --devtool false --output-library-target umd -o index.js
      重要

      请注意,输出被命名为 index.js。这是因为 Lambda 函数必须有一个 index.js 处理程序才能工作。

    3. 将捆绑的输出文件压缩成名mylambdafunction.zip为的ZIP文件。index.js

    4. mylambdafunction.zip 上传到您在本教程的创建 AWS 资源 主题中创建的 Amazon S3 存储桶。

    部署 Lambda 函数

    在项目的根目录中,创建一个 lambda-function-setup.ts 文件,然后将以下内容粘贴到其中。

    Replace(替换) BUCKET_NAME 使用您将 Lambda 函数ZIP版本上传到的 Amazon S3 存储桶的名称。Replace(替换) ZIP_FILE_NAME 使用名称命名您的 Lambda 函数的ZIP版本。Replace(替换) ROLE 使用您在本教程创建 AWS 资源 主题中创建的IAM角色的 Amazon 资源编号 (ARN)。Replace(替换) LAMBDA_FUNCTION_NAME 带有 Lambda 函数的名称。

    // Load the required Lambda client and commands. const { CreateFunctionCommand } = require ( "@aws-sdk/client-lambda" ); const { lambdaClient} = require ( "./libs/lambdaClient.js ); // Set the parameters. const params = { Code: { S3Bucket: "BUCKET_NAME", // BUCKET_NAME S3Key: "ZIP_FILE_NAME", // ZIP_FILE_NAME FunctionName: "LAMBDA_FUNCTION_NAME", Handler: "index.handler", Role: "IAM_ROLE_ARN", // IAM_ROLE_ARN; e.g., arn:aws:iam::650138640062:role/v3-lambda-tutorial-lambda-role Runtime: "nodejs12.x", Description: "Scans a DynamoDB table of employee details and using Amazon Simple Notification Services (Amazon SNS) to " + "send employees an email on each anniversary of their start-date.", const run = async () => { try { const data = await lambdaClient.send(new CreateFunctionCommand(params)); console.log("Success", data); // successful response } catch (err) { console.log("Error", err); // an error occurred run();

    在命令行中输入以下内容以部署 Lambda 函数。

    node lambda-function-setup.ts

    此代码示例可在此处找到 GitHub

    将API网关配置为调用 Lambda 函数

    构建应用程序:
    1. 创建其余的 API

      测试网API关方法

      部署网API关方法

      创建其余的 API

      您可以使用API网关控制台为 Lambda 函数创建休息终端节点。完成后,您就可以使用 restful 调用来调用 Lambda 函数。

      1. 登录 Amazon API Gateway 控制台

      2. 在 “休息” 下API,选择 “构建”。

      3. 选择新建API