Implementar funciones de Lambda .NET con imágenes de contenedor

Instale el paquete NuGet de Amazon.Lambda.Templates.

dotnet new install Amazon.Lambda.Templates

Cree un proyecto de .NET con la plantilla lambda.image.EmptyFunction.

dotnet new lambda.image.EmptyFunction --name MyFunction --region us-east-1

Vaya al directorio MyFunction/src/MyFunction. Aquí es donde se almacenan los archivos del proyecto. Examine los siguientes archivos:

Examine el Dockerfile en el directorio src/MyFunction. Puede usar el Dockerfile proporcionado para realizar pruebas o sustituirlo por el suyo propio. Si usa el suyo propio, asegúrese de que se cumpla lo siguiente:

Tenga en cuenta que el Dockerfile de ejemplo no incluye una instrucción USER. Al implementar una imagen de contenedor en Lambda, Lambda define automáticamente un usuario predeterminado de Linux con permisos de privilegio mínimo. Esto es diferente del comportamiento estándar de Docker, que utiliza de forma predeterminada el usuario root cuando no se proporciona ninguna instrucción USER.

# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM public.ecr.aws/lambda/dotnet:8
  
# Copy function code to Lambda-defined environment variable
COPY publish/* ${LAMBDA_TASK_ROOT}
  
# Set the CMD to your handler (could also be done as a parameter override outside of the Dockerfile)
CMD [ "MyFunction::MyFunction.Function::FunctionHandler" ]

Instale la herramienta global .NET de Amazon.Lambda.Tools.

dotnet tool install -g Amazon.Lambda.Tools

Si ya se ha instalado Amazon.Lambda.Tools, asegúrese de que posee la versión más reciente.

dotnet tool update -g Amazon.Lambda.Tools

Cambie el directorio a MyFunction/src/MyFunction si aún no se encuentra allí.

cd src/MyFunction

Utilice Amazon.Lambda.Tools para crear la imagen de Docker, subirla a un nuevo repositorio de Amazon ECR e implementar la función de Lambda.

En --function-role, especifique el nombre del rol (no el nombre de recurso de Amazon (ARN)) del rol de ejecución de la función. Por ejemplo, lambda-role.

dotnet lambda deploy-function MyFunction --function-role lambda-role

Para obtener más información acerca de la herramienta global de .NET de Amazon.Lambda.Tools, consulte el repositorio Extensiones de AWS para la CLI de .NET en GitHub.

Invoque la función.

dotnet lambda invoke-function MyFunction --payload "Testing the function"

Si todo es correcto, verá lo siguiente:

Payload:
"TESTING THE FUNCTION"

Log Tail:
START RequestId: id Version: $LATEST
END RequestId: id
REPORT RequestId: id  Duration: 0.99 ms       Billed Duration: 1 ms         Memory Size: 256 MB     Max Memory Used: 12 MB

Elimine la función de Lambda.

dotnet lambda delete-function MyFunction

Instale el paquete NuGet de Amazon.Lambda.Templates.

dotnet new install Amazon.Lambda.Templates

Cree un proyecto de .NET con la plantilla lambda.CustomRuntimeFunction. Esta plantilla incluye el paquete Amazon.Lambda.RuntimeSupport.

dotnet new lambda.CustomRuntimeFunction --name MyFunction --region us-east-1

Vaya al directorio MyFunction/src/MyFunction. Aquí es donde se almacenan los archivos del proyecto. Examine los siguientes archivos:

Abra el archivo aws-lambda-tools-defaults.json y agregue las siguientes líneas:

  "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"

{
  "Information": [
    "This file provides default values for the deployment wizard inside Visual Studio and the AWS Lambda commands added to the .NET Core CLI.",
    "To learn more about the Lambda commands with the .NET Core CLI execute the following command at the command line in the project root directory.",
    "dotnet lambda help",
    "All the command line options for the Lambda command can be specified in this file."
  ],
  "profile": "",
  "region": "us-east-1",
  "configuration": "Release",
  "function-runtime": "provided.al2023",
  "function-memory-size": 256,
  "function-timeout": 30,
  "function-handler": "bootstrap",
  "msbuild-parameters": "--self-contained true",
  "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"
}

Cree un Dockerfile en el directorio MyFunction/src/MyFunction. El siguiente Dockerfile de ejemplo usa una imagen base de .NET para Microsoft en lugar de una imagen base de AWS.

Tenga en cuenta que el Dockerfile de ejemplo no incluye una instrucción USER. Al implementar una imagen de contenedor en Lambda, Lambda define automáticamente un usuario predeterminado de Linux con permisos de privilegio mínimo. Esto es diferente del comportamiento estándar de Docker, que utiliza de forma predeterminada el usuario root cuando no se proporciona ninguna instrucción USER.

# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM mcr.microsoft.com/dotnet/runtime:8.0

# Set the image's internal work directory
WORKDIR /var/task
  
# Copy function code to Lambda-defined environment variable
COPY "bin/Release/net8.0/linux-x64"  .
  
# Set the entrypoint to the bootstrap
ENTRYPOINT ["/usr/bin/dotnet", "exec", "/var/task/bootstrap.dll"]

Instale la extensión de herramientas globales de .NET de Amazon.Lambda.Tools.

dotnet tool install -g Amazon.Lambda.Tools

Si ya se ha instalado Amazon.Lambda.Tools, asegúrese de que posee la versión más reciente.

dotnet tool update -g Amazon.Lambda.Tools

Utilice Amazon.Lambda.Tools para crear la imagen de Docker, subirla a un nuevo repositorio de Amazon ECR e implementar la función de Lambda.

En --function-role, especifique el nombre del rol (no el nombre de recurso de Amazon (ARN)) del rol de ejecución de la función. Por ejemplo, lambda-role.

dotnet lambda deploy-function MyFunction --function-role lambda-role

Para obtener más información acerca de la extensión CLI de la herramienta global de .NET de Amazon Lambda, consulte el repositorio Extensiones de AWS para la CLI de .NET en GitHub.

Invoque la función.

dotnet lambda invoke-function MyFunction --payload "Testing the function"

Si todo es correcto, verá lo siguiente:

Payload:
"TESTING THE FUNCTION"

Log Tail:
START RequestId: id Version: $LATEST
END RequestId: id
REPORT RequestId: id  Duration: 0.99 ms       Billed Duration: 1 ms         Memory Size: 256 MB     Max Memory Used: 12 MB

Elimine la función de Lambda.

dotnet lambda delete-function MyFunction