Utilizzo di Lambda con l'infrastructure as code (IaC)

Lambda offre diversi modi per implementare il codice e creare funzioni. Ad esempio, puoi usare la console Lambda o il AWS Command Line Interface (AWS CLI) per creare o aggiornare manualmente le funzioni Lambda. Oltre a queste opzioni manuali, AWS offre una serie di soluzioni per l'implementazione di funzioni Lambda e applicazioni serverless utilizzando l'infrastruttura come codice (IaC). Con l'IaC, puoi fornire e gestire funzioni Lambda e altre risorse AWS utilizzando il codice anziché servirti di processi e impostazioni manuali.

La maggior parte delle volte, le funzioni Lambda non vengono eseguite in modo isolato. Fanno invece parte di un'applicazione serverless con altre risorse come database, code e spazio di archiviazione. Con IaC, è possibile automatizzare i processi di distribuzione per distribuire e aggiornare in modo rapido e ripetibile intere applicazioni serverless che coinvolgono molte risorse separate. AWS Questo approccio accelera il ciclo di sviluppo, semplifica la gestione della configurazione e garantisce che le risorse vengano implementate sempre allo stesso modo.

Strumenti di IaC per Lambda

Per implementare funzioni Lambda e applicazioni serverless utilizzando IaC AWS , offre una serie di strumenti e servizi diversi.

AWS CloudFormation è stato il primo servizio offerto da AWS per creare e configurare risorse cloud. Con AWS CloudFormation, puoi creare modelli di testo per definire l'infrastruttura e il codice. Con l' AWS introduzione di nuovi servizi e l'aumento della complessità della creazione di AWS CloudFormation modelli, sono stati rilasciati altri due strumenti. AWS SAM è un altro framework basato su modelli per la definizione di applicazioni serverless. AWS Cloud Development Kit (AWS CDK) Si tratta di un approccio basato sul codice per la definizione e il provisioning dell'infrastruttura utilizzando costrutti di codice in molti linguaggi di programmazione popolari.

Con both AWS SAM and the AWS CDK, AWS CloudFormation opera dietro le quinte per creare e implementare l'infrastruttura. Il diagramma seguente illustra la relazione tra questi strumenti, mentre i paragrafi successivi al diagramma ne illustrano le funzionalità principali.

AWS fornisce anche un servizio chiamato Strumento AWS per la creazione di applicazioni a sviluppare modelli IaC utilizzando una semplice interfaccia grafica. Con Application Composer, puoi progettare un'architettura applicativa trascinandola, raggruppandola e connettendola in un'area di disegno visiva. AWS servizi Application Composer crea quindi uno o più AWS SAM AWS CloudFormation modelli dal tuo progetto che puoi utilizzare per distribuire l'applicazione.

Nella sezione Guida introduttiva all'IaC per Lambda seguente, utilizzi Strumento per la creazione di applicazioni per sviluppare un modello per un'applicazione serverless basata su una funzione Lambda esistente.

Guida introduttiva all'IaC per Lambda

In questo tutorial, puoi iniziare a utilizzare iAc con Lambda creando AWS SAM un modello da una funzione Lambda esistente e quindi creando un'applicazione serverless in Application Composer aggiungendo altre risorse. AWS

Se preferisci iniziare con un AWS SAM AWS CloudFormation tutorial per imparare a lavorare con i modelli senza usare Application Composer, troverai i link ad altre risorse nella Passaggi successivi sezione alla fine di questa pagina.

Man mano che svolgi questo tutorial, imparerai alcuni concetti fondamentali, ad esempio come vengono specificate AWS le risorse. AWS SAM Imparerai anche come usare Application Composer per creare un'applicazione serverless che puoi distribuire utilizzando or. AWS SAM AWS CloudFormation

Per completare questo tutorial, eseguirai le seguenti attività:

Nella Passaggi successivi sezione troverai le risorse che puoi utilizzare per saperne di più su Application AWS SAM Composer. Queste risorse includono collegamenti a tutorial più avanzati che insegnano come distribuire un'applicazione serverless utilizzando. AWS SAM

