Complemento de Jenkins

Este complemento te permite crear e implementar procesos de automatización de UiPath, así como ejecutar casos de prueba automatizados de UiPath.

Para empaquetar proyectos creados con UiPath Studio a partir de la versión 2020.10, debes utilizar una versión a partir de la versión 2.1 de esta extensión.

Requisitos previos

• Servidor Jenkins ejecutado en Windows o Linux.
• Al menos un esclavo de Jenkins que se ejecuta en Windows (requerido para la ejecución del paso).

• Instancia de Orchestrator (se admite autenticación básica, federada o en la nube).

  • Las características de prueba requieren Orchestrator versión 2020.4 o superior.
  • Cuando utilizas un Orchestrator local con HTTPS, asegúrate de importar el certificado SSL para que las llamadas HTTPS a Orchestrator sean de confianza.

Instalar y habilitar el complemento

El complemento de Jenkins puede instalarse desde cualquier instalación de Jenkins conectada a Internet usando la pantalla del Administrador de complementos.

Trabajos

UiPath Run Job

El paso posterior a la compilación UiPath Run Job inicia un proceso que ya se ha implementado en una instancia de Orchestrator. En la versión 2020.10 de Orchestrator, puedes encontrar los procesos que ejecuta esta tarea en la pestaña Procesos. En las versiones de Orchestrator 2021.10 y posteriores, puedes encontrar los procesos que ejecuta esta tarea en Automatizaciones, en Procesos.

Configuración

Parámetro de trabajo	Descripción
Proceso (requerido)	Nombre del proceso. Puede tomar el nombre del proceso de la interfaz de usuario de Orchestrator. Si el proceso se implementa en una carpeta moderna, este argumento debe ser el nombre del proceso en la pestaña Procesos . Si el proceso se implementa en una carpeta clásica, el argumento debe estar formado por el Nombre del proceso y el Entorno (por ejemplo: NAME: ProcessA ENVIRONMENT: Production ProcessName: ProcessA_Production).
Parámetros	La ruta completa a un archivo de entrada JSON. Se utiliza cuando el proceso requiere entrada. Ejemplo de formato de archivo JSON: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
Prioridad	La prioridad de ejecución del trabajo
Estrategia	Especifique la estrategia de ejecución de trabajos, los trabajos asignados dinámicamente o los trabajos específicos del robot. Elige una de las siguientes opciones: Asignar dinámicamente Robots específicos
Tipo de trabajo (disponible solo para carpetas modernas)	Elija el modelo de licencia del tiempo de ejecución en el que se ejecutará el trabajo.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator donde ejecutará el proceso.
Tenant de Orchestrator	Especifique el tenant de Orchestrator.
Carpeta de Orchestrator	Especifique la carpeta donde se implementó el proceso especificado. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.
Ruta de salida de los resultados del trabajo	Especifique la ruta de salida de los resultados del trabajo (por ejemplo, testResults.json). Los resultados se generan en formato JSON. Si no se especifica, los resultados se enviarán al directorio de clasificación de artefactos como UiPathResults.json. La salida está en formato json.
Tiempo de espera	Especifique el tiempo de espera de ejecución del trabajo en segundos.
Falla cuando el trabajo falla	La tarea falla cuando se produce un error al menos en un trabajo. El valor predeterminado es Verdadero.
Esperar a que finalice el trabajo	Esperar a que finalice la ejecución de trabajo/s. El valor predeterminado es Verdadero.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.
N.º de trabajos	El número de ejecuciones de trabajos El valor predeterminado es 1.
Usuario (disponible solo para carpetas modernas)	El nombre del usuario. Debe ser un usuario de la máquina, no un usuario de Orchestrator. Para los usuarios locales, el formato debe ser MachineName \ UserName.
Máquina (disponible solo para carpetas modernas)	El nombre de la máquina.
Nombres del robot	Lista separada por comas de nombres de robots específicos.

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Dynamically(jobsCount: 1, machine: 'TestMachine', user: 'TestUser'), timeout: 3600, waitForJobCompletion: true, traceLoggingLevel: 'None'
        )
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Robot('robot1,robot2'),
          timeout: 1800,
          waitForJobCompletion: false,
          traceLoggingLevel: 'None'
        )
    }
  }
}

UiPath Manage Assets

El paso Administrar activos de UiPath le permite implementar, actualizar o eliminar activos en una instancia de Orchestrator. Para implementar activos, debes describirlos en un archivo CSV como el del siguiente ejemplo codificado en uft-8.

name,type,value,description
asset_1_name,text,asset_value,this is an test description   # we can have comments
asset_2_name,integer,123
asset_3_name,boolean,false
asset_4_name,credential,"username::password"

Hay cuatro tipos de activos:

• Texto
• Entero
• Booleano
• Credencial. Para la Credencial debes codificar el nombre y la contraseña utilizando :: para separar los dos campos.
  
  

  

  
  

Configuración

Parámetro de trabajo	Descripción
Acción	Qué hacer con los activos proporcionados: implementar o eliminar. Si existe un activo implementado, se actualizará.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator donde implementará o actualizará los activos.
Tenant de Orchestrator	Especifique el tenant de Orchestrator en el que se implementarán o actualizarán los activos.
Carpeta de Orchestrator	Especifique la carpeta donde se implementarán o actualizarán los activos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autenticarse en un Orchestrator local mediante autenticación de aplicación externaautenticación de aplicación externa.
Ruta del archivo CSV	La ruta al archivo CSV que contiene los detalles del activo. Se puede usar el mismo archivo para implementar o actualizar los activos, aunque el tipo no es necesario para las actualizaciones. El campo type también puede estar vacío, pero la columna debe estar presente. Para eliminar, solo se utiliza la columna name , por lo que las otras columnas pueden estar vacías, pero deben estar presentes. Puedes establecer una descripción opcional para cada activo (por ejemplo: type, value, description). Asegúrate de eliminar cualquier salto de línea, ya que cada línea se interpreta como un nuevo activo.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathAssets (
            assetsAction: DeployAssets(), 
            credentials: Token(accountName: '', credentialsId: ''), 
            filePath: '${WORKSPACE}/test.csv', 
            folderName: 'Default', 
            orchestratorAddress: 'https://test-orchestrator.somedomain.com', 
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
        UiPathAssets(
            assetsAction: DeleteAssets(),
            credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
            filePath: '${WORKSPACE}/test.csv',
            folderName: 'Default',
            orchestratorAddress: 'https://test-orchestrator.somedomain.com',
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
    }
  }
}

UiPath Pack

Aplicación: RPA

Tipo: tarea de creación

UiPath Pack está disponible en trabajos y procesos estándar, y te permite empaquetar un proyecto de UiPath existente en un paquete NuGet.

Configuración

Parámetro de trabajo	Descripción
Elija el método de control de versiones	Los paquetes de UiPath están versionados. Con el paquete de UiPath puede elegir entre 3 opciones diferentes: (1) Generar automáticamente (2) Definir versión personalizada (3) Utilice la versión actual establecida en el proyecto.
Ruta de proyecto/s	La ubicación de los proyectos que se van a empaquetar. Puede ser una ruta de acceso directa a un archivo project.json o un directorio con uno o varios proyectos. En este último caso, cada proyecto de nivel uno se empaqueta individualmente.
CarpetaDeSalida	Ruta a la carpeta donde desea crear el paquete.
Tipo de salida	El tipo de salida de los proyectos. Hay 5 opciones para el tipo de proyecto: (1) Tipo de salida del proyecto (2) Empaquetar un proyecto de proceso (3) Empaquetar un proyecto de biblioteca (4) Empaquetar un proyecto de pruebas (5) Empaquetar un proyecto de objetos.
Ejecutar análisis del flujo de trabajo	Ejecuta el análisis del flujo de trabajo antes de empaquetar, comprobando el proyecto mediante reglas predefinidas en busca de infracciones. Fallar el trabajo en caso de errores. De forma predeterminada, el análisis no se ejecuta.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.
Usar Orchestrator	Utilice la fuente de Orchestrator al empaquetar bibliotecas. La versión de Orchestrator debe ser 20.4 o superior. La fuente de la biblioteca debe permitir la autenticación de clave de API en Tenant > Configuración > Implementación.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator desde la que se deben restaurar las dependencias de la librería.
Tenant de Orchestrator	El tenant de Orchestrator desde el que se deben restaurar las dependencias de la biblioteca.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.

