Dépannage du plugin Jenkins

Si vous rencontrez des problèmes d’installation ou de mise à niveau, envisagez les scénarios de résolution de problèmes suivants :

Problème lié à la version uipcli héritée mise en cache

Plate-forme : CloudBees

Description : le problème concerne la mise à niveau du logiciel CloudBees. Après la mise à niveau, la version uipcli mise en cache au niveau interne ne peut pas être mise à jour, ce qui laisse une version uipcli héritée mise en cache. Cela empêche de trouver le dossier tools après l’extraction.

Solution :

Pour résoudre ce problème, vous devez procéder à une installation forcée de UiPath.CLI.Windows.nupkg ou de UiPath.CLI.nupkg. Pour cela, vous pouvez utiliser extrait similaire à celui de l’exemple suivant :

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

Notez que cliNupkgPath fait référence à l’emplacement de la version uipcli mise en cache sur votre machine agent.

Par ailleurs, dans l’exemple ci-dessus, cliVersion est défini sur X_23.10.8753.32995 pour forcer UiPathInstallPlatform à extraire à partir du chemin cliNupkgPath, évitant ainsi l’extraction d’une version héritée à partir d’un fichier .jar interne.

Enfin, veillez à ce que la version de votre plug-in uipath-automation-package soit égale ou supérieure à la version 3.1 (la version 3.2 est recommandée) ; si vous extrayez une uipcli Windows, l’agent doit être une machine Windows.

Erreur non autorisée

Description: erreur non autorisée.

Solution :

• Si vous utilisez l'authentification de base: assurez-vous que la combinaison nom d'utilisateur-mot de passe sur la connexion Web est correcte.

  Si l'authentification fédérée est activée, assurez-vous d'écrire le nom d'utilisateur dans la tâche en tant que « DOMAINE\utilisateur »

• Si vous utilisez l'authentification par jeton:

  • Révoquez le jeton du panneau d'accès à l'API et générez-en un nouveau.
  • Assurez-vous que l'utilisateur qui a généré la clé peut accéder à Orchestrator et dispose d'un compte utilisateur sur l'instance Orchestrator.
• Si vous vous authentifiez par rapport à un Orchestrator sur site: assurez-vous que le certificat Orchestrator est valide et que la machine exécutant la tâche fait confiance au certificat Orchestrator au cas où vous utiliseriez un certificat auto-signé. Vous pouvez recevoir cette erreur car le certificat utilisé pour Orchestrator n'est pas valide. Cela peut signifier qu’il a le mauvais CN ou d’autres problèmes de validation.

Erreur interdite

Remède: l'utilisateur n'a pas l'autorisation d'effectuer l'action. Assurez-vous que l'utilisateur dispose des autorisations pour lire les dossiers, télécharger des packages, créer et mettre à jour des processus, lire des ensembles de tests et des cas de test, lire des tâches en arrière-plan et créer et exécuter des ensembles de tests.

Dossier/environnement introuvable

Solution: assurez-vous que l'utilisateur authentifié utilisé par les plug-ins CI/CD dispose des autorisations Folders.View et BackgroundTask.View (uniquement pour la version 20.4).

Le package existe déjà (conflit)

Solution: assurez-vous que le package que vous essayez de déployer n'existe pas déjà avec la même version. S'il existe, envisagez d'utiliser la gestion automatique des versions de package, afin que la nouvelle version soit augmentée à chaque déploiement.

Échec de l'exécution de la commande (erreur générique)

Solution: si l'espace de travail Jenkins se trouve à un emplacement du disque (par exemple, C:\Windows or C:\Program Files ) pour lequel l'utilisateur ne dispose pas d'autorisations, assurez-vous que l'espace de travail est placé sur un chemin accessible par l'utilisateur.

Jenkins ne parvient pas à traiter les chemins contenant des caractères non latins

Remède: Jenkins n’est pas en mesure de transmettre correctement les caractères encodés non standard lors de l’invocation du plugin UiPath. Les caractères inconnus seront remplacés par ??? .

La solution dépend de la façon dont Jenkins est déployé à la fois sur les machines hôtes du serveur et de l'agent, mais implique de définir file.encoding sur UTF-8 dans les options Java :

Windows

Lors de l'exécution de Jenkins sous Windows en tant que service : dans le fichier de configuration du service, ajoutez les arguments à l'intérieur de la balise. Suivez l'exemple de script ci-dessous.

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

Lors de l'exécution de Jenkins dans Docker : transmettez JAVA_OPTS au conteneur via --env JAVA_OPTS="..." , en suivant l'exemple de script ci-dessous.

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

Lors de l'exécution de Jenkins dans Tomcat : utilisez la variable d'environnement CATALINA_OPTS . Suivez l'exemple de script ci-dessous.

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

Linux

Lors de l'exécution sur des distributions Linux basées sur Debian ou Ubuntu : dans le fichier de configuration, recherchez l'argument JAVA_ARGS et ajoutez l'encodage du fichier. Suivez l'exemple de script ci-dessous :

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

Lors de l'exécution sur des distributions RedHat basées sur Linux : dans le fichier de configuration, recherchez l'argument JENKINS_JAVA_OPTIONS et ajoutez l'encodage du fichier. Suivez l'exemple de script ci-dessous.

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