Casos de uso de condiciones de etapa Consideraciones sobre la configuración de los resultados para las condiciones de etapa Consideraciones sobre las reglas configuradas para las condiciones de etapa Creación de condiciones de entrada Creación de condiciones de fallo Creación de condiciones de éxito Eliminación de condiciones de etapa Anulación de condiciones de etapa

Configuración de las condiciones de una etapa

Puede especificar una condición para una etapa, como por ejemplo, comprobar si hay una variable específica en la ejecución de la canalización y, a continuación, obtener un resultado para la condición, como por ejemplo, omitir la etapa o fallar la etapa. Se puede configurar una canalización para comprobar las condiciones de una etapa durante la ejecución, en la que se deben especificar en primer lugar las comprobaciones de dicha etapa y, en segundo lugar, la forma en que debe continuar la etapa cuando se cumplen determinadas condiciones. Las condiciones contienen una o más reglas que están disponibles en una lista de reglas en CodePipeline. Si todas las reglas de una condición se realizan correctamente, se cumple la condición. Puede configurar las condiciones para que, cuando no se cumplan los criterios, se active el resultado especificado.

Cada condición tiene un conjunto de reglas, en el que las reglas se ordenan y se evalúan juntas. Por lo tanto, si una regla falla en la condición, la condición también fallará. Puede anular las condiciones de la regla en el tiempo de ejecución de la canalización.

Las condiciones se utilizan para tipos específicos de expresiones, y cada una tiene opciones específicas de resultados disponibles, de la siguiente manera:

Entrada: las condiciones para realizar comprobaciones que, si se cumplen, permiten la entrada a una etapa. Las reglas se activan con las siguientes opciones de resultado: Fallar u Omitir.
Fallo: las condiciones para realizar las comprobaciones de la etapa en caso de que se produzca un error. Las reglas se activan con la siguiente opción de resultado: Reversión.
Éxito: las condiciones para realizar las comprobaciones de la etapa en caso de éxito. Las reglas se activan con las siguientes opciones de resultado: Reversión o Fallar.

Las condiciones están respaldadas por un conjunto de reglas para cada tipo de condición.

Para cada tipo de condición, la condición establece acciones específicas. La acción es el resultado de una comprobación de condición correcta o fallida. Por ejemplo, si la condición para la entrada (condición de entrada) genera una alarma (regla), la comprobación se realiza correctamente y el resultado (acción) es que se bloquea la entrada a la etapa.

También puede usar la consola de AWS CodePipeline o la AWS CLI para revertir o volver a intentar manualmente una etapa o acciones de una etapa. Consulte Configuración de las condiciones de una etapa.

Temas

Casos de uso de condiciones de etapa
Consideraciones sobre la configuración de los resultados para las condiciones de etapa
Consideraciones sobre las reglas configuradas para las condiciones de etapa
Creación de condiciones de entrada
Creación de condiciones de fallo
Creación de condiciones de éxito
Eliminación de condiciones de etapa
Anulación de condiciones de etapa

Casos de uso de condiciones de etapa

Las condiciones de etapa tienen varios casos de uso para configurar la seguridad de lanzamiento y de cambio en las canalizaciones. Los siguientes son ejemplos de casos de uso para las condiciones de etapa.

Utilice una condición de entrada para definir una condición que compruebe el estado de las alarmas de CloudWatch y, a continuación, bloquee un cambio si el entorno de producción no se encuentra en buen estado.
Utilice una condición de entrada con un tiempo de espera de 60 para definir una condición que se evaluará cuando todas las acciones de una etapa se hayan completado correctamente y, a continuación, revierta los cambios si una alarma de CloudWatch pasa al estado ALARM en un plazo de 60 minutos.
Utilice la condición de éxito para definir una condición de modo que, cuando la etapa se complete correctamente, la regla compruebe si la hora actual se encuentra en la ventana de implementación y, a continuación, se implemente si la regla se ejecuta correctamente.

Consideraciones sobre la configuración de los resultados para las condiciones de etapa

Los aspectos sobre las condiciones de etapa que se deben tener en cuenta son los siguientes:

No puede utilizar el reintento automático de etapas con las condiciones onFailure.
Al configurar una condición con un resultado de Reversión, la etapa solo puede revertirse a una ejecución anterior si está disponible en la versión actual de la estructura de canalización.
Al configurar una condición con un resultado de Reversión, no se puede revertir a un identificador de ejecución de destino que sea un tipo de ejecución de reversión.
En el caso de las condiciones de entrada que utilizan el resultado Omitir para saltarse la etapa si la condición falla, solo se admiten las reglas LambdaInvoke y VariableCheck.
No se puede realizar un reintento manual de una etapa en una etapa que esté en estado Omitido.
No se puede realizar una reversión manual a una etapa que esté en estado Omitido.
No puede anular una condición si la condición está configurada con un resultado Omitir.
A excepción de los resultados Omitir, puede anular la condición de una etapa al iniciar la ejecución de una canalización. En el caso de una condición de etapa en la que se produzca una anulación, la ejecución se realizará tal y como se detalla en la siguiente tabla.

Tipo	Resultado configurado en caso de fallo en la condición	Estado de la etapa	Comportamiento de anulación
Entrada	Fail	En curso	La etapa continúa.
Entrada	Omitir	Omitido	No se usa.
OnFailure	Reversión	Con error	La etapa ha fallado.
OnSuccess	Reversión	Realizado correctamente	La etapa continúa.
OnSuccess	Fail	Con error	La etapa continúa.

Consideraciones sobre las reglas configuradas para las condiciones de etapa

Los aspectos que se deben tener en cuenta sobre las reglas disponibles para las condiciones de etapa son los siguientes:

Para la regla LambdaInvoke, primero debe configurar la función de Lambda que se utilizará en la regla. Tenga el ARN de la función de Lambda listo para proporcionarlo al configurar la regla.
Para la regla CloudWatchAlarm, primero debe configurar el evento de CloudWatch Events que se utilizará en la regla. Tenga preparado el ARN del evento que desee proporcionar al configurar la regla.

Creación de condiciones de entrada

Puede configurar las condiciones de entrada de una etapa mediante la consola o la CLI. Configurará las reglas y los resultados correspondientes para cada condición. Para obtener un resultado de reversión, la canalización solo puede revertirse a una ejecución anterior si dicha ejecución anterior se inició en la versión actual de la estructura de canalización.

Los pasos proporcionan un ejemplo de condición de entrada que utiliza una regla de supervisión.

Para obtener más información, consulte Condition, RuleTypeId y RuleExecution en la Guía de la API de CodePipeline.

Creación de condiciones de entrada: ejemplo de regla de CloudWatchAlarm (consola)

Puede configurar las condiciones de entrada para una etapa, junto con las reglas y los resultados que desee que realice la etapa cuando se cumplan las condiciones.

Configuración de una condición de entrada (consola)

Complete todos los requisitos previos, como crear el recurso y el ARN para una regla en la que se proporcione un recurso, como la regla AWS CloudWatchAlarm.
Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la acción que desee editar, elija Editar etapa.
Seleccione Agregar condición de entrada. Aparecerá la tarjeta de Condición previa a la entrada a la fase con la opción de Error disponible para esta condición.
Elija Agregar regla y, a continuación, complete lo siguiente.
1. En Nombre de la regla, introduzca un nombre para la regla. En este ejemplo, escriba MyAlarmRule.
2. En Proveedor de reglas, elija el proveedor de reglas preconfigurado para agregarlo a la condición. Para este ejemplo, elija AWS CloudWatchAlarm y, a continuación, complete los pasos siguientes.
3. En Región, elija la región para su condición o deje la que aparece por defecto.
4. En Nombre de alarma, elija el recurso de CloudWatch que se va a usar para la regla. Debe haber creado previamente el recurso en su cuenta.
5. (Opcional) En Tiempo de espera, introduzca la cantidad de tiempo que CodePipeline esperará si la alarma está en estado ALARM cuando se evalúe por primera vez. Si la alarma está en estado Correcto cuando se comprueba la regla por primera vez, la regla se ejecutará correctamente de inmediato.
6. (Opcional) Introduzca los estados de alarma específicos que desee supervisar y el ARN del rol, si procede.
7. Cuando haya terminado de editar la etapa, elija Listo. En la página de edición de la canalización, elija Guardar.
Tras la ejecución, consulte el resultado.

