如何在 localstack 上运行 AWS Lambda dotnet

ibe*_*dev 5 aws-cli aws-lambda dotnet-tool localstack .net-core-3.1

DotNet3.1 AWS Lambda

我使用 Amazon 模板使用 C# DotNet3.1 创建了一个 AWS Lambda 解决方案

dotnet new serverless.AspNetCoreWebAPI -n MyDotNet.Lambda.Service
Run Code Online (Sandbox Code Playgroud)

这将创建一个 lambda 函数,其处理程序是MyDotNet.Lambda.Service::MyDotNet.Lambda.Service.LambdaEntryPoint::FunctionHandlerAsync加上一些serverless.template文件和aws-lambda-tools-defaults.json

部署 DotNet3.1 AWS Lambda 的标准方式

部署它的标准方法是安装 Amazon.Lambda.Tools

dotnet tool update -g Amazon.Lambda.Tools
Run Code Online (Sandbox Code Playgroud)

然后运行

dotnet lambda deploy-serverless --profile myawsprofile
Run Code Online (Sandbox Code Playgroud)

请注意,配置文件是可选的,但我已经在该配置文件下配置了 AWS。这将提示输入 CloudFormation 堆栈名称(例如:foo)和一个 S3 存储桶(例如:my-bucket),并将其部署到自定义配置文件下配置的“真实”AWSmyawsprofile

LocalStack 作为 docker 容器运行

到目前为止一切都很好。现在我刚刚发现https://github.com/localstack/localstack这是在本地运行 AWS 平台的好方法,所以我使用 docker-compose 文件localstack-compose.yml来启动容器

version: '3.8'

services:
  localstack:
    container_name: "${LOCALSTACK_DOCKER_NAME-localstack_main}"
    image: localstack/localstack-full
    network_mode: bridge
    ports:
      - "4566:4566"
      - "4571:4571"
      - "${PORT_WEB_UI-8080}:${PORT_WEB_UI-8080}"
    environment:
      - SERVICES=${SERVICES- }
      - DEBUG=${DEBUG- }
      - DATA_DIR=${DATA_DIR- }
      - PORT_WEB_UI=${PORT_WEB_UI- }
      - LAMBDA_EXECUTOR=${LAMBDA_EXECUTOR- }
      - KINESIS_ERROR_PROBABILITY=${KINESIS_ERROR_PROBABILITY- }
      - DOCKER_HOST=unix:///var/run/docker.sock
      - HOST_TMP_FOLDER=${TMPDIR}
    volumes:
      - "${TMPDIR:-/tmp/localstack}:/tmp/localstack"
      - "/var/run/docker.sock:/var/run/docker.sock"
Run Code Online (Sandbox Code Playgroud)

像这样:

docker-compose -f localstack-compose.yml up
Run Code Online (Sandbox Code Playgroud)

它全部在端口 4566 下运行

AWS 本地

为了使用 LocalStack 运行 AWS CLI,我安装了包装器https://github.com/localstack/awscli-local以便我可以执行以下操作

awslocal s3 ls
Run Code Online (Sandbox Code Playgroud)

如何在本地部署 AWS Lambda?

我太新了,无法理解我遵循的大多数教程。其中一些是指无服务器框架,但我只是使用 localstack 作为 docker 容器。我还安装了 SAM CLI,以防需要它(虽然我还不明白是为了什么)

我试过将它部署到本地堆栈

dotnet lambda deploy-serverless --profile default
Run Code Online (Sandbox Code Playgroud)

这将是等效的,我认为,但我得到

Error uploading to MyDotNet.Lambda.Service/AspNetCoreFunction-CodeUri-Or-ImageUri-637509113851513062-637509113886357582.zip in bucket foo: The bucket you are attempting to access must be addressed using the specified endpoint. Please send all future requests to this endpoint
Run Code Online (Sandbox Code Playgroud)

虽然我有一个桶 s3://foo in localstack

找到一个我可以用我的 AWS 基本知识水平来遵循的例子真的很复杂。是否有我遗漏的任何说明,或者有关如何逐步实现我想要的内容的不错链接/教程?谢谢

更新 1 (11/3/2021) 我已经一步一步地尝试使用亚马逊模板创建的 web api 项目https://gitlab.com/sunnyatticsoftware/sandbox/localstack-sandbox/-/tree/master/02-lambda -dotnet-webapi

但我发现问题。

步骤:首先我为 lambda 执行创建角色

