DeploymentPreference

Especifica las configuraciones para habilitar implementaciones Lambda graduales. Para obtener más información acerca de la configuración de implementaciones de Lambda graduales, consulteImplementará gradualmente aplicaciones sin servidor.

Nota: Debe especificar unaAutoPublishAliasen suAWS::Serverless::Functionutilizar unDeploymentPreference; de lo contrario, se producirá un error.

Sintaxis

Para declarar esta entidad en suAWS Serverless Application Model(AWS SAM), utilice la siguiente sintaxis.

YAML

  Alarms: List
  Enabled: Boolean
  Hooks: Hooks
  Role: String
  TriggerConfigurations: List
  Type: String

Properties

Alarms

Una lista de alarmas de CloudWatch que desea que se activen algún error de la implementación.

Este establecimiento acepta elFn::Iffunción intrínseca. Consulte la sección Ejemplos en la parte inferior de este tema para ver una plantilla de ejemplo que utilizaFn::If.

Type: Lista

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad es específica deAWS SAMy no tieneAWS CloudFormationequivalente.

Enabled

Si esta preferencia de implementación está habilitada.

Type: Booleano

Obligatorio: No

Valor predeterminado: True

AWS CloudFormationcompatibilidad: Esta propiedad es específica deAWS SAMy no tieneAWS CloudFormationequivalente.

Hooks

Funciones de validación Lambda que se ejecutan antes y después del cambio de tráfico.

Type: Ganchos

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad es específica deAWS SAMy no tieneAWS CloudFormationequivalente.

Role

Un ARN de rol de IAM que CodeDeploy utilizará para cambiar el tráfico. No se creará un rol de IAM si se proporciona.

Type: Cadena

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad es específica deAWS SAMy no tieneAWS CloudFormationequivalente.

TriggerConfigurations

Una lista de configuraciones de activadores que desea asociar al grupo de implementación. Se utiliza para notificar a un tema de SNS sobre eventos del ciclo de vida.

Type: Lista

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente a la acciónTriggerConfigurationspropiedad de unAWS::CodeDeploy::DeploymentGrouprecurso.

Type

Actualmente, existen dos categorías de tipos de implementación: Linear y Canario. Para obtener más información acerca de los tipos de implementación disponibles, consulteImplementará gradualmente aplicaciones sin servidor.

Type: Cadena

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad es específica deAWS SAMy no tieneAWS CloudFormationequivalente.

Ejemplos

DeploymentPreference con ganchos anteriores y posteriores al tráfico.

Ejemplo de preferencia de implementación que contiene enlaces anteriores y posteriores al tráfico.

YAML

DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    - Ref: AliasErrorMetricGreaterThanZeroAlarm
    - Ref: LatestVersionErrorMetricGreaterThanZeroAlarm
  Hooks:
    PreTraffic:
      Ref: PreTrafficLambdaFunction
    PostTraffic:
      Ref: PostTrafficLambdaFunction

DeploymentPreference con Fn። If función intrínseca

Ejemplo de preferencia de implementación que utilizaFn::Ifpara configurar alarmas. En este ejemplo,Alarm1se configurará siMyConditionestrue, yAlarm2yAlarm5se configurará siMyConditionesfalse.

YAML

DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    Fn::If:
      - MyCondition
      - - Alarm1
      - - Alarm2
        - Alarm5