Creación de condiciones de entrada con el resultado Omitir y la regla `VariableCheck` (consola)

Puede configurar las condiciones de entrada para una etapa de modo que, si no se cumple la condición de entrada, se omita la etapa. Si la condición falla, el resultado se activa y se omite la etapa. Cuando se omite una etapa, el estado de la etapa es Omitido y el estado de la acción es No se ejecutó. Para obtener información con respecto a las condiciones de etapa con los resultados Omitir, consulte Consideraciones sobre la configuración de los resultados para las condiciones de etapa.

En el siguiente ejemplo, la regla de verificación de variables determina que el valor no coincide, por lo que se omite la etapa de compilación.

Configure una condición de entrada con un resultado Omitir (consola)

Complete todos los requisitos previos, como crear el recurso y el ARN para una regla en la que se proporcione un recurso, como la regla AWS CloudWatchAlarm.
Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la acción que desee editar, elija Editar etapa.
Seleccione Agregar condición de entrada y, a continuación, seleccione Omitir como el resultado.
Elija Agregar regla y, a continuación, complete lo siguiente.
1. En Nombre de la regla, introduzca un nombre para la regla. En este ejemplo, escriba MyAlarmRule.
2. En Proveedor de reglas, elija el proveedor de reglas preconfigurado para agregarlo a la condición. Para este ejemplo, elija VariableCheck y, a continuación, complete los pasos siguientes.
3. En Región, elija la región para su condición o deje la que aparece por defecto.
4. En Variable, elija la variable con la que desee comparar como, por ejemplo, #{SourceVariables.FullRepositoryName} en el caso de una canalización que tenga una acción de origen de la versión 2 de GitHub. Introduzca el nombre del repositorio y elija el operador, como Igual a.
5. Cuando haya terminado de editar la etapa, elija Listo. En la página de edición de la canalización, elija Guardar.
Tras la ejecución, consulte el resultado.
Para revisar los detalles, seleccione Revisar. El detalle del siguiente ejemplo muestra que el resultado configurado para la condición es Omitir, que no se puede anular. El estado de la regla es Fallido porque no se cumple la condición.

Creación de condiciones de entrada (la CLI)

Para utilizar la AWS CLI a fin de configurar una condición de entrada, utilice los comandos para crear o actualizar una canalización, tal y como se detalla en Creación de una canalización, etapas y acciones y Editar una canalización en CodePipeline.

Configuración de la condición y la regla o reglas (la CLI)

Abra un terminal (Linux, macOS o Unix) o el símbolo del sistema (Windows) y utilice la AWS CLI para ejecutar el comando update-pipeline, especificando la condición de fallo en la estructura de canalización. El siguiente ejemplo configura una condición de entrada para una etapa denominada Deploy:


{
    "name": "Deploy",
    "actions": [
        {
            "name": "Deploy",
            "actionTypeId": {
                "category": "Deploy",
                "owner": "AWS",
                "provider": "S3",
                "version": "1"
            },
            "runOrder": 1,
            "configuration": {
                "BucketName": "MyBucket",
                "Extract": "false",
                "ObjectKey": "object.xml"
            },
            "outputArtifacts": [],
            "inputArtifacts": [
                {
                    "name": "SourceArtifact"
                }
            ],
            "region": "us-east-1",
            "namespace": "DeployVariables"
        }
    ],
    "beforeEntry": {
        "conditions": [
            {
                "result": "FAIL",
                "rules": [
                    {
                        "name": "MyAlarmRule",
                        "ruleTypeId": {
                            "category": "Rule",
                            "owner": "AWS",
                            "provider": "CloudWatchAlarm",
                            "version": "1"
                        },
                        "configuration": {
                            "AlarmName": "CWAlarm",
                            "WaitTime": "1"
                        },
                        "inputArtifacts": [],
                        "region": "us-east-1"
                    }
                ]
            }
        ]
    }
}

