Acerca de los pasos

Un paso es un componente de un proyecto. Cuando el proyecto se ejecuta como un trabajo, cada paso se ejecuta en orden. Un paso contiene uno o varios mandatos y propiedades de paso que afectan a su comportamiento.

Acerca del panel Pasos

Separador Detalles

Las propiedades del paso especifican cómo ejecutar un paso, manejar su salida y qué hacer cuando el paso finaliza. Un paso puede también ejecutar otro proyecto o biblioteca.

Para ver las propiedades del paso, seleccione un paso dentro de un proyecto. El separador Detalles aparecerá de forma predeterminada. Este contiene las propiedades del paso.

Si una propiedad de un paso no está definida de forma explícita, hereda el valor del proyecto. Las propiedades del paso establecidas para un paso alteran temporalmente los valores heredados.

Imagen de pantalla del separador Detalles del panel Pasos
Las propiedades de un paso incluyen:
Nombre
El nombre del paso. Se utiliza como etiqueta del paso en el sistema y en el registro.
Activo
Especifica si se ejecuta el paso. Un paso está, de forma predeterminada, habilitado. Seleccione Inhabilitado para impedir que se ejecute el paso. Un paso inhabilitado no está disponible para ser ejecutado en un trabajo.
Directorio
Establece la ubicación donde se ejecutan los mandatos. El sistema crea automáticamente un directorio exclusivo para cada trabajo. El campo Directorio ofrece una manera adecuada de ejecutar mandatos en directorios que su proyecto ha construido durante un trabajo. (Build Forge no construye directorios especificados en el campo Directorio.)
Vía de acceso
Especifica si Directorio es una vía de acceso absoluta o relativa.
  • Relativa: los mandatos de paso se ejecutan en una vía de acceso encontrada añadiendo los directorios de servidor, proyecto, trabajo y paso.
  • Absoluta: los mandatos de paso se ejecutan en una vía de acceso entrada añadiendo los directorios de servidor y paso. Esta opción permite seleccionar directorios que no estén en la estructura de directorios del proyecto. Ejemplo: puede utilizarse para iniciar aplicaciones instaladas permanentemente en el servidor.
Tipo de paso
Determina cómo se ejecuta el paso. Esta propiedad afecta al contenido del mandato y el proyecto especificado en Integrado, si hay.
  • Normal: el paso se ejecuta una vez.
  • Condicional: el paso se ejecuta una vez si la expresión en la propiedad Condición es verdadera. Seleccionar Condicional hace que aparezcan las propiedades Condición, Else integrado y Mandato Else. Si la propiedad Condición es falsa, Mandato e Integrado no se ejecutarán. En su ligar, Mandato Else y Else Integrado serán ejecutando si se han especificado.
  • Bucle While: el paso puede ejecutarse varias veces. Será ejecutado hasta que la expresión en la propiedad Condición sea falsa o hasta que se alcance el número máximo de iteraciones. Seleccionar Bucle While hace que aparezcan las propiedades Condición y Máx. iteraciones.

    El selector se evalúa en cada iteración del Bucle While para determinar el servidor que se debe utilizar para la iteración.

Integrado
Especifica un proyecto o biblioteca que ejecutar integrado con el proyecto actual. Los pasos del proyecto o biblioteca se ejecutan utilizando el entorno y las propiedades del proyecto actual. Sin embargo, el sistema utiliza el selector del proyecto integrado como el selector predeterminado para los pasos del integrado. El comportamiento es igual a que si los pasos en el proyecto especificado se copiasen después del paso actual.
Acceso
Seleccione un grupo de acceso para definir qué usuarios pueden utilizar el paso. Puede utilizar esta propiedad para restringir el acceso a pasos específicos dentro de un proyecto. Cuando un usuario no es miembro del grupo de acceso de un paso inicia el proyecto que contiene el paso, el paso será ignorado.

Si selecciona Valor predeterminado de proyecto, el paso hereda las propiedades de acceso del proyecto.

Máx. iteraciones
Sólo se muestra si el Tipo de paso es Bucle While. Especifica el número máximo de iteraciones que pueden ejecutarse un paso en un bucle. El valor predeterminado impuesto por el sistema es de 100. El paso se muestra como completado satisfactoriamente (con éxito) en el registro de pasos. Fallar el paso si se alcanza el máximo, para hacer que el paso falle cuando se alcanza el número máximo de iteraciones.

Cuando se están ejecutando pasos, la variable de sólo lectura BF_ITERATION contiene el número de iteraciones especificadas satisfactoriamente. Si se detiene y reinicia un trabajo, este será reiniciado a la iteración en BF_ITERATION.

Fallar el paso si se alcanza el máximo
Si es Sí, un paso de Bucle While falla si se alcanza el número máximo de iteraciones. Si es No, el paso será con éxito.
Else integrado
Mostrado sólo si el Tipo de paso es condicional. Especifica un proyecto para que se ejecute integrado si la condición especificada es falsa. El valor predeterminado es No.
Mandato

Uno o más mandatos. Los mandatos pueden ser mandatos del sistema operativo, mandatos de punto o una combinación de ambos. Consulte Cómo se ejecutan los pasos.

Condición
Sólo aparece si ha seleccionado un tipo de paso Condicional o Bucle While.
  • Condicional: el mandato se ejecuta si la condición es verdadera.
  • Bucle While: el mandato puede ejecutarse varias veces siempre que la condición sea verdadera. Puede establecer el límite utilizando Máx. iteraciones.

