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

使用 .zip 文件归档部署 Go Lambda 函数

您的 Amazon Lambda 函数代码由脚本或编译的程序及其依赖项组成。您可以使用部署程序包将函数代码部署到 Lambda。Lambda 支持两种类型的部署程序包:容器镜像和 .zip 文件归档。

本页将介绍如何创建 .zip 文件作为 Go 运行时系统的部署包,然后使用 .zip 文件通过 Amazon Web Services Management Console、Amazon Command Line Interface(Amazon CLI)和 Amazon Serverless Application Model(Amazon SAM)将函数代码部署到 Amazon Lambda。

请注意,Lambda 使用 POSIX 文件权限,因此在创建 .zip 文件归档之前,您可能需要为部署包文件夹设置权限

在 macOS 和 Linux 上创建 .zip 文件

以下步骤显示如何使用 go build 命令编译可执行文件并为 Lambda 创建 .zip 文件部署包。在编译代码之前,请确保已从 GitHub安装了 lambda 软件包。此模块提供运行时系统接口的实现,用于管理 Lambda 与函数代码之间的交互。要下载此库,请运行以下命令。

go get github.com/aws/aws-lambda-go/lambda

如果您的函数使用 Amazon SDK for Go,请下载标准的开发工具包模块集以及应用程序所需的任何 Amazon 服务 API 客户端。要了解如何安装适用于 Go 的开发工具包,请参阅 Amazon SDK for Go V2 入门

使用提供的运行时系列

Go 的实施方式与其他托管式运行时系统不同。由于 Go 本机编译为可执行的二进制文件,因此它不需要专用的语言运行时。使用仅限操作系统的运行时(运行时系列)将 Go 函数部署到 Lambda。provided

创建 .zip 部署包(macOS/Linux)
  1. 在包含应用程序的 main.go 文件的项目目录中,编译可执行文件。请注意以下几点:

    • 可执行文件必须命名为 bootstrap。有关更多信息,请参阅命名

    • 设置目标指令集架构。仅限操作系统的运行时同时支持 arm64 和 x86_64。

    • 您可以使用可选的 lambda.norpc 标签排除 lambda 库的远程过程调用(RPC)组件。只有在使用已弃用的 Go 1.x 运行时时,才需要 RPC 组件。排除 RPC 会减小部署包的大小。

    对于 arm64 架构:

    GOOS=linux GOARCH=arm64 go build -tags lambda.norpc -o bootstrap main.go

    对于 x86_64 架构:

    GOOS=linux GOARCH=amd64 go build -tags lambda.norpc -o bootstrap main.go
  2. (可选)您可能需要使用 Linux 上的 CGO_ENABLED=0 编译程序包:

    GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o bootstrap -tags lambda.norpc main.go

    此命令为标准 C 库 (libc) 版本创建稳定的二进制程序包,这在 Lambda 和其他设备上可能有所不同。

  3. 通过将可执行文件打包为 .zip 文件来创建部署程序包。

    zip myFunction.zip bootstrap
    注意

    bootstrap 文件必须位于 .zip 文件的根目录中。

  4. 创建函数。请注意以下几点:

    • 二进制文件必须命名为 bootstrap,但处理程序名称可以是任何名称。有关更多信息,请参阅命名

    • 仅在使用 arm64 时,必须使用 --architectures 选项。默认值为 x86_64。

    • 对于 --role,指定执行角色的 Amazon 资源名称(ARN)。

    aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler bootstrap \ --architectures arm64 \ --role arn:aws:iam::111122223333:role/lambda-ex \ --zip-file fileb://myFunction.zip

在 Windows 上创建 .zip 文件

以下步骤说明如何从下载适用于 Windows 的build-lambda-zip工具 GitHub、编译可执行文件以及创建.zip 部署包。

注意

如果您尚未完成此操作,则必须安装 git,然后将 git 可执行文件添加到您的 Windows %PATH% 环境变量。

在编译代码之前,请确保已从 GitHub安装了 lambda 库。要下载此库,请运行以下命令。

go get github.com/aws/aws-lambda-go/lambda

如果您的函数使用 Amazon SDK for Go,请下载标准的开发工具包模块集以及应用程序所需的任何 Amazon 服务 API 客户端。要了解如何安装适用于 Go 的开发工具包,请参阅 Amazon SDK for Go V2 入门

使用提供的运行时系列

Go 的实施方式与其他托管式运行时系统不同。由于 Go 本机编译为可执行的二进制文件,因此它不需要专用的语言运行时。使用仅限操作系统的运行时(运行时系列)将 Go 函数部署到 Lambda。provided

