使用容器镜像部署 Go Lambda 函数

使用 provided.al2 基本映像构建和部署 Go 函数。

请注意，无论是将函数部署为 .zip 文件存档还是容器映像，前三个步骤都是相同的。

1. 在本地计算机上，为新函数创建项目目录。

2. 在项目文件夹中，运行以下命令以安装所需的 Lambda Go 库。

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

   有关 Lambda Go 库的描述，请参阅使用 Go 构建 Lambda 函数。

3. 创建您的 Go 处理程序代码并包含 aws-lambda-go/lambda 程序包。

4. 使用文本编辑器在项目目录中创建一个 Dockerfile。以下示例 Dockerfile 使用 Amazon provided.al2 基本映像。

   FROM public.ecr.aws/lambda/provided:al2 as build
   # install compiler
   RUN yum install -y golang
   RUN go env -w GOPROXY=direct
   # cache dependencies
   ADD go.mod go.sum ./
   RUN go mod download
   # build
   ADD . .
   RUN go build -o /main
   # copy artifacts to a clean image
   FROM public.ecr.aws/lambda/provided:al2
   COPY --from=build /main /main
   ENTRYPOINT [ "/main" ]           

5. 使用 docker build 命令构建 Docker 映像。输入映像的名称。以下示例将映像命名为 hello-world。

   docker build -t hello-world . 

6. 对您的 Amazon ECR 注册表进行 Docker CLI 身份验证。

   aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com    

7. 标记镜像以匹配您的存储库名称，然后使用 docker push 命令将镜像部署到 Amazon ECR。

   docker tag  hello-world:latest 123456789012.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest
   docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest        

将 RIE 添加到映像

1. 在 Dockerfile 中，将 ENTRYPOINT 指令替换为以下内容：

   # (Optional) Add Lambda Runtime Interface Emulator and use a script in the ENTRYPOINT for simpler local runs
   ADD https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie /usr/bin/aws-lambda-rie
   RUN chmod 755 /usr/bin/aws-lambda-rie
   COPY entry.sh /
   RUN chmod 755 /entry.sh
   ENTRYPOINT [ "/entry.sh" ]        

2. 使用文本编辑器在项目目录中创建包含以下内容的文件 entry.sh：

   #!/bin/sh
   if [ -z "${AWS_LAMBDA_RUNTIME_API}" ]; then
     exec /usr/bin/aws-lambda-rie "$@"
   else
     exec "$@"
   fi        

在不向映像添加 RIE 的情况下进行本地测试

1. 从项目目录中，运行以下命令以从 GitHub 下载 RIE 并将其安装在本地计算机上。

   mkdir -p ~/.aws-lambda-rie && curl -Lo ~/.aws-lambda-rie/aws-lambda-rie \
   https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie \
   && chmod +x ~/.aws-lambda-rie/aws-lambda-rie               

2. 使用 docker run 命令运行您的 Lambda 镜像函数。在以下示例中，/main 是函数入口点的路径。

   docker run -d -v ~/.aws-lambda-rie:/aws-lambda --entrypoint /aws-lambda/aws-lambda-rie  -p 9000:8080 myfunction:latest /main      

   这会将映像作为容器运行，并在 localhost:9000/2015-03-31/functions/function/invocations 以本地方式启动终端节点。

3. 使用 curl 命令将事件发布到以下终端节点：

   curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

   此命令调用在容器映像中运行的 函数并返回响应。