Solução de problemas

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.

Remedy:

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.

Remedy:

• 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, escreva o nome de usuário na tarefa como “DOMAIN\user”
• Se você usar a 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 as permissões para executar a ação. Certifique-se de que o usuário tenha permissões para ler pastas, carregar pacotes, criar e atualizar processos, ler conjuntos de testes e casos de teste, ler tarefas em segundo plano e criar e executar conjuntos de testes.

Pasta/ambiente não encontrado

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

O pacote já existe (conflito)

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

Falha ao executar o comando (erro genérico)

Solução: se o espaço de trabalho do 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 o espaço de trabalho seja colocado em um caminho que pode ser acessado pelo usuário.

Jenkins falha ao processar caminhos contendo caracteres não latinos

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

A solução depende de como o Jenkins é implantado no servidor e nas máquinas do host do agente, mas envolve a configuração de 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 contêiner 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 no RedHat Linux: no arquivo de configuração, procure o argumento JENKINS\_JAVA\_OPTIONS e adicione a codificação do arquivo. Siga o script de exemplo abaixo.

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