Para obtener más información sobre la configuración de las condiciones de éxito para la reversión de etapas, consulte SuccessConditions en la Referencia de la API de CodePipeline.

Creación de condiciones de entrada (CFN)

Para usar AWS CloudFormation a fin de configurar una condición de entrada, utilice el parámetro beforeEntry. En la entrada, la etapa ejecutará la regla y realizará el resultado.


beforeEntry:
     Result: FAIL

Actualice la plantilla como se muestra en el fragmento de código siguiente. En el siguiente ejemplo se configura una condición de entrada con una regla denominada MyMonitorRule:


Name: Deploy
Actions:
- Name: Deploy
  ActionTypeId:
    Category: Deploy
    Owner: AWS
    Provider: S3
    Version: '1'
  RunOrder: 1
  Configuration:
    BucketName: MyBucket
    Extract: 'false'
    ObjectKey: object.xml
  OutputArtifacts: []
  InputArtifacts:
  - Name: SourceArtifact
  Region: us-east-1
  Namespace: DeployVariables
BeforeEntry:
  Conditions:
  - Result: FAIL
    Rules:
    - Name: MyMonitorRule
      RuleTypeId:
        Category: Rule
        Owner: AWS
        Provider: CloudWatchAlarm
        Version: '1'
      Configuration:
        AlarmName: CWAlarm
        WaitTime: '1'
      InputArtifacts: []
      Region: us-east-1

Para obtener más información sobre la configuración de las condiciones de beforeEntry, consulte AWS::CodePipeline::Pipeline BeforeEntryConditions en StageDeclaration en la Guía del usuario de AWS CloudFormation.

Creación de condiciones de fallo

Puede configurar las condiciones de fallo para una etapa mediante la consola o la CLI. Configurará las reglas y los resultados correspondientes para cada condición. Para obtener un resultado de reversión, la canalización solo puede revertirse a una ejecución anterior si dicha ejecución anterior se inició en la versión actual de la estructura de canalización.

Creación de condiciones de fallo (consola)

Puede configurar las condiciones de fallo para una etapa, junto con las reglas y los resultados que desee que realice la etapa cuando se cumplan las condiciones.

Configuración de una condición de fallo (consola)

Complete todos los requisitos previos, como crear el recurso y el ARN para una regla en la que se proporcione un recurso, como la regla LambdaInvoke.
Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la acción que desee editar, elija Editar etapa.
Seleccione Agregar condición de fallo. Aparecerá la tarjeta de Condición de fallo con la opción de Reversión disponible para esta condición.
Elija Agregar regla y, a continuación, complete lo siguiente.
1. En Nombre de la regla, introduzca un nombre para la regla. En este ejemplo, escriba MyLambdaRule.
2. En Proveedor de reglas, elija el proveedor de reglas preconfigurado para agregarlo a la condición. Para este ejemplo, elija AWS LambdaInvoke y, a continuación, complete los pasos siguientes.
3. En Región, elija la región para su condición o deje la que aparece por defecto.
4. En Artefactos de entrada, seleccione el artefacto de origen.
5. En Nombre de la función, elija el recurso de Lambda que se va a usar para la regla. Debe haber creado previamente el recurso en su cuenta.
6. (Opcional) En Parámetros del usuario, introduzca cualquier par que represente parámetros para una configuración adicional.
7. (Opcional) En el ARN del rol, introduzca el ARN del rol si está configurado.
8. (Opcional) En Tiempo de espera en minutos, introduzca el tiempo en minutos que la regla debe esperar antes de que se agote el tiempo de espera.
9. Cuando haya terminado de editar la etapa, elija Listo. En la página de edición de la canalización, elija Guardar.

Creación de condiciones onFailure con ejemplo de resultado de reintento (consola)

Puede configurar las condiciones onFailure para una etapa de modo que, si no se cumple la condición de entrada, se reintente la etapa. Como parte de este resultado, se configura el modo de reintento, especificando si se deben reintentar las acciones fallidas o si se debe reintentar la etapa fallida.

Configuración de una condición onFailure con un resultado de reintento (consola)