Prerequisiti

In questo tutorial, utilizzi la funzionalità di sincronizzazione locale di Strumento per la creazione di applicazioni per salvare i file di modello e codice sul computer di compilazione locale. Per utilizzare questa funzionalità, è necessario un browser che supporti il File System AccessAPI, che consente alle applicazioni Web di leggere, scrivere e salvare file nel file system locale. Ti consigliamo di utilizzare Google Chrome o Microsoft Edge. Per ulteriori informazioni sull'accesso al file systemAPI, vedete Cos'è l'accesso al file systemAPI?

Creazione di una funzione Lambda

In questo primo passaggio, creerai una funzione Lambda da utilizzare nei passaggi successivi del tutorial. Per semplicità, utilizzerai la console Lambda per creare una funzione di base "Hello world" tramite il runtime Python 3.11.

Visualizza il AWS SAM modello per la tua funzione

Prima di esportare la configurazione della funzione in Strumento per la creazione di applicazioni, utilizza la console Lambda per visualizzare la configurazione corrente della funzione come modello AWS SAM . Seguendo i passaggi di questa sezione, imparerai a conoscere l'anatomia di un AWS SAM modello e a definire risorse come le funzioni Lambda per iniziare a specificare un'applicazione serverless.

Dedichiamo un momento a esaminare il YAML modello della tua funzione e a comprendere alcuni concetti chiave.

Il modello inizia con la dichiarazione Transform: AWS::Serverless-2016-10-31. Questa dichiarazione è necessaria perché dietro le quinte vengono implementati dei AWS SAM modelli. AWS CloudFormation L'utilizzo dell'istruzione Transform identifica il modello come file di modello AWS SAM .

Dopo la dichiarazione Transform, arriva la sezione Resources. È qui che vengono AWS definite le risorse che si desidera distribuire con il AWS SAM modello. AWS SAM i modelli possono contenere una combinazione di AWS SAM risorse e AWS CloudFormation risorse. Questo perché durante la distribuzione, i AWS SAM modelli si espandono in AWS CloudFormation modelli, quindi è possibile aggiungere qualsiasi AWS CloudFormation sintassi valida a un AWS SAM modello.

Al momento, nella sezione Resources del modello è presente soltanto una risorsa definita, la funzione Lambda LambdaIaCDemo. Per aggiungere una funzione Lambda a un AWS SAM modello, si utilizza il tipo di AWS::Serverless::Function risorsa. La risorsa Properties di una funzione Lambda definisce il runtime della funzione, il gestore delle funzioni e altre opzioni di configurazione. Qui viene definito anche il percorso del codice sorgente della funzione da AWS SAM utilizzare per distribuire la funzione. Per ulteriori informazioni sulle risorse delle funzioni Lambda in AWS SAM, consulta AWS: :Serverless: :Function nella Developer Guide.AWS SAM

Oltre alle proprietà e alle configurazioni delle funzioni, il modello specifica anche una politica AWS Identity and Access Management () IAM per la funzione. Questa politica autorizza la tua funzione a scrivere log su Amazon CloudWatch Logs. Quando crei una funzione nella console Lambda, Lambda associa automaticamente questa policy alla tua funzione. Per ulteriori informazioni su come specificare una IAM policy per una funzione in un AWS SAM modello, consulta la policies proprietà nella pagina AWS: :Serverless: :Function della Developer Guide.AWS SAM

Per ulteriori informazioni sulla struttura dei modelli, consulta anatomia dei AWS SAM modelli.AWS SAM

Strumento AWS per la creazione di applicazioni Utilizzatelo per progettare un'applicazione serverless

Per iniziare a creare una semplice applicazione serverless utilizzando il AWS SAM modello della funzione come punto di partenza, esportate la configurazione della funzione in Application Composer e attivate la modalità di sincronizzazione locale di Application Composer. La sincronizzazione locale salva automaticamente il codice della funzione e il AWS SAM modello sulla macchina di compilazione locale e mantiene sincronizzato il modello salvato man mano che si aggiungono altre AWS risorse in Application Composer.

