트리거 변수 참조

시스템은 다음 변수 이름을 감시합니다. 단계의 환경에 이런 변수 중 하나가 포함된 경우(명확하게 또는 프로젝트 또는 서버에서 상속됨), 조치가 수행됩니다.

변수

컨텐츠

_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개 행만 표시합니다.

참고: 이 변수는 Perl 엔진 프로젝트에만 사용됩니다.

_ERROR_THRESHOLD

허용되는 최대 오류 수(사용자가 정의한 실패 설정 필터로 포착됨)를 설정합니다. 이 변수를 사용하여 개별 단계 또는 프로젝트의 실패 또는 메시지 임계값을 설정할 수 있습니다.

다음 형식 중 하나를 사용하십시오.

  • 값 5 또는 F5는 5개를 초과하는 오류가 발생하는 경우 작업이 실패하게 됨을 표시합니다.
  • 값 N7은 7개를 초과하는 오류가 발생하는 경우 시스템에 작업 노트에 메시지를 추가함을 표시합니다. 메시지는 이 임계값이 충족되었음을 표시합니다.

단계에서 변수를 사용할 때 시스템은 개별 단계에서 오류를 계수합니다. 다음과 같은 추가 양식을 사용할 수 있습니다.

  • W9 같은 값은 필터가 포착하는 향후 오류에 관계없이 9개의 오류 후에는 단계가 경고 상태에 놓이게 됨을 표시합니다.
  • C8 같은 값은 8개의 오류 후에 단계가 실패 상태로 설정되지만 실패 지우기 필터가 실패를 지울 수 있음을 표시합니다.

참고: 이 변수가 계수하는 오류는 필터를 실패 설정 조치와 일치시키고 프로젝트의 단계에 지정된 문자열로 정의됩니다. 필터에 의해 실패로 식별된 각 문자열은 단계 총계에 하나의 오류로 계수되고 프로젝트 총계에 하나의 오류로 계수됩니다.

_EXITCODE_MAP

시스템이 단계 성공 표시기로 승인해야 하는 숫자 목록(쉼표, 공백, 세미콜론 또는 콜론으로 분리)을 지정합니다. 기본적으로 종료 코드 0은 성공을 표시합니다. 이 변수가 지정된 경우, 변수에 나열된 모든 값도 성공을 표시합니다.

_InterfaceLoggingLevel

Build Forge가 어댑터 단계를 실행할 때 로깅하는 로그 데이터의 양을 제어합니다. _InterfaceLoggingLevel 이름을 사용하여 어댑터 환경에 환경 변수를 작성하십시오. 0에서 8까지의 정수 값을 지정하십시오. 로깅 레벨은 포괄적입니다. 예를 들어, 레벨 2는 레벨 1과 레벨 0의 정보를 포함합니다.
  • 0: Exec 행 + 서버 연결 오류 또는 취소 알림, 그 밖엔 없음
  • 1: 구문 분석된 명령(서버로 보내질 명령)
  • 2: 구문 분석되지 않은 명령(로컬 변수가 설정되기 전의 명령)
  • 3: 빌드 및 환경 변수 SET 행
  • 4: 임시 및 내부 변수 SET 행
  • 5: 환경 평가, 이메일 그룹 추가, BOM 텍스트 로깅 행
  • 6: 블록 및 하위 블록 시작/끝 행
  • 7: (기본 로깅 레벨) 일치 패턴과 비교하여 확인되는 에이전트 출력 + 패턴과 일치한 행
  • 8: 모든 에이전트 출력

_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 항목으로 나타납니다. 변수는 다음 값으로 설정할 수 있습니다.
  • ALWAYS: 항상 ENV 메시지를 생략합니다.
  • 기타 값: ENV 메시지를 생략합니다. 그러나 이 명령에 실패하면 명령 메시지 다음에 ENV 메시지가 인쇄됩니다. 이 정보는 명령 실행 실패를 디버깅하는 경우에 유용합니다.

_SUPPRESS_AGENT_LOG_OUTPUT

1로 설정하면 에이전트가 로그 데이터를 엔진으로 전송하지 못하게 합니다. _SUPPRESS_LOG_OUTPUT과 비교하십시오. 여기서 로그 데이터는 에이전트에서 전송되지만 엔진에 의해 삭제됩니다.

참고: 이 변수를 사용하면 필터 일치를 사용하지 못합니다.

_SUPPRESS_LOG_OUTPUT

이 변수를 임의 값으로 설정하면 엔진이 에이전트에서 수신된 로그 출력을 거의 모두 삭제합니다. 일부 콘솔 로그 메시지는 남아 있습니다. 필터 일치사항이 표시됩니다.

_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 연결을 작성할 수 있어야 합니다. 해당 연결이 존재하는 경우 연결을 허용하도록 방화벽을 구성해야 합니다.

프로토콜 유형은 인코딩 데이터의 메소드를 판별하며 다음 중 하나입니다.

AES-CBC
암호화적으로 강한 알고리즘은 데이터를 인코드하는 데 사용됩니다. 두 에이전트는 모두 OpenSSL을 사용하여 컴파일되고 엔진과의 통신에서 SSL을 사용해야 합니다. 암호화 키는 엔진에서 얻습니다.
PRNG
의사 난수 생성기는 파일 컨텐츠를 알 수 없게 하기 위해 사용됩니다.
PLAIN
파일은 인코딩하지 않고 현상태대로 전송됩니다.

피드백