Configurar scripts de construcción Ant para una integración de compilación

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

  1. 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.
  2. 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).
  3. 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.
  4. 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.
  5. 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 Ayuda > Ampliaciones, 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" />
  6. 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

Comentarios