Charges de travail .NET sur AWS Lambda

Dans Visual Studio, accédez au menu Extension et sélectionnez Gérer les extensions. Sur la droite, dans le champ de recherche, saisissez « AWS Toolkit ». Dans le volet des résultats, sélectionnez l'extension « AWS Toolkit pour Visual Studio » et cliquez sur Télécharger. Suivez les instructions pour installer l'extension. Vous devrez peut-être redémarrer Visual Studio.

En ce qui concerne le service Lambda, la boîte à outils fournit deux ensembles de fonctionnalités clés, des modèles de projet pour les fonctions Lambda et des outils destinés à faciliter le déploiement, la gestion et le test/l'invocation des fonctions Lambda. Parallèlement, la boîte à outils vous permet de gérer d'autres ressources AWS et de déployer des applications sur d'autres types d'infrastructure AWS tels qu'AWS Fargate, AWS App Runner et AWS Elastic Beanstalk (ils ne sont pas abordés dans ce cours).

La boîte à outils ajoute de nombreux modèles de projets Lambda pour vous aider à créer diverses fonctions Lambda.

La méthode la plus simple prend une chaîne et renvoie une version majuscule de cette chaîne. C'est l'idéal pour commencer grâce à sa simplicité, à sa facilité de déploiement et à sa facilité de test. En quelques minutes, vous pouvez exécuter une fonction .NET Lambda sur AWS, lui envoyer des requêtes et obtenir des réponses.

D'un point de vue plus complexe, il existe un modèle qui fournit une application Web .NET 6 complète (avec des pages Web et des contrôleurs d'API). Une fois celui-ci déployé, l'infrastructure requise pour le rendre accessible depuis le Web sera également déployée et configurée pour vous.

Des modèles de projets de conteneurs sont disponibles si vous le souhaitez. Notez que Docker doit être installé sur votre ordinateur pour que cela fonctionne. Consultez la section « Choisir l'exécution qui vous convient » du module 4 pour savoir pourquoi vous pouvez choisir d'utiliser des images de conteneur avec des fonctions Lambda.

Le test unitaire de vos fonctions Lambda est tout aussi important que le test de n'importe quel autre code. La plupart des modèles de projet incluent un projet de test qui utilise xUnit pour tester le code dans le projet de code source. Cela facilite le démarrage des tests unitaires.

Comme vous pouvez le constater ci-dessus, à partir de Visual Studio, vous pouvez également publier vos fonctions sur le service AWS Lambda. La fonctionnalité de publication prend en charge la création d'un package, le téléchargement vers le service Lambda, l'application des autorisations, la création du point de terminaison API Gateway et toutes les autres étapes nécessaires pour que votre code soit opérationnel et disponible pour l'invocation. Il vous suffit d'écrire le code.

Une autre fonctionnalité de la boîte à outils est l'explorateur AWS, qui vous permet de visualiser et de gérer de nombreuses ressources AWS, telles que DynamoDB, S3, SNS, les files d'attente SQS, EC2 et, bien sûr, les fonctions Lambda.

Pour ouvrir l'explorateur AWS, allez dans le menu Afficher et sélectionnez Explorateur AWS.

En ce qui concerne les fonctions Lambda, l'explorateur AWS vous permet de :

• Choisir une région.
• Afficher et gérer vos fonctions Lambda.
• Invoquer les fonctions Lambda sur AWS, en transmettant tous les paramètres nécessaires, et visualiser la réponse. L'outil fournit des exemples d'entrées pour simuler des appels provenant de divers autres services AWS. C'est très utile lorsque vous créez une fonction Lambda déclenchée par un événement provenant d'un autre service, par exemple un fichier créé sur S3.
• Déboguer une version exécutée localement d'une fonction Lambda.
• Configurer les services autorisés à déclencher une fonction Lambda.
• Afficher les journaux générés par les fonctions Lambda.
  

Pour invoquer une fonction Lambda depuis le kit d'outils, ouvrez l'explorateur AWS, développez la section Lambda, cliquez avec le bouton droit sur la fonction Lambda que vous souhaitez exécuter, puis sélectionnez Afficher la fonction.