Ejemplo de proceso

ipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathPack (
          outputPath: "Output\)\)\)\)${env.BUILD_NUMBER}",
          projectJsonPath: "UiBank\)\)\)\)project.json",
          version: [$class: 'ManualVersionEntry', version: "${MAJOR}.${MINOR}.${env.BUILD_NUMBER}"]
          useOrchestrator: true,
          traceLoggingLevel: "None",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”]
        )
      }
    }
  }
}

UiPath Deploy

Aplicación: RPA

Tipo: tarea posterior a la creación

UiPath Deploy está disponible en trabajos y procesos estándar, y te permite implementar un paquete NuGet de UiPath en UiPath Orchestrator.

Configuración

Parámetro de trabajo	Descripción
Ruta de paquete/s	La carpeta que contiene sus paquetes nuget de UiPath.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator en la que se implementarán los paquetes.
Tenant de Orchestrator	El tenant de Orchestrator en el que se implementarán los paquetes.
Carpeta de Orchestrator	La carpeta en la que se va a implementar. Si se trata de una carpeta Clásica, también deberás establecer el environmentscampo .Para carpetas Modernas, no es necesario establecer el campo environments. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Entornos (requerido para las carpetas clásicas)	El entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto. Especifique el entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto.
Puntos de entrada	Especifica puntos de entrada para crear o actualizar un proceso. El punto de entrada especifica el filePath comenzando desde la raíz del proyecto. Condiciones: Hay puntos de entrada disponibles para la versión 21.4 de Orchestrator o superior (por ejemplo, 21.4.UiPathDeploy.entryPoints). Para las versiones de Orchestrator inferiores a la 21.4, debes introducir cualquier valor, ya que el campo no debe permanecer vacío. Punto de entrada predeterminado establecido en Main.xaml. Para las carpetas clásicas (obsoletas) solo se puede especificar un punto de entrada para cada entorno. Para obtener más información, consulta Puntos de entrada de Orchestrator.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autenticarse en un Orchestrator local mediante autenticación de aplicación externaautenticación de aplicación externa.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Nota:

Asegúrate de que tu red permite acceder al siguiente feed de paquete de NuGet:

• https://api.nuget.org/v3/index.json
• https://uipath.pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json
• https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-* Internal/nuget/v3/index.json
• https://www.myget.org/F/workflow
• http://www.myget.org/F/uipath
• https://www.myget.org/F/uipath-dev/api/v3/index.json

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathDeploy (
          packagePath: "path\)\)\)    o\)\)NuGetpackage",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          environments: "environment",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”],
          traceLoggingLevel: 'None'
        )
      }
    }
  }
}

Pruebas de ejecución de UiPath

Aplicación: Pruebas

Tipo: tarea posterior a la creación

Las pruebas de UiPath Run está disponible en trabajos y procesos estándar, y le permite:

• Ejecutar un conjunto de prueba existente en Orchestrator.
• Empaquete, implemente y ejecute casos de prueba especificando la ruta a un proyecto de prueba de UiPath.

