Se configuran los scripts Ant que se suministran
con IBM® Rational Asset Manager para integrarlos
con una aplicación de compilación
como IBM Rational Build Forge u
otro programa de utilidad de compilación.
Antes de empezar
- Debe establecer las propiedades en los scripts para que hagan referencia a la información del sistema
de Rational Asset Manager.
- Para ejecutar los scripts Publish y DownloadArtifactLinks, debe instalar el archivo .jar
Ant-Contrib en la vía de acceso de la biblioteca. Puede descargar
el archivo
comprimido que contiene el archivo .jar y seguir
la información de instalación para ver los detalles.
Nota: Cuando configura los scripts de
construcción de Ant para una integración de construcción, debe utilizar Ant 1.7.0 o una versión posterior en el sistema
de construcción para evitar un error de vía de acceso de clases al ejecutar los scripts. Establezca la variable
JAVA_HOME en la carpeta Java y establezca la variable ANT_HOME
en el directorio de instalación de Ant (que debe ser 1.7.0 o una versión
posterior). No es necesario establecer PATH o CLASSPATH.
Procedimiento
- Cree un proyecto de compilación (como un
proyecto Rational Build Forge). Si las herramientas, las bibliotecas y los componentes dependientes están
todos disponibles como activos en Rational
Asset Manager, puede utilizar los scripts ANT proporcionados para ejecutar una
compilación basada en estos activos. También puede utilizar estos scripts con otras soluciones y otros programas de utilidad de compilación.
- Utilice los scripts ANT proporcionados en Rational Asset Manager para que el proyecto de compilación utilice
activos en la compilación y para publicar los resultados de la compilación como activos
nuevos. Cada script utiliza tareas ANT de Rational Asset
Manager. Para cada script, debe descargar el archivo ramclient.zip,
extraerlo en una carpeta e incluir esa carpeta en la vía de acceso de la biblioteca ANT
cuando ejecute uno de los scripts ANT. El archivo ramclient.zip contiene un conjunto
de archivos .jar necesarios y scripts ANT, y está disponible en la
página Ampliaciones de cualquier instancia de servidor Rational Asset Manager
desplegada. También puede acceder a él directamente
desde aquí: http://<nombre_host>:<puerto>/ram/ramclient.zip
(por ejemplo http://<localhost>:<9080>/ram/ramclient.zip
- Para hacer referencia a activos que se utilizarán en la compilación,
utilice este script: ramDownloadAsset.xml
El archivo ramDownloadAsset.xml es un script Ant
de ejemplo que descarga el contenido del activo (como artefactos).
Este script se puede utilizar en un proceso de compilación donde sea necesario un
conjunto de bibliotecas aprobadas o archivos ejecutables para poder ejecutar la
compilación (por ejemplo: un compilador especial, componentes comunes o scripts comunes).
En el script DownloadAsset, se deben definir las propiedades siguientes:
- lib.dir = Directorio en el que copiar el activo.
- ram.url = URL para la aplicación de servicios web de Rational Asset Manager (en el cliente web de
Rational Asset Manager, pulse
el icono Ayuda, pulse Ampliaciones y desplácese hacia abajo hasta la sección de servicios web y
localice el campo Ubicación de repositorio).
- ram.user.uid = ID de usuario que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.user.passwd = Contraseña que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.asset.quid = Identificador exclusivo del activo (es decir, el identificador
exclusivo de Rational Asset Manager
contenido en la página Activo).
- ram.asset.version = Versión del activo (es decir, la versión de Rational Asset Manager contenida en la página
Activo).
- build.id = Identificador de compilación que será utilizado por Rational Asset Manager para hacer un seguimiento de la compilación
para la cual se realiza esta descarga.
Por ejemplo, sustituya estos valores por su propio activo que se debe
descargar:
<property name="lib.dir" value="C:\libdir" />
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="ram.asset.quid" value="{8141FA04-E837-FA50-7052-5269E7C6937C}" />
<property name="ram.asset.version" value="1.0" />
A continuación se indican propiedades opcionales que se enviarán a Rational Asset Manager para describir la
compilación para la cual se realiza la descarga:
- build.type = Tipo de compilación (por ejemplo, "RTC Daily Build")
- build.team.area = Equipo o proyecto para el que se realiza esta compilación (por
ejemplo, proyecto de Rational Asset Manager).
- build.team.server = Servidor utilizado para el origen de cambio o control para este
proyecto o equipo.
- Para referenciar artefactos relacionados que son necesarios para los activos
referenciados en la compilación, utilice este script: ramDownloadArtifactLinks.xml
El archivo ramDownloadArtifactLinks.xml es un script Ant
de ejemplo que resuelve enlaces de artefactos de proyecto Eclipse
para Rational Asset Manager
descargando los artefactos a los que apuntan los enlaces. Este script puede utilizarse
en un proceso de compilación donde el código fuente se extrae de un sistema SCM, y donde los proyectos
extraídos tienen enlaces a artefactos de Rational Asset Manager. En
Eclipse, los plug-ins de cliente para Rational Asset
Manager procesarán estos enlaces automáticamente.
Este script utiliza los programas de utilidad de la tarea ANT-CONTRIB (http://ant-contrib.sourceforge.net/).
Asegúrese de poner el archivo ant-contrib-XXX.jar en la vía de acceso a biblioteca.
En el script DownloadArtifactLinks, se deben definir las propiedades siguientes:
- build.dir = Espacio de trabajo de Eclipse donde se encuentran los archivos rambuildercontrol.xml. Vía de acceso del directorio en el que se extrajeron todos los proyectos de Eclipse
(normalmente de un sistema SCM).
- ram.url
= URL para la aplicación de servicios web de Rational Asset
Manager (en el cliente web de Rational Asset Manager,
pulse ,
desplácese hacia abajo en la sección de servicios web y consulte el campo Ubicación de
repositorio).
- ram.user.uid = ID de usuario que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.user.passwd = Contraseña que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.download.result.file = Vía de acceso al archivo opcional. Si se establece, también habría una propiedad "ram.downloadlist" que mantendría una lista separada mediante ";" de activos descargables. (Por ejemplo, GUID,version,artifact,artifact;GUID,version,artifact,artifact,artifact).
Por ejemplo, sustituya estos valores por sus propios activos relacionados que se deben
descargar:
<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" />
- Para publicar los resultados de la compilación como activos nuevos,
utilice este script: ramPublishAsset.xml
El archivo ramPublishAsset.xml es un script Ant de ejemplo
que publica el contenido de un activo en Rational Asset Manager . Este script se puede utilizar en un proceso de
compilación, en el que sea necesario publicar un conjunto de artefactos generados en Rational Asset Manager como un activo único,
reflejando las dependencias respecto de otros activos que se han utilizado para generar
este activo (por ejemplo, componentes de código abierto/comunes, plataformas soportadas y
especificaciones) así como un enlace a lo implementado por este activo compilado y
publicado (por ejemplo, una especificación, release o diseño).
Este script utiliza los programas de utilidad de la tarea ANT-CONTRIB (http://ant-contrib.sourceforge.net/).
Asegúrese de poner el archivo ant-contrib-XXX.jar en la vía de acceso a biblioteca.
En el script PublishAsset, se deben definir las propiedades siguientes:
- ram.url
= URL para la aplicación de servicios web de Rational Asset
Manager (consulte la página Ayuda/Ampliación de Rational Asset Manager para ver la ubicación
del repositorio).
- ram.user.uid = ID de usuario que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.user.passwd = Contraseña que se debe utilizar cuando se utiliza el servidor Rational Asset Manager.
- ram.asset.version = Versión del activo (es decir, la versión de Rational Asset Manager contenida en la página
Activo).
- ram.asset.name = Nombre exclusivo del activo.
- ram.asset.community = Comunidad en la que cargar el activo.
- ram.asset.type = Tipo que se debe utilizar para este activo.
- ram.asset.shortDescription = Descripción breve.
- ram.asset.description = Descripción del activo.
- ram.asset.artifacts = Archivo de archivado que contiene una estructura de
directorios de todos los artefactos que se deben publicar.
- ram.release.guid = Identificador exclusivo con el que está relacionado este activo
como parte de un release. Activo con el que se debe establecer una relación
"implementación para" (por ejemplo, cuando se publica un activo, puede
relacionar el activo con especificaciones, requisitos de release, etc.)
- ram.release.version = Versión del activo con la relación "implementación para".
- build.id = Identificador de compilación que será utilizado por Rational Asset Manager para hacer un
seguimiento de la compilación para la cual se realiza esta descarga. Puede ser una serie
de caracteres cualquiera.
Por ejemplo, sustituya estos valores por valores propios para publicar
sus activos:
<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" />
A continuación se indican propiedades opcionales que se enviarán a Rational Asset Manager para describir para qué
se realiza la descarga.
- ram.download.result.file = Vía de acceso opcional de un archivo creado por el script
ramDownloadArtifactLinks.xml. Si se define esta opción, el script establecerá una
relación de dependencia con todos los activos listados en este archivo.
- verify.state.name = Si se especifica esta opción, el script verificará que todos los
archivos listados en ram.download.result.file estén en el estado indicado (por ejemplo,
"Aprobado").
Lo siguiente se pondrá como información en los artefactos cargados:
- build.type = Tipo de compilación (por ejemplo, "RTC Daily Build").
- build.team.area = Equipo o proyecto para el que se realiza esta compilación (por
ejemplo, proyecto de Rational Asset Manager).
- build.team.server = Servidor utilizado para el origen de cambio o control para este
proyecto o equipo.
- src.repository = Repositorio para el origen/fuente con el que este activo se ha
desarrollado.
- build.id = Identificador de compilación por el que se ha generado este activo.
- build.def.id = Tipo de compilación utilizada para crear este activo.
- build.label = Descripción de la compilación.
- build.url = URL para enlazar con una compilación con la que se ha generado este activo.
- src.repository = URL de repositorio utilizado para desarrollar este activo.
Ejemplo
A continuación se muestra un ejemplo de la ejecución del script de descarga:
ant -v -lib <ramclient jars path>
-file ramDownloadAsset.xml
-Dlib.dir=<ubicación donde descargar los artefactos>
-Dram.url=<URL de la ubicación de repositorio contenida en la página Ampliación>
-Dram.user.id=<ID de usuario de RAM>
-Dram.user.passwd=<contraseña de RAM>
-Dram.asset.quid=<identificador exclusivo global>
-Dram.asset.version=<versión>
-Dbuild.id=<Identificador que denota para qué se realiza la descarga>
Para obtener un ejemplo sobre cómo se pueden utilizar estos scripts, consulte
http://www.ibm.com/support/docview.wss?uid=swg27016509 o
http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html