Implementare le implementazioni canary Lambda utilizzando un alias ponderato

È possibile utilizzare un alias ponderato per suddividere il traffico tra due diverse versioni della stessa funzione. Con questo approccio, puoi testare nuove versioni delle tue funzioni con una piccola percentuale di traffico e ripristinarle rapidamente se necessario. Questa operazione è nota come implementazione canary. Le implementazioni canary si differenziano dalle implementazioni blu/verdi in quanto espongono la nuova versione solo a una parte delle richieste anziché spostare tutto il traffico contemporaneamente.

È possibile puntare un alias a un massimo di due versioni della funzione Lambda. Le versioni devono soddisfare i seguenti criteri:

Creare un alias ponderato

Console

Per configurare il routing utilizzando la console

Nota

Verificare che la funzione abbia almeno due versioni pubblicate. Per creare versioni aggiuntive, seguire le istruzioni in Creazione di versioni delle funzioni.

1. Aprire la pagina Funzioni della console Lambda.

2. Scegliere una funzione.

3. Scegliere Aliases (Alias) e quindi Create alias (Crea alias).

4. Nella pagina Create alias (Crea alias), eseguire le operazioni seguenti:

   1. Immettere un Name (Nome) per la query.

   2. (Facoltativo) Immettere una Description (Descrizione) per l'alias.

   3. Per Version (Versione), scegliere la prima versione della funzione a cui si desidera puntare l'alias.

   4. Espandere Weighted alias (Alias ponderato).

   5. In Additional version (Versione aggiuntiva), scegliere la seconda versione della funzione a cui si desidera puntare l'alias.

   6. Per Weight (%) (Ponderazione %), digitare un valore di ponderazione per la funzione. Weight (Ponderazione) è la percentuale di traffico assegnata alla versione quando l'alias viene invocato. La prima versione riceve la ponderazione residua. Ad esempio se si specifica il 10 percento per Additional version (Versione aggiuntiva), alla prima versione viene automaticamente assegnato il 90 percento.

   7. Selezionare Salva.

AWS CLI

Utilizza i comandi create-alias e update-alias della AWS CLI per configurare i pesi del traffico tra due versioni di funzioni. Quando crei o aggiorni l'alias, specifica il peso del traffico nel parametro routing-config.

Nell'esempio seguente viene creato un alias della funzione Lambda denominato routing-alias che punta alla versione 1 della funzione. La versione 2 della funzione riceve il 3% del traffico. Il restante 97 percento del traffico viene instradato alla versione 1.

aws lambda create-alias \
  --name routing-alias \
  --function-name my-function \
  --function-version 1  \
  --routing-config AdditionalVersionWeights={"2"=0.03}

Utilizza il comando update-alias per aumentare la percentuale di traffico in ingresso alla versione 2. Nell'esempio seguente, aumenti il traffico al 5%.

aws lambda update-alias \
  --name routing-alias \
  --function-name my-function \
  --routing-config AdditionalVersionWeights={"2"=0.05}

Per instradare tutto il traffico alla versione 2, utilizza il comando update-alias per modificare la proprietà function-version in modo che l'alias punti alla versione 2. Il comando reimposta anche la configurazione di routing.

aws lambda update-alias \
  --name routing-alias \
  --function-name my-function  \
  --function-version 2 \
  --routing-config AdditionalVersionWeights={}

I comandi AWS CLI nei passaggi precedenti corrispondono alle seguenti operazioni API Lambda:

• CreateAlias

• UpdateAlias

Determinazione della versione richiamata

Quando configuri i pesi del traffico tra due versioni di funzioni, esistono due modi per determinare la versione della funzione Lambda invocata:

Creare una implementazione continua con alias ponderati

Usa AWS CodeDeploy e AWS Serverless Application Model (AWS SAM) per creare una implementazione continua che rilevi automaticamente le modifiche al codice della funzione, implementi una nuova versione della funzione e aumenti gradualmente la quantità di traffico che fluisce verso la nuova versione. La quantità di traffico e la velocità dell'aumento sono parametri che è possibile configurare.

In una distribuzione in sequenza, AWS SAM esegue le seguenti attività:

Modello AWS SAM di esempio

Nell'esempio seguente viene illustrato un modello AWS SAM per una semplice distribuzione in sequenza.

AWSTemplateFormatVersion : '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: A sample SAM template for deploying Lambda functions

Resources:
# Details about the myDateTimeFunction Lambda function
  myDateTimeFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: myDateTimeFunction.handler
      Runtime: nodejs22.x
# Creates an alias named "live" for the function, and automatically publishes when you update the function.
      AutoPublishAlias: live
      DeploymentPreference:
# Specifies the deployment configuration
          Type: Linear10PercentEvery2Minutes

Questo modello definisce una funzione Lambda denominata myDateTimeFunction con le seguenti proprietà.

Per ulteriori informazioni su come creare implementazioni continue con CodeDeploy e AWS SAM, consulta gli argomenti seguenti: