Conexión a un proveedor TRS como un origen de datos para el índice LQE utilizando un URL de origen de datos

Cualquier herramienta de ciclo de vida que soporte la especificación TRS se puede utilizar como un origen de datos para crear el índice de datos enlazados del ciclo de vida. En este tema se describe cómo generar el índice para una herramienta de ciclo de vida en un JTS diferente, como LQE, mediante un URL de origen de datos. Este es el método más complejo para añadir orígenes de datos a LQE, y solo deben realizarlo los administradores que poseen conocimientos expertos sobre la arquitectura de su solución.

Antes de empezar

El usuario funcional de LQE (lqe_user) se debe crear en el JTS para la herramienta de ciclo de vida, tal como se describe en Configurar LQE en la consola de administración de JTS

Acerca de esta tarea

Si la aplicación no tiene un documento de servicios raíz o si desea proporcionar manualmente los URL OAuth, entonces puede registrar manualmente el TRS. Cuando LQE se comunica con el proveedor de TRS (su aplicación), se comunicará directamente con su aplicación. Por lo tanto, debe crear una pareja de secreto de consumidor/clave de OAuth para LQE dentro de la aplicación. El consumidor de entrada debe ser de confianza y debe tener un usuario funcional (lqe_user). Se debe asignar la licencia interna al usuario funcional.

Procedimiento

  1. En el panel de administración de LQE, seleccione el panel Orígenes de datos. Este panel muestra el estado de vida de los orígenes de datos a los que LQE está conectado.
    Captura de pantalla del panel de orígenes de datos que muestra un origen de datos que se indexa.
  2. Seleccione Añadir origen de datos y pulse URL de origen de datos.
    Captura de pantalla del asistente Añadir origen de datos.
    1. Escriba el URL del origen de datos para su aplicación. El formato predeterminado es https://servidor:puerto/tool/trs. Seleccione el origen de datos que desea añadir.
    2. Añada una etiqueta como un identificador para el origen de datos.
    3. Los campos de planificación permiten establecer cuando se producirá la indexación. Si los campos se dejan en blanco, el índice se crea en cuanto finaliza el asistente. En un entorno de laboratorio de prueba, LQE puede indexar 50.000 artefactos en menos de 1 hora; dependiendo de la configuración y el hardware, puede experimentar una velocidad de indexación más lenta.
      Nota: Puede indexar varios orígenes de datos simultáneamente. Cada uno se ejecutará en su propia hebra. También puede planificar la indexación inicial de varios orígenes de datos de TRS para ejecutarlos uno detrás de otro.
    4. Dado que esta aplicación está en un JTS diferente de LQE, seleccione la especificación de los detalles de autenticación.
  3. En el panel Especificar detalles de autenticación, escriba la información de autenticación para la aplicación.
    Panel de detalles de autenticación
    1. En otra ventana del navegador, busque la clave que ha generado para LQE en: Registro de aplicaciones como proveedores TRS para Lifecycle Query Engine. En este ejemplo añadirá la aplicación QM, por lo tanto, deberá ir al panel administrativo QM: https://servidor:puerto/QM/admin#action=com.ibm.team.repository.admin.configureOAuth.
      Nota: A menos que la autenticación se delegue a Jazz Team Server, debe ir al panel administrativo para la aplicación y no al panel administrativo de Jazz Team Server.
    2. Bajo la lista Claves autorizadas, busque y copie la clave lqe_user y el secreto.
    3. Regrese a la ventana del navegador LQE y escriba la Clave del consumidor y el Secreto.
    4. Escriba los URL de OAuth para su aplicación. Los URL de ejemplo serán similares a los siguientes:
      • https://servidor:puerto/tool/oauth-request-token
      • https://servidor:puerto/tool/oauth-authorize
      • https://servidor:puerto/tool/oauth-access-token
  4. Seleccione las opciones de configuración del origen de datos.
    Captura de pantalla del panel "Configurar origen de datos" del asistente Añadir origen de datos
    1. La cadencia de renovación especifica la frecuencia con que LQE intenta acceder al origen de datos para las renovaciones en curso de su índice. Un origen de datos que no se actualiza frecuentemente puede tener una cadencia de renovación más baja que un origen de datos que se actualiza continuamente. El aumento de la cadencia de renovación afectará al rendimiento.
    2. El número de hebras para la indexación inicial se debe establecer generalmente entre 2 y 4. Cada hebra es aproximadamente equivalente a un usuario que utiliza el servidor LQE. Para máquinas Intel, la cadencia de mejora en la velocidad de recuperación de datos para más de 4 hebras es mínima.
    3. El número de hebras para la indexación en curso se debe establecer generalmente entre 2 y 4. Cada hebra es aproximadamente equivalente a un usuario que utiliza el servidor LQE. Para máquinas Intel, la cadencia de mejora en la velocidad de recuperación de datos para más de 4 hebras es mínima.
    4. Continuar con la actualización incremental en caso de que hayan saltado recursos permite a LQE registrar un error y continuar indexando cuando encuentra un recurso que no puede indexar. Esto está seleccionado de forma predeterminada. Si esta opción está inhabilitada, el proceso de indexación se detendrá cada vez que no se pueda indexar un recurso.
  5. Cuando finalice el asistente se le mostrarán los datos que se pueden configurar en cualquier punto para este origen de datos. Pulse Guardar para iniciar la indexación. El estado en directo del proceso de indexación se muestra en el panel Orígenes de datos principal. Al pulsar el enlace del campo de estado se visualizará el informe de estado en profundidad para el proceso de indexación.
    Captura de pantalla de la página de estado Origen de datos
    Captura de pantalla de la página de historial de estado de origen de datos

Qué hacer a continuación

Si en cualquier momento necesita indexar un origen de datos o detener el proceso de indexación, en la ventana principal de Origen de datos, pase el cursor sobre el campo Acciones para visualizar los iconos para poner en pausa, detener o suprimir un índice.


Comentarios