El sistema tiene en cuenta los siguientes nombres de variables. Cuando un entorno de paso contiene una de ellas (específicamente o heredades de un proyecto o servidor), las acciones serán ejecutadas.
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. |
_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:
Cuando utiliza la variable en un paso, el sistema cuenta los errores en el paso individual. Hay otras formas disponibles:
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.
|
_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:
|
_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 se establece en 1, 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:
|