Complete todos los requisitos previos, como crear el recurso y el ARN para una regla en la que se proporcione un recurso, como la regla AWS CloudWatchAlarm.
Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la acción que desee editar, elija Editar etapa.
En la parte inferior de la etapa, en Configuración automatizada de escenarios, seleccione Habilitar el reintento automático en caso de fallo de una etapa. En el Modo de reintento, seleccione Reintentar etapa fallida o Reintentar acciones fallidas.
Elija agregar una condición onFailure y, a continuación, elija Agregar regla e introduzca una regla para la condición.
1. En Nombre de la regla, introduzca un nombre para la regla. En este ejemplo, escriba MyAlarmRule.
2. En Proveedor de reglas, elija el proveedor de reglas preconfigurado para agregarlo a la condición. Para este ejemplo, elija CloudWatchAlarm y, a continuación, complete los pasos siguientes.
3. En Región, elija la región para su condición o deje la que aparece por defecto.
4. En Nombre de alarma, elija el recurso configurado para la alerta.
5. Cuando haya terminado de editar la etapa, elija Listo. En la página de edición de la canalización, elija Guardar.
Tras la ejecución, consulte el resultado.

Creación de condiciones de fallo (CLI)

Para utilizar la AWS CLI a fin de configurar una condición de fallo, utilice los comandos para crear o actualizar una canalización, tal y como se detalla en Creación de una canalización, etapas y acciones y Editar una canalización en CodePipeline.

Configuración de la condición y la regla o reglas (la CLI)


{
    "name": "Deploy",
    "actions": [
        {
            "name": "Deploy",
            "actionTypeId": {
                "category": "Deploy",
                "owner": "AWS",
                "provider": "S3",
                "version": "1"
            },
            "runOrder": 1,
            "configuration": {
                "BucketName": "MyBucket",
                "Extract": "false",
                "ObjectKey": "object.xml"
            },
            "outputArtifacts": [],
            "inputArtifacts": [
                {
                    "name": "SourceArtifact"
                }
            ],
            "region": "us-east-1",
            "namespace": "DeployVariables"
        }
    ],
    "onFailure": {
        "conditions": [
            {
                "result": "ROLLBACK",
                "rules": [
                    {
                        "name": "MyLambdaRule",
                        "ruleTypeId": {
                            "category": "Rule",
                            "owner": "AWS",
                            "provider": "LambdaInvoke",
                            "version": "1"
                        },
                        "configuration": {
                            "FunctionName": "my-function"
                        },
                        "inputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "region": "us-east-1"
                    }
                ]
            }
        ]
    }
}

Para obtener más información sobre la configuración de las condiciones de fallo, consulte FailureConditions en la Referencia de la API de CodePipeline.

Creación de condiciones de fallo (CFN)

Para usar AWS CloudFormation a fin de configurar una condición de fallo, utilice el parámetro OnFailure. En caso de éxito, la etapa ejecutará la regla y realizará el resultado.


OnFailure:
     Result: ROLLBACK

Actualice la plantilla como se muestra en el fragmento de código siguiente. En el siguiente ejemplo se configura una condición de fallo con una regla denominada MyMonitorRule:


name: Deploy
actions:
- name: Deploy
  actionTypeId:
    category: Deploy
    owner: AWS
    provider: S3
    version: '1'
  runOrder: 1
  configuration:
    BucketName: MyBucket
    Extract: 'false'
    ObjectKey: object.xml
  outputArtifacts: []
  inputArtifacts:
  - name: SourceArtifact
  region: us-east-1
  namespace: DeployVariables
onFailure:
  conditions:
  - result: ROLLBACK
    rules:
    - name: MyMonitorRule
      ruleTypeId:
        category: Rule
        owner: AWS
        provider: CloudWatchAlarm
        version: '1'
      configuration:
        AlarmName: AlarmOnHelloWorldInvocation
        AlarmStates: ALARM
        WaitTime: '1'
      inputArtifacts: []
      region: us-east-1

Para obtener más información sobre la configuración de las condiciones de fallo, consulte OnFailure en StageDeclaration de la Guía del usuario de AWS CloudFormation.

Creación de condiciones de éxito

