Si IBM® UrbanCode Deploy no tiene
un tipo de configuración de origen para el sistema de compilación, puede
utilizar el cliente de línea de mandatos udclient para gestionar
componentes.
Acerca de esta tarea
Cuando utilice el cliente
udclient de
esta forma, puede introducir nuevas versiones de componentes en el servidor, iniciar
proceso, añadir enlaces a orígenes externos y ejecutar otras muchas tareas en el
servidor de
IBM UrbanCode Deploy
como parte del proceso de la compilación. De esta manera, podrá trabajar con sus componentes
en
IBM UrbanCode Deploy sin modificar
la tecnología de la compilación.
Procedimiento
Siga estos pasos generales para configurar un componente que utiliza
el cliente de línea de mandatos:
- Cree uno o varios componentes en IBM UrbanCode Deploy para
representar los componentes de la compilación. Utilice los parámetros siguientes en la ventana
Crear componente:
- En el campo Tipo de configuración de origen, seleccione
Ninguno.
- Anule la selección de la casilla de verificación Importar versiones de forma automática.
- Complete el resto de los campos de la ventana de la forma habitual.
- En los scripts de compilación del componente, añada código
para llamar a los mandatos de cliente udclient y crear una versión de componente, así
como cargar los artefactos en el servidor de IBM UrbanCode Deploy. En la mayoría de los casos, utilice diferentes mandatos para crear
la versión. Los siguientes pasos muestran algunos ejemplos de mandatos que puede utilizar.
Nota: Estos ejemplos utilizan código en un archivo de compilación de Apache Ant. Específicamente, llaman al cliente udclient
con el mandato <exec> de Ant, que llama a programas
externos. Si va a utilizar una tecnología de compilación diferente, deberá adaptar los ejemplos
a su tecnología de compilación para llamar al cliente udclient.
- Utilice el mandato createVersion para crear la nueva versión. El siguiente código de ejemplo crea una versión de un componente
que se denomina mycomponent. El nombre de versión
se establece en la marca de fecha y hora de la compilación. Las variables ${udclient.weburl}, ${udclient.username}
y ${udclient.password} representan el URL del servidor
y el nombre de usuario y contraseña del servidor.
<exec executable="/bin/bash"
outputproperty="mycomponent.component.output">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="createVersion"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-name"/>
<arg value="${buildTimestamp}"/>
</exec>
- Utilice el mandato addVersionFiles para cargar los artefactos en la versión de componente. El siguiente código de ejemplo carga los archivos
en la carpeta ${destdir} de la versión:
<exec executable="/bin/bash">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="addVersionFiles"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-version"/>
<arg value="${buildTimestamp}"/>
<arg value="-base"/>
<arg value="${destdir}"/>
</exec>
- Opcional: Añada enlaces de la versión de componente. Con el mandato addVersionLink, puede añadir enlaces de la versión a los recursos de compilación externos, como la página que muestra información
sobre el resultado de la compilación. Estos enlaces aparecen en la parte superior de la página de información
de la versión de componente. El siguiente ejemplo muestra una versión de componente
con un enlace al trabajo de compilación relacionado y el resultado de compilación relacionado
en el sistema de gestión de código fuente: Por ejemplo, el siguiente código añade un enlace
a la página de resultados de la compilación en el URL http://build.example.com/projects/mycomponent/${buildResultUUID}:
<exec executable="/bin/bash">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="addVersionLink"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-version"/>
<arg value="${buildTimestamp}"/>
<arg value="-linkName"/>
<arg value="External build result"/>
<arg value="-link"/>
<arg value="http://build.example.com/projects/mycomponent/${buildResultUUID}"/>
</exec>
Resultados
Ahora, cuando ejecute una compilación en la herramienta de compilación externa, el proceso
de compilación creará una versión de componente y cargará los artefactos de la versión
en el servidor de
IBM UrbanCode Deploy.
A partir de este momento, podrá trabajar con el componente y la versión en el servidor
de la forma habitual; por ejemplo, ejecutando procesos con él.
También puede añadir otros mandatos
al script de compilación. Por ejemplo, puede iniciar procesos de aplicación
con el mandato requestApplicationProcess.