Referencia de variables de desencadenantes

El sistema tiene en cuenta los siguientes nombres de variables. Cuando un entorno de paso contiene uno de ellas, específicamente o heredados de un proyecto o servidor, se realizarán las acciones.

Variable

Contenidos

_CI_BUILD_DELETE

Defina esta variable con cualquier valor para suprimir la compilación y los datos asociados ésta después de que se ejecute un trabajo. (La variable de código se restablece con su valor inicial, antes de suprimir la compilación, si no se ejecutan otras compilaciones del proyecto).

_CI_BUILD_KEEP

Defina esta variable con cualquier valor para mantener la compilación y los datos asociados a la compilación después de ejecutar el trabajo. Por ejemplo, si su trabajo incluye un enlace de adaptador y el paso del adaptador resulta anómalo, los otros pasos del proyecto no se ejecutan. Es posible que desee guardar una copia de los registros de la compilación referentes al trabajo para hacer una depuración, por ejemplo.

CLEARCASE_VIEW

Inicia la vista de ClearCase especificada. La vista especificada en esta variable debe existir, y el paso que la utiliza se debe establecer en "absoluto". En sistemas que ejecuten Microsoft Windows, esta variable se debe utilizar con la opción de configuración cc_suppress_server_root para el agente en bfagent.conf.

_CLEARCASE_VIEWS

Especifica una lista de vistas de ClearCase que se deben iniciar antes de ejecutar un mandato. Defina el valor con una lista separada por comas de vistas, por ejemplo, "Vista1,Vista2,Vista3".

_CLEARCASE_VOBS

Especifica un lista de VOB de ClearCase que se deben montar antes de ejecutar un mandato. Defina el valor con una lista separada por comas de VOB, por ejemplo, "Vob1,Vob2,Vob3".

_CONTEXT_LOG_RANGE

Utilice esta variable para limitar la salida de registro a las líneas que se aproximen a las coincidencias de filtro. Esta variable adquiere un valor entero positivo y hace que el sistema omita las salidas de registro excepto en el caso de un intervalo de líneas alrededor de cada coincidencia de serie para el filtro cuyo tamaño sea igual al valor de la variable. Por ejemplo, si establece la variable en 5, los registros mostrarán sólo las líneas que coincidan con el filtro, además de las 5 líneas anteriores y posteriores a las mismas.

Nota: Esta variable se utiliza solo para los proyectos del motor Perl.

_ERROR_THRESHOLD

Establece el número máximo de errores permitidos (detectados por los filtros Establecer anomalía que ha definido). Utilizando esta variable puede establecer umbrales de anomalías y mensajes para pasos individuales o para un proyecto.

Utilice una de estas formas:

  • El valor 5 o F5 indica que el trabajo debe fallar si se producen más de 5 errores.
  • El valor N7 indica que el sistema debe añadir un mensaje a las notas del trabajo cuando se produzcan más de 7 errores. El mensaje indica que se ha alcanzado este umbral.

Cuando utiliza la variable en un paso, el sistema cuenta los errores en el paso individual. Hay otras formas disponibles:

  • Un valor de W9 indica que después de 9 errores, el paso se deberá colocar en estado de aviso, independientemente de los futuros errores detectados por los filtros.
  • Un valor de C8 indica que después de 8 errores, el paso será establecido en estado de anomalía, pero cualquier filtro Borrado de anomalía puede borrar dicha anomalía.

NOTA: los errores contados por esta variable se definen como series que coinciden con los filtros con acciones Establecer anomalía y que están asignadas a pasos en el proyecto. Cada serie identificada como anomalía por un filtro cuenta como un error para el total del paso y el total del proyecto.

_EXITCODE_MAP

Especifica una lista de números (separados por comas, espacios, puntos y comas o dos puntos) que el sistema debería aceptar como indicadores de éxito de un paso. De forma predeterminada, un código de salida 0 indica éxito; cuando esta variable se especifica, cualquier valor listado en él también indica éxito.

_InterfaceLoggingLevel

Controla cuántos datos de registro registra Build Forge cuando ejecuta un paso de adaptador. Cree una variable de entorno (en su entorno de adaptador) con el nombre _InterfaceLoggingLevel. Asígnele un valor entero de 0 a 8. Los niveles de registro cronológico están incluidos, por ejemplo, el nivel 2 incluye información de los niveles 1 y 0.
  • 0: Errores en la línea de excepción y en la conexión del servidor o notificación de cancelación; nada más
  • 1: Mandatos analizados (mandatos tal y como se enviarán al servidor)
  • 2: Mandatos no analizados (mandatos antes de tener definidas sus variables locales)
  • 3: Líneas SET de la compilación y la variable de entorno
  • 4: Líneas SET temporales y de la variable interna
  • 5: Evaluaciones del entorno, adición de grupos de correo electrónico, líneas de registro cronológico de texto BOM
  • 6: Líneas de inicio/fin de bloque y subbloque
  • 7: (nivel de registro predeterminado) La salida del agente que será comprobada con los patrones de coincidencia, además de las líneas que han coincidido con los patrones.
  • 8: Salida de todos los agentes

_LOG

Especifica un nombre de vía de acceso para crear un archivo de registro que contenga la salida raw del agente Build Forge.

Nota: Dicho registro no incluye indicaciones de fecha y hora, a menos que también se especifique _LOG_TIMESTAMP. Los datos de registro de este archivo normalmente tiene el formato: código de agente, grupos de registro, y mensaje.

Utilice esta variable para guardar una copia del registro del trabajo en el servidor. Si el archivo ya existe, el sistema lo añade.

_LOG_TIMESTAMP

Coloca un prefijo en cada línea de la salida de _LOG con una indicación de fecha y hora. El valor de esta variable debería una serie de formato en la misma sintaxis de strftime que se utiliza en los mandatos de entorno .date y .gmdate.

