Rational Build Forge 및 Rational ClearQuest

BuildForge는 빌드 레코드 업데이트를 위해 Rational ClearQuest와 함께 작동할 수 있습니다.

Build Forge에는 두 가지의 ClearQuest와의 통합이 있습니다.

이 기능은 서로 완전히 독립적입니다. 특히, 어댑터는 어댑터에 대해 작성된 환경과 연관됩니다. 해당 환경의 변수는 자동 빌드 레코드를 활성화하기 위해 설정된 변수와 독립적입니다.

빌드 레코드의 자동 생성 설정

시스템은 로그 데이터로의 링크를 사용하여 IBM Rational® ClearQuest® 데이터베이스에 빌드 레코드를 자동으로 작성할 수 있습니다. 뿐만 아니라, 작업 패스 시에 시스템은 ClearQuest 데이터베이스를 업데이트할 수 있으며 작업이 완료되면 종료 시간과 달성된 단계에 대한 요약을 기록합니다. 이 기능에는 Rational ClearQuest 버전 7.0 이상이 필요합니다.

ClearQuest 데이터베이스를 업데이트하도록 프로젝트를 구성하는 경우 시스템은 다음과 같이 작성 또는 업데이트 빌드 레코드를 수행합니다.
작업 시작
시스템은 작업을 실행할 때 ClearQuest 빌드 레코드를 작성합니다. 빌드 레코드는 제출 상태에 있으며 작업 로그 URL, 시작 시간, 릴리스 이름 및 ID와, "빌드 XYZ가 시작되었음"을 표시하는 로그 항목을 포함합니다. 소스 제어 어댑터가 작업을 취소하는 경우(예를 들어, 소스 변경사항이 없어서) ClearQuest 빌드 레코드가 작성되지 않습니다.
참고: 프로젝트에 다른 프로젝트가 체인된 경우, 새 프로젝트는 자체의 고유 ClearQuest 빌드 ID를 가져옵니다.
작업 패스/실패
작업이 패스 또는 실패할 때 시스템은 ClearQuest에서 빌드 상태를 완료 또는 실패로 변경하고 빌드 종료 시간을 설정하며, ClearQuest 빌드 로그에 작업 단계 요약을 저장합니다. 요약에는 각 단계의 이름, 결과 상태 및 서버가 포함됩니다.
작업 다시 시작
작업이 다시 시작될 때 시스템은 ClearQuest에서 빌드 상태를 제출로 변경하고 "빌드 XYZ가 다시 시작되었음"을 표시하는 ClearQuest 빌드 로그 항목을 작성합니다.

특수 환경 변수를 통해 자동 빌드 레코드 업데이트를 구성합니다. ClearQuest 데이터베이스에 프로젝트를 링크하려면 다음 표의 변수가 프로젝트 환경에 포함되어 있는지 확인하십시오.

참고: 이러한 변수가 프로젝트 환경에 있어야 하며, 단계에 변수를 추가하는 것으로는 부족합니다. 그러나 다른 환경을 통해 이러한 변수를 포함하는 포함 유형으로 설정된 변수를 사용할 수 있습니다. 또한 CQ_RELEASE_NAME 값은 유일하게 프로젝트마다 다를 수 있으므로 다른 변수를 포함하는 환경을 작성하고 포함 유형의 변수를 사용하여 프로젝트 환경에 해당 환경을 포함시킬 수 있습니다(이 경우, CQ_RELEASE_NAME을 프로젝트 특정 환경 변수로 지정할 수도 있음).

Build Forge 작업에서 빌드 레코드의 자동 업데이트를 활성화하려면 프로젝트에 대해 다음 환경 변수를 설정해야 합니다. 이 환경 변수는 단계 레벨에서 작동하지 않습니다.

변수

설명

CQ_DBNAME

필수. 업데이트할 ClearQuest 데이터베이스의 이름

CQ_DBSET

ClearQuest 데이터베이스 설정 값. 필수가 아니며 기본값은 공백입니다.

CQ_INTERACTION

ClearQuest 빌드 레코드 작성을 사용하도록 프로젝트 환경에 올바른 환경 변수가 정의되어 있지만 빌드 레코드를 작성하지 않으려면 이 변수를 OFF로 설정하여 빌드 레코드 작성을 사용하지 않도록 하십시오.

빌드 레코드 작성을 사용하려면 이 변수를 ON으로 설정하십시오.

참고: ClearQuest 어댑터 중 하나를 사용 중인 경우, 이 환경 변수를 OFF로 설정하십시오. 어댑터는 빌드 레코드와 직접 상호작용합니다.

CQ_PASSWORD

필수. ClearQuest 데이터베이스에 로그인할 때 사용할 비밀번호. 필수는 아니며, 기본값은 공백으로 설정됩니다.

CQ_RELEASE_NAME

필수. ClearQuest 데이터베이스에서 업데이트할 릴리스의 이름

CQ_USER

필수. ClearQuest 데이터베이스에 로그인할 때 사용할 사용자 이름

ClearQuest 어댑터에 대한 추가 설정 요구사항

ClearQuest 어댑터 템플리트 샘플은 ClearQuest에서 빌드 레코드를 업데이트하고 ClearCase를 스캔하는 방법을 제공합니다. 이는 일반적으로 Build Forge에서 실행되는 빌드의 성공 또는 실패로 링크됩니다. 일반 요구사항은 어댑터 요구사항의 내용을 참조하십시오. 또한 다음 구성을 완료해야 합니다.

다음을 수행하십시오.

  1. ClearCase 서버에 연결할 수 있는 호스트에 Build Forge 에이전트를 설치하십시오.
  2. 에이전트 호스트에 ClearCase 전체 클라이언트를 설치하십시오.
  3. ClearCase 클라이언트를 통해 명령을 실행할 수 있도록 에이전트에 대한 환경을 설정하십시오.
  4. Build Forge 콘솔 호스트에 ClearQuest 전체 클라이언트를 설치하십시오.
  5. cqperl(ClearQuest Perl API)를 시스템 경로에 직접 추가하십시오.
  6. Build Forge 호스트의 ClearQuest 클라이언트가 ClearQuest 데이터베이스에 액세스하는 데 사용할 수 있는 연결을 정의하십시오. ClearQuest 클라이언트 호스트에서 해당 조치를 수행하십시오.
    1. cqreg 명령을 사용하여 데이터베이스 세트(cqreg add_dbset)를 추가하십시오.
    2. CQ 유지보수 도구를 사용하여 ClearQuest 데이터베이스에 대한 연결을 설정하십시오.
  7. 필요한 ClearCase 보기를 시작하는 방법과 시기 및 구현하는 방법을 판별하십시오.
Build Forge, ClearCase 및 ClearQuest
설치의 관계를 표시하는
그림

에이전트를 설치할 필요는 없습니다. ClearQuest 어댑터는 ClearQuest Perl API를 사용하여 클라이언트를 통해 ClearQuest와 직접 통신합니다.

중요사항: ClearQuest 어댑터는 단계에서 점(dot) 명령으로만 호출할 수 있습니다. 소스 어댑터가 아니므로 어댑터 링크를 사용할 수 없습니다.

ClearQuest 어댑터 템플리트 샘플

다음 어댑터 템플리트 샘플이 제공됩니다.

ClearQuestBaseClearCaseByDate
  1. ClearCase 보기에서 두 날짜 간의 변경사항을 조회합니다. 기본 날짜는 현재 시간소인 및 이전 어댑터 실행의 시간소인입니다.
  2. 변경된 각 파일에 대해 ClearQuest 변경 ID를 식별하는 CrmRequest 하이퍼링크 속성을 검색합니다. ClearQuest 상태가 결함 레코드 분석을 허용하는 경우 ClearQuest에서 결함 레코드를 분석하기 위해 작업 정보를 추가하여 변경 ID 분석을 시도합니다.
  3. 변경된 각 파일에 대해 BOM 보고서에 파일 이름, 결함 ID, 결함 상태 및 ClearQuest 오류 정보를 기록합니다.