awslocal iam create-role --role-name lambda-dotnet-webapi-ex --assume-role-policy-document file://trust-policy.json
Run Code Online (Sandbox Code Playgroud)

将策略附加到角色以授予执行权限

awslocal iam attach-role-policy --role-name lambda-dotnet-webapi-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
Run Code Online (Sandbox Code Playgroud)

创建 Lambda 函数

awslocal lambda create-function --function-name lambda-dotnet-webapi-function --zip-file fileb://function.zip --handler Sample.Lambda.DotNet.WebApi::Sample.Lambda.DotNet.WebApi.LambdaEntryPoint::FunctionHandlerAsync --runtime dotnetcore3.1 --role arn:aws:iam::000000000000:role/lambda-dotnet-webapi-ex
Run Code Online (Sandbox Code Playgroud)

使用 base64 实用程序调用 AWS Lambda 来解码日志

awslocal lambda invoke --function-name lambda-dotnet-webapi-function out --log-type Tail --query 'LogResult' --output text | base64 -d
Run Code Online (Sandbox Code Playgroud)

它返回:

iptables v1.4.21: can't initialize iptables table `nat': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
[Information] Microsoft.Hosting.Lifetime: Application started. Press Ctrl+C to shut down.
[Information] Microsoft.Hosting.Lifetime: Hosting environment: Production
[Information] Microsoft.Hosting.Lifetime: Content root path: /var/task
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
      Content root path: /var/task
START RequestId: a5eb1d2d-d908-15f6-ace3-d4d0e01a0066 Version: $LATEST
Could not load file or assembly 'System.IO.Pipelines, Version=4.0.2.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'. The system cannot find the file specified.
: FileNotFoundException
   at Amazon.Lambda.AspNetCoreServer.AbstractAspNetCoreFunction`2.FunctionHandlerAsync(TREQUEST request, ILambdaContext lambdaContext)
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at Amazon.Lambda.AspNetCoreServer.AbstractAspNetCoreFunction`2.FunctionHandlerAsync(TREQUEST request, ILambdaContext lambdaContext)
   at lambda_method(Closure , Stream , Stream , LambdaContextInternal )


END RequestId: a5eb1d2d-d908-15f6-ace3-d4d0e01a0066
REPORT RequestId: a5eb1d2d-d908-15f6-ace3-d4d0e01a0066  Init Duration: 2305.87 ms       Duration: 33.29 ms      Billed Duration: 100 ms      Memory Size: 1536 MB    Max Memory Used: 0 MB
Starting daemons...
ImportError: No module named site
Run Code Online (Sandbox Code Playgroud)

有人有工作示例吗?

更新 2 有趣的是,我已经尝试过针对真正的 AWS(AWS 凭证中的不同配置文件)并且我也收到了一个错误,但它是不同的。

创建角色

aws iam create-role --role-name lambda-dotnet-webapi-ex --assume-role-policy-document file://trust-policy.json --profile diegosasw
Run Code Online (Sandbox Code Playgroud)

列出角色

aws iam list-roles --profile diegosasw
Run Code Online (Sandbox Code Playgroud)

附加政策

aws iam attach-role-policy --role-name lambda-dotnet-webapi-ex
 --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole --profile diegosasw
Run Code Online (Sandbox Code Playgroud)

创建 lambda

aws lambda create-function --function-name lambda-dotnet-webap
i-function --zip-file fileb://function.zip --handler Sample.Lambda.DotNet.WebApi::Sample.Lambda.DotNet.WebApi.LambdaEntryPoint::FunctionHa
ndlerAsync --runtime dotnetcore3.1 --role arn:aws:iam::308309238958:role/lambda-dotnet-webapi-ex --profile diegosasw
Run Code Online (Sandbox Code Playgroud)

调用

aws lambda invoke --function-name lambda-dotnet-webapi-function --profile diegosasw out --log-type Tail --query 'LogResult' --output text | base64 -d
Run Code Online (Sandbox Code Playgroud)

它返回

START RequestId: 7d77489f-869b-4e4d-87a0-ac800d71eb2d Version: $LATEST
warn: Amazon.Lambda.AspNetCoreServer.AbstractAspNetCoreFunction[0]
      Request does not contain domain name information but is derived from APIGatewayProxyFunction.
