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

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 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 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 --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, 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. Certifique-se de copiar o valor de global.userInputs.identity.krb5KeytabSecret para global.kerberosAuthConfig.userKeytab se atender simultaneamente aos seguintes requisitos:

   • 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 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 o Dapr e Desinstalar o Gerenciador de certificados .

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.