使用 .zip 文件归档部署 Go Lambda 函数 - Amazon Lambda
在 macOS 和 Linux 上创建 .zip 文件在 Windows 上创建 .zip 文件使用 .zip 文件创建和更新 Go Lambda 函数为依赖项创建 Go 层
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 可编译为原生代码，因此 Lambda 将 Go 视为自定义运行时系统。建议您使用 provided.al2 运行时系统将 Go 函数部署到 Lambda。

创建 .zip 部署包（macOS/Linux）

  1. 在包含应用程序的 main.go 文件的项目目录中，编译可执行文件。请注意以下几点：

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

    • 设置目标指令集架构。provided.al2 运行时系统支持 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

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

    • 处理程序值必须是 bootstrap。有关更多信息，请参阅命名。

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

    • 对于 --role，指定执行角色的 Amazon 资源名称（ARN）。

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

Lambda 的 Go 1.x 托管式运行时系统基于 Amazon Linux AMI（AL1）。Lambda 将继续支持 Go 1.x 托管式运行时系统，直到 2023 年 12 月 31 日结束对 Amazon Linux AMI 的维护支持。如果您使用的是 Go 1.x 运行时系统，则必须将函数迁移到 provided.al2。

创建 .zip 部署包（MacOS/Linux）

  1. 在包含应用程序的 main.go 文件的项目目录中，使用 go build 编译可执行文件。

    GOOS=linux GOARCH=amd64 go build main.go

    将 GOOS 设置为 linux 和将 GOARCH 设置为 amd64 可确保编译的可执行文件与 Go 运行时系统兼容（即使您在非 Linux 环境中或在配备 ARM 处理器的计算机上编译它也是如此）。

  2. （可选）如果您的 main 程序包包含多个文件，请使用以下 go build 命令来编译此程序包：

    GOOS=linux GOARCH=amd64 go build main

  3. （可选）您可能需要使用 Linux 上的 CGO_ENABLED=0 编译程序包：

    GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build main.go

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

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

    zip myFunction.zip main

  5. 创建 函数。对于 --role，指定执行角色的 Amazon 资源名称（ARN）。

    aws lambda create-function --function-name myFunction \
--runtime go1.x --handler main \
--role arn:aws:iam::111122223333:role/lambda-ex \
--zip-file fileb://myFunction.zip

在 Windows 上创建 .zip 文件

以下步骤演示如何从 GitHub 下载用于 Windows 的 build-lambda-zip 工具、如何编译可执行文件，以及如何创建 .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 可编译为原生代码，因此 Lambda 将 Go 视为自定义运行时系统。建议您使用 provided.al2 运行时系统将 Go 函数部署到 Lambda。

创建 .zip 部署包（Windows）

  1. 从 GitHub 下载 build-lambda-zip 工具。

    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 中，根据目标指令集架构运行以下任一命令。provided.al2 运行时系统支持 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 中，根据目标指令集架构运行以下任一命令。provided.al2 运行时系统支持 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.al2 --handler bootstrap \
--architectures arm64 \
--role arn:aws:iam::111122223333:role/lambda-ex \
--zip-file fileb://myFunction.zip

Lambda 的 Go 1.x 托管式运行时系统基于 Amazon Linux AMI（AL1）。Lambda 将继续支持 Go 1.x 托管式运行时系统，直到 2023 年 12 月 31 日结束对 Amazon Linux AMI 的维护支持。如果您使用的是 Go 1.x 运行时系统，则必须将函数迁移到 provided.al2。

创建 .zip 部署包（Windows）

  1. 从 GitHub 下载 build-lambda-zip 工具。

    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 中，运行以下命令：

    set GOOS=linux
set GOARCH=amd64
set CGO_ENABLED=0
go build main.go
%USERPROFILE%\Go\bin\build-lambda-zip.exe -o myFunction.zip main
    PowerShell

    在 PowerShell 中，运行以下命令：

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

  3. 创建 函数。对于 --role，指定执行角色的 Amazon 资源名称（ARN）。

    aws lambda create-function --function-name myFunction \
--runtime go1.x --handler main \
--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 层）的组合大小。

使用控制台通过 .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. 对于运行时系统，根据您创建的部署包类型，选择以下选项之一：

      • 在 Amazon Linux 2 上提供您自己的引导程序（推荐）：选择此选项可使用 provided.al2 运行时系统创建函数。

      • Go 1.x（旧版）：此运行时系统基于 Amazon Linux AMI（AL1）。Lambda 将继续支持 Go 1.x 运行时系统，直到 2023 年 12 月 31 日结束对 Amazon Linux AMI 的维护支持。建议您改用 provided.al2 运行时系统。

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

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

从本地计算机上传 .zip 归档（控制台）

  1. 在 Lambda 控制台的“函数”页面中，选择要为其上传 .zip 文件的函数。

  2. 选择代码选项卡。

  3. 在代码源窗格中，选择上传自。

  4. 选择 .zip 文件。

  5. 要上传 .zip 文件，请执行以下操作：

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

    2. 选择 Open（打开）。

    3. 选择 Save（保存）。

从 Amazon S3 存储桶上传 .zip 归档（控制台）

  1. 在 Lambda 控制台的“函数”页面中，选择要为其上传新 .zip 文件的函数。

  2. 选择代码选项卡。

  3. 在代码源窗格中，选择上传自。

  4. 选择 Amazon S3 位置。

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

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

您可以使用 Amazon CLI 创建新函数或使用 .zip 文件更新现有函数。使用 create-function 和 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.al2 --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.al2 --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 程序包。

要了解有关在 Amazon SAM 中使用 .zip 文件部署函数的更多信息，请参阅《Amazon SAM 开发人员指南》中的 AWS::Serverless::Function。

示例：使用 Amazon SAM，通过 provided.al2  构建 Go 函数

  1. 创建具有以下属性的 Amazon SAM 模板：

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

    • Runtime：使用 provided.al2。

    • 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.al2
      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 – 在 S3Bucket 和 S3Key 字段中输入 Amazon S3 存储桶名称和 .zip 文件名。

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

Amazon CloudFormation 生成的 .zip 文件不能超过 4MB。要了解有关在 Amazon CloudFormation 中使用 .zip 文件部署函数的更多信息，请参阅《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 中创建和删除层 和 向函数添加层 以完成层设置。