Jenkins プラグインのトラブルシューティング

インストールまたはアップグレードに関する問題が発生した場合は、以下のトラブルシューティングをお試しください。

キャッシュされた古い uipcli のバージョンに関連する問題

プラットフォーム: 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 マシンである必要があります。

未承認のエラー

説明: 未承認のエラーです。

解決策:

• 基本認証を使用する場合: Web ログインのユーザー名とパスワードの組み合わせが正しいことを確認してください。

  フェデレーション認証が有効化されている場合は、タスクのユーザー名を「DOMAIN\user」と記述してください。

• トークン認証を使用する場合:

  • API アクセス パネルからトークンを取り消し、新しいトークンを生成します。
  • キーを生成したユーザーが Orchestrator にアクセスでき、Orchestrator インスタンス上にユーザー アカウントを持っていることを確認します。
• オンプレミスの Orchestrator に対する認証を行う場合: Orchestrator の証明書が有効であること、および自己署名証明書を使用している場合は、ジョブを実行するマシンが Orchestrator の証明書を信頼していることを確認してください。Orchestrator に使用する証明書が有効でないことが原因で、このエラーが発生することがあります。これは、CN に誤りがある、またはその他の検証の問題があることを意味する可能性があります。

Forbidden エラー

解決策: ユーザーに、その操作を実行する権限がありません。フォルダーの読み取り、パッケージのアップロード、プロセスの作成と更新、テスト セットとテスト ケースの読み取り、バックグラウンド タスクの読み取り、テスト セットの作成と実行の権限がユーザーに付与されていることを確認します。

フォルダー/ロボット グループが見つからない

手順: CI/CD プラグインで使用される認証済みユーザーに、Folders.View 権限と BackgroundTask.View 権限 (v20.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

Jenkins を Tomcat 内で実行する場合: 環境変数 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"