À partir de là, vous pouvez choisir un exemple de demande dans la liste déroulante. Ces exemples vous permettent de simuler des appels provenant d'autres services AWS tels que API Gateway, S3, SNS, etc. Cela vous permet de tester facilement et directement vos fonctions Lambda qui sont invoquées par des événements provenant d'autres services.

Ou vous pouvez utiliser votre propre demande.

Outre ce qui précède, tous les outils de ligne de commande liés à Lambda peuvent être utilisés via le terminal.

Si vous utilisez AWS pour la première fois, la boîte à outils pour Visual Studio est le meilleur moyen de commencer. Il possède le plus de fonctionnalités de toutes les boîtes à outils disponibles et est le plus facile à déboguer et à effectuer des déploiements. L'AWS Toolkit pour Visual Studio fonctionne également avec Visual Studio Community Edition, qui est disponible gratuitement. Ceci, associé au niveau gratuit d'AWS, constitue une excellente combinaison pour les développeurs qui découvrent AWS.

Pour installer l'AWS Toolkit pour Rider, ouvrez le menu Fichier, puis Paramètres et plug-ins. Recherchez AWS Toolkit et installez-le.

Si vous avez déjà configuré un compte AWS sur votre ordinateur, la boîte à outils se connectera automatiquement à votre compte AWS.

Une fois l'installation terminée, vous aurez accès à une gamme de nouveaux modèles de fonctions AWS Lambda.

AWS CLI est disponible pour Windows, Linux et Mac. La méthode d'installation varie en fonction de votre système d'exploitation. Des instructions complètes sont disponibles sur la page AWS – Installation ou mise à jour de la dernière version de l'AWS CLI. AWS déconseille d'installer l'interface de ligne de commande AWS à l'aide d'un logiciel de gestion de packages. Utilisez plutôt le lien fourni ci-dessus.

N'oubliez pas que vous devez mettre à jour l'interface de ligne de commande AWS de temps à autre pour bénéficier des dernières fonctionnalités.

Pour vérifier votre version de l'AWS CLI, exécutez la commande suivante :

Vous verrez une réponse similaire à celle-ci :

Cela m'indique que la version 2.5.4 de l'AWS CLI est installée.

Pour voir quelle est la version la plus récente de l'AWS CLI, rendez-vous sur https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst. Vous trouverez ci-dessous la version de la version la plus récente dans le « CHANGELOG ». Au moment de la rédaction de cet article, il s'agit de la version 2.7.2, je dois donc mettre à jour mon AWS CLI !

Avec l'interface de ligne de commande AWS, vous pouvez gérer toutes vos ressources AWS. L'interface de ligne de commande AWS inclut de puissantes fonctionnalités de requête et de filtrage, qui peuvent vous aider à trouver les ressources que vous recherchez. Comme on peut s'y attendre, l'interface de ligne de commande AWS vous permet de répertorier, de visualiser, de gérer et d'invoquer des fonctions Lambda.

Une documentation complète avec des exemples est disponible sur la page AWS CLI Command Reference.

Pour installer les modèles, exécutez la commande suivante :

Une fois l'installation terminée, vous utiliserez la commande dotnet new pour créer de nouveaux projets de fonctions Lambda.

Pour voir la liste des modèles de projet disponibles, exécutez la commande suivante :

Vous verrez une sortie qui ressemble à ceci (notez que les modèles disponibles changent périodiquement) :

Vous remarquerez peut-être que le nom abrégé de certains modèles commence par « sans serveur ». « et certains commencent par « lambda ».

Ceux qui commencent par « sans serveur », utilisez le modèle d'application sans serveur (SAM) AWS pour déployer la fonction Lambda et créer l'infrastructure requise que la fonction Lambda utilisera. AWS SAM est un cadre open source qui vous permet de créer des applications sans serveur sur AWS. Outre la définition de la fonction Lambda, AWS SAM vous permet de définir d'autres ressources telles que des passerelles d'API, des bases de données et des sources d'événements.