创建 .zip 部署包(Windows)
  1. 从中下载该build-lambda-zip工具 GitHub。

    go install github.com/aws/aws-lambda-go/cmd/build-lambda-zip@latest
  2. 使用来自 GOPATH 的工具创建 .zip 文件。如果您有 Go 的默认安装,则该工具通常在 %USERPROFILE%\Go\bin 中。否则,请导航到安装 Go 运行时的位置,然后执行以下任一操作:

    cmd.exe

    在 cmd.exe 中,根据目标指令集架构运行以下任一命令。仅限操作系统的运行时同时支持 arm64 和 x86_64。

    您可以使用可选的 lambda.norpc 标签排除 lambda 库的远程过程调用(RPC)组件。只有在使用已弃用的 Go 1.x 运行时时,才需要 RPC 组件。排除 RPC 会减小部署包的大小。

    例 – 对于 x86_64 架构
    set GOOS=linux set GOARCH=amd64 set CGO_ENABLED=0 go build -tags lambda.norpc -o bootstrap main.go %USERPROFILE%\Go\bin\build-lambda-zip.exe -o myFunction.zip bootstrap
    例 – 对于 arm64 架构
    set GOOS=linux set GOARCH=arm64 set CGO_ENABLED=0 go build -tags lambda.norpc -o bootstrap main.go %USERPROFILE%\Go\bin\build-lambda-zip.exe -o myFunction.zip bootstrap
    PowerShell

    在中 PowerShell,根据您的目标指令集架构,运行以下任一命令。仅限操作系统的运行时同时支持 arm64 和 x86_64。

    您可以使用可选的 lambda.norpc 标签排除 lambda 库的远程过程调用(RPC)组件。只有在使用已弃用的 Go 1.x 运行时时,才需要 RPC 组件。排除 RPC 会减小部署包的大小。

    对于 x86_64 架构:

    $env:GOOS = "linux" $env:GOARCH = "amd64" $env:CGO_ENABLED = "0" go build -tags lambda.norpc -o bootstrap main.go ~\Go\Bin\build-lambda-zip.exe -o myFunction.zip bootstrap

    对于 arm64 架构:

    $env:GOOS = "linux" $env:GOARCH = "arm64" $env:CGO_ENABLED = "0" go build -tags lambda.norpc -o bootstrap main.go ~\Go\Bin\build-lambda-zip.exe -o myFunction.zip bootstrap
  3. 创建函数。请注意以下几点:

    • 二进制文件必须命名为 bootstrap,但处理程序名称可以是任何名称。有关更多信息,请参阅命名

    • 仅在使用 arm64 时,必须使用 --architectures 选项。默认值为 x86_64。

    • 对于 --role,指定执行角色的 Amazon 资源名称(ARN)。

    aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler bootstrap \ --architectures arm64 \ --role arn:aws:iam::111122223333:role/lambda-ex \ --zip-file fileb://myFunction.zip

使用 .zip 文件创建和更新 Go Lambda 函数

创建 .zip 部署包后,您可以使用它来创建新的 Lambda 函数或更新现有的 Lambda 函数。您可以使用 Lambda 控制台、Amazon Command Line Interface 和 Lambda API 部署 .zip 程序包。您也可以使用 Amazon Serverless Application Model(Amazon SAM)和 Amazon CloudFormation 创建和更新 Lambda 函数。

Lambda 的 .zip 部署包的最大大小为 250MB(已解压缩)。请注意,此限制适用于您上传的所有文件(包括任何 Lambda 层)的组合大小。

Lambda 运行时需要权限才能读取部署包中的文件。在 Linux 权限八进制表示法中,Lambda 需要对不可执行文件(rw-r--r--)有 644 个权限,目录和可执行文件需要 755 个权限()。rwxr-xr-x

在 Linux 和 MacOS 中,使用 chmod 命令更改部署包中文件和目录的文件权限。例如,要为可执行文件提供正确的权限,请运行以下命令。

chmod 755 <filepath>

要在 Windows 中更改文件权限,请参阅 Microsoft Windows 文档中的 Set, View, Change, or Remove Permissions on an Object

使用控制台通过 .zip 文件创建和更新函数

要创建新函数,必须先在控制台中创建该函数,然后上传您的 .zip 归档。要更新现有函数,请打开函数页面,然后按照相同的步骤添加更新的 .zip 文件。

