AWS Lambda
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

将 AWS Lambda 与 AWS CloudFormation 结合使用

在 AWS CloudFormation 模板中,您可以指定 Lambda 函数作为自定义资源的目标。使用自定义资源来处理参数、检索配置值或者在堆栈生命周期事件期间调用其他 AWS 服务。

以下示例调用在模板中的其他位置定义的函数。

例 – 自定义资源定义

Resources: primerinvoke: Type: AWS::CloudFormation::CustomResource Version: "1.0" Properties: ServiceToken: !GetAtt primer.Arn FunctionName: !Ref randomerror

服务令牌是在您创建、更新或删除堆栈时,AWS CloudFormation 所调用函数的 Amazon 资源名称 (ARN)。您还可以按原样包含 AWS CloudFormation 传递到您函数的其他属性,例如 FunctionName

AWS CloudFormation 通过包含回调 URL 的事件异步调用您的 Lambda 函数。

例 – AWS CloudFormation 消息事件

{ "RequestType": "Create", "ServiceToken": "arn:aws:lambda:us-east-2:123456789012:function:lambda-error-processor-primer-14ROR2T3JKU66", "ResponseURL": "https://cloudformation-custom-resource-response-useast2.s3-us-east-2.amazonaws.com/arn%3Aaws%3Acloudformation%3Aus-east-2%3A123456789012%3Astack/lambda-error-processor/1134083a-2608-1e91-9897-022501a2c456%7Cprimerinvoke%7C5d478078-13e9-baf0-464a-7ef285ecc786?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Expires=1555451971&Signature=28UijZePE5I4dvukKQqM%2F9Rf1o4%3D", "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/lambda-error-processor/1134083a-2608-1e91-9897-022501a2c456", "RequestId": "5d478078-13e9-baf0-464a-7ef285ecc786", "LogicalResourceId": "primerinvoke", "ResourceType": "AWS::CloudFormation::CustomResource", "ResourceProperties": { "ServiceToken": "arn:aws:lambda:us-east-2:123456789012:function:lambda-error-processor-primer-14ROR2T3JKU66", "FunctionName": "lambda-error-processor-randomerror-ZWUC391MQAJK" } }

函数负责将指示成功还是失败的响应返回到回调 URL。有关完整响应语法,请参阅自定义资源响应对象

例 – AWS CloudFormation 自定义资源响应

{ "Status": "SUCCESS", "PhysicalResourceId": "2019/04/18/[$LATEST]b3d1bfc65f19ec610654e4d9b9de47a0", "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/lambda-error-processor/1134083a-2608-1e91-9897-022501a2c456", "RequestId": "5d478078-13e9-baf0-464a-7ef285ecc786", "LogicalResourceId": "primerinvoke" }

AWS CloudFormation 提供称为 cfn-response 的库来处理响应的发送。如果您在模板中定义函数,则可以按名称请求库。随后,AWS CloudFormation 将库添加到为函数创建的部署程序包。

以下示例函数调用第二个函数。如果调用成功,则函数发送成功响应到 AWS CloudFormation,并且堆栈更新继续。

例 – 自定义资源参考

Resources: primer: Type: AWS::Serverless::Function Properties: Handler: index.handler Runtime: nodejs8.10 InlineCode: | var aws = require('aws-sdk'); var response = require('cfn-response'); exports.handler = function(event, context) { // For Delete requests, immediately send a SUCCESS response. if (event.RequestType == "Delete") { response.send(event, context, "SUCCESS"); return; } var responseStatus = "FAILED"; var responseData = {}; var functionName = event.ResourceProperties.FunctionName var lambda = new aws.Lambda(); lambda.invoke({ FunctionName: functionName }, function(err, invokeResult) { if (err) { responseData = {Error: "Invoke call failed"}; console.log(responseData.Error + ":\n", err); } else responseStatus = "SUCCESS"; response.send(event, context, responseStatus, responseData); }); }; Description: Invoke a function to create a log stream. MemorySize: 128 Timeout: 8 Role: !GetAtt role.Arn Tracing: Active

如果模板中未定义自定义资源调用的函数,您可以从 AWS CloudFormation 用户指南 中的 cfn-response 模块获取 cfn-response 的源代码。

有关使用自定义资源确保首先创建函数的日志组(先于依赖于它的其他资源)的示例应用程序,请参阅AWS Lambda 错误处理器示例应用程序

有关自定义资源的更多信息,请参阅 AWS CloudFormation 用户指南 中的自定义资源