Creación de componentes con el cliente de línea de mandatos

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.

Antes de empezar

Para instalar el cliente, consulte Instalación del cliente de línea de mandatos.

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:

  1. 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.
  2. 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.
    1. 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>
    2. 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>
    3. 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:
      Versión de componente con dos enlaces en la sección Enlaces
      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.


Comentarios