Solución de problemas

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 almacenada en caché internamente no se actualiza, lo que hace que quede una uipcli heredada en caché. Esto hace que la carpeta tools no se encuentre después de la extracción.

Remedy:

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.

Remedy:

• Si utilizas la autenticación básica: asegúrate 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úrate de escribir el nombre de usuario en la tarea como "DOMINIO\usuario"
• Si utilizas 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 en un Orchestrator local: asegúrate de que el certificado de Orchestrator sea válido y de que la máquina que ejecuta el trabajo confíe en el certificado de Orchestrator en caso de que estés utilizando un certificado autofirmado. Es posible que recibas este error debido a que el certificado utilizado para Orchestrator no es válido. Esto podría significar que tiene el CN incorrecto u otros problemas de validación.

Error prohibido

Remedio: 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 pruebas y casos de prueba, leer tareas en segundo plano y crear y ejecutar conjuntos de pruebas.

Carpeta / entorno no encontrado

Remedio: asegúrate de que el usuario autenticado utilizado por los complementos CI/CD tiene los permisos Folders.View y BackgroundTask.View (solo para la versión 20.4).

El paquete ya existe (conflicto)

Remedio: asegúrate de que el paquete que estás intentando implementar no existe con la misma versión. Si existe, considera la posibilidad de utilizar el versionado automático de paquetes, de modo que la nueva versión se actualice cada vez que implementemos.

Error al ejecutar el comando (error genérico)

Remedio: si el espacio de trabajo de Jenkins está dentro de una ubicación en el 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 esté ubicado en una ruta a la que pueda acceder el usuario.

Jenkins no puede procesar rutas que contengan caracteres no latinos

Remedio: 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 establecer 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 el JAVA\_OPTS al contenedor a través de --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 ejecuta en distribuciones basadas en RedHat Linux: en el archivo de configuración, busca el argumento JENKINS\_JAVA\_OPTIONS y añade la codificación del archivo. Sigue el siguiente script de ejemplo.

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