如果您的 .zip 文件小于 50MB,则可以通过直接从本地计算机上传该文件来创建或更新函数。对于大于 50MB 的 .zip 文件,必须首先将您的程序包上传到 Amazon S3 存储桶。有关如何使用 Amazon Web Services Management Console 将文件上传到 Amazon S3 存储桶的说明,请参阅 Amazon S3 入门。要使用 Amazon CLI 上传文件,请参阅《Amazon CLI 用户指南》中的移动对象

注意

您无法将现有容器映像函数转换为使用 .zip 归档。您必须创建新函数。

创建新函数(控制台)
  1. 打开 Lambda 控制台的“函数”页面,然后选择创建函数

  2. 选择 Author from scratch (从头开始创作)

  3. Basic information (基本信息) 中,执行以下操作:

    1. 对于函数名称,输入函数的名称。

    2. 对于 Runtime (运行时),请选择 provided.al2023

  4. (可选)在 Permissions(权限)下,展开 Change default execution role(更改默认执行角色)。您可以创建新的执行角色,也可以使用现有角色。

  5. 选择创建函数。Lambda 使用您选择的运行时系统创建基本“Hello world”函数。

从本地计算机上传 .zip 归档(控制台)
  1. 在 Lambda 控制台的“函数”页面中,选择要为其上传 .zip 文件的函数。

  2. 选择代码选项卡。

  3. 代码源窗格中,选择上传自

  4. 选择 .zip 文件

  5. 要上传 .zip 文件,请执行以下操作:

    1. 选择上传,然后在文件选择器中选择您的 .zip 文件。

    2. 选择打开

    3. 选择保存

从 Amazon S3 存储桶上传 .zip 归档(控制台)
  1. 在 Lambda 控制台的“函数”页面中,选择要为其上传新 .zip 文件的函数。

  2. 选择代码选项卡。

  3. 代码源窗格中,选择上传自

  4. 选择 Amazon S3 位置

  5. 粘贴 .zip 文件的 Amazon S3 链接 URL,然后选择保存

使用 Amazon CLI 通过 .zip 文件创建和更新函数

您可以使用 Amazon CLI 创建新函数或使用 .zip 文件更新现有函数。使用 create-fun ction 和update-function-code命令部署您的.zip 软件包。如果您的 .zip 文件小于 50MB,则可以从本地生成计算机上的文件位置上传 .zip 程序包。对于较大的文件,必须从 Amazon S3 存储桶上传 .zip 程序包。有关如何使用 Amazon CLI 将文件上传到 Amazon S3 存储桶的说明,请参阅《Amazon CLI 用户指南》中的移动对象

注意

如果您使用 Amazon CLI 从 Amazon S3 存储桶上传 .zip 文件,则该存储桶必须与您的函数位于同一个 Amazon Web Services 区域 中。

要通过 Amazon CLI 使用 .zip 文件创建新函数,则必须指定以下内容:

  • 函数的名称 (--function-name)

  • 函数的运行时系统 (--runtime)

  • 函数的执行角色 (--role) 的 Amazon 资源名称(ARN)

  • 函数代码 (--handler) 中处理程序方法的名称

还必须指定 .zip 文件的位置。如果 .zip 文件位于本地生成计算机上的文件夹中,请使用 --zip-file 选项指定文件路径,如以下示例命令所示。

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

要指定 .zip 文件在 Amazon S3 存储桶中的位置,请使用 --code 选项,如以下示例命令所示。您只需对版本控制对象使用 S3ObjectVersion 参数。

aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler bootstrap \ --role arn:aws:iam::111122223333:role/service-role/my-lambda-role \ --code S3Bucket=myBucketName,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

要使用 CLI 更新现有函数,请使用 --function-name 参数指定函数的名称。您还必须指定要用于更新函数代码的 .zip 文件的位置。如果 .zip 文件位于本地生成计算机上的文件夹中,请使用 --zip-file 选项指定文件路径,如以下示例命令所示。

aws lambda update-function-code --function-name myFunction \ --zip-file fileb://myFunction.zip

要指定 .zip 文件在 Amazon S3 存储桶中的位置,请使用 --s3-bucket--s3-key 选项,如以下示例命令所示。您只需对版本控制对象使用 --s3-object-version 参数。

aws lambda update-function-code --function-name myFunction \ --s3-bucket myBucketName --s3-key myFileName.zip --s3-object-version myObject Version

使用 Lambda API 通过 .zip 文件创建和更新函数

要使用 .zip 文件归档创建和更新函数,请使用以下 API 操作:

使用 Amazon SAM 通过 .zip 文件创建和更新函数

