Atualização do Automation Suite no EKS/AKS

Importante:

Se você usar o Active Directory (AD) e estiver planejando atualizar para a versão 2023.4.0, é altamente recomendável que você pule diretamente para a versão 2023.4.3, pois 2023.4.0, 2023.4.1 e 2023.4.2 são impactados por um problema do AD.

Automation Suite on AKS/EKS consists of multiple components. Both you as a customer and UiPath share responsibility of these components. For details, see Compatibility matrix.

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:

Há um problema conhecido com a lógica de backup no Automation Suite para AKS/EKS versões 2023.10.0 a 2023.10.7. Especificamente, esse problema exclui o backup dos painéis do Insights. No entanto, é feito o backup de todos os dados históricos com sucesso.

Para incluir os painéis do Insights no backup, você deve reconfigurar a solução de backup usando o script disponível aqui. Este script permite que você reconfigure a solução de backup e crie o backup. Para obter detalhes sobre como executar o comando, consulte esta seção.

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 compatabile with the version you plan to upgrade to. For details, see Compatibility matrix.

2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, see 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
     

   • 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
     

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:

   It is strongly recommended to create a backup of the cluster and the SQL database before upgrading Automation Suite. This is to ensure you can restore the cluster if something goes wrong during the upgrade operation.

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

Upgrading Kubernetes infrastructure

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