Déploiement du code AWS Lambda dans différents environnements

La beauté d'AWS Lambda est qu'il vous permet de déployer et d'exécuter du code sans avoir besoin d'un quelconque serveur physique. En d'autres termes, vous pouvez mettre en place une architecture « serverless » à l'aide d'AWS Lambda.

Lorsque vous déployez votre code, il se peut que vous souhaitiez le déployer dans différents environnements (tels que les environnements de test, de développement et de production), afin de pouvoir le tester avant de le mettre en ligne.

Cet article vous présente les étapes de la configuration des fonctions Lambda dans différents environnements en utilisant l'alias de fonction AWS Lambda et le contrôle des versions. À la fin de ce blog, vous aurez appris à faire ce qui suit :

• Créer un alias pour la fonction AWS Lambda
• Associer l'alias de la fonction AWS Lambda à l'étape AWS API Gateway
• Sécuriser l'étape AWS API Gateway avec une clé d'API et une limitation de débit
• Réassocier les versions à l'alias

Ce sont les éléments essentiels pour gérer les différents environnements au sein du système serverless et pour le bon déroulement des mises à jour.

Créer un alias pour la fonction AWS Lambda

La section suivante vous montre comment créer des alias d'environnement pour une fonction Lambda et les associer aux versions de la fonction. Nous allons créer deux alias pour les environnements de développement et de production à titre d'exemple.

Créer une fonction Lambda

Pour créer une fonction Lambda, suivez les étapes ci-dessous :

1. Connectez-vous à votre console de gestion AWS, sélectionnez le service AWS Lambda dans la liste des services.
2. Cliquez sur le bouton Create function, puis sur l'option Author from scratch.
3. Configurez la lambda en fonction de vos besoins. Choisissez Node.js 12.x comme langage d'exécution et cliquez sur le bouton Create function.

Publier la version

Après avoir créé une fonction Lambda, vous pouvez publier la version comme suit :

1. Accédez à la version que vous venez de créer.
2. Sélectionnez Publish new version dans le menu déroulant « Actions » :

3. Publiez la nouvelle version avec une description appropriée, par exemple « Première version stable ».

Créer un alias pour chaque environnement

L'étape suivante consiste à créer un alias pour chaque environnement, comme indiqué ci-dessous :

1. Dans le menu déroulant Actions, sélectionnez Create a new alias.
2. Ajoutez le nom, la description et la version de l'alias, comme indiqué dans l'exemple suivant :

Remarque : vous devez effectuer cette étape deux fois, d'abord pour l'environnement de développement et ensuite pour l'environnement de production.

3. La version pour l'environnement de développement doit être $LATEST et celle pour l'environnement de production doit être 1, c.-à-d. la version que vous avez créée dans la section Publier la version ci-dessus.

Ces étapes garantissent qu'une version spécifique de la fonction Lambda est attribuée à l'environnement de production et que la dernière version est attribuée à l'environnement de développement.

Associer l'alias de la fonction AWS Lambda à l'étape AWS API Gateway

Cette section montre comment créer une nouvelle passerelle API AWS Lambda et associer les étapes de production et d'environnement aux alias de fonction Lambda respectifs.

Créer une nouvelle API REST

Les API REST permettent à la fonction Lambda de récupérer les données et de les envoyer. L'étape suivante consiste donc à créer une API REST en suivant les étapes ci-dessous :

1. Connectez-vous à la console de gestion AWS et sélectionnez API Gateways dans la liste des services.
2. Cliquez sur le bouton Create API.
3. Sur la page Choose an API type, choisissez l'option REST API(l'API publique) et cliquez sur Build.
4. Sur la page suivante, assurez-vous que la section Choose the protocol est cochée et que New API est coché dans la section Create new API. Saisissez le nom de l'API dans la section Paramètres et cliquez sur Create API.

5. Ajoutez maintenant une nouvelle ressource à la passerelle API, comme indiqué dans la capture d'écran suivante :

6. Ajoutez une méthode simple du type requis. Dans cet exemple, nous avons créé une méthode GET pour "/demo-resource".

Déploiement et ajout d'une variable de scène