Amazon Serverless Application Model(Amazon SAM)是一个工具包,可帮助简化在 Amazon 上构建和运行无服务器应用程序的过程。您可以在 YAML 或 JSON 模板中为应用程序定义资源,并使用 Amazon SAM 命令行界面(Amazon SAM CLI)构建、打包和部署应用程序。当您通过 Amazon SAM 模板构建 Lambda 函数时,Amazon SAM 会使用您的函数代码和您指定的任何依赖项自动创建 .zip 部署包或容器映像。要了解有关使用 Amazon SAM 构建和部署 Lambda 函数的更多信息,请参阅《Amazon Serverless Application Model 开发人员指南》中的 Amazon SAM 入门

您可以使用 Amazon SAM 创建使用现有 .zip 文件归档的 Lambda 函数。要使用 Amazon SAM 创建 Lambda 函数,您可以将 .zip 文件保存在 Amazon S3 存储桶或生成计算机上的本地文件夹中。有关如何使用 Amazon CLI 将文件上传到 Amazon S3 存储桶的说明,请参阅《Amazon CLI 用户指南》中的移动对象

在 Amazon SAM 模板中,AWS::Serverless::Function 资源将指定 Lambda 函数。在此资源中,设置以下属性以创建使用 .zip 文件归档的函数:

  • PackageType – 设置为 Zip

  • CodeUri-设置为函数代码的 Amazon S3 URI、本地文件夹的路径或FunctionCode对象

  • Runtime – 设置为您选择的运行时系统

使用 Amazon SAM,如果 .zip 文件大于 50MB,则不需要先将其上传到 Amazon S3 存储桶。Amazon SAM 可以从本地生成计算机上的某个位置上传最大允许大小为 250MB(已解压缩)的 .zip 程序包。

要详细了解如何使用.zip 文件部署函数Amazon SAM,请参阅Amazon SAM开发人员指南AWS::Serverless::Function中的。

示例:使用 Amazon SAM,通过 provided.al2023 构建 Go 函数
  1. 创建具有以下属性的 Amazon SAM 模板:

    • BuildMethod:为您的应用程序指定编译器。使用 go1.x

    • Runtime:使用 provided.al2023

    • CodeUri: 输入代码的路径。

    • Architectures:对于 arm64 架构,使用 [arm64]。对于 x86_64 指令集架构,使用 [amd64] 或删除 Architectures 属性。

    例 template.yaml
    AWSTemplateFormatVersion: '2010-09-09' Transform: 'AWS::Serverless-2016-10-31' Resources: HelloWorldFunction: Type: AWS::Serverless::Function Metadata: BuildMethod: go1.x Properties: CodeUri: hello-world/ # folder where your main program resides Handler: bootstrap Runtime: provided.al2023 Architectures: [arm64]
  2. 使用 sam build 命令编译可执行文件。

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

    sam deploy --guided

使用 Amazon CloudFormation 通过 .zip 文件创建和更新函数

您可以使用 Amazon CloudFormation 创建使用 .zip 文件归档的 Lambda 函数。要从 .zip 文件创建 Lambda 函数,必须先将您的文件上传到 Amazon S3 存储桶。有关如何使用 Amazon CLI 将文件上传到 Amazon S3 存储桶的说明,请参阅《Amazon CLI 用户指南》中的移动对象

在 Amazon CloudFormation 模板中,AWS::Lambda::Function 资源将指定 Lambda 函数。在此资源中,设置以下属性以创建使用 .zip 文件归档的函数:

  • PackageType – 设置为 Zip

  • Code – 在 S3BucketS3Key 字段中输入 Amazon S3 存储桶名称和 .zip 文件名。

  • Runtime – 设置为您选择的运行时系统

Amazon CloudFormation 生成的 .zip 文件不能超过 4MB。要了解有关使用.zip 文件部署函数的更多信息Amazon CloudFormation,请参阅Amazon CloudFormation用户指南AWS::Lambda::Function中的。

为依赖项创建 Go 层

注意

在 Go 等编译语言中将层与函数结合使用,不一定会产生与使用 Python 等解释性语言的相同效果。由于 Go 是一种编译语言,因此函数仍然需要在初始化阶段将所有共享程序集手动加载到内存中,而这可能会增加冷启动时间。我们建议您改为在编译时包含任何共享代码,以充分利用内置编译器的优化。

本部分中的说明旨在向您展示如何将依赖项包含在层中。

Lambda 会自动检测 /opt/lib 目录中的任何库,以及 /opt/bin 目录中的任何二进制文件。为确保 Lambda 正确获取层内容,请创建包含以下结构的层:

custom-layer.zip └ lib | lib_1 | lib_2 └ bin | bin_1 | bin_2

打包层后,请参阅 在 Lambda 中创建和删除层 和 向函数添加层 以完成层设置。