Es posible hacer que la salida de una tarea en la canalización determine si la canalización se ejecuta o se detiene en función de una condición que se proporciona. Para que la canalización se realice correctamente o con errores según la salida de la tarea, utilice el tipo de tarea Condición.

La tarea Condición se utiliza como punto de decisión en la canalización. Al usar la tarea Condición con una expresión de condición proporcionada, es posible evaluar cualquier propiedad de la canalización, las etapas y las tareas.

El resultado de la tarea Condición determina si se ejecuta la siguiente tarea en la canalización.

  • Una condición verdadera permite que se siga ejecutando la canalización.
  • Una condición falsa detiene la canalización.

Si desea obtener ejemplos sobre la forma de enlazar tareas con una tarea Condición para usar el valor de salida de una tarea como la entrada de la siguiente tarea, consulte Cómo utilizar las variables de enlace en canalizaciones de Code Stream.

Tabla 1. Formas en que la tarea Condición y su expresión de condición se relacionan con la canalización
Tarea Condición Lo que afecta Qué función tiene

Tarea Condición

Canalización

La tarea Condición determina si la canalización se ejecuta o se detiene en ese punto, en función de si la salida de la tarea es verdadera o falsa.

Expresión de condición

Salida de la tarea de condición

Cuando se ejecuta la canalización, la expresión de condición que se incluye en la tarea Condición genera un estado de salida verdadera o falsa. Por ejemplo, una expresión de condición puede requerir que el estado de salida de la tarea Condición sea Completado o que use el número de compilación 74.

La expresión de condición aparece en la pestaña Tarea de la tarea Condición.

Las construcciones admitidas para la expresión condicional aparecen y proporcionan ejemplos de variables de canalización, variables de salida de tareas, valores y operadores.

La tarea Condición difiere en función y comportamiento de la opción Con condición de otros tipos de tareas.

La opción Con condición está disponible en otros tipos de tareas.

En otros tipos de tareas, la opción Con condición determina si se ejecuta la tarea actual, en lugar de las tareas sucesivas, en función de la evaluación de su expresión de condición previa verdadera o falsa. La expresión de condición de la opción Con condición produce un estado de salida verdadera o falsa para la tarea actual cuando se ejecuta la canalización. La opción Con condición aparece en la pestaña Tarea con su propia expresión de condición.

En este ejemplo, se utiliza la tarea Condición.

Requisitos previos

  • Compruebe que exista una canalización y que esta incluya copias intermedias y tareas.

Procedimiento

  1. En la canalización, determine el punto de decisión en el que debe aparecer la tarea Condición.
  2. Agregue la tarea Condición antes de la tarea que depende de su estado correcto o con errores.
  3. Agregue una expresión de condición a la tarea Condición.
    Por ejemplo: "${Stage1.task1.output.status}" == "COMPLETED" || ${input.buildNumber} == 74
    Agregue una tarea Condición con una expresión de condición que se evalúe como verdadera o falsa cuando se ejecuta la canalización.
  4. Valide la tarea.
  5. Guarde la canalización y, a continuación, habilítela y ejecútela.

Resultados

Observe las ejecuciones de canalizaciones y vea si la canalización se sigue ejecutando o se detiene en la tarea Condición.

Qué hacer a continuación

Si revierte una implementación de canalización, también puede utilizar la tarea Condición. Por ejemplo, en una canalización de reversión, la tarea Condición ayuda a Code Stream a marcar un error de canalización en función de la expresión de condición y puede activar un único flujo de reversión para varios tipos de errores.

Para revertir una implementación, consulte Cómo revertir una implementación en Code Stream.