Una vez finalizada la ejecución de prueba, la pestaña Resultado de la prueba se publica en la compilación de Jenkins y muestra los resultados detallados. Además, se crea un archivo de resultados de prueba JUnit en la ruta de salida de resultados de la prueba, cuando se especifica, o en la raíz del espacio de trabajo si no se especifica.

En función del resultado, la compilación se marcará como satisfactoria (se han aprobado todos los casos de prueba) o como inestable (ha fallado al menos un caso de prueba).

Configuración

Parámetro de trabajo	Descripción
Destino	Especifique un conjunto de pruebas existente en UiPath Orchestrator (para ejecutar el conjunto de pruebas). Proporcione la ruta project.json de un proyecto de prueba de UiPath (para ejecutar el proyecto de prueba).
Ruta de salida del resultado de la prueba	El conjunto de pruebas ejecutadas devuelve el resultado de la prueba como junit.xml. Especifica la ruta de acceso donde se debe almacenar el resultado, en relación con el directorio del espacio de trabajo de Jenkins (por ejemplo, result.xml).
Parámetros de entrada	Define los argumentos personalizados para tus casos de prueba para anular los valores predeterminados a nivel del conjunto de pruebas. Mediante los argumentos podrás establecer los parámetros para probar los casos en el runtime. Para definir los argumentos, debes publicar un paquete con argumentos.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator en la que se implementarán los paquetes.
Tenant de Orchestrator	El tenant de Orchestrator en el que se implementarán los paquetes.
Carpeta de Orchestrator	La carpeta en la que se va a implementar. Si la carpeta es Clásica, también deberá establecer el campo environments. Para las carpetas modernas, configurando environments. no es obligatorio. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Entornos (requerido para las carpetas clásicas)	El entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto. Especifique el entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autenticarse en un Orchestrator local mediante autenticación de aplicación externaautenticación de aplicación externa.
Tiempo de espera (segundos)	El tiempo de espera de ejecución de prueba. El valor predeterminado es 7200 segundos. Si el tiempo de espera se supera antes de que la ejecución en Orchestrator finalice y devuelva el resultado, lo creado se cancelará y se marcará como fallido.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Ejemplo de proceso

pipeline {
  agent any
  environment {
    MAJOR = '1'
    MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathTest (
          testTarget: [$class: 'TestSetEntry', testSet: "My Test Set"],
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          timeout: "10000",
          traceLoggingLevel: 'None',
          testResultsOutputPath: "result.xml",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: "credentialsId"]
        )
      }
    }
  }
}

Obtener la clave de la API de Cloud Orchestrator

Configurar la conexión de servicio para aplicaciones externas

Paso 1: configura tu aplicación externa y tus ámbitos. Después de añadir la aplicación, ten a mano el ID de la aplicación, el Secreto y los Ámbitos de la aplicación, para utilizarlos en el siguiente paso.

Nota: Si generas y utilizas un nuevo secreto, el viejo será invalidado.

Paso 2: Configurar las credenciales de la aplicación como texto secreto en Jenkins. Para este paso necesita el Secreto generado en Automation Cloud.

Paso 3: configure la autenticación para cada tarea en Acciones posteriores a la compilación, agregando el nombre de la cuenta, seguido del ID de la aplicación, el secreto y los ámbitos de la aplicación generados a través de Automation Cloud.

Nota: Considera la posibilidad de usar la aplicación externa en procesos individuales para evitar errores de invalidación.

Información adicional

• Todas las rutas especificadas deben ser locales para el espacio de trabajo actual. Puedes usar variables de entorno en las rutas, aunque debes asegurarte de que den lugar a rutas locales para el espacio de trabajo.
• Para implementar paquetes o ejecutar pruebas, asegúrate de que el usuario autenticado tiene los permisos Vista de carpetas (o vista de unidades de organización) y (solo20.4+ ) Vista de tareas en segundo plano.
• Para empaquetar bibliotecas, cuando esté conectado a una instancia de Orchestrator, asegúrese de que el usuario autenticado tenga el permiso Ver bibliotecas .

