Atualizando o Automação Suite

O Automation Suite consiste em vários componentes. Tanto você, como cliente, quanto a UiPath® compartilham a responsabilidade por esses componentes. Para obter detalhes, consulte Matriz de responsabilidade.

Você é responsável por atualizar:

• Infraestrutura do Kubernetes em que o Automation Suite é implantado (OpenShift)
• Os componentes que você escolhe trazer como parte do Automation Suite (por exemplo, Gatekeeper, FluentD etc.)

A UiPath® é responsável por atualizar:

• Serviços da UiPath® (por exemplo, Orchestrator)
• Componentes implantados como parte do Automation Suite (por exemplo, ArgoCD)

Atualização de serviços e componentes da UiPath®

Preparação

Observação:

Se você atualizar para o Automation Suite 2024.10 e desejar usar projetos modernos do Document Understanding, você deve atender aos requisitos adicionais de hardware que especificamos nas Recomendações adicionais do Document Understanding.

Observação:

Se você atualizar para o Automation Suite 2024.10.3 ou superior e quiser a versão mais recente do Airflow, você precisa trazer um banco de dados PostgreSQL para AutomationSuite_Airflow e configurar a string de conexão para ele em input.json.

Consulte Configuração específica do Process Mining para obter detalhes.

Para se preparar para a atualização, siga as seguintes etapas:

1. Verifique a matriz de compatibilidade para determinar as versões suportadas para cada cenário de atualização disponível. Se você trouxe seus próprios componentes, certifique-se de que as versões de seus componentes sejam compatíveis com a versão para a qual você planeja atualizar. Para obter detalhes, consulte Matriz de compatibilidade.
2. Baixe versions.json e uipathctl para a versão para a qual você deseja atualizar em sua máquina de gerenciamento. Para obter instruções de download, consulte Download dos pacotes de instalação.
3. Generate the latest input.json file as follows:
   • Opção A: para obter a revisão mais recente de seu arquivo input.json, execute o seguinte comando:

     uipathctl manifest get-revision

   • Opção B: para listar todos os arquivos input.json anteriores e determinar aquele que você deseja escolher, execute o seguinte comando:

     uipathctl manifest list-revisions

4. Se o Process Mining estiver instalado e você quiser usar a versão mais recente do Airflow, que precisa do PostgreSQL, você deve adicionar ou atualizar o modelo de string de conexão sqlalchemy aplicável para o PostgreSQL no arquivo cluster_config.json antes da atualização: postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>

   Observação:

   Isso se aplica apenas ao Process Mining no Automation Suite 2024.10.3 ou superior.

Execução

Para realizar uma atualização de serviços e do componente da UiPath®, siga os seguintes passos:

1. Confirme se seu cluster está íntegro:

   uipathctl health check

2. Coloque o cluster em modo de manutenção para garantir um backup consistente:

   uipathctl cluster maintenance enable

   Importante:

   Essa operação causa tempo de inatividade e sua automação de negócios é suspensa enquanto o modo de manutenção está habilitado.

3. Verifique se o cluster está em modo de manutenção:

   uipathctl cluster maintenance is-enabled

4. Faça o backup do cluster e do banco de dados SQL, depois verifique se o backup foi concluído com sucesso.
   Importante:

   É altamente recomendável criar um backup do cluster e do banco de dados SQL antes de atualizar o Automation Suite. Isso é para garantir que você possa restaurar o cluster se algo der errado durante a operação de atualização. Isso também é aplicável antes de atualizar sua infraestrutura do Kubernetes.

   Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:

   • você configurou a integração do Active Directory usando nome de usuário e senha
   • you have Windows authentication enabled
   • você não usa autenticação integrada SQL
5. Desabilite o modo de manutenção:

   uipathctl cluster maintenance disable

   Observação: você deve desabilitar o modo de manutenção antes de atualizar. O processo de atualização do Automation Suite não é compatível com a ativação do modo de manutenção.
6. Realize a atualização de serviços e componentes da UiPath®:

   uipathctl cluster upgrade input.json --versions versions.json

   Importante:

   Essa operação causa tempo de inatividade e sua automação de negócios é suspensa durante o processo de atualização. É importante que você realize a atualização apenas durante sua janela de manutenção.

7. Verifique se o cluster está íntegro após a atualização:

   uipathctl health check

   Observação: se você atualizou para o Automation Suite 2024.10.3 ou superior, pode desinstalar o Dapr e o Cert Manager se não tiver habilitado o Task Mining. Para obter mais detalhes, consulte as seções Desinstalar Dapr e Desinstalar Cert Manager .

Upgrade da infraestrutura do Kubernetes

Observação: o Automation Suite é compatível com as versões de upstream N-1 para N-3 do Kubernetes, independentemente do provedor de nuvem. Por exemplo, se o upstream for 1.27, teremos suporte às versões 1.26, 1.25 e 1.24. Para versões compatíveis, consulte a matriz de Compatibilidade.

Você é responsável por atualizar a infraestrutura do Kubernetes que hospeda o Automation Suite. Você deve seguir as práticas padrão de sua empresa para atualizar a infraestrutura do Kubernetes.