使用 .zip 文件存档部署 Rust Lambda 函数 - Amazon Lambda
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

使用 .zip 文件存档部署 Rust Lambda 函数

注意

Rust 运行时系统客户端是实验性程序包。它随时可能更改,并且仅用于评估目的。

本页将介绍如何编译 Rust 函数,然后使用 Cargo Lambda 将已编译的二进制文件部署到 Amazon Lambda。此外,还会显示如何使用 Amazon Command Line Interface 和 Amazon Serverless Application Model CLI 部署已编译的二进制文件。

先决条件

在 macOS、Windows 或 Linux 上构建 Rust 函数

以下步骤将演示如何使用 Rust 为第一个 Lambda 函数创建项目,并使用 Cargo Lambda 对其进行编译。

  1. 安装 Cargo Lambda(一个 Cargo 子命令),它会为 macOS、Windows 和 Linux 上的 Lambda 编译 Rust 函数。

    要在任何安装有 Python 3 的系统上安装 Cargo Lambda,请使用 pip:

    pip3 install cargo-lambda

    要在 macOS 或 Linux 上安装 Cargo Lambda,请使用 Homebrew:

    brew tap cargo-lambda/cargo-lambda brew install cargo-lambda

    要在 Windows 上安装 Cargo Lambda,请使用 Scoop

    scoop bucket add cargo-lambda scoop install cargo-lambda/cargo-lambda

    有关其他选项,请参阅 Cargo Lambda 文档中的安装

  2. 创建程序包结构。此命令可在 src/main.rs 中创建一些基本的函数代码。您可以使用此代码进行测试,也可以将其替换为您自己的代码。

    cargo lambda new my-function
  3. 在程序包的根目录中,运行 build 子命令以编译函数中的代码。

    cargo lambda build --release

    (可选)如果要在 Lambda 上使用 Amazon Graviton2,请添加 --arm64 标志以针对 ARM CPU 编译代码。

    cargo lambda build --release --arm64
  4. 在部署 Rust 函数之前,请在计算机上配置 Amazon 凭证。

    aws configure

使用 Cargo Lambda 部署 Rust 函数二进制文件

使用 deploy 子命令将已编译的二进制文件部署到 Lambda。此命令可创建执行角色,然后创建 Lambda 函数。要指定现有的执行角色,请使用 --iam-role 标志

cargo lambda deploy my-function

使用 Amazon CLI 部署 Rust 函数二进制文件

您也可以使用 Amazon CLI 部署二进制文件。

  1. 使用 build 子命令构建 .zip 部署包。

    cargo lambda build --release --output-format zip
  2. 将 .zip 程序包部署到 Lambda。对于 --role,指定执行角色的 ARN。

    aws lambda create-function --function-name my-function \ --runtime provided.al2023 \ --role arn:aws:iam::111122223333:role/lambda-role \ --handler rust.handler \ --zip-file fileb://target/lambda/my-function/bootstrap.zip

使用 Amazon SAM CLI 部署 Rust 函数二进制文件

您也可以使用 Amazon SAM CLI 部署二进制文件。

  1. 使用资源和属性定义创建 Amazon SAM 模板。有关更多信息,请参阅 Amazon Serverless Application Model 开发人员指南中的 AWS::Serverless::Function

    例 Rust 二进制文件的 SAM 资源和属性定义
    AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Description: SAM template for Rust binaries Resources: RustFunction: Type: AWS::Serverless::Function Properties: CodeUri: target/lambda/my-function/ Handler: rust.handler Runtime: provided.al2023 Outputs: RustFunction: Description: "Lambda Function ARN" Value: !GetAtt RustFunction.Arn
  2. 使用 build 子命令编译函数。

    cargo lambda build --release
  3. 使用 sam deploy 命令将函数部署到 Lambda。

    sam deploy --guided

有关使用 Amazon SAM CLI 构建 Rust 函数的更多信息,请参阅《Amazon Serverless Application Model 开发人员指南》中的使用 Cargo Lambda 构建 Rust Lambda 函数

使用 Cargo Lambda 调用 Rust 函数

使用 invoke 子命令,通过负载测试函数。

cargo lambda invoke --remote --data-ascii '{"command": "Hello world"}' my-function

使用 Amazon CLI 调用 Rust 函数

您也可以使用 Amazon CLI 调用函数。

aws lambda invoke --function-name my-function --cli-binary-format raw-in-base64-out --payload '{"command": "Hello world"}' /tmp/out.txt

如果使用 cli-binary-format 版本 2,则 Amazon CLI 选项是必需的。要将其设为默认设置,请运行 aws configure set cli-binary-format raw-in-base64-out。有关更多信息,请参阅版本 2 的 Amazon Command Line Interface 用户指南中的 Amazon CLI 支持的全局命令行选项