Atualizando o Automação Suite

Atualize o Automation Suite para versões mais recentes no cluster do OpenShift.

Automation Suite consists of multiple components. Both you as a customer and UiPath® share responsibility of these components. For details, refer to Responsibility matrix.

Você é responsável por atualizar:

• Infraestrutura do Kubernetes em que o Automation Suite está 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:

• If you upgrade to Automation Suite 2.2510, you need to bring a PostgreSQL database for AutomationSuite_Airflow and configure the connection string for it in input.json. For details, refer to Process Mining-specific configuration.
• Se você atualizar 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.

For details, refer to Configuring 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.

We recommend archiving or purging data that is no longer needed from high-volume tables before starting the upgrade; for details, refer to Performing database maintenance.

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

1. Check the compatibility matrix to determine the supported versions for each available upgrade scenario. If you brought your own components, make sure the versions of your components are compatible with the version you plan to upgrade to. For details, refer to Compatibility matrix.
2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, refer to Downloading the installation packages.
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 --namespace <uipath>
     

   • 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 --namespace <uipath>
     

4. If you are using an offline setup with an external OCI-compliant registry, you must hydrate the registry with container images and Helm charts before upgrade. For details, refer to Hydrating the registry with the offline bundle.
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. If you upgrade to Automation Suite 2.2510.0 or later from previous Automation Suite 2024.10 versions and have Studio Web enabled, you must also enable Solutions. For details, refer to Enabling or disabling Solutions. Make sure you also review the additional hardware requirements for Solutions. For details, refer to Capacity Planning.

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 --namespace <uipath>
   

   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 --namespace <uipath>
   

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. Desabilite o modo de manutenção:

   uipathctl cluster maintenance disable
   

   Observação:

   Você deve desabilitar o modo de manutenção antes da atualização. O processo de atualização do Automation Suite não é compatível com ter o modo de manutenção habilitado.

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 --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, caso tenha instalado anteriormente esses complementos para o Process Mining ou o Task Mining. Para obter detalhes, consulte as e seções.

Upgrade da infraestrutura do Kubernetes

Observação:

Automation Suite supports upstream N-1 to N-3 versions of Kubernetes irrespective of the cloud provider. For instance, if upstream is 1.27, we support versions 1.26, 1.25, and 1.24. For supported versions, refer to the Compatibility matrix.

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 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.