Création de fonctions Lambda .NET avec une compilation native AOT dans AWS SAM

Créez et empaquetez vos AWS Lambda fonctions .NET 8 avec le AWS Serverless Application Model (AWS SAM), en utilisant la compilation native Ahead-of-Time (AOT) pour améliorer les temps de démarrage à AWS Lambda froid.

Présentation de .NET 8 Native AOT

Historiquement, les fonctions Lambda .NET ont eu des temps de démarrage à froid affectant l'expérience utilisateur, la latence du système et les coûts d'utilisation de vos applications sans serveur. Avec la compilation .NET Native AOT, vous pouvez améliorer les temps de démarrage à froid de vos fonctions Lambda. Pour en savoir plus sur l'AOT natif pour .NET 8, voir Utilisation de l'AOT natif dans le référentiel GitHub Dotnet.

Utilisation AWS SAM avec vos fonctions Lambda .NET 8

Procédez comme suit pour configurer vos fonctions Lambda .NET 8 avec le AWS Serverless Application Model ()AWS SAM :

• Installez les prérequis sur votre machine de développement.

• Définissez les fonctions Lambda .NET 8 dans votre AWS SAM modèle.

• Créez votre application à l'aide du AWS SAMCLI.

Installer les prérequis

Les prérequis sont les suivants :

• Le AWS SAMCLI

• La CLI .NET Core

• L'outil global .NET Core d'Amazon.Lambda.Tools

• Docker

Installer la CLI  AWS SAM

1. Pour vérifier si la CLI  AWS SAM est déjà installée, procédez comme suit :

   sam --version

2. Pour installer le AWS SAMCLI, voirInstaller la CLI  AWS SAM.

3. Pour mettre à niveau une version installée du AWS SAMCLI, voirMise à niveau du AWS SAM CLI.

Installer la CLI .NET Core

1. Pour télécharger et installer la CLI .NET Core, veuillez consulter la rubrique Télécharger .NET (langue française non garantie) du site web Microsoft.

2. Pour plus d'informations sur la CLI .NET Core, veuillez consulter la rubrique Interface de ligne de commande .NET Core dans le Guide du développeur AWS Lambda .

Installer l'outil global .NET Core d'Amazon.Lambda.Tools

1. Exécutez la commande suivante :

   dotnet tool install -g Amazon.Lambda.Tools

2. Si cet outil est déjà installé, vous pouvez vérifier qu'il s'agit de la dernière version avec la commande suivante :

   dotnet tool update -g Amazon.Lambda.Tools

3. Pour plus d'informations sur l'outil global .NET Core d'Amazon.Lambda.Tools, consultez les extensions AWS pour le référentiel .NET CLI sur. GitHub

Installer Docker

• Docker doit être installé pour permettre la création avec la compilation anticipée native. Pour obtenir des instructions d’installation, consultez Installation de Docker à utiliser avec AWS SAM CLI.

Définissez les fonctions Lambda .NET 8 dans votre modèle AWS SAM

Pour définir un. NET8 Fonction Lambda dans votre AWS SAM modèle, procédez comme suit :

1. Exécutez la commande suivante depuis le répertoire de départ de votre choix :

   sam init

2. Sélectionnez AWS Quick Start Templates pour choisir un modèle de départ.

3. Choisissez le modèle Hello World Example.

4. Choisissez de ne pas utiliser le moteur d'exécution et le type de package les plus populaires en saisissantn.

5. Pour l'exécution, choisissezdotnet8.

6. Pour le type de package, choisissezZip.

7. Pour votre modèle de démarrage, choisissezHello World Example using native AOT.

Installer Docker

• Docker doit être installé pour permettre la création avec la compilation anticipée native. Pour obtenir des instructions d’installation, consultez Installation de Docker à utiliser avec AWS SAM CLI.

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

Note

Lorsque la Event propriété de an AWS::Serverless::Function est définie surApi, mais que la RestApiId propriété n'est pas spécifiée, AWS SAM la AWS::ApiGateway::RestApi AWS CloudFormation ressource est générée.

Créer votre application à l'aide de la CLI  AWS SAM

Depuis le répertoire racine de votre projet, exécutez la sam build commande pour commencer à créer votre application. Si la PublishAot propriété a été définie dans votre fichier de projet .NET 8, elle AWS SAMCLI sera compilée avec la compilation native AOT. Pour en savoir plus sur la propriété PublishAot, veuillez consulter la rubrique Déploiement anticipé natif (langue française non garantie) dans la documentation .NET de Microsoft.

Pour créer votre fonction, la CLI  AWS SAM invoque la CLI .NET Core qui utilise l'outil global .NET Core d'Amazon.Lambda.Tools.

Note

Lors de la création, si un fichier .sln existe dans le même répertoire ou dans le répertoire parent de votre projet, le répertoire contenant le fichier .sln sera monté dans le conteneur. Si aucun fichier .sln n'est trouvé, seul le dossier du projet est monté. Par conséquent, si vous créez une application multi-projets, assurez-vous que le fichier .sln est bien localisé.

En savoir plus

Pour plus d'informations sur la création de fonctions Lambda .NET 8, consultez Présentation du moteur d'exécution .NET 8 pour. AWS Lambda

Pour obtenir la référence de la commande sam build, consultez sam build.