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.
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 En línea, si hay.
- En línea
- 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 en línea 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.
- Proveedor de paso
- La implementación de la ejecución del mandato del paso.
El proveedor de paso predeterminado es MJC.
Proporciona un comportamiento heredado como estaba previsto para ejecutar el texto de los mandatos en la máquina del agente de punto final.
- 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 (superado)
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á superado.
- Else en línea
- Mostrado sólo si el Tipo de paso es condicional. Especifica un proyecto para que se ejecute
en línea 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 se supera 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 superado.
- Cadena de éxito
- Especifica un proyecto que iniciar si se supera el paso actual. (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
superado 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.