Nota: Requiere _LOG.

_MAP

Consulte el apartado Conectar unidades en Windows para saber cómo utilizar esta variable.

_NO_PREPARSE_COMMAND

Normalmente el sistema intenta solucionar los valores de las variables de entorno antes de enviar mandatos a los agentes. Cuando se define la variable _NO_PREPARSE_COMMAND (con cualquier valor), el sistema envía variables a los agentes sin solucionarlas. Utilice esta variable para asegurarse de que el shell de su sistema operativo trata las variables.

_PRISM_DIR_POSTCMD

Se utiliza con plug-ins para IDE. Especifica un mandato que se debe ejecutar en directorios después de ejecutar el paso del proyecto. Consulte Variables especiales para proyectos de pruebas.

_PRISM_DIR_PRECMD

Se utiliza con plug-ins para IDE. Especifica un mandato que se debe ejecutar en directorios antes de copiarlos al servidor para un paso del proyecto. Consulte Variables especiales para proyectos de pruebas.

_PRISM_FILE_POSTCMD

Se utiliza con plug-ins para IDE. Especifica un mandato que se debe ejecutar en archivos después de ejecutar el paso del proyecto. Consulte Variables especiales para proyectos de pruebas.

_PRISM_FILE_PRECMD

Se utiliza con plug-ins para IDE. Especifica un mandato que se debe ejecutar en archivos antes de copiarlos al servidor para un paso del proyecto. Consulte Variables especiales para proyectos de pruebas.

_SUPPRESS_ENV_OUTPUT

Especifica que el sistema omite los mensajes de entorno del registro. De manera predeterminada, esta variable no está establecida y todos los valores de las variables del entorno se imprimen antes de que se ejecute un mandato de paso. Los valores aparecen como entradas ENV en el registro de pasos. La variable se puede establecer en los valores siguientes:
  • SIEMPRE: siempre ignora los mensajes ENV.
  • Cualquier otro valor: ignora los mensajes ENV. Sin embargo, si el mandato falla, los mensajes ENV se imprimen después del mensaje del mandato. Esta información puede ser útil para la depuración del error de ejecución del mandato.

_SUPPRESS_AGENT_LOG_OUTPUT

Cuando se establece en 1, impide que el agente envíe datos de registro al motor. Compare con _SUPPRESS_LOG_OUTPUT, en donde los datos del registro se envían al agente sin que el motor los descarte.

Nota: Mediante el uso de esta variable, se evitan las coincidencias de filtro.

_SUPPRESS_LOG_OUTPUT

Cuando esta variable se establece en un valor, hace que el motor descarte casi toda la salida de registro recibida por parte del agente. Algunos de los mensajes de la consola permanecerán. Se muestran las coincidencias de los filtros.

_TIMEOUT

Es un valor que anula la propiedad Tiempo de espera excedido para uno o todos los pasos de su proyecto.

_TRAP

Una serie que se debe ejecutar si el paso actual es anómalo; la serie puede definirse con el nombre de un archivo o mandato ejecutable. NOTA: la salida del mandato no vuelve a la consola porque la conexión entre la consola y el agente se cierra cuando el paso es anómalo; si quiere retener la salida de un mandato emitido a través de _TRAP, haga que el mandato escriba su salida en un archivo para recuperarla posteriormente.

_USE_BFCREDS

Cuando se establece en 1, el sistema utiliza las credenciales de inicio de sesión del usuario para iniciar sesión en los servidores, en vez de almacenar las credenciales en la autorización del servidor adjuntada al servidor. El sistema utiliza las credenciales de inicio de sesión para la consola de gestión del usuario que inició el proyecto para ejecutar los mandatos en el proyecto. Puede definir esta variable para un solo paso o para todo un proyecto.
Nota: Si está utilizando la autenticación LDAP/Active Directory, el valor del sistema Almacenar autenticación de usuario localmente deberá establecerse en Sí (su valor predeterminado) para que la función _USE_BFCREDS funcione correctamente. Cuando el valor es Sí, el sistema almacena en caché la información de autenticación del usuario de forma encriptada y puede acceder a la información de autenticación del usuario que debe utilizarse con _USE_BFCREDS.
Consejo: En Windows, considere establecer también la variable _USE_BFCREDS_DOMAIN.

_USE_BFCREDS_DOMAIN (sólo Windows)

Cuando se establece en 1, el sistema utiliza el dominio del usuario además de las credenciales de inicio de sesión que _USE_BFCREDS utiliza para iniciar sesión en los servidores.

_XSTREAM_PROTOCOL tipo

Habilita transferencias directas de archivo entre agentes.
Importante: Los agentes en algunos sistemas operativos tienen un soporte limitado, o ningún soporte, para la transferencia directa de archivos. Consulte Configuración de transferencias directas de archivos entre agentes.

El motor, el agente de envío y el agente de recepción deben dar soporte todos ellos a las transferencias directas de archivos. Si no es así, se ignora _XSTREAM_PROTOCOL sin aviso alguno, utilizándose el método normal de transferencia de archivos.

Los agentes de recepción deben ser capaces de crear conexiones TCP en el host del agente de envío. Si existen, es necesario configurar los cortafuegos para que permitan las conexiones.

El protocolo tipo determina el método de codificación de los datos y es uno de los siguientes:

AES-CBC
Se utilizan algoritmos fuertes de criptografía para codificar los datos. Es necesario compilar ambos agentes con OpenSSL y utilizar SSL en la comunicación con el motor. La clave de cifrado se obtiene desde el motor.
PRNG
Se utiliza un generado de números pseudo-aleatorio para ocultar el contenido de los archivos.
PLAIN
Los archivos se transfieren tal cual sin codificar.

Comentarios