[Warning] Amazon.Lambda.AspNetCoreServer.AbstractAspNetCoreFunction: Request does not contain domain name information but is derived from APIGatewayProxyFunction.
Object reference not set to an instance of an object.: NullReferenceException
   at Amazon.Lambda.AspNetCoreServer.APIGatewayProxyFunction.MarshallRequest(InvokeFeatures features, APIGatewayProxyRequest apiGatewayRequest, ILambdaContext lambdaContext)
   at Amazon.Lambda.AspNetCoreServer.AbstractAspNetCoreFunction`2.FunctionHandlerAsync(TREQUEST request, ILambdaContext lambdaContext)
   at lambda_method(Closure , Stream , Stream , LambdaContextInternal )


END RequestId: 7d77489f-869b-4e4d-87a0-ac800d71eb2d
REPORT RequestId: 7d77489f-869b-4e4d-87a0-ac800d71eb2d  Duration: 755.06 ms     Billed Duration: 756 ms Memory Size: 128 MB     Max Memory Used: 87 MB    Init Duration: 462.09 ms
Run Code Online (Sandbox Code Playgroud)

ibe*_*dev 11

我让它适用于 AWS 和 LocalStack(即:awslocal)。以下是仅使用 AWS CLI 的步骤。这是回购示例https://gitlab.com/sunnyatticsoftware/sandbox/localstack-sandbox/-/tree/master/03-lambda-dotnet-empty

使用 AWS CLI 在 localstack 中创建 AWS lambda

AWS

从 Amazon 模板创建空示例 C# lambda 函数

dotnet new lambda.EmptyFunction -n Sample.Lambda.DotNet
Run Code Online (Sandbox Code Playgroud)

编译并发布

dotnet build
dotnet publish -c Release -o publish
Run Code Online (Sandbox Code Playgroud)

压缩 lambda 文件

cd publish
zip -r ../function.zip *
Run Code Online (Sandbox Code Playgroud)

创建角色

aws --profile diegosasw iam create-role --role-name lambda-dotnet-ex --assume-role-policy-document '{"Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
Run Code Online (Sandbox Code Playgroud)

将 AWSLambdaBasicExecutionRole 策略附加到角色

aws --profile diegosasw iam attach-role-policy --role-name lambda-dotnet-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
Run Code Online (Sandbox Code Playgroud)

创建拉姆达

aws --profile diegosasw lambda create-function --function-name lambda-dotnet-function --zip-file fileb://function.zip --handler Sample.Lambda.DotNet::Sample.Lambda.DotNet.Function::FunctionHandler --runtime dotnetcore3.1 --role arn:aws:iam::308309238958:role/lambda-dotnet-ex
Run Code Online (Sandbox Code Playgroud)

调用 lambda

aws --profile diegosasw lambda invoke --function-name lambda-dotnet-function --payload "\"Just Checking If Everything is OK\"" response.json --log-type Tail
Run Code Online (Sandbox Code Playgroud)

本地堆栈

对于 localStack 是类似的,但是当然替换awsawslocal,并且我没有指定任何配置文件,但您可以使用--profile default或您拥有的任何.aws/credentials配置文件

创建角色

awslocal iam create-role --role-name lambda-dotnet-ex --assume-role-policy-document '{"Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
Run Code Online (Sandbox Code Playgroud)

将 AWSLambdaBasicExecutionRole 策略附加到角色

awslocal iam attach-role-policy --role-name lambda-dotnet-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
Run Code Online (Sandbox Code Playgroud)

创建拉姆达

awslocal lambda create-function --function-name lambda-dotnet-function --zip-file fileb://function.zip --handler Sample.Lambda.DotNet::Sample.Lambda.DotNet.Function::FunctionHandler --runtime dotnetcore3.1 --role arn:aws:iam::000000000000:role/lambda-dotnet-ex
Run Code Online (Sandbox Code Playgroud)

在 localstack 中调用 lambda 并传递 json 负载(字符串是有效的 JSON)

awslocal lambda invoke --function-name lambda-dotnet-function --payload "\"Just Checking If Everything is OK again\"" response.json --log-type Tail
Run Code Online (Sandbox Code Playgroud)

查看功能

awslocal lambda list-functions
Run Code Online (Sandbox Code Playgroud)

删除功能

awslocal lambda delete-function --function-name lambda-dotnet-function
Run Code Online (Sandbox Code Playgroud)

点网工具

使用 dotnet 工具,相当于

dotnet lambda invoke-function lambda-dotnet-function --payload "Just Checking If Everything is OK" --profile diegosasw
Run Code Online (Sandbox Code Playgroud)