Creación de funciones de Lambda de .NET con compilación de AOT nativa en AWS SAM - AWS Serverless Application Model
Descripción general de AOT nativo para .NET 8Uso de AWS SAM con .NET 8Requisitos previos de instalaciónDefine las funciones de Lambda .NET 8 en tu plantilla de AWS SAM.Crea tu aplicación con la CLI de AWS SAM.Más información

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de funciones de Lambda de .NET con compilación de AOT nativa en AWS SAM

Cree y empaquete sus funciones de AWS Lambda de .NET 8 con AWS Serverless Application Model (AWS SAM), utilizando la compilación nativa avanzada (AOT) para mejorar los tiempos de arranque en frío de AWS Lambda.

Descripción general de AOT nativo para .NET 8

Históricamente, las funciones de Lambda .NET tienen tiempos de inicio en frío que afectan a la experiencia del usuario, la latencia del sistema y los costos de uso de las aplicaciones sin servidor. Con la compilación de AOT nativo de .NET, puede mejorar los tiempos de arranque en frío de sus funciones de Lambda. Para obtener más información sobre el AOT nativo para .NET 8, consulte Using Native AOT en el repositorio de GitHub de Dotnet.

Uso de AWS SAM con las funciones de Lambda de .NET 8

Siga estos pasos para configurar las funciones de Lambda de .NET 8 con AWS Serverless Application Model (AWS SAM):

  • Instala los requisitos previos en su máquina de desarrollo.

  • Defina las funciones de Lambda de .NET 8 en su plantilla de AWS SAM.

  • Crea tu aplicación con AWS SAM CLI.

Requisitos previos de instalación

A continuación, se indican los requisitos previos.

  • El valor AWS SAM CLI

  • La CLI de .NET Core

  • La herramienta global .NET Core de Amazon.Lambda.Tools.

  • Docker

Instala la CLIAWS SAM

  1. Para comprobar si ya tienes la CLI de AWS SAM instalada, ejecuta lo siguiente:

    sam --version

  2. Para instalar la CLI de AWS SAM, consulta Instala la AWS SAM CLI.

  3. Para actualizar una versión instalada de CLI de AWS SAM, consulta Actualización de AWS SAM CLI.

Instalar la CLI de .NET Core

  1. Para descargar e instalar la CLI de .NET Core, consulta Descargar .NET desde el sitio web de Microsoft.

  2. Para obtener más información sobre la CLI de .NET Core, consulta la CLI de .NET Core en la Guía para desarrolladores de AWS Lambda.

Instala la herramienta global .NET Core de Amazon.Lambda.Tools.

  1. Ejecuta el siguiente comando:

    dotnet tool install -g Amazon.Lambda.Tools

  2. Si ya tienes la herramienta instalada, puedes asegurarse de que es la versión más reciente usando el siguiente comando:

    dotnet tool update -g Amazon.Lambda.Tools

  3. Para obtener más información acerca de la herramienta de .NET Core Global Amazon.Lambda.Tools, consulta el repositorio AWS Extensions for .NET CLI en GitHub.

Instalar Docker

Define las funciones de Lambda .NET 8 en tu plantilla de AWS SAM.

Para definir una función de Lambda de .NET 8 en la plantilla de AWS SAM, haga lo siguiente:

  1. Ejecute el siguiente comando desde el directorio de inicio que quiera:

    sam init

  2. Seleccione AWS Quick Start Templates para elegir una plantilla de inicio.

  3. Elige la plantilla Hello World Example.

  4. Introduzca n para no utilizar la versión ejecutable y el tipo de paquete más populares.

  5. Para la versión ejecutable, elija dotnet8.

  6. Para el tipo de paquete, elija Zip.

  7. Para su plantilla de inicio, elija Hello World Example using native AOT.

Instalar Docker
Resources:
HelloWorldFunction:
  Type: AWS::Serverless::Function
  Properties:
    CodeUri: ./src/HelloWorldAot/
    Handler: bootstrap
    Runtime: dotnet8
    Architectures:
      - x86_64
    Events:
      HelloWorldAot:
        Type: Api 
        Properties:
          Path: /hello
          Method: get
nota

Cuando la propiedad Event de AWS::Serverless::Function se establece en Api, pero no se especifica la propiedad RestApiId, AWS SAM genera el recurso CloudFormation de AWS::ApiGateway::RestApi.

Crea tu aplicación con la CLI de AWS SAM.

Desde el directorio raíz del proyecto, ejecute el comando sam build para empezar a crear la aplicación. Si la propiedad PublishAot se ha definido en el archivo de proyecto de .NET 8, la AWS SAM de CLI se compilará con la compilación de AOT nativo. Para obtener más información sobre la propiedad PublishAot, consulta Implementación nativa de AOT en la documentación de .NET de Microsoft.

Para crear la función, AWS SAM CLI invoca la CLI de .NET Core, que utiliza la herramienta de .NET Core Global Amazon.Lambda.Tools.

nota

Al compilar, si existe un archivo .sln en el mismo directorio o en el directorio principal del proyecto, el directorio que contienes el archivo .sln se montará en el contenedor. Si no se encuentra ningún archivo .sln, solo se montará la carpeta del proyecto. Por lo tanto, si está creando una aplicación para varios proyectos, asegúrese de que el archivo .sln esté ubicado en la propiedad.

Más información

Para obtener más información sobre la creación de funciones de Lambda de .NET 8, consulte Introducing the .NET 8 runtime for AWS Lambda.

Para obtener más información sobre el comando sam build, consulta sam build.