Atualizando o Automação Suite

Execute atualizações de versões principais e secundárias do Automation Suite no EKS/AKS.

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 na qual o Automation Suite está implantado (AKS ou EKS)
• 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 2.2510, você precisa trazer um banco de dados PostgreSQL para AutomationSuite_Airflow e configurar a string de conexão para ele em input.json. Para obter detalhes, consulte Configuração específica do Process Mining.
• Se você atualizar a partir de versões anteriores à 2.2510.0 usando o Studio Web, certifique-se de usar o mesmo nome de classe de armazenamento especificado em storage_class_single_replica, para oferecer suporte ao modo de acesso RWX. Para obter detalhes, consulte Configuração do input.json.

Além disso, revise as seguintes orientações de manutenção do banco de dados antes de iniciar a atualização.

Importante:

Tabelas de banco de dados do Automation Suite muito grandes podem fazer com que os trabalhos de migração de banco de dados demorem muito mais ou falhem na conclusão durante a atualização. Manter as tabelas de banco de dados bem mantidas reduz esse risco.

Recomendamos arquivar ou remover dados que não são mais necessários das tabelas de alto volume antes de iniciar a atualização; para obter detalhes, consulte Executando a manutenção do banco de dados.

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 você estiver usando uma configuração offline com um registro externo compatível com OCI, você deve hidratar o registro com imagens de contêiner e gráficos do Helm antes da atualização. Para obter detalhes, consulte Hidratar o registro com o pacote offline.

5. 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 input.json antes da atualização: postgresql_connection_string_template_sqlalchemy_pyodbc.

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

6. Se o Integration Service estiver instalado, certifique-se de que suas filas de nuvem externas (SQS) estejam sincronizadas e que a replicação entre regiões esteja habilitada. Por exemplo:

   • No Azure Queue Storage, configure as opções de redundância GRS/RA-GRS ou GZRS/RA-GZRS. Para obter detalhes, consulte:
     • Redundância de dados no Azure Storage
     • Confiabilidade no Armazenamento de Filas do Azure
     • Orientação de design com redundância geográfica
   • No Amazon SQS, crie filas do SQS em cada região e replicar mensagens usando a lógica de Administrador ou personalizada do SNS. Para obter detalhes, consulte:
     • Amazon SQS - Recuperação de desastres ativa/ativa
     • Entrega de mensagens entre regiões do SNS

7. Se você atualizar para o Automation Suite 2.2510.0 ou posterior do Automation Suite 2024.10 e tiver o Studio Web habilitado, você também deve habilitar Soluções. Para obter detalhes, consulte Habilitar ou desabilitar Soluções. Certifique-se de revisar também os requisitos de hardware adicionais para Soluções. Para obter detalhes, consulte Planejamento de capacidade.

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 --namespace <uipath> --versions versions.json
   

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 e, em seguida, verifique se o backup foi concluído com sucesso. Crie um backup também antes de atualizar sua infraestrutura do Kubernetes.

   Se você atender simultaneamente aos seguintes requisitos, certifique-se de copiar o valor de global.userInputs.identity.krb5KeytabSecret para global.kerberosAuthConfig.userKeytab:

   • 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. A partir do Automation Suite 2.2510.2, o modo de manutenção deve permanecer habilitado durante a atualização. Para versões anteriores ao Automation Suite 2.2510.2, desabilite o modo de manutenção antes de realizar a atualização:

   uipathctl cluster maintenance disable
   

   Observação:

   Se você estiver atualizando para o Automation Suite 2.2510.2 ou posterior, pule esta etapa e desabilite o modo de manutenção apenas depois que a atualização for concluída.

6. Realize a atualização de serviços e componentes da UiPath®:

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

   No Automation Suite Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'. , o comando falha com o seguinte erro quando o modo de manutenção está desabilitado: uipathctl cluster upgrade

   Para evitar a mensagem de erro, use o seguinte comando para realizar a atualização. Certifique-se de ter criado todos os backups necessários antes de prosseguir.

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

   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. A partir do Automation Suite 2.2510.2, desabilite o modo de manutenção:

   uipathctl cluster maintenance disable
   

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

   uipathctl health check --namespace <uipath> --versions versions.json
   

   Observação:

   Se você atualizou para o Automation Suite 2.2510 ou superior, pode desinstalar o Dapr e o Cert Manager, se você tiver instalado esses complementos anteriormente para o Process Mining ou o Task Mining. Para obter detalhes, consulte as seções Desinstalar Dapr e Desinstalar o 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.

Realização de operações pós-atualização

Os cenários a seguir descrevem quais operações pós-atualização são necessárias para seu ambiente:

• Se você atualizou para o Automation Suite 2.2510.0 ou superior e o Process Mining ou o Task Mining estava habilitado na versão anterior:

  • Desinstale o Dapr. Para obter detalhes, consulte Como desinstalar o Dapr.
  • Desinstale o Gerenciador de certificados. Para obter detalhes, consulte Como desinstalar o Certificado Manager.

• Se você atualizou para o Automation Suite 2.2510.0 ou mais recente, deve reativar imediatamente suas licenças existentes para cada organização e host:

  • Ativação online: reative diretamente após a atualização.
  • Ativação offline: gere um novo arquivo de carga de ativação a partir da instância do Automation Suite e, em seguida, carregue-o em Ativação.

  A reutilização de arquivos de ativação antigos não é permitida e resultará em uma licença inválida. A reativação da licença deve ser realizada usando o botão Atualizar Licença . Não desative manualmente e, em seguida, reative a licença, pois isso desabilita os serviços.