• Para obtener más información sobre la gestión de aplicaciones externas:

  • Para Cloud Orchestrator, consulte la documentación oficial.
  • Para Orchestrator local: consulta la documentación oficial.

Solución de problemas del complemento de Jenkins

Si tienes problemas durante la instalación o al actualizar, considera los siguientes escenarios de resolución de problemas.

Error no autorizado

Descripción: error no autorizado.

Remedio:

• Si utiliza la autenticación básica: asegúrese de que la combinación de nombre de usuario y contraseña en el inicio de sesión web sea correcta.

  Si la autenticación federada está habilitada, asegúrese de escribir el nombre de usuario en la tarea como "DOMINIO / usuario"

• Si usa la autenticación de token:

  • Revoque el token desde el panel de acceso a la API y genere uno nuevo.
  • Asegúrate de que el usuario que generó la clave pueda acceder a Orchestrator y tenga una cuenta de usuario en la instancia de Orchestrator.
• Si te autenticas con un Orchestrator local: asegúrate de que el certificado de Orchestrator es válido y que la máquina que ejecuta el trabajo confía en el certificado de Orchestrator en caso de que estés utilizando un certificado autofirmado. Es posible que reciba este error porque el certificado utilizado para Orchestrator no es válido. Esto puede significar que tiene el CN incorrecto u otros problemas de validación.

Error prohibido

Solución: el usuario no tiene permiso para realizar la acción. Asegúrate de que el usuario tenga permisos para leer carpetas, cargar paquetes, crear y actualizar procesos, leer conjuntos de prueba y casos de prueba, leer tareas en segundo plano y crear y ejecutar conjuntos de prueba.

Carpeta / entorno no encontrado

Solución: Asegúrese de que el usuario autenticado utilizado por los complementos de CI / CD tenga los permisos Folders.View y SecondTask.View (solo para la versión 20.4).

El paquete ya existe (conflicto)

Solución: Asegúrese de que el paquete que está intentando implementar no exista ya con la misma versión. Si existe, considere usar el control de versiones automático de paquetes, para que la nueva versión se actualice cada vez que se implemente.

Error al ejecutar el comando (error genérico)

Solución: si el espacio de trabajo de Jenkins está dentro de una ubicación del disco (por ejemplo, C:\Windows or C:\Program Files) para la que el usuario no tiene permisos, asegúrate de que el espacio de trabajo se encuentra en una ruta a la que pueda acceder el usuario.

Jenkins no puede procesar rutas que contengan caracteres no latinos

Solución: Jenkins no puede pasar correctamente los caracteres codificados no estándar al invocar el complemento de UiPath. Los caracteres desconocidos se reemplazarán por ???.

La solución depende de cómo se implemente Jenkins tanto en el servidor como en las máquinas host del agente, pero implica configurar file.encoding en UTF-8 en las opciones de Java :

Ventanas

Al ejecutar Jenkins en Windows como servicio: en el archivo de configuración del servicio, añade los argumentos dentro de la etiqueta. Siga el script de muestra que aparece a continuación.

<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>

Al ejecutar Jenkins dentro de Docker: pasa JAVA_OPTS al contenedor a través --env JAVA_OPTS="...", siguiendo el script de ejemplo a continuación.

docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 jenkins/jenkins:lts

Al ejecutar Jenkins dentro de Tomcat: usa la variable de entorno CATALINA_OPTS. Siga el script de ejemplo a continuación.

export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"

Linux

Cuando se ejecuta en distribuciones de Linux basadas en Debian o Ubuntu: en el archivo de configuración busca el argumento JAVA_ARGSy añade la codificación del archivo. Siga el script de ejemplo a continuación:

JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"

Cuando se ejecute en distribuciones basadas en RedHat: en el archivo de configuración, busque el argumento JENKINS_JAVA_OPctions y añada la codificación del archivo. Siga el script de muestra que aparece a continuación.

JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"