Solução de problemas do plug-in Jenkins

Se você encontrar problemas de instalação ou atualização, considere os seguintes cenários para a solução dos problemas.

Problema relacionado à versão uipcli legada em cache

Plataforma: CloudBees

Descrição: o problema envolve a atualização de software do CloudBees. Depois de atualizar, a versão uipcli armazenada em cache internamente não é atualizada, fazendo com que um uipcli legado permaneça em cache. Isso faz com que a pasta tools não seja encontrada após a extração.

Soluções de problemas:

Para corrigir esse problema, você deve forçar a instalação de UiPath.CLI.Windows.nupkg ou UiPath.CLI.nupkg. Você pode fazer isso usando um fragmento semelhante ao do exemplo a seguir:

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

Observe que cliNupkgPath se refere ao local do uipcli em cache na sua máquina de agentes.

Além disso, no exemplo acima, cliVersion é definido como X_23.10.8753.32995 para forçar UiPathInstallPlatform a extrair de cliNupkgPath, evitando a extração de uma versão legada de um arquivo .jar interno.

Por fim, certifique-se de que sua versão do plug-in uipath-automation-package seja pelo menos 3.1 (a recomendação é 3.2) e, se você estiver extraindo um uipcli Windows, o agente deve ser uma máquina do Windows.

erro não autorizado

Descrição: Erro não autorizado.

Soluções de problemas:

• Se você usar autenticação básica: certifique-se de que a combinação de nome de usuário e senha no login da web esteja correta.

  Se a autenticação federada estiver habilitada, certifique-se de escrever o nome de usuário na tarefa como “DOMAIN\user”

• Se você usar autenticação de token:

  • Revogue o token do painel de acesso à API e gere um novo.
  • Certifique-se de que o usuário que gerou a chave possa acessar o Orchestrator e tenha uma conta de usuário na instância do Orchestrator
• Se você se autenticar em um On-Premise Orchestrator: verifique se o certificado do Orchestrator é válido e se a máquina que está executa o trabalho confia no certificado do Orchestrator caso você esteja usando um certificado autoassinado. Você pode receber esse erro porque o certificado usado para o Orchestrator não é válido. Isso pode significar que ele tem o CN errado ou outros problemas de validação.

erro proibido

Solução: o usuário não tem permissão para executar a ação. Certifique-se de que o usuário tenha permissões para ler pastas, fazer upload de pacotes, criar e atualizar processos, ler conjuntos de teste e casos de teste, ler tarefas em segundo plano e criar e executar conjuntos de teste.

Pasta/ambiente não encontrado

Solução: Certifique-se de que o usuário autenticado usado pelos plug-ins CI/CD tenha as permissões Folders.View e BackgroundTask.View (somente para 20.4).

O pacote já existe (conflito)

Solução: certifique-se de que o pacote que você está tentando implantar não exista com a mesma versão. Se existir, considere o uso do controle de versão automático do pacote, para que a nova versão seja aprimorada toda vez que implantarmos.

Falha ao executar o comando (erro genérico)

Solução: Se a área de trabalho Jenkins estiver dentro de um local no disco (por exemplo, C:\Windows or C:\Program Files) para o qual o usuário não tem permissões, certifique-se de que a área de trabalho seja colocada em um caminho que possa ser acessado pelo usuário.

Jenkins falha ao processar caminhos contendo caracteres não latinos

Solução: Jenkins não é capaz de transmitir corretamente caracteres codificados fora do padrão ao invocar o plug-in UiPath. Os caracteres desconhecidos serão substituídos por ???.

A solução depende de como o Jenkins é implantado no servidor e nas máquinas host do agente, mas envolve definir file.encoding como UTF-8 nas opções Java :

Windows

Ao executar o Jenkins no Windows como um serviço: no arquivo de configuração do serviço, adicione os argumentos dentro da tag. Siga o exemplo de script abaixo.

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

Ao executar o Jenkins dentro do Docker: passe o JAVA_OPTS para o container via --env JAVA_OPTS="...", seguindo o script de exemplo abaixo.

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

Ao executar o Jenkins dentro do Tomcat: use a variável de ambiente CATALINA_OPTS. Siga o exemplo de script abaixo.

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

Linux

Ao executar em distribuições Linux baseadas em Debian ou Ubuntu: no arquivo de configuração, procure o argumento JAVA_ARGSe adicione a codificação do arquivo. Siga o exemplo de script abaixo:

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

Ao executar em distribuições baseadas em RedHat Linux: no arquivo de configuração, procure o argumento JENKINS_JAVA_OPTIONS e adicione a codificação do arquivo. Siga o exemplo de script abaixo.

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