shogo82148/p5-aws-lambda

AWS::Lambda - Perl支持的AWS Lambda自定义运行时

镜像概述和主要用途

AWS::Lambda镜像基于lambci/lambda构建，旨在简化Perl脚本在AWS Lambda中的运行。通过预构建的Lambda层、Docker本地测试环境及配套工具，开发者可快速开发、部署和调试Perl语言的AWS Lambda函数，支持AWS ***请求追踪和Paws（Perl AWS SDK）调用AWS服务。

核心功能和特性

• 多Perl版本支持：提供Perl 5.32、5.30、5.28、5.26等版本的预构建Lambda层
• 预构建Lambda层：包含运行时环境和Paws SDK层，支持直接引用ARN快速部署
• 本地Docker测试：提供构建和运行镜像，支持本地安装依赖及事件触发测试
• **AWS *集成：预装AWS::XRay模块，支持请求追踪和性能分析
• Paws SDK支持：提供预构建Paws层，简化AWS服务API调用
• 自定义模块层：支持创建包含自定义Perl模块的Lambda层

使用场景和适用范围

适用于需要在AWS Lambda中运行Perl代码的开发者，特别是：

• 开发Perl微服务并部署到AWS Lambda
• 需要调用AWS服务API（如S3、DynamoDB）的Lambda函数
• 需对Lambda请求进行分布式追踪和性能分析
• 希望在本地模拟Lambda环境进行开发调试

详细使用方法和配置说明

快速入门示例

1. 创建Perl处理函数handler.pl：

   perl
   sub handle {
       my ($payload, $context) = @_;
       return $payload;
   }
   

2. 打包代码：

   bash
   zip handler.zip handler.pl
   

3. 使用AWS CLI创建Lambda函数：

   bash
   aws --region "$REGION" --profile "$PROFILE" lambda create-function \
       --function-name "hello-perl" \
       --zip-file "fileb://handler.zip" \
       --handler "handler.handle" \
       --runtime provided.al2 \
       --role arn:aws:iam::xxxxxxxxxxxx:role/service-role/lambda-custom-runtime-perl-role \
       --layers "arn:aws:lambda:$REGION:445285296882:layer:perl-5-32-runtime-al2:1"
   

使用预构建公共Lambda层

控制台部署步骤

1. 登录AWS账户，进入Lambda控制台
2. 创建新函数，指定名称和IAM角色
3. 运行时选择Amazon Linux 2上提供自己的引导程序（provided.al2）
4. 在函数设计器中选择Layers，点击添加层
5. 选择提供层版本ARN，粘贴对应区域的层ARN
6. 点击添加并保存，上传代码即可使用

获取层ARN

通过代码获取：

perl
use AWS::Lambda;
my $info = AWS::Lambda::get_layer_info_al2(
    "5.32",      # Perl版本
    "us-east-1", # 区域
);
say $info->{runtime_arn};     # 运行时层ARN
say $info->{paws_arn};         # Paws SDK层ARN

通过命令行获取：

bash
# 获取运行时层ARN
perl -MAWS::Lambda -e 'AWS::Lambda::print_runtime_arn_al2("5.32", "us-east-1")'

# 获取Paws层ARN
perl -MAWS::Lambda -e 'AWS::Lambda::print_paws_arn_al2("5.32", "us-east-1")'

Perl 5.32运行时层ARN列表（Amazon Linux 2）

• arn:aws:lambda:af-south-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-east-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-northeast-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-northeast-2:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-south-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-southeast-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ap-southeast-2:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:ca-central-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:eu-central-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:eu-south-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:eu-west-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:eu-west-2:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:eu-west-3:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:me-south-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:sa-east-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:us-east-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:us-east-2:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:us-west-1:445285296882:layer:perl-5-32-runtime-al2:1
• arn:aws:lambda:us-west-2:445285296882:layer:perl-5-32-runtime-al2:1

本地使用Docker运行

安装依赖

bash
docker run --rm -v $(PWD):/var/task shogo82148/p5-aws-lambda:build-5.32.al2 \
    cpanm --notest --local-lib extlocal --no-man-pages --installdeps .

触发事件测试

bash
docker run --rm -v $(PWD):/var/task shogo82148/p5-aws-lambda:5.32.al2 \
    handler.handle '{"some":"event"}'

AWS ***支持

通过AWS::XRay模块实现请求追踪：

perl
use utf8;
use warnings;
use strict;
use AWS::XRay qw/ capture /;

sub handle {
    my ($payload, $context) = @_;
    capture "myApp" => sub {
        capture "nested" => sub {
            # 业务逻辑...
        };
    };
    capture "another" => sub {
        # 业务逻辑...
    };
    return;
}

1;

Paws SDK支持

Paws是Perl的AWS SDK，可通过预构建层快速集成。

使用Paws层创建函数

bash
aws --region "$REGION" --profile "$PROFILE" lambda create-function \
    --function-name "hello-perl-paws" \
    --zip-file "fileb://handler.zip" \
    --handler "handler.handle" \
    --runtime provided.al2 \
    --role arn:aws:iam::xxxxxxxxxxxx:role/service-role/lambda-custom-runtime-perl-role \
    --layers \
        "arn:aws:lambda:$REGION:445285296882:layer:perl-5-32-runtime-al2:1" \
        "arn:aws:lambda:$REGION:445285296882:layer:perl-5-32-paws-al2:1"

Paws代码示例

perl
use Paws;
my $s3 = Paws->service('S3');
my $buckets = $s3->ListBuckets();
return { buckets => [map { $_->Name } @{$buckets->Buckets}] };

本地Paws开发

bash
# 安装依赖
docker run --rm -v $(PWD):/var/task shogo82148/p5-aws-lambda:build-5.32-paws.al2 \
    cpanm --notest --local-lib extlocal --no-man-pages --installdeps .

# 运行测试
docker run --rm -v $(PWD):/var/task shogo82148/p5-aws-lambda:5.32-paws.al2 \
    handler.handle '{"some":"event"}'

创建自定义模块层

将自定义Perl模块打包为Lambda层：

bash
# 创建Some::Module层
docker run --rm \
    -v $(PWD):/var/task \
    -v $(PATH_TO_LAYER_DIR)/lib/perl5/site_perl:/opt/lib/perl5/site_perl \
    shogo82148/p5-aws-lambda:build-5.32.al2 \
    cpanm --notest --no-man-pages Some::Module

# 打包层
cd $(PATH_TO_LAYER_DIR) && zip -9 -r $(PATH_TO_DIST)/some-module.zip .

遗留自定义运行时（Amazon Linux）

提供基于旧版Amazon Linux（runtime=provided）的层，支持Perl 5.32/5.30/5.28/5.26，层ARN格式：

• 运行时层：arn:aws:lambda:$REGION:445285296882:layer:perl-$VERSION-runtime:$VERSION
• Paws层：arn:aws:lambda:$REGION:445285296882:layer:perl-$VERSION-paws:$VERSION

参见

• AWS::Lambda::Bootstrap
• AWS::Lambda::Context
• AWS::Lambda::PSGI
• Paws
• AWS::***

许可证

MIT许可证（MIT）

版权所有 (C) Ichinose Shogo。

作者

Ichinose Shogo <***>