Puede configurar las condiciones de éxito para una etapa mediante la consola o la CLI. Configurará las reglas y los resultados correspondientes para cada condición. Para obtener un resultado de reversión, la canalización solo puede revertirse a una ejecución anterior si dicha ejecución anterior se inició en la versión actual de la estructura de canalización.

Los pasos proporcionan un ejemplo de condición de éxito que utiliza una regla de ventana de implementación.

Para obtener más información, consulte Condition, RuleTypeId y RuleExecution en la Guía de la API de CodePipeline.

Creación de condiciones de éxito (consola)

Puede configurar las condiciones de éxito para una etapa, junto con las reglas y los resultados que desee que realice la etapa cuando se cumplan las condiciones.

Configuración de una condición de éxito (consola)

Complete todos los requisitos previos, como crear el recurso y el ARN para una regla en la que se proporcione un recurso, como la regla de AWS Lambda.
Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la acción que desee editar, elija Editar etapa.
Seleccione Agregar condición de éxito. Aparecerá la tarjeta Condición de éxito en la fase. Seleccione la opción Reversión o Fallar que se muestra entre los resultados disponibles para este tipo de condición.
Elija Agregar regla y, a continuación, complete lo siguiente.
1. En Nombre de la regla, introduzca un nombre para la regla. En este ejemplo, escriba MyDeploymentRule.
2. En Proveedor de reglas, elija la regla preconfigurada para agregarla a la condición. Para este ejemplo, elija AWS DeploymentWindow y, a continuación, complete los pasos siguientes.
3. En Región, elija la región para su condición o deje la que aparece por defecto.
4. En Cron, introduzca la expresión cron para la ventana de implementación. La expresión cron define los días y las horas en los que se debe permitir la implementación. Para obtener información de referencia sobre las expresiones cron, consulte Uso de expresiones cron y expresiones de frecuencia para programar reglas.
5. (Opcional) En Zona horaria, introduzca la zona horaria de la ventana de implementación.
Tras la ejecución, consulte el resultado.

Creación de condiciones de éxito (CLI)

Para utilizar la AWS CLI a fin de configurar una condición de éxito, utilice los comandos para crear o actualizar una canalización, tal y como se detalla en Creación de una canalización, etapas y acciones y Editar una canalización en CodePipeline.

Configuración de la condición y la regla o reglas (la CLI)

Abra un terminal (Linux, macOS o Unix) o el símbolo del sistema (Windows) y utilice la AWS CLI para ejecutar el comando update-pipeline, especificando la condición de fallo en la estructura de canalización. En el siguiente ejemplo, se configura una condición de éxito para una etapa llamada Deploy, donde la regla se llama MyDeploymentRule:


{
    "name": "Deploy",
    "actions": [
        {
            "name": "Deploy",
            "actionTypeId": {
                "category": "Deploy",
                "owner": "AWS",
                "provider": "S3",
                "version": "1"
            },
            "runOrder": 1,
            "configuration": {
                "BucketName": "MyBucket",
                "Extract": "false",
                "ObjectKey": "object.xml"
            },
            "outputArtifacts": [],
            "inputArtifacts": [
                {
                    "name": "SourceArtifact"
                }
            ],
            "region": "us-east-1",
            "namespace": "DeployVariables"
        }
    ],
    "onSuccess": {
       "conditions": [
            {
                "result": "FAIL",
                "rules": [
                    {
                        "name": "MyAlarmRule",
                        "ruleTypeId": {
                            "category": "Rule",
                            "owner": "AWS",
                            "provider": "CloudWatchAlarm",
                            "version": "1"
                        },
                        "configuration": {
                            "AlarmName": "CWAlarm",
                            "WaitTime": "1"
                        },
                        "inputArtifacts": [],
                        "region": "us-east-1"
                    }
                ]
            }
        ]
    }
}

Para obtener más información sobre cómo configurar condiciones de éxito, consulte SuccessConditions en la Referencia de la API de CodePipeline.

Creación de una condición de éxito (CFN)

Para usar AWS CloudFormation a fin de configurar una condición de éxito, utilice el parámetro OnSuccess. En caso de éxito, la etapa ejecutará la regla y realizará el resultado.


