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 configure los scripts de
construcción Ant para una integración de compilación, 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 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. El archivo
ramclient.zip contiene un conjunto de archivos .jar y tareas 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 utilizar el archivo ramclient.zip, extraiga el archivo en una carpeta y establezca el
parámetro de biblioteca Ant para incluir el archivo .jar de Ant. Si está utilizando Ant 1.8, establezca el parámetro de biblioteca Ant en el archivo
ramclient-ant1.8.jar de esa carpeta. Si está utilizando Ant 1.7, establezca el parámetro de
biblioteca Ant en el archivo ramclient-ant.jar de esa carpeta. No mueva ninguno de los archivos extraídos después de extraer el archivo ramclient.zip.
Ant busca automáticamente los otros archivos .jar requeridos por
ramclient-ant1.8.jar o ramclient-ant.jar según sea necesario.
- 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
Rational Asset Manager (en el
cliente web de
Rational Asset Manager, pulse el
icono Ayuda, pulse Ampliaciones, desplácese a la sección de servicios web
y busque el campo Ubicación de repositorio).
- ram.user.uid = El ID de usuario a utilizar cuando se utiliza el servidor
Rational Asset Manager.
- ram.user.passwd = Contraseña a utilizar cuando se utiliza el servidor
Rational Asset Manager.
- ram.asset.guid = Identificador exclusivo del activo (es decir, el ID exclusivo de
Rational Asset Manager de la
página de activo).
- ram.asset.version = Versión del activo (es decir, la versión de
Rational Asset Manager de la
página de activo).
- build.id = ID de compilación que
Rational Asset Manager utilizará
para hacer un seguimiento de la compilación para la que 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.guid" value="8141FA04-E837-FA50-7052-5269E7C6937C" />
<property name="ram.asset.version" value="1.0" />
A continuación se indican las propiedades opciones que se enviarán a
Rational Asset Manager para
describir lo que se 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 se puede utilizar 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 establecer las siguientes propiedades:
- 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
Rational Asset Manager (en el
cliente web
Rational Asset Manager, pulse
, desplácese a la sección de
servicios web y mire el campo Ubicación de repositorio).
- ram.user.uid = El ID de usuario a utilizar cuando se utiliza el servidor
Rational Asset Manager.
- ram.user.passwd = Contraseña a 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 un conjunto de artefactos generados debe
publicarse en
Rational Asset Manager como un
único activo, reflejando las dependencias de otros activos utilizados para generar este activo (por ejemplo componentes
de código abierto/componentes comunes, plataformas soportadas y especificaciones) así como un enlace a lo que este
activo compilado y publicado implementa (como por ejemplo una especificación, un release o un 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
Rational Asset Manager (consulte
la página Ayuda/Ampliación de
Rational Asset Manager para
conocer la ubicación del repositorio).
- ram.user.uid = El ID de usuario a utilizar cuando se utiliza el servidor
Rational Asset Manager.
- ram.user.passwd = Contraseña a 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 de la
página de 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 las propiedades opciones que se enviarán a
Rational Asset Manager para
describir lo que se 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 proporciona un ejemplo de la ejecución del script de descarga cuando se utiliza Ant 1.8:
ant -v -lib <carpeta ramclient>/ramclient-ant1.8.jar
-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.guid=<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