Fehlerbehebung beim Jenkins-Plugin

Wenn bei der Installation oder beim Upgrade Probleme auftreten, ziehen Sie die folgenden Problembehandlungsszenarien in Betracht.

Problem im Zusammenhang mit der zwischengespeicherten Uipcli-Legacy-Version

Plattform: CloudBees

Beschreibung: Das Problem betrifft das CloudBees Software-Upgrade. Nach dem Upgrade kann die intern zwischengespeicherte uipcli-Version nicht aktualisiert werden, was dazu führt, dass eine alte uipcli-Version zwischengespeichert bleibt. Dies führt dazu, dass der Ordner tools nach der Extraktion nicht gefunden wird.

Lösung:

Um dieses Problem zu beheben, müssen Sie die Installation von UiPath.CLI.Windows.nupkg oder UiPath.CLI.nupkg erzwingen. Sie können dies mit einem Snippet ähnlich dem im folgenden Beispiel tun:

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

Beachten Sie, dass sich cliNupkgPath auf den Speicherort der zwischengespeicherten uipcli auf Ihrer Agent-Maschine bezieht.

Außerdem wird im obigen Beispiel cliVersion auf X_23.10.8753.32995 gesetzt, um zu erzwingen, dass UiPathInstallPlatform aus cliNupkgPath extrahiert wird, um die Extraktion einer Legacy-Version aus einer internen Datei .jar zu vermeiden.

Stellen Sie schließlich sicher, dass Sie mindestens die Version 3.1 des Plugins uipath-automation-package haben (3.2 wird empfohlen). Wenn Sie ein Windows- uipcli extrahieren, muss der Agent eine Windows-Maschine sein.

Nicht autorisierter Fehler

Beschreibung: Nicht autorisierter Fehler.

Lösung:

• Wenn Sie die Standardauthentifizierung verwenden: Stellen Sie sicher, dass die Kombination aus Benutzername und Kennwort bei der Webanmeldungkorrekt ist.

  Wenn die Verbundauthentifizierung aktiviert ist, stellen Sie sicher, dass Sie den Benutzernamen in der Aufgabe als „DOMAIN\user“ eingeben.

• Wenn Sie die Token-Authentifizierungverwenden:

  • Widerrufen Sie das Token im API-Zugriffsbereich und generieren Sie ein neues.
  • Stellen Sie sicher, dass der Benutzer, der den Schlüssel generiert hat, auf den Orchestrator zugreifen kann und über ein Benutzerkonto auf der Orchestrator-Instanz verfügt.
• Wenn Sie sich bei einem lokalen Orchestrator authentifizieren: Stellen Sie sicher, dass das Orchestrator-Zertifikat gültig ist und dass die Maschine, auf der der Auftrag ausgeführt wird, dem Orchestrator-Zertifikat vertraut, falls Sie ein selbstsigniertes Zertifikat verwenden. Dieser Fehler wird möglicherweise angezeigt, da das für den Orchestrator verwendete Zertifikat nicht gültig ist. Dies kann bedeuten, dass der falsche CN oder andere Validierungsprobleme vorliegen.

Verbotener Fehler

Abhilfe: Der Benutzer hat nicht die Berechtigung zum Ausführen der Aktion. Stellen Sie sicher, dass der Benutzer über Berechtigungen zum Lesen von Ordnern, Hochladen von Paketen, Erstellen und Aktualisieren von Prozessen, Lesen von Testsätzen und Testfällen, Lesen von Hintergrundaufgaben sowie Erstellen und Ausführen von Testsätzen verfügt.

Ordner/Umgebung nicht gefunden

Abhilfe: Stellen Sie sicher, dass der authentifizierte Benutzer, der von CI/CD-Plugins verwendet wird, über die Berechtigungen Folders.View und BackgroundTask.View (nur für 20.4) verfügt.

Paket ist bereits vorhanden (Konflikt)

Lösung: Stellen Sie sicher, dass das Paket, das Sie bereitstellen möchten, nicht bereits mit derselben Version vorhanden ist. Wenn sie vorhanden ist, sollten Sie die automatische Paketversionsverwaltung verwenden, damit die neue Version bei jeder Bereitstellung aktualisiert wird.

Fehler beim Ausführen des Befehls (generischer Fehler)

Abhilfe: Wenn sich der Jenkins-Arbeitsbereich an einem Speicherort auf der Festplatte befindet (z. B. C:\Windows or C:\Program Files ), für den der Benutzer keine Berechtigungen hat, stellen Sie sicher, dass sich der Arbeitsbereich in einem Pfad befindet, auf den der Benutzer zugreifen kann.

Jenkins kann keine Pfade verarbeiten, die nicht-lateinische Zeichen enthalten

Abhilfe: Jenkins kann beim Aufrufen des UiPath-Plugins nicht ordnungsgemäß codierte Zeichen übergeben, die nicht dem Standard entsprechen. Die unbekannten Zeichen werden durch ??? ersetzt.

Die Lösung hängt davon ab, wie Jenkins sowohl auf den Server- als auch auf den Agent-Hostmaschinen bereitgestellt wird, erfordert jedoch das Festlegen von file.encoding auf UTF-8 in Java -Optionen:

Windows

Beim Ausführen von Jenkins unter Windows als Dienst: Fügen Sie in der Dienstkonfigurationsdatei die Argumente innerhalb des Tags hinzu. Folgen Sie dem folgenden Beispielskript.

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

Wenn Sie Jenkins in Docker ausführen: Übergeben Sie JAVA_OPTS über --env JAVA_OPTS="..." an den Container, indem Sie dem folgenden Beispielskript folgen.

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

Beim Ausführen von Jenkins in Tomcat: Verwenden Sie die Umgebungsvariable CATALINA_OPTS . Folgen Sie dem folgenden Beispielskript.

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

Linux

Bei Ausführung auf Debian- oder Ubuntu-basierten Linux-Distributionen: Suchen Sie in der Konfigurationsdatei nach dem Argument JAVA_ARGS und fügen Sie die Dateicodierung hinzu. Folgen Sie dem folgenden Beispielskript:

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

Bei Ausführung auf RedHat Linux-basierten Distributionen: Suchen Sie in der Konfigurationsdatei nach dem Argument JENKINS_JAVA_OPTIONS und fügen Sie die Dateicodierung hinzu. Folgen Sie dem folgenden Beispielskript.

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