시스템은 다음 변수 이름을 감시합니다. 단계의 환경에 이런 변수 중 하나가 포함된 경우(명확하게 또는 프로젝트 또는 서버에서 상속됨), 조치가 수행됩니다.
변수 |
컨텐츠 |
---|---|
_CI_BUILD_DELETE |
작업이 실행된 후에 빌드 및 연관된 빌드 데이터를 삭제하려면 이 변수를 임의의 값으로 설정하십시오(실행된 기타 프로젝트 빌드가 없으면 태그 변수는 삭제된 빌드 이전의 초기 값으로 다시 설정됨). |
_CI_BUILD_KEEP |
작업이 실행된 후에 빌드 및 연관된 빌드 데이터를 보존하려면 이 변수를 임의의 값으로 설정하십시오. 예를 들어, 작업에 어댑터 링크가 포함되어 있고 어댑터 단계가 실패하는 경우 기타 프로젝트 단계는 실행되지 않습니다. 예를 들어, 디버깅을 위해 작업에 대한 빌드 레코드 사본을 보존할 수 있습니다. |
CLEARCASE_VIEW |
지정된 ClearCase 보기를 시작합니다. 이 변수에 지정된 보기는 존재해야 하며 이 변수를 사용하는 단계는 "absolute"로 설정되어야 합니다. Microsoft Windows를 실행하는 시스템에서 이 변수는 bfagent.conf의 에이전트에 대한 cc_suppress_server_root 구성 옵션과 함께 사용해야 합니다. |
_CLEARCASE_VIEWS |
명령 실행 전에 시작할 ClearCase 보기 목록을 지정합니다. 값을 쉼표로 분리된 보기 목록으로 설정하십시오(예: "View1,View2,View3"). |
_CLEARCASE_VOBS |
명령 실행 전에 마운트할 ClearCase VOB 목록을 지정합니다. 값을 쉼표로 분리된 VOB 목록으로 설정하십시오(예: "\Vob1,\Vob2,\Vob3"). |
_CONTEXT_LOG_RANGE |
로그 출력을 필터 일치 가까이에 있는 행으로 제한하려면 이 변수를 사용하십시오. 이 변수는 양의 정수 값을 가지며, 시스템이 크기가 변수 값과 같은 각 필터 문자열 히트 근처의 행 범위를 제외하고 로그 출력을 생략하게 합니다. 예를 들어, 변수를 5로 설정한 경우 로그는 필터 일치가 있는 행과 이전 5개의 행 및 해당 일치 다음의 5개 행만 표시합니다. |
_ERROR_THRESHOLD |
허용되는 최대 오류 수(사용자가 정의한 실패 설정 필터로 포착됨)를 설정합니다. 이 변수를 사용하여 개별 단계 또는 프로젝트의 실패 또는 메시지 임계값을 설정할 수 있습니다. 다음 형식 중 하나를 사용하십시오.
단계에서 변수를 사용할 때 시스템은 개별 단계에서 오류를 계수합니다. 다음과 같은 추가 양식을 사용할 수 있습니다.
참고: 이 변수가 계수하는 오류는 필터를 실패 설정 조치와 일치시키고 프로젝트의 단계에 지정된 문자열로 정의됩니다. 필터에 의해 실패로 식별된 각 문자열은 단계 총계에 하나의 오류로 계수되고 프로젝트 총계에 하나의 오류로 계수됩니다. |
_EXITCODE_MAP |
시스템이 단계 성공 표시기로 승인해야 하는 숫자 목록(쉼표, 공백, 세미콜론 또는 콜론으로 분리)을 지정합니다. 기본적으로 종료 코드 0은 성공을 표시합니다. 이 변수가 지정된 경우, 변수에 나열된 모든 값도 성공을 표시합니다. |
_InterfaceLoggingLevel |
Build
Forge가 어댑터 단계를 실행할 때 로깅하는 로그 데이터의 양을 제어합니다. _InterfaceLoggingLevel 이름을 사용하여
어댑터 환경에 환경 변수를 작성하십시오. 0에서 8까지의 정수 값을 지정하십시오. 로깅 레벨은
포괄적입니다. 예를 들어, 레벨 2는 레벨 1과 레벨 0의 정보를 포함합니다.
|
_LOG |
Build Forge 에이전트의 원시 출력을 포함하는 로그 파일을 작성할 경로 이름을 지정합니다. 참고: 이 로그는
_LOG_TIMESTAMP도 지정되지 않는 한, 시간소인을 포함하지 않습니다.
이 파일의 로그 데이터는 일반적으로 에이전트 코드, 로그 버킷 및 메시지와 같이
형식화됩니다.
서버에 작업 로그 사본을 저장하려면 이 변수를 사용하십시오. 파일이 있으면, 시스템은 여기에 추가합니다. |
_LOG_TIMESTAMP |
_LOG의 각 출력 행에 시간소인을 접두부로 추가합니다. 이 변수 값은 .date 및 .gmdate 환경 명령에서 사용한 동일한 strftime 구문의 형식 문자열이어야 합니다. 참고: _LOG가 필요합니다.
|
_MAP |
이 변수 사용 방법에 대한 설명은 Windows 드라이브 맵핑의 내용을 참조하십시오. |
_NO_PREPARSE_COMMAND |
일반적으로 시스템은 에이전트로 명령을 보내기 전에 환경 변수 값을 분석하려고 시도합니다. _NO_PREPARSE_COMMAND 변수가 임의의 값을 사용하여 정의된 경우, 시스템은 변수를 분석하지 않고 에이전트로 보냅니다. 운영 체제 쉘이 변수를 처리하도록 하려면 이 변수를 사용하십시오. |
_PRISM_DIR_POSTCMD |
IDE용 플러그인과 함께 사용됨. 프로젝트 단계가 실행된 후 디렉토리에서 실행할 명령을 지정합니다. 테스트 프로젝트의 특수 변수의 내용을 참조하십시오. |
_PRISM_DIR_PRECMD |
IDE용 플러그인과 함께 사용됨. 프로젝트 단계 중에 서버로 복사되기 전에 디렉토리에서 실행할 명령을 지정합니다. 테스트 프로젝트의 특수 변수의 내용을 참조하십시오. |
_PRISM_FILE_POSTCMD |
IDE용 플러그인과 함께 사용됨. 프로젝트 단계가 실행된 후 파일에서 실행할 명령을 지정합니다. 테스트 프로젝트의 특수 변수의 내용을 참조하십시오. |
_PRISM_FILE_PRECMD |
IDE용 플러그인과 함께 사용됨. 프로젝트 단계 중에 서버로 복사되기 전에 파일에서 실행할 명령을 지정합니다. 테스트 프로젝트의 특수 변수의 내용을 참조하십시오. |
_SUPPRESS_ENV_OUTPUT |
시스템이 로그에서 환경 메시지를 생략하도록 지정합니다. 기본적으로
이 변수는 설정되지 않으며 단계 명령을 실행하기 전에
환경의 모든 변수 값이 인쇄됩니다. 값은 단계 로그에서 ENV 항목으로
나타납니다. 변수는 다음 값으로 설정할 수 있습니다.
|
_SUPPRESS_AGENT_LOG_OUTPUT |
1로 설정하면 에이전트가 로그 데이터를 엔진으로 전송하지 못하게 합니다. _SUPPRESS_LOG_OUTPUT과 비교하십시오. 여기서 로그 데이터는 에이전트에서 전송되지만 엔진에 의해 삭제됩니다. 참고: 이
변수를 사용하면 필터 일치를 사용하지 못합니다.
|
_SUPPRESS_LOG_OUTPUT |
1로 설정하면 엔진이 에이전트에서 수신된 로그 출력을 거의 모두 삭제합니다. 일부 콘솔 로그 메시지는 남아 있습니다. 필터 일치사항이 표시됩니다. |
_TIMEOUT |
프로젝트의 모든 또는 한 단계에 대해 제한시간 특성을 대체하는 값입니다. |
_TRAP |
현재 단계가 실패하면 실행될 문자열입니다. 실행 파일 또는 명령 이름으로 문자열을 설정할 수 있습니다. 참고: 단계가 실패하면 콘솔과 에이전트 간의 연결이 닫히므로 명령의 출력이 콘솔에 리턴되지 않습니다. _TRAP를 통해 실행된 명령의 출력을 보유하려면, 나중 검색을 위해 명령이 파일에 출력을 기록하게 하십시오. |
_USE_BFCREDS |
1로 설정되면, 시스템은 서버에 접속된 서버 권한에 저장된 신임을 사용하지 않고
사용자의 로그인 신임을 사용하여 서버에 로그인합니다. 시스템은 프로젝트에서
명령을 실행하기 위해 프로젝트를 시작한 사용자의 관리 콘솔 로그인
신임 정보를 사용합니다. 단일 단계에 대해 또는 전체 프로젝트에 대해 이 변수를 설정할 수 있습니다.
참고: LDAP/Active Directory 인증을 사용 중인 경우, _USE_BFCREDS 함수가 작동하려면
사용자 인증을 로컬로 저장 시스템 설정을
예(기본값)로 설정해야 합니다. 설정이 예이면 시스템이 사용자 인증
정보를 암호화된 양식으로 캐시한 다음 _USE_BFCREDS로 사용하도록
사용자 인증 정보에 액세스할 수 있습니다.
팁: Windows에서는
_USE_BFCREDS_DOMAIN 변수도 설정할 것을 고려하십시오.
|
_USE_BFCREDS_DOMAIN(Windows만 해당) |
1로 설정되면 시스템은 _USE_BFCREDS가 서버에 로그인하는 데 사용하는 로그인 신임 정보에 추가로 사용자의 도메인을 사용합니다. |
_XSTREAM_PROTOCOL 유형 |
에이전트 간 직접 파일 전송을 사용합니다. 중요사항: 일부 운영 체제의 에이전트의 경우 직접 파일 전송에 대한 지원이 제한되거나 지원되지 않습니다. 에이전트 간 직접 파일 전송 구성의 내용을 참조하십시오.
엔진, 전송 에이전트 및 수신 에이전트는 모두 직접 파일 전송을 지원합니다. 해당사항이 없는 경우, _XSTREAM_PROTOCOL은 경고 없이 무시되며 일반 파일 전송 메소드가 사용됩니다. 수신 에이전트는 전송 에이전트 호스트에서 TCP 연결을 작성할 수 있어야 합니다. 해당 연결이 존재하는 경우 연결을 허용하도록 방화벽을 구성해야 합니다. 프로토콜 유형은 인코딩 데이터의 메소드를 판별하며 다음 중 하나입니다.
|