Si vous accédez au répertoire projectname/src/projectname, vous verrez un fichier appelé serverless.template. Cela définit l'infrastructure requise et la manière dont elle est connectée à la fonction Lambda. Dans tous les modèles « sans serveur» listés ci-dessus, une passerelle API est utilisée pour acheminer les requêtes HTTP vers la fonction Lambda.

Les modèles qui commencent par « lambda » n'utilisent pas le modèle d'application sans serveur et ne configurent aucune autre infrastructure. Si une autre infrastructure est requise, vous devrez la configurer vous-même. Par exemple, le modèle de projet Lambda.kinesis vous montre comment traiter les événements Kinesis entrants, mais il ne crée PAS les flux Kinesis pour vous et n'ajoute PAS les autorisations pertinentes nécessaires pour que Kinesis déclenche la fonction Lambda.

Pour créer un nouveau projet basé sur le modèle Lambda.EmptyFunction, exécutez :

L'outillage est open source et peut être consulté sur GitHub,

https://github.com/aws/aws-lambda-dotnet#dotnet-cli-templates.

Comme pour les autres outils de ligne de commande, vous devez garder un œil sur les pages GitHub pertinentes pour savoir quand de nouvelles versions seront publiées.

Pour installer l'extension AWS pour .NET CLI, exécutez ce qui suit :

Pour vérifier qu'elle est correctement installée, exécutez :

Cela affichera un résumé des commandes que vous pouvez utiliser et un numéro de version.

Cet outil fonctionne à partir de n'importe quel shell et est particulièrement utile lorsqu'il est utilisé depuis le terminal dans Visual Studio Code et Rider. Il vous permet d'effectuer des tâches courantes liées aux fonctions Lambda.

Par exemple, pour répertorier toutes les fonctions Lambda, vous pouvez utiliser :

Ou pour invoquer une fonction Lambda, exécutez :

Il peut également déployer des fonctions Lambda. Après avoir créé une fonction Lambda, avec les modèles Lambda Dotnet (voir ci-dessus), vous pouvez déployer la fonction sur AWS en utilisant :

Cela lancera un processus de construction et de déploiement guidé. L'outil vous demandera le nom de la fonction Lambda, le rôle à attribuer à la fonction (ou à en créer un nouveau). Si vous avez créé un nouveau rôle, il vous sera demandé de choisir une politique d'autorisation pour ce nouveau rôle. L'outil déploiera ensuite la fonction sur AWS et vous pourrez l'invoquer en quelques secondes !

Pour voir toutes les options de ligne de commande disponibles, utilisez -

Gardez à l'esprit que chaque commande peut contenir de nombreuses fonctionnalités. Il est donc important de comprendre que chaque ligne de commande prend en charge plusieurs options. Par exemple, le fichier update-function-config vous permet d'activer et de configurer les URL des fonctions Lambda. Cette fonctionnalité n'est pas disponible dans la commande deploy-function. Il est important de rester au fait de la documentation et des fonctionnalités les plus récentes du service Lambda, car cela vous aidera à comprendre et à utiliser les dernières fonctionnalités.

Bien que cet outil soit très pratique et puissant pour gérer les fonctions Lambda lors du développement de code et de l'apprentissage d'AWS, nous vous encourageons vivement à utiliser un processus CI/CD robuste pour le déploiement sur vos applications lorsqu'elles atteignent un certain niveau de maturité. AWS prend en charge tous les principaux outils CI/CD.

Pour l'installation sur Windows, consultez le guide d'installation des outils AWS pour PowerShell sur Windows.

Pour l'installation sur Linux ou Mac, consultez le guide d'installation des outils AWS pour PowerShell sous Linux ou macOS.

Le nombre de modules, puis de commandes pouvant être exécutés par Outils AWS pour PowerShell est très important. En relation avec AWS Lambda, vous pouvez utiliser les outils pour répertorier, afficher, déployer, gérer et invoquer des fonctions.

Pour voir toutes les commandes disponibles, exécutez :

Vous trouverez la documentation complète de toutes les commandes dans la référence Cmdlet Outils AWS pour PowerShell. Accédez à la section Lambda dans la barre de gauche.

Pour répertorier toutes les fonctions Lambda exécutées :

Pour invoquer une fonction Lambda, exécutez :