어댑터 템플리트에 정의된 변수:

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestClearCaseByActivity
  1. ClearCase 활동 목록과 연관된 ClearQuest 결함 레코드를 찾습니다.
  2. 발견된 각 결함 레코드에 대해 ClearQuest 상태가 결함 레코드 분석을 허용하는 경우 ClearQuest에서 결함 레코드를 분석하기 위해 작업 정보를 추가합니다.
  3. BOM 보고서에 ClearCase 활동 ID와 연관된 파일 및 ClearQuest 결함 상태 정보를 기록합니다.

어댑터 템플리트에 정의된 변수:

  • CurDate
  • VIEW
  • VOB_PATH
  • ACTIVITIES
  • CQ_USER
  • CQ_PASSWORD
  • PROJECT_VOB
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestUCMClearCaseByDate
  1. ClearCase 보기에서 두 날짜 간의 변경사항을 조회합니다. 기본 날짜는 현재 시간소인 및 이전 어댑터 실행의 시간소인입니다. Rational 통합 변경 관리(UCM)를 사용하여 결과를 채웁니다.
  2. 변경된 각 파일에 대해 BOM 보고서에 파일 이름, 결함 ID, 결함 상태 및 ClearQuest 오류 정보를 기록합니다.

어댑터 템플리트에 정의된 변수:

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE

ClearQuest 어댑터 변수

이 표는 어댑터 템플리트에 대한 변수 목록의 참조입니다.

표 1. Rational ClearQuest 통합에 필요한 환경 변수

변수

설명

ACTIVITIES ClearQuestClearCaseByActivity 어댑터의 경우, 공백으로 구분된 활동 ID 세트입니다. (예: SAMPL0001@\ProjectVob)
BFSERVER 이 변수를 Build Forge 콘솔에 대한 호스트의 이름으로 설정하십시오.

CQ_PASSWORD

필수. ClearQuest 데이터베이스에 로그인할 때 사용할 비밀번호. 필수는 아니며, 기본값은 공백으로 설정됩니다.

CQ_USER

필수. ClearQuest 데이터베이스에 로그인할 때 사용할 사용자 이름

CurDate 어댑터에 현재 날짜를 제공합니다. .date 명령을 사용하여 날짜를 생성합니다. 이 값을 변경하지 마십시오.
LAST_RUN ByDate 어댑터의 경우, 시스템은 이 값을 사용하여 변경사항이 발생했는지 여부를 판별합니다. 값은 마지막 성공적 실행 날짜입니다. 어댑터를 강제 실행하기 위해 어댑터를 테스트할 때 일부 변경사항에 선행하는 날짜를 선택하여 이 값을 조작할 수 있습니다. 실행을 계속하도록 허용하는 경우, 어댑터는 이 값을 현재 날짜로 자동으로 업데이트합니다. 기본값은 1-Jan-05.00:00:00입니다.
UNIXCLIENT 플랫폼 특정 정보를 설정하기 위해 사용됩니다. 클라이언트가 Windows에서 실행 중인 경우 0으로 설정하십시오. 클라이언트가 UNIX 또는 Linux에서 실행 중인 경우 1로 설정하십시오.
VIEW 이 변수를 어댑터와 함께 사용할 ClearCase 보기의 이름으로 설정하십시오.
VOB_PATH 이 값을 컴포넌트 VOB의 이름으로 설정하고 선택적으로 서브디렉토리를 설정하십시오. 이름이 여러 개인 경우 쉼표로 구분되는 목록을 사용하십시오.
_CHAR_NATIVE 내부적으로 사용되며 항상 1로 설정됩니다.

ClearQuest 통합 작업 다시 시작

ClearQuest 통합이 완료되면 일반적으로 Rational Build Forge에서 다시 시작할 수 없습니다. 단순 임시 해결책으로는 새 작업으로 작업을 시작할 수 있습니다.

다시 시작을 사용하려면 ClearQuest 디자이너 도구를 사용하여 ClearQuest 스키마를 편집해야 합니다. 완료에서 제출로 상태 전이를 허용하려면 빌드 레코드의 워크플로우를 수정해야 합니다.


피드백