Maintenant que l'API est créée, déployons-la.

1. Déployez l'API dans deux nouvelles étapes et nommez-les développement et production.
2. Dans l'onglet Stages de API Gateway, naviguez jusqu'à chaque étape déployée et ajoutez la variable stage avec la clé lambdaAlias et le nom de l'étape comme valeur.

Associer l'étape à l'alias lambda

1. Dans l'onglet Resources de API Gateway, sélectionnez la méthode REST API que vous avez créée ci-dessus.

2. Cliquez sur Integration Request,, qui est associé à Mock par défaut.
3. Sélectionnez la région Lambda dans la section Integration Request et définissez le nom comme étant le nom de la fonction Lambda suivi de :${stageVariables.lambdaAlias}. Dans notre exemple, nous l'avons nommée demo-function:${stageVariables.lambdaAlias} comme indiqué ci-dessous :

5. Après avoir cliqué sur Enregistrer, une invite apparaît avec une commande CLI et des instructions pour ajouter des autorisations pour chaque étape. Exécutez la commande à partir de la CLI AWS en remplaçant :${stageVariables.lambdaAlias}:par le nom de chaque étape.
6. Après avoir exécuté la commande, vos étapes Lambda s'attachent avec succès aux alias de fonction Lambda respectifs.

Sécurisation de l'étape AWS API Gateway avec une clé d'API et une limitation de débit

La section suivante montre comment ajouter la sécurité de la clé API à la passerelle API et appliquer la limitation de débit appropriée pour protéger vos environnements respectifs.

Création d'un plan d'utilisation

1. Créez un plan d'utilisation de l'API pour les environnements de développement et de production avec une limitation et un quota appropriés pour l'étape respective.

2. Remarque : pour de plus amples informations sur l'algorithme de limitation du débit, consultez le guide à la page suivante : https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html.
3. Associez maintenant l'étape de la passerelle API au plan d'utilisation correspondant lors de la création. Dans notre cas d'utilisation, nous associons le plan d'utilisation de développement à la phase de développement de la passerelle API.

Créer et ajouter une clé Api au plan d'utilisation

1. Sélectionnez chaque plan d'utilisation et accédez à l'onglet API Keys.

2. Cliquez sur Create an API Key and add it to the Usage Plan (Créer une clé API et l'ajouter au plan d'utilisation), puis ajoutez la clé API.

3. Après avoir créé la clé API, cliquez sur la clé API que vous venez de créer dans les plans d'utilisation respectifs.

Rendre la clé API obligatoire pour la ressource

1. Accédez à la méthode de ressource créée pour l'API.
2. Dans la section Method Execution, cliquez sur Method Request.
3. Dans la section Paramètres, définissez la valeur de la liste déroulante API Key Required sur true (vrai).

4. Déployez la passerelle API dans les deux étapes créées pour les environnements respectifs.

Après avoir effectué les étapes ci-dessus, vous aurez besoin des clés API respectives pour accéder aux étapes de la passerelle API associées aux différents alias.

Réassociation de la version à l'alias

Cette section montre comment vous pouvez mettre à jour la version de l'alias pour une fonction Lambda, que vous pouvez utiliser pour associer une nouvelle version à un alias de production ou pour revenir à une version antérieure du code.

Publier une nouvelle version

1. Publiez une nouvelle version de la dernière fonction Lambda lorsque le développement est terminé.
2. Cette étape est facultative si vous essayez de revenir à une version antérieure du code.

Changer d'alias

Sélectionnez l'alias de production dans la liste déroulante Qualifiers de la fonction AWS Lambda.

Mettre à jour la version de l'alias

1. Après avoir changé d'alias dans le menu déroulant, descendez jusqu'à la section Aliases de la fonction Lambda et sélectionnez une nouvelle version pour l'alias.

2. Cliquez sur Save pour terminer la réassociation de la version à l'alias.

Les étapes ci-dessus devraient vous aider à configurer plusieurs environnements dans AWS Lambda. Vous pouvez vous assurer que l'URL de développement obtient toujours le résultat de la dernière fonction Lambda et que l'environnement de production est lié à une version fixe de la fonction Lambda.