Utilisation de Lambda avec infrastructure en tant que code (IaC)

Lambda propose plusieurs méthodes pour déployer votre code et créer des fonctions. Par exemple, vous pouvez utiliser la console Lambda ou le AWS Command Line Interface (AWS CLI) pour créer ou mettre à jour manuellement des fonctions Lambda. Outre ces options manuelles, AWS propose un certain nombre de solutions pour déployer des fonctions Lambda et des applications sans serveur utilisant l'infrastructure en tant que code (IaC). Avec l’IaC, vous pouvez configurer et gérer des fonctions Lambda et d’autres ressources AWS à l’aide de code plutôt qu’utiliser des processus et des paramètres manuels.

La plupart du temps, les fonctions Lambda ne s’exécutent pas de manière isolée. Elles font plutôt partie d’une application sans serveur avec d’autres ressources telles que les bases de données, les files d’attente et le stockage. Avec IaC, vous pouvez automatiser vos processus de déploiement pour déployer et mettre à jour rapidement et de manière répétée des applications sans serveur complètes impliquant de nombreuses ressources distinctes. AWS Cette approche accélère votre cycle de développement, facilite la gestion des configurations et garantit que vos ressources sont déployées de la même manière à chaque fois.

Outils de l’IaC pour Lambda

Pour déployer des fonctions Lambda et des applications sans serveur à l'aide d'IaC, AWS propose un certain nombre d'outils et de services différents.

AWS CloudFormation a été le premier service proposé par AWS pour créer et configurer des ressources cloud. Avec AWS CloudFormation, vous créez des modèles de texte pour définir l'infrastructure et le code. À mesure que de nouveaux services étaient AWS introduits et que la complexité de la création de AWS CloudFormation modèles augmentait, deux autres outils ont été publiés. AWS SAM est un autre framework basé sur des modèles pour définir des applications sans serveur. AWS Cloud Development Kit (AWS CDK) Il s'agit d'une approche axée sur le code pour définir et approvisionner l'infrastructure à l'aide de constructions de code dans de nombreux langages de programmation courants.

Avec les deux AWS SAM et le AWS CDK, AWS CloudFormation opère en coulisse pour créer et déployer votre infrastructure. Le schéma suivant illustre la relation entre ces outils, et les paragraphes qui suivent le schéma expliquent leurs principales fonctionnalités.

AWS fournit également un service appelé Composeur d'applications AWS à développer des modèles IaC à l'aide d'une interface graphique simple. Avec Application Composer, vous concevez une architecture d'application en faisant glisser, en regroupant et AWS services en connectant dans un canevas visuel. Application Composer crée ensuite un AWS SAM modèle ou un AWS CloudFormation modèle à partir de votre conception que vous pouvez utiliser pour déployer votre application.

Dans la section Démarrage avec l’IaC pour Lambda ci-dessous, Application Composer vous permet de développer un modèle pour une application sans serveur basée sur une fonction Lambda existante.

Démarrage avec l’IaC pour Lambda

Dans ce didacticiel, vous pouvez commencer à utiliser IaC avec Lambda en créant un AWS SAM modèle à partir d'une fonction Lambda existante, puis en développant une application sans serveur dans Application Composer en ajoutant d'autres ressources. AWS

Si vous préférez commencer par suivre un AWS SAM AWS CloudFormation didacticiel pour apprendre à travailler avec des modèles sans utiliser Application Composer, vous trouverez des liens vers d'autres ressources dans la Étapes suivantes section à la fin de cette page.

Au cours de ce didacticiel, vous apprendrez certains concepts fondamentaux, tels que la manière dont les AWS ressources sont spécifiées dans AWS SAM. Vous apprendrez également à utiliser Application Composer pour créer une application sans serveur que vous pouvez déployer à l'aide de AWS SAM ou AWS CloudFormation.

Pour compléter ce didacticiel, effectuez les tâches suivantes :

Dans Étapes suivantes cette section, vous trouverez des ressources que vous pouvez utiliser pour en savoir plus sur AWS SAM Application Composer. Ces ressources incluent des liens vers des didacticiels plus avancés qui vous apprennent à déployer une application sans serveur à l'aide AWS SAM de.

Prérequis

Dans ce didacticiel, vous allez utiliser la fonctionnalité de synchronisation locale d’Application Composer pour enregistrer votre modèle et vos fichiers de code sur votre machine de génération locale. Pour utiliser cette fonctionnalité, vous devez disposer d'un navigateur prenant en charge l'accès au système de fichiersAPI, qui permet aux applications Web de lire, d'écrire et d'enregistrer des fichiers dans votre système de fichiers local. Nous vous recommandons d’utiliser Google Chrome ou Microsoft Edge. Pour plus d'informations sur l'accès au système de fichiersAPI, voir Qu'est-ce que l'accès au système de fichiers API ?

Création d’une fonction Lambda

Dans cette première étape, vous allez créer une fonction Lambda que vous pouvez utiliser pour terminer le reste du didacticiel. Pour simplifier les choses, vous utilisez la console Lambda pour créer une fonction de base « Hello world » à l’aide du moteur d’exécution Python 3.11.

