- Notes de publication
- Introduction
- Gouvernance
- Contrôle de code source
- Pipelines CI/CD
- Gestion des flux
- Journalisation
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 :
Plate-forme : CloudBees
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 :
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'
)
UiPathInstallPlatform(
cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',
cliVersion: 'X_23.10.8753.32995',
forceInstall: true,
traceLevel: 'Information'
)
cliNupkgPath
fait référence à l’emplacement de la version uipcli
mise en cache sur votre machine agent.
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.
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.
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.
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.
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).
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.
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.
???
.
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>
<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>
--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
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
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"
export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"
Linux
JAVA_ARGS
et ajoutez l'encodage du fichier. Suivez l'exemple de script ci-dessous :
JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"
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"
JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"