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.

Problema relacionado con la versión de uipcli heredada en caché

Plataforma: CloudBees

Descripción: el problema implica la actualización del software CloudBees. Después de actualizar, la versión uipcli en caché internamente no se actualiza, lo que lleva a un legado uipcli restante en caché. Esto hace que la carpeta tools no se encuentre después de la extracción.

Remedio:

Para solucionar este problema, debes forzar la instalación UiPath.CLI.Windows.nupkg o UiPath.CLI.nupkg. Puedes hacerlo utilizando un fragmento similar al del siguiente ejemplo:

UiPathInstallPlatform(
                        cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',
                        cliVersion: 'X_23.10.8753.32995',
                        forceInstall: true,
                        traceLevel: 'Information'
                    )

Ten en cuenta que cliNupkgPath se refiere a la ubicación de la caché uipcli en tu máquina de agente.

Además, en el ejemplo anterior, cliVersion se establece en X_23.10.8753.32995 para forzar UiPathInstallPlatform a extraer de cliNupkgPath, evitando la extracción de una versión heredada de un archivo .jar interno.

Por último, asegúrate de que la versión del complemento uipath-automation-package sea al menos 3.1 (la recomendación es 3.2), y si extraes un windows uipcli, el agente debe ser una máquina de Windows.

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"