Aplicar implementaciones canarias de Lambda con un alias ponderado

Puede utilizar un alias ponderado para dividir el tráfico entre dos versiones diferentes de la misma función. Bajo este enfoque, puede probar nuevas versiones de las funciones con un pequeño porcentaje del tráfico y revertir rápidamente si es necesario. Esto se conoce como implementación canaria. Las implementaciones canarias difieren de las azules/verdes en la medida en que exponen la nueva versión únicamente a una parte de las solicitudes, en lugar de cambiar todo el tráfico a la vez.

Puede apuntar un alias a un máximo de dos versiones de una función de Lambda. Las versiones deben cumplir los siguientes criterios:

Creación de un alias ponderado

Console

Para configurar el direccionamiento en un alias con la consola

nota

Verifique que la función tenga al menos dos versiones publicadas. Si necesita crear otras versiones, siga las instrucciones que se indican en Creación de versiones de funciones.

1. Abra la página de Funciones en la consola de Lambda.

2. Elija una función.

3. Elija Alias y, a continuación, elija Crear alias.

4. En la página Crear alias, haga lo siguiente:

   1. En Nombre, escriba el nombre del alias.

   2. (Opcional) En Descripción, escriba una descripción del alias.

   3. En Versión, elija la primera versión de la función a la que desea que apunte el alias.

   4. Expanda Weighted alias (Alias ponderados).

   5. En Versión adicional, elija la segunda versión de la función a la que desea que apunte el alias.

   6. En Weight (%) [Ponderación (%)], especifique la ponderación de la función. La ponderación es el porcentaje de tráfico que se asigna a dicha versión cuando se invoca el alias. La primera versión recibe la ponderación residual. Por ejemplo, si especifica un 10 por ciento en Additional version (Versión adicional), a la primera versión se asigna automáticamente el 90 %.

   7. Seleccione Guardar.

AWS CLI

Utilice los comandos create-alias y update-alias de AWS CLI para configurar las ponderaciones de tráfico entre dos versiones de funciones. Cuando se crea o actualiza el alias, se especifica la ponderación del tráfico en el parámetro routing-config.

En el ejemplo siguiente se crea un alias de una función de Lambda llamado routing-alias que apunta a la versión 1 de la función. La versión 2 de la función recibe el 3 por ciento del tráfico. El 97 por ciento restante del tráfico se dirige a la versión 1.

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

Utilice el comando update-alias para aumentar el porcentaje de tráfico entrante a la versión 2. En el ejemplo siguiente, aumenta el tráfico al 5 por ciento.

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

So desea dirigir todo el tráfico a la versión 2, utilice el comando update-alias para cambiar la propiedad function-version y dirigir el alias a la versión 2. El comando también restablece la configuración de direccionamiento.

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

Los comandos de la AWS CLI mencionados en los pasos anteriores se corresponden con las siguientes operaciones de la API de Lambda:

• CreateAlias

• UpdateAlias

anchoranchor

• Console
• AWS CLI

Para configurar el direccionamiento en un alias con la consola

nota

Verifique que la función tenga al menos dos versiones publicadas. Si necesita crear otras versiones, siga las instrucciones que se indican en Creación de versiones de funciones.

1. Abra la página de Funciones en la consola de Lambda.

2. Elija una función.

3. Elija Alias y, a continuación, elija Crear alias.

4. En la página Crear alias, haga lo siguiente:

   1. En Nombre, escriba el nombre del alias.

   2. (Opcional) En Descripción, escriba una descripción del alias.

   3. En Versión, elija la primera versión de la función a la que desea que apunte el alias.

   4. Expanda Weighted alias (Alias ponderados).

   5. En Versión adicional, elija la segunda versión de la función a la que desea que apunte el alias.

   6. En Weight (%) [Ponderación (%)], especifique la ponderación de la función. La ponderación es el porcentaje de tráfico que se asigna a dicha versión cuando se invoca el alias. La primera versión recibe la ponderación residual. Por ejemplo, si especifica un 10 por ciento en Additional version (Versión adicional), a la primera versión se asigna automáticamente el 90 %.

   7. Seleccione Guardar.

Cómo saber qué versión se invocó

Al configurar las ponderaciones de tráfico entre dos versiones de función, hay dos formas de determinar la versión de la función de Lambda que se ha invocado:

Creación de una implementación continua con alias ponderados

Utilice AWS CodeDeploy y AWS Serverless Application Model (AWS SAM) para crear una implementación continua que detecte automáticamente los cambios en el código de la función, implemente una nueva versión de la función y aumente gradualmente la cantidad de tráfico que fluye hacia la nueva versión. La cantidad de tráfico y la tasa de aumento son parámetros que puede configurar.

En una implementación continua, AWS SAM realiza las siguientes tareas:

Plantilla de AWS SAM de ejemplo

En el siguiente ejemplo se muestra una plantilla de AWS SAM para una implementación continua simple.

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: nodejs18.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

Esta plantilla define una función de Lambda denominada myDateTimeFunction con las siguientes propiedades.

Para obtener más información sobre cómo crear implementaciones continuas con CodeDeploy y AWS SAM, consulte lo siguiente: