Jenkins 插件故障排除

如果遇到安装或升级问题，请考虑以下故障排除方案：

与缓存的旧版 UiPath CLI 版本相关的问题

平台：CloudBees

说明：此问题涉及 CloudBees 软件升级。升级后，内部缓存的 uipcli 版本无法更新，从而导致旧版 uipcli 仍处于缓存状态。这将导致提取后找不到 tools 文件夹。

补救措施：

要解决此问题，您必须强制安装 UiPath.CLI.Windows.nupkg 或 UiPath.CLI.nupkg。您可以使用与以下示例中的代码片段类似的代码片段执行此操作：

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 是指代理计算机上缓存的 uipcli 的位置。

此外，在上面的示例中，将 cliVersion 设置为 X_23.10.8753.32995 以强制 UiPathInstallPlatform 从 cliNupkgPath 中提取，从而避免从内部 .jar 文件中提取旧版。

最后，确保您的 uipath-automation-package 插件版本至少为 3.1（建议为 3.2），如果要提取 Windows uipcli，则代理必须是 Windows 计算机。

未经授权的错误

说明: 未经授权的错误。

补救措施：

• 如果您使用 基本身份验证：确保网页登录名中的用户名-密码组合正确。

  如果启用了联合身份验证，请确保在任务中将用户名写入“DOMAIN\user”

• 如果您使用 令牌身份验证：

  • 从 API 访问面板撤消令牌并生成新令牌。
  • 确保生成密钥的用户可以访问 Orchestrator，并且在 Orchestrator 实例上拥有用户帐户。
• 如果您 针对内部部署的 Orchestrator 进行身份验证：确保 Orchestrator 证书有效，并且运行作业的计算机信任 Orchestrator 证书，以防您使用自签名证书。 由于 Orchestrator 使用的证书无效，您可能会收到此错误。 这可能意味着它存在错误的 CN 或其他验证问题。

禁止的错误

解决方法：用户无权执行该操作。 确保用户有权读取文件夹、上传包、创建和更新流程、读取测试集和测试用例、读取后台任务以及创建和运行测试集。

未找到文件夹/环境

解决方法：确保 CI/CD 插件使用的经过身份验证的用户具有 Folders.View 和 BackgroundTask.View （仅适用于 20.4）权限。

包已存在 (冲突)

解决方法：确保您尝试部署的包不存在具有相同版本的包。 如果存在，请考虑使用自动包版本控制，以便在每次部署时升级新版本。

运行命令失败 (一般错误)

解决方法：如果 Jenkins 工作区位于磁盘上用户无权访问的位置（例如C:\Windows or C:\Program Files ），请确保将工作区放置在用户可以访问的路径上。

Jenkins 无法处理包含非拉丁字符的路径

解决方法：调用 UiPath 插件时，Jenkins 无法正确传递非标准编码字符。 未知字符将替换为??? 。

该解决方案取决于 Jenkins 在服务器和代理主机上的部署方式，但需要在 Java 选项中将file.encoding设置为 UTF-8：

Windows

在 Windows 上作为服务运行 Jenkins 时：在服务配置文件中，在标签内添加参数。 请按照以下示例脚本操作。

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

在 Docker 中运行 Jenkins 时：按照以下示例脚本，通过--env JAVA_OPTS="..."将 JAVA_OPTS 传递给容器。

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

在 Tomcat 中运行 Jenkins 时：使用环境变量CATALINA_OPTS 。 请按照以下示例脚本操作。

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

Linux

在基于 Debian 或 Ubuntu 的 Linux 发行版上运行时：在配置文件中搜索参数JAVA_ARGS ，并添加文件编码。 请按照以下示例脚本操作：

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

在基于 RedHat Linux 的发行版上运行时：在配置文件中搜索参数 JENKINS_JAVA_OPTIONS 并添加文件编码。 请按照以下示例脚本操作。

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