UiPath Documentation
cicd-integrations
2023.4
false
Guia do usuário de integrações de CI/CD
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

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.

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'
                    )
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:

  • If you use basic authentication: make sure that the username-password combination on the web login is correct.

    Se a autenticação federada estiver habilitada, certifique-se de escrever 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>
<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>

When running Jenkins inside Docker: pass the JAVA_OPTS to the container via --env JAVA_OPTS="...", following the example script below.

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
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"
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"
JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"

When running on RedHat Linux-based distributions: in the configuration file search for the argument JENKINS_JAVA_OPTIONS and add the file encoding. Follow the sample script below.

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

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte(opens in new window)

Quer aprender? Academia UiPath(opens in new window)

Tem perguntas? Fórum do UiPath(opens in new window)

Fique por dentro das novidades