Afficher le AWS SAM modèle correspondant à votre fonction

Avant d’exporter la configuration de votre fonction vers Application Composer, utilisez la console Lambda pour afficher la configuration actuelle de votre fonction sous forme de modèle AWS SAM . En suivant les étapes décrites dans cette section, vous découvrirez l'anatomie d'un AWS SAM modèle et comment définir des ressources telles que les fonctions Lambda pour commencer à spécifier une application sans serveur.

Prenons un moment pour examiner le YAML modèle de votre fonction et comprendre certains concepts clés.

Le modèle commence par la déclaration Transform: AWS::Serverless-2016-10-31. Cette déclaration est obligatoire car, dans les coulisses, les AWS SAM modèles sont déployés via AWS CloudFormation. L’utilisation de l’instruction Transform identifie le modèle en tant que fichier modèle AWS SAM .

Après la déclaration Transform vient la section Resources. C'est ici que sont définies les AWS ressources que vous souhaitez déployer avec votre AWS SAM modèle. AWS SAM les modèles peuvent contenir une combinaison de AWS SAM ressources et de AWS CloudFormation ressources. Cela est dû au fait que pendant le déploiement, les AWS SAM AWS CloudFormation modèles se transforment en modèles, de sorte que toute AWS CloudFormation syntaxe valide peut être ajoutée à un AWS SAM modèle.

Pour le moment, une seule ressource est définie dans la section Resources du modèle, votre fonction Lambda LambdaIaCDemo. Pour ajouter une fonction Lambda à un AWS SAM modèle, vous devez utiliser le type de AWS::Serverless::Function ressource. La ressource Properties d’une fonction Lambda définit l’exécution de la fonction, le gestionnaire de fonctions et les autres options de configuration. Le chemin d'accès au code source de votre fonction qui AWS SAM doit être utilisé pour déployer la fonction est également défini ici. Pour en savoir plus sur les ressources des fonctions Lambda dans AWS SAM, consultez AWS: :Serverless : :Function dans le manuel du développeur.AWS SAM

Outre les propriétés et les configurations de la fonction, le modèle spécifie également une politique AWS Identity and Access Management (IAM) pour votre fonction. Cette politique autorise votre fonction à écrire des journaux sur Amazon CloudWatch Logs. Lorsque vous créez une fonction dans la console Lambda, Lambda associe automatiquement cette politique à votre fonction. Pour en savoir plus sur la spécification d'une IAM politique pour une fonction dans un AWS SAM modèle, consultez la policies propriété sur la AWS page ::Serverless : :Function du manuel du AWS SAM développeur.

Pour en savoir plus sur la structure des AWS SAM modèles, consultez la section Anatomie des AWS SAM modèles.

Composeur d'applications AWS À utiliser pour concevoir une application sans serveur

Pour commencer à créer une application sans serveur simple en utilisant le AWS SAM modèle de votre fonction comme point de départ, vous devez exporter la configuration de votre fonction vers Application Composer et activer le mode de synchronisation local d'Application Composer. La synchronisation locale enregistre automatiquement le code de votre fonction et votre AWS SAM modèle sur votre machine de génération locale et synchronise votre modèle enregistré lorsque vous ajoutez d'autres AWS ressources dans Application Composer.

Pour exporter votre fonction vers Application Composer, vous devez être autorisé à utiliser certaines API actions. Si vous ne parvenez pas à exporter votre fonction, vérifiez Autorisations nécessaires et assurez-vous que vous disposez des autorisations nécessaires.

Maintenant que vous avez ajouté ces ressources supplémentaires, examinons le AWS SAM modèle mis à jour créé par Application Composer.

Votre AWS SAM modèle doit désormais contenir les ressources et propriétés supplémentaires suivantes :

Le AWS SAM modèle final complet doit ressembler à ce qui suit.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An AWS Serverless Specification template describing your function.
Resources:
  LambdaIaCDemo:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: .
      Description: ''
      MemorySize: 128
      Timeout: 3
      Handler: lambda_function.lambda_handler
      Runtime: python3.11
      Architectures:
        - x86_64
      EventInvokeConfig:
        MaximumEventAgeInSeconds: 21600
        MaximumRetryAttempts: 2
      EphemeralStorage:
        Size: 512
      RuntimeManagementConfig:
        UpdateRuntimeOn: Auto
      SnapStart:
        ApplyOn: None
      PackageType: Zip
      Policies:
        - Statement:
            - Effect: Allow
              Action:
                - logs:CreateLogGroup
              Resource: arn:aws:logs:us-east-1:594035263019:*
            - Effect: Allow
              Action:
                - logs:CreateLogStream
                - logs:PutLogEvents
              Resource:
                - arn:aws:logs:us-east-1:594035263019:log-group:/aws/lambda/LambdaIaCDemo:*
        - DynamoDBCrudPolicy:
            TableName: !Ref LambdaIaCTable
      Events:
        LambdaIaCQueue:
          Type: SQS
          Properties:
            Queue: !GetAtt LambdaIaCQueue.Arn
            BatchSize: 1
      Environment:
        Variables:
          LAMBDAIACTABLE_TABLE_NAME: !Ref LambdaIaCTable
          LAMBDAIACTABLE_TABLE_ARN: !GetAtt LambdaIaCTable.Arn
  LambdaIaCQueue:
    Type: AWS::SQS::Queue
    Properties:
      MessageRetentionPeriod: 345600
  LambdaIaCTable:
    Type: AWS::DynamoDB::Table
    Properties:
      AttributeDefinitions:
        - AttributeName: id
          AttributeType: S
      BillingMode: PAY_PER_REQUEST
      KeySchema:
        - AttributeName: id
          KeyType: HASH
      StreamSpecification:
        StreamViewType: NEW_AND_OLD_IMAGES

