빌드 통합을 위한 Ant 빌드 스크립트 구성

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를 설정할 필요가 없습니다.

프로시저

  1. 빌드 프로젝트(예: Rational Build Forge 프로젝트)를 작성하십시오. Rational Asset Manager에서 도구, 라이브러리 및 종속자 컴포넌트가 모두 자산으로 사용 가능한 경우에는 제공된 Ant 스크립트를 사용하여 이 자산을 기반으로 빌드를 실행할 수 있습니다. 또한 이러한 스크립트를 다른 빌드 유틸리티 및 솔루션과 함께 사용할 수도 있습니다.
  2. 빌드 프로젝트가 빌드의 자산을 사용하고 빌드 결과를 새 자산으로 공개하려면 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)에서 직접 액세스할 수도 있습니다.
  3. 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 파일을 자동으로 찾습니다.
  4. 빌드에서 사용할 자산을 참조하려면 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 = 이 프로젝트 또는 팀의 변경 또는 제어 소스에 사용되는 서버.
  5. 빌드의 참조된 자산에 필요한 관련 아티팩트를 참조하려면 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" />
  6. 빌드 결과를 새 자산으로 공개하려면 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.

다음은 Ant 1.8을 사용할 때 다운로드 스크립트 실행 예입니다.
ant -v -lib <ramclient folder>/ramclient-ant1.8.jar 
-file ramDownloadAsset.xml 
-Dlib.dir=<location where to download the artifacts> 
-Dram.url=<URL to repository location from Extension page> 
-Dram.user.id=<ram uid> 
-Dram.user.passwd=<ram passwd> 
-Dram.asset.guid=<guid> 
-Dram.asset.version=<version> 
-Dbuild.id=<An ID that denotes what this download is for>
이러한 스크립트 사용의 예는 http://www.ibm.com/support/docview.wss?uid=swg27016509 또는 http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html을 참조하십시오.

피드백