IBM® Rational® Asset Manager와 함께
제공되는 Ant 스크립트를 구성하여
IBM Rational Build Forge® 또는
기타 빌드 유틸리티와 같은 빌드 애플리케이션과 통합할 수 있습니다.
시작하기 전에
- Rational Asset Manager 시스템 정보를 참조하려면 스크립트에서
특성을 설정해야 합니다.
- Publish 및 DownloadArtifactLinks 스크립트를 실행하려면 lib 경로에
Ant-Contrib .jar 파일을 설치해야 합니다. .jar 파일을
포함한 압축 파일을 다운로드할 수 있으며 자세한 정보를 보려면
설치 정보를 따르십시오.
참고: 빌드 통합을 위한 Ant 빌드 스크립트를 구성할 때는
JAVA_HOME 변수를 Java™ 폴더로 설정하고
ANT_HOME 변수를 Ant 설치 디렉토리(1.7.0 이상이어야 함)로 설정하십시오. PATH 또는 CLASSPATH를 설정할 필요가 없습니다.
프로시저
- 빌드 프로젝트(예: Rational Build Forge 프로젝트)를 작성하십시오.
Rational Asset Manager에서
도구, 라이브러리 및 종속자 컴포넌트가 모두 자산으로 사용 가능한 경우에는
제공된 Ant 스크립트를 사용하여 이 자산을 기반으로 빌드를 실행할 수 있습니다. 또한 이러한 스크립트를 다른 빌드 유틸리티 및 솔루션과 함께
사용할 수도 있습니다.
- 빌드 프로젝트가 빌드의 자산을 사용하고 빌드 결과를 새 자산으로 공개하려면
Rational Asset Manager에서
제공하는 Ant 스크립트를 사용하십시오. 각 스크립트는 Rational Asset Manager Ant
태스크를 사용합니다. ramclient.zip 파일에는
필수 .jar 파일 세트, Ant 태스크 및 스크립트가 포함되어 있으며 이 파일은 배치된
Rational Asset Manager 서버 인스턴스의
확장기능 페이지에서 사용 가능합니다. 또한 http://<hostname>:<port>/ram/ramclient.zip(예:
http://<localhost>:<9080>/ram/ramclient.zip)에서 직접 액세스할 수도 있습니다.
- ramclient.zip 파일을 사용하려면 폴더에
파일의 압축을 푼 후 Ant .jar 파일을 포함하도록 Ant 라이브러리 매개변수를 설정하십시오. Ant 1.8을 사용 중인 경우에는 Ant 라이브러리 매개변수를
해당 폴더의 ramclient-ant1.8.jar 파일로
설정하십시오. Ant 1.7을 사용 중인 경우에는 Ant 라이브러리 매개변수를
해당 폴더의 ramclient-ant.jar 파일로 설정하십시오.
ramclient.zip 아카이브의 압축을 푼 후에는 압축이 풀린 파일을 이동하지 마십시오.
Ant는 필요에 따라 ramclient-ant1.8.jar 또는 ramclient-ant.jar에서 필요한
기타 .jar 파일을 자동으로 찾습니다.
- 빌드에서 사용할 자산을 참조하려면
ramDownloadAsset.xml 스크립트를 사용하십시오.
ramDownloadAsset.xml 파일은
자산 컨텐츠(예: 아티팩트)를 다운로드하는 샘플 Ant 스크립트입니다.
이 스크립트는 빌드(예: 특수 컴파일러, 공통 컴포넌트 또는
공통 스크립트)를 실행하기 위해 승인된 라이브러리 또는 실행 파일
세트가 필요한 빌드 프로세스에서 사용할 수 있습니다.
DownloadAsset 스크립트에서 다음 특성을 설정해야
합니다.
- lib.dir = 자산을 복사할 디렉토리.
- ram.url = Rational Asset Manager 웹 서비스
애플리케이션의 URL(Rational Asset Manager 웹 클라이언트에서
도움말 아이콘을 클릭하고 확장기능을 클릭한 후에
웹 서비스 섹션을 아래로 스크롤하여 저장소 위치 필드를 찾음).
- ram.user.uid = Rational Asset Manager 서버를 사용할 때 사용하는 UID입니다.
- ram.user.passwd = Rational Asset Manager 서버를 사용할 때 사용하는 비밀번호입니다.
- ram.asset.guid = 자산의 고유 ID(즉, 자산 페이지의 Rational Asset Manager 고유 ID)입니다.
- ram.asset.version = 자산의 버전(즉, 자산 페이지의 Rational Asset Manager 버전)입니다.
- build.id = 빌드 ID는 이 다운로드가 해당되는 빌드를 추적하기 위해 Rational Asset Manager에서 사용합니다.
예를 들어, 다음 값을 다운로드할 사용자의 자산으로 대체하십시오.
<property name="lib.dir" value="C:\libdir" />
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="ram.asset.guid" value="8141FA04-E837-FA50-7052-5269E7C6937C" />
<property name="ram.asset.version" value="1.0" />
다음은 다운로드 내용을 설명하기 위해
Rational Asset Manager에 제출될 선택적 특성입니다.
- build.type = 빌드 유형(예: "RTC 매일
빌드").
- build.team.area = 이 빌드가 해당되는 팀 또는 프로젝트(예:
Rational Asset Manager 프로젝트).
- build.team.server = 이 프로젝트 또는 팀의 변경 또는 제어
소스에 사용되는 서버.
- 빌드의 참조된 자산에 필요한 관련 아티팩트를 참조하려면
ramDownloadArtifactLinks.xml 스크립트를 사용하십시오.
ramDownloadArtifactLinks.xml 파일은 링크가 지시하는 아티팩트를 다운로드하여
Rational Asset Manager에 대한
Eclipse 프로젝트 아티팩트 링크를 해석하는 샘플 Ant 스크립트입니다.
이 스크립트는 SCM 시스템에서 소스 코드를 추출하고 추출된 프로젝트에
Rational Asset Manager의
아티팩트에 대한 링크가 있는 빌드 프로세스에서 사용할 수 있습니다.
Eclipse에서 Rational Asset Manager의
클라이언트 플러그인은 이 링크를 자동으로 처리합니다.
이 스크립트는
ANT-CONTRIB(http://ant-contrib.sourceforge.net/) 태스크 유틸리티를 사용합니다.
반드시 ant-contrib-XXX.jar 파일을 라이브러리 경로에 두십시오.
DownloadArtifactLinks
스크립트에서 다음 특성을 설정해야
합니다.
- build.dir = rambuildercontrol.xml 파일이 있는 Eclipse
작업공간. 모든 Eclipse 프로젝트가 추출된 디렉토리
경로(일반적으로 SCM 시스템에서 추출됨).
- ram.url = Rational Asset Manager 웹 서비스
애플리케이션의 URL(Rational Asset Manager 웹 클라이언트에서
을 클릭하고
웹 서비스 섹션을 아래로 스크롤하여 저장소 위치 필드를 찾음).
- ram.user.uid = Rational Asset Manager 서버를 사용할 때 사용하는 UID입니다.
- ram.user.passwd = Rational Asset Manager 서버를 사용할 때 사용하는 비밀번호입니다.
- ram.download.result.file = 선택적 파일 경로. 설정한 경우
";"으로 구분된 다운로드 자산 목록이 포함되는
"ram.downloadlist" 특성도 있습니다(예: GUID,version,artifact,artifact;GUID,version,artifact,artifact,artifact).
예를 들어, 다음 값을 다운로드할 사용자의
관련 자산으로 대체하십시오.
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="build.dir" value="C:\Documents and Settings\Administrator\Desktop\RTC Workspace\" />
<property name="ram.download.result.file" value="C:\BuildDir\publishresults" />
- 빌드 결과를 새 자산으로 공개하려면 ramPublishAsset.xml 스크립트를 사용하십시오.
ramPublishAsset.xml 파일은
Rational Asset Manager에
자산의 컨텐츠를 공개하는 샘플 Ant 스크립트입니다.
이 스크립트는 이 자산을 생성하는 데 사용된 기타 자산(예:
개방형 소스/공통 컴포넌트, 지원되는 플랫폼 및 스펙)에 대한 종속성은 물론
이 빌드되고 공개된 자산이 구현하는 사항(예: 스펙, 릴리스 또는 디자인)에 대한 링크를 반영하여
Rational Asset Manager에
생성된 아티팩트의 세트를 단일 자산으로 공개해야 하는 빌드 프로세스에서 사용할 수 있습니다.
이 스크립트는
ANT-CONTRIB(http://ant-contrib.sourceforge.net/) 태스크 유틸리티를 사용합니다.
반드시 ant-contrib-XXX.jar 파일을 라이브러리 경로에 두십시오.
PublishAsset
스크립트에서 다음 특성을 설정해야 합니다.
- ram.url = Rational Asset Manager 웹
서비스 애플리케이션의 URL(저장소 위치는 Rational Asset Manager 도움말/확장기능
페이지 참조).
- ram.user.uid = Rational Asset Manager 서버를 사용할 때 사용하는 UID입니다.
- ram.user.passwd = Rational Asset Manager 서버를 사용할 때 사용하는 비밀번호입니다.
- ram.asset.version = 자산의 버전(즉, 자산 페이지의 Rational Asset Manager 버전)입니다.
- ram.asset.name = 자산의 고유 이름.
- ram.asset.community = 자산을 업로드할 커뮤니티.
- ram.asset.type = 이 자산에 사용할 유형.
- ram.asset.shortDescription = 간단한 설명.
- ram.asset.description = 이 자산과 관련된 설명.
- ram.asset.artifacts = 공개할 모든 아티팩트의 디렉토리 구조가
있는 아카이브 파일.
- ram.release.guid = 릴리스의 일부분으로 이 자산이 관련된
고유 ID. "구현" 관계에 관련되는 자산(예: 자산을
공개할 때 스펙, 릴리스 요구사항 등에 자산을
관련시킬 수 있음).
- ram.release.version = "구현" 자산의
버전.
- build.id = 이 다운로드가 해당되는 빌드를 추적하기 위해
Rational Asset Manager에서
빌드 ID를 사용합니다. 임의의 문자열이 가능합니다.
예를 들어, 자산을 공개하려면 이러한 값을 대체하십시오.
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="ram.asset.version" value="1.0" />
<property name="ram.asset.name" value="Publish Script test" />
<property name="ram.release.guid" value="7198899C-3E2A-A3CE-2E76-68BC2A637AD2" />
<property name="ram.release.version" value="7.2" />
<property name="build.id" value="1234" />
다음은 다운로드 내용을 설명하기 위해
Rational Asset Manager에
제출될 선택적 특성입니다.
- ram.download.result.file = ramDownloadArtifactLinks.xml
스크립트에서 작성한 파일의 선택적 파일 경로. 설정한 경우 이 스크립트는
이 파일에 표시된 모든 자산의 종속성 관계를 나타냅니다.
- verify.state.name = 지정한 경우 스크립트는 ram.download.result.file에
표시된 모든 파일이 이 상태(예: "승인됨")인지
확인합니다.
다음은 업로드된 아티팩트에 정보로
표시됩니다.
- build.type = 빌드 유형(예: "RTC 매일 빌드").
- build.team.area = 이 빌드가 해당되는 팀 또는 프로젝트(예:
Rational Asset Manager 프로젝트).
- build.team.server = 이 프로젝트 또는 팀의 변경 또는 제어
소스에 사용되는 서버.
- src.repository = 이 자산을 개발하는 데 사용된 소스/오리진의
저장소.
- build.id = 이 자산을 생성한 빌드 ID.
- build.def.id = 이 자산을 작성하는 데 사용된 빌드 유형.
- build.label = 빌드 설명.
- build.url = 이 자산이 생성된 빌드의 링크에 대한 URL.
- src.repository = 이 자산을 개발하는 데 사용된 저장소 URL.