Per esportare la funzione in Application Composer, è necessaria l'autorizzazione per utilizzare determinate azioni. API Se non sei in grado di esportare la funzione, consulta Autorizzazioni richieste e assicurati di disporre delle autorizzazioni necessarie.

Ora che hai aggiunto queste risorse extra, diamo un'occhiata al AWS SAM modello aggiornato creato da Application Composer.

Il AWS SAM modello dovrebbe ora contenere le seguenti risorse e proprietà aggiuntive:

Il AWS SAM modello finale completo dovrebbe essere simile al seguente.

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

Implementa la tua applicazione serverless utilizzando AWS SAM (opzionale)

Se desideri utilizzare AWS SAM per distribuire un'applicazione serverless utilizzando il modello appena creato in Application Composer, devi prima installare il. AWS SAM CLI A tale scopo, segui le istruzioni riportate in Installazione di. AWS SAM CLI

Inoltre, prima di implementare l'applicazione devi aggiornare il codice della funzione che Strumento per la creazione di applicazioni ha salvato insieme al modello. Al momento, il file lambda_function.py salvato da Strumento per la creazione di applicazioni contiene solo il codice di base "Hello world" fornito da Lambda al momento della creazione della funzione.

Per aggiornare il codice della funzione, copia il codice seguente e incollalo nel file lambda_function.py che Strumento per la creazione di applicazioni ha salvato sul computer di compilazione locale. Hai specificato la directory in cui Strumento per la creazione di applicazioni deve salvare questo file quando hai attivato la modalità di sincronizzazione locale.

Questo codice accetta una coppia chiave-valore in un messaggio dalla SQS coda Amazon creata in Application Composer. Se sia la chiave sia il valore sono stringhe, il codice li utilizza per scrivere un elemento nella tabella DynamoDB definita nel modello.

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

Durante il processo di distribuzione, AWS SAM crea le seguenti risorse nel tuo: Account AWS

AWS SAM crea anche IAM i ruoli e le policy necessari in modo che la funzione Lambda possa leggere i messaggi dalla SQS coda Amazon ed eseguire CRUD operazioni sulla tabella DynamoDB.

Per saperne di più sull'utilizzo AWS SAM per la distribuzione di applicazioni serverless, consulta le risorse nella sezione. Passaggi successivi

Test dell'applicazione implementata (facoltativo)

Per confermare che la tua applicazione serverless sia stata distribuita correttamente, invia un messaggio alla tua SQS coda Amazon contenente una coppia chiave-valore e verifica che Lambda scriva un elemento nella tua tabella DynamoDB utilizzando questi valori.

Passaggi successivi

Per ulteriori informazioni sull'utilizzo di Application Composer con AWS SAM e AWS CloudFormation, inizia con Utilizzo di Application Composer con AWS CloudFormation e. AWS SAM

Per un tutorial guidato che utilizza la distribuzione AWS SAM di un'applicazione serverless progettata in Application Composer, ti consigliamo anche di seguire il Strumento AWS per la creazione di applicazioni tutorial del Serverless Patterns Workshop.AWS

AWS SAM fornisce un'interfaccia a riga di comando (CLI) che è possibile utilizzare con AWS SAM modelli e integrazioni di terze parti supportate per creare ed eseguire applicazioni serverless. Con AWS SAM CLI, puoi creare e distribuire la tua applicazione, eseguire test e debug locali, configurare pipeline CI/CD e altro ancora. Per ulteriori informazioni sull'utilizzo di AWS SAM CLI, consulta la Guida introduttiva per gli sviluppatori. AWS SAMAWS Serverless Application Model

Per informazioni su come distribuire un'applicazione serverless con un AWS SAM modello utilizzando la AWS CloudFormation console, inizia con Utilizzo della AWS CloudFormation console nella Guida per l'AWS CloudFormation utente.

Regioni che supportano l'integrazione Lambda con Strumento per la creazione di applicazioni

L'integrazione Lambda con Application Composer è supportata nei seguenti casi: Regioni AWS