OnSuccess:
     Result: ROLLBACK

Actualice la plantilla como se muestra en el fragmento de código siguiente. En el siguiente ejemplo se configura una condición de éxito con una regla denominada MyDeploymentWindowRule:


name: Deploy
actions:
- name: Deploy
  actionTypeId:
    category: Deploy
    owner: AWS
    provider: S3
    version: '1'
  runOrder: 1
  configuration:
    BucketName: MyBucket
    Extract: 'false'
    ObjectKey: object.xml
  outputArtifacts: []
  inputArtifacts:
  - name: SourceArtifact
  region: us-east-1
  namespace: DeployVariables
onSuccess:
   conditions:
  - result: FAIL
    rules:
    - name: MyMonitorRule
      ruleTypeId:
        category: Rule
        owner: AWS
        provider: CloudWatchAlarm
        version: '1'
      configuration:
        AlarmName: CWAlarm
        WaitTime: '1'
      inputArtifacts: []
      region: us-east-1

Para obtener más información sobre la configuración de las condiciones de fallo para la reversión de etapas, consulte OnFailure en StageDeclaration de la Guía del usuario de AWS CloudFormation.

Eliminación de condiciones de etapa

Puede eliminar las condiciones de etapa que se hayan configurado para la canalización.

Para eliminar una condición de etapa

Inicie sesión en la AWS Management Console y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

Se muestran los nombres y estados de todas las canalizaciones asociadas con su Cuenta de AWS.
En Nombre, elija el nombre de la canalización que desea editar.
En la página de detalles de la canalización, elija Edit.
En la página Editar, para la condición que desee editar, elija Editar etapa.
Junto a la condición que desee eliminar, elija Eliminar condición.

Anulación de condiciones de etapa

Puede anular las condiciones de etapa que se hayan configurado para la canalización. En la consola, cuando la etapa y la regla estén en ejecución, puede optar por anular la condición de la etapa. Esto da como resultado que la etapa se ejecute

Para anular una condición de etapa

En este ejemplo, la etapa de canalización se ejecuta con una condición. El botón Anular está habilitado.
Junto a la condición que desee anular, seleccione Anular.
Para revisar los detalles, seleccione Revisar. El detalle del siguiente ejemplo muestra que el resultado configurado para la condición es Fallar, que no se ha anulado. El estado de la regla es Abandonado debido a la anulación.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Visualización de los detalles del estado de reversión

Uso de tipos de acciones, acciones personalizadas y acciones de aprobación

Configuración de las condiciones de una etapa

Temas

Casos de uso de condiciones de etapa

Consideraciones sobre la configuración de los resultados para las condiciones de etapa

Consideraciones sobre las reglas configuradas para las condiciones de etapa

Creación de condiciones de entrada

Creación de condiciones de entrada: ejemplo de regla de CloudWatchAlarm (consola)

Configuración de una condición de entrada (consola)

Creación de condiciones de entrada con el resultado Omitir y la regla VariableCheck (consola)

Configure una condición de entrada con un resultado Omitir (consola)

Creación de condiciones de entrada (la CLI)

Configuración de la condición y la regla o reglas (la CLI)

Creación de condiciones de entrada (CFN)

Creación de condiciones de fallo

Creación de condiciones de fallo (consola)

Configuración de una condición de fallo (consola)

Creación de condiciones onFailure con ejemplo de resultado de reintento (consola)

Configuración de una condición onFailure con un resultado de reintento (consola)

Creación de condiciones de fallo (CLI)

Configuración de la condición y la regla o reglas (la CLI)

Creación de condiciones de fallo (CFN)

Creación de condiciones de éxito

Creación de condiciones de éxito (consola)

Configuración de una condición de éxito (consola)

Creación de condiciones de éxito (CLI)

Configuración de la condición y la regla o reglas (la CLI)

Creación de una condición de éxito (CFN)

Eliminación de condiciones de etapa

Para eliminar una condición de etapa

Anulación de condiciones de etapa

Para anular una condición de etapa

Creación de condiciones de entrada con el resultado Omitir y la regla `VariableCheck` (consola)