Una condición puede ser una función o un mandato que se ejecute en el recurso de servidor seleccionado.

  • Una función, si se utiliza, debe ser utilizada al comienzo del campo Condición. Es evaluada por el motor de Build Forge. No se envía al recurso de servidor. Para obtener una lista de las funciones e instrucciones sobre cómo utilizarlas, consulte el apartado Funciones de condición.
  • Se ejecuta un mandato en el servidor seleccionado. Cualquier mandato utilizando aquí debe ser válido en el entorno del shell del agente. El código de retorno de la ejecución determina si la condición finaliza con éxito o falla.

Las variables de Build Forge en el proyecto están disponibles para ser utilizadas en una expresión de condición. Consulte el apartado Interpretación de variables en los pasos para obtener información sobre cómo pueden expresarse las variables y cómo son evaluadas.

Mandato Else
Sólo se muestra si ha seleccionado un tipo de paso Condicional. Especifica un mandato que ejecutar si la condición es falsa.
Entorno

Especifica un entorno que aplicar antes de ejecutar los mandatos. Los valores en este entorno alteran temporalmente cualquier valor heredado del entorno de servidor, entorno de proyecto y variables de paso.

Selector
Especifica un selector que utilizar para seleccionar un servidor para este paso. Si se deja como Predeterminado, el mandato se ejecuta en el servidor determinado por el selector del proyecto.
Difusión
Si se selecciona, ejecuta el paso en todos los servidores que coincidan con el selector actual (el selector del paso si se ha especificado o, en caso contrario, el selector del proyecto). Durante el tiempo de ejecución, el sistema sustituye un paso de difusión con una serie de pasos, uno para cada servidor, y los ejecuta en serie o en paralelo, en función de la propiedad del paso de difusión Enhebrar.

Comportamiento de la difusión al reiniciar: cuando se reinicia un paso de difusión, no realiza la difusión. Este valor únicamente se aplica a nuevos inicios de este paso. Al reiniciar, el motor elige un servidor individual de forma aleatoria para el paso.

Tiempo de espera excedido en minutos
Especifica cuántos minutos espera el sistema para que el mandato actual produzca salida (el valor predeterminado es 5 minutos). Un valor de 0 significa que el paso no excede el tiempo de espera si el paso se conecta adecuadamente al agente. Si se alcanza el valor de tiempo de espera excedido, el sistema ejecuta un paso anómalo. El proyecto también fallará a no ser que el paso se establezca en Continuar en error.
Resultado
La propiedad Resultado define cómo juzga el sistema si un paso se ejecuta con éxito o de forma anómala. Utilice el valor predeterminado Código de salida para determinar el éxito a partir de un código de salida devuelto por el shell del mandato. Puede también elegir un filtro de registro que examine la salida del mandato. Para seleccionar un Filtro de registro, deberá primero crearlo.
En caso de anomalía
Especifica si debe detenerse o continuar el trabajo si falla el paso. De forma predeterminada, el sistema detiene el trabajo.
Enhebrar
Si es Sí, ejecuta este paso en paralelo con otros pasos. Defina esta propiedad en Sí para permitir la creación de hebras de este paso (ejecutando el paso paralelamente con otros pasos). Defina la propiedad en No para no permitir la creación de hebras. Defina la propiedad en Unir para separar bloques enhebrados de pasos. El primer conjunto de pasos debe finalizar antes de iniciarse el siguiente conjunto de pasos enhebrados que siguen al paso Unir.
Notificar éxito
Especifica el grupo de acceso que debe ser notificado si el paso es con éxito.
Cadena de éxito
Especifica un proyecto que iniciar si el paso actual finaliza con éxito. (Un paso con el estado "Aviso" se cuenta como pasado e iniciará una cadena de éxito).
Esperar éxito
Si se selecciona, el sistema suspenderá el proyecto actual hasta que el proyecto encadenado con éxito termine. Si este paso (o su proyecto) se cancela, también será cancelado el proyecto encadenado. Si no se selecciona, el proyecto encadenado se inicia de forma asíncrona y el proyecto actual continua al paso siguiente.
Notificar anomalía
Especifica el grupo de acceso al que debe enviarse una notificación si el paso falla.
Cadena de anomalía
Especifica el proyecto que debe iniciarse si el paso actual se ejecuta de forma anómala. (Un paso establecido en Continuar en caso de error se cuenta como erróneo, e iniciará las cadenas de anomalía asignadas a ese paso).
Esperar anomalía
Si está seleccionada, el sistema suspende el proyecto actual hasta que se complete el proyecto encadenado fallido. Si este paso (o su proyecto) se cancela, también será cancelado el proyecto encadenado.

Separador Notas

El separador Notas contiene una lista cronológica de notas sobre el paso. Las notas se crean manualmente. No registra automáticamente las ediciones de registros del paso en sí. El separador muestra el número actual de notas, por ejemplo, Notas (2).

Para añadir una nota:
  1. Pulse el separador Notas.
  2. Escriba la nueva nota en el campo de texto.
  3. Pulse Enviar.
Para editar una nota:
  1. Pulse el separador Notas.
  2. Pulse el icono Editar icono Editar junto a la nota que desea editar. Realice las ediciones.
  3. Pulse Enviar.
Para suprimir una nota:
  1. Pulse el separador Notas.
  2. Pulse el icono Papelera Icono de papelera. Una solicitud preguntará si está seguro de que desea borrar la nota.
  3. Pulse Aceptar.

Comentarios