Déployez votre application sans serveur à l'aide de AWS SAM (facultatif)

Si vous souhaitez déployer une application sans serveur AWS SAM à l'aide du modèle que vous venez de créer dans Application Composer, vous devez d'abord installer le AWS SAM CLI. Pour ce faire, suivez les instructions de la section Installation du AWS SAM CLI.

Avant de déployer votre application, vous devez également mettre à jour le code de fonction enregistré par Application Composer avec votre modèle. Pour le moment, le fichier lambda_function.py enregistré par Application Composer ne contient que le code de base « Hello world » fourni par Lambda lors de la création de la fonction.

Pour mettre à jour votre code de fonction, copiez le code suivant et collez-le dans le fichier lambda_function.py Application Composer enregistré sur votre machine de compilation locale. Vous avez spécifié le répertoire dans lequel Application Composer doit enregistrer ce fichier lorsque vous avez activé le mode de synchronisation locale.

Ce code accepte une paire clé-valeur dans un message provenant de la SQS file d'attente Amazon que vous avez créée dans Application Composer. Si la clé et la valeur sont des chaînes, le code les utilise ensuite pour écrire un élément dans la table DynamoDB définie dans votre modèle.

import boto3
import os
import json

# define the DynamoDB table that Lambda will connect to
tablename = os.environ['LAMBDAIACTABLE_TABLE_NAME']

# create the DynamoDB resource
dynamo = boto3.client('dynamodb')

def lambda_handler(event, context):
    # get the message out of the SQS event
    message = event['Records'][0]['body']
    data = json.loads(message)
    # write event data to DDB table
    if check_message_format(data):
        key = next(iter(data))
        value = data[key]
        dynamo.put_item(
            TableName=tablename,
            Item={
                'id': {'S': key},
                'Value': {'S': value}
            }
        )
    else:
        raise ValueError("Input data not in the correct format")

# check that the event object contains a single key value  
# pair that can be written to the database
def check_message_format(message):
    if len(message) != 1:
        return False
        
    key, value = next(iter(message.items()))
    
    if not (isinstance(key, str) and isinstance(value, str)):
        return False

    else:
        return True

Au cours du processus de déploiement, AWS SAM crée les ressources suivantes dans votre Compte AWS :

AWS SAM crée également les IAM rôles et les politiques nécessaires pour que votre fonction Lambda puisse lire les messages de la SQS file d'attente Amazon et effectuer des CRUD opérations sur la table DynamoDB.

Pour en savoir plus sur l'utilisation AWS SAM pour déployer des applications sans serveur, consultez les ressources de la Étapes suivantes section.

Testing de votre application déployée (facultatif)

Pour vérifier que votre application sans serveur s'est déployée correctement, envoyez un message à votre SQS file d'attente Amazon contenant une paire clé-valeur et vérifiez que Lambda écrit un élément dans votre table DynamoDB en utilisant ces valeurs.

Étapes suivantes

Pour en savoir plus sur l'utilisation d'Application Composer avec AWS SAM et AWS CloudFormation, commencez par Utiliser Application Composer avec AWS CloudFormation et AWS SAM.

Pour un didacticiel guidé permettant de AWS SAM déployer une application sans serveur conçue dans Application Composer, nous vous recommandons également de suivre le Composeur d'applications AWS didacticiel dans le AWS Serverless Patterns Workshop.

AWS SAM fournit une interface de ligne de commande (CLI) que vous pouvez utiliser avec des AWS SAM modèles et des intégrations tierces prises en charge pour créer et exécuter vos applications sans serveur. Vous pouvez ainsi créer et déployer votre application, effectuer des tests et un débogage locaux, configurer des pipelines CI/CD, etc. AWS SAM CLI Pour en savoir plus sur l'utilisation du AWS SAM CLI, consultez la section Getting started with AWS SAM dans le guide du AWS Serverless Application Model développeur.

Pour savoir comment déployer une application sans serveur avec un AWS SAM modèle à l'aide de la AWS CloudFormation console, commencez par Utiliser la AWS CloudFormation console dans le Guide de l'AWS CloudFormation utilisateur.

Régions prises en charge pour l’intégration de Lambda à Application Composer

L'intégration de Lambda à Application Composer est prise en charge dans les domaines suivants : Régions AWS