Execução da atualização

Execute uma atualização de cluster do Automation Suite, incluindo o modo de manutenção, etapas de backup e processo de atualização.

Importante:

Para executar uma atualização do Automation Suite, você deve colocar o cluster no modo de manutenção. O modo de manutenção causa tempo de inatividade durante todo o processo de atualização, e a automação empresarial está suspensa durante esse tempo. É altamente recomendável criar um backup do cluster e do banco de dados SQL antes da atualização. Isso é para garantir que você possa restaurar o cluster se algo der errado durante a operação de atualização.

Para executar a atualização, você deve seguir as seguintes etapas:

1. Execute as verificações de pré-requisitos.
2. Configure o backup.
3. Desabilite o backup.
4. Coloque o cluster no modo de manutenção.
5. Migre cargas de trabalho do Longhorn, dados do MongoDB e Ceph para implantação baseada no Helm.
6. Atualize o Kubernetes e outros componentes de infraestrutura.
7. Atualize os componentes compartilhados e os serviços UiPath®.

Execução das verificações de pré-requisitos

Você deve verificar se todos os requisitos de atualização são atendidos antes de colocar o cluster no modo de manutenção.

1. Execute as verificações de pré-requisitos de infraestrutura, usando o seguinte comando:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json
   

2. Execute as verificações de pré-requisitos de componentes e serviços compartilhados, usando o seguinte comando:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json
   

Observação:

Se sua versão atual do Automation Suite usar um FQDN maiúsculo, as verificações de pré-requisitos falharão com uma mensagem solicitando que você alterne para um FQDN em minúsculas. Nesse caso, atualize o FQDN para letras minúsculas antes de prosseguir com a atualização. Para obter instruções, consulte Configuração da pós-instalação do FQDN.

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

1. Certifique-se de que você habilitou o backup no cluster. Você deve criar o backup usando a mesma versão do instalador usada para a implantação atual.

   Para obter detalhes, consulte a documentação de backup e restauração correspondente à versão do Automation Suite que você planeja atualizar. Por exemplo, para atualizar o Automation Suite 2023.4, consulte o guia 2023.4.

2. Conecte-se a um dos nós do servidor via SSH.

3. Verifique se todos os volumes desejados têm backups no cluster:

   • Se você atualizar a partir da 2022.4 ou mais antiga, execute o seguinte comando:

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
     

   • Se você atualizar a partir da 2022.10 ou mais recente, execute o seguinte comando:

     ./configureUiPathAS.sh snapshot list
     

   • Se você atualizar a partir da 2024.10 ou mais recente, execute o seguinte comando:

     ./bin/uipathctl snapshot list
     

Observação:

O backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique o backup dos volumes novamente.

Após a criação do backup, continue com as próximas etapas.

Observação:

Certifique-se de usar o comando uipathctl do diretório de versão de destino ao atualizar a partir da versão 23.10.0 ou posterior.

Disabling the backup

Antes de colocar o cluster no modo de manutenção, você deve desabilitar o backup para evitar o backup do cluster em um estado abaixo do ideal. Para obter detalhes, consulte Desabilitar o backup de instantâneo.

Putting the cluster in maintenance mode

Colocar o cluster no modo de manutenção encerra o controlador de ingresso e todos os serviços da UiPath®, bloqueando todo o tráfego de entrada para o cluster do Automation Suite.

1. Para colocar o cluster no modo de manutenção, execute:

   ./bin/uipathctl cluster maintenance enable
   

2. Para verificar se o cluster está no modo de manutenção, execute:

   ./bin/uipathctl cluster maintenance is-enabled
   

Realização de operações de migração pré-atualização

Execute o seguinte comando pré-atualização obrigatório:

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

Este comando migra seletivamente cargas de trabalho do Longhorn para PV local, dados do MongoDB para SQL e migra a implantação Ceph de ArgoCD para uma implantação baseada em Helm.

Updating Kubernetes and other infrastructure components

Para atualizar o Kubernetes e os outros componentes de infraestrutura, execute o seguinte comando no nó do servidor primário:

Importante:

Certifique-se de atualizar o arquivo cluster_config.json gerado conforme descrito em Atualização da configuração do cluster.

Observação:

Como o Task Mining não está mais disponível a partir do Automation Suite 2.2510.0, se você tiver um nó de Task Mining dedicado, poderá removê-lo do cluster seguindo as instruções em Remoção de um nó do cluster.

Se você quiser reutilizar o nó no Automation Suite, você pode remover a contaminações executando o seguinte comando:

kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

Observação:

• Executar o comando anterior no nó do servidor primário copia o instalador e cluster_config.json para o local padrão /opt/UiPathAutomationSuite/<version>/installer e atualiza a infraestrutura em todas as máquinas.

• O local padrão /opt/UiPathAutomationSuite/<version> deve ter pelo menos 5 GB disponíveis em todos os nós.

• Para alterar o local padrão, atualize a seguinte variável de ambiente com o local desejado. Certifique-se de que o local esteja disponível em todos os nós e tenha as permissões necessárias para executar a atualização.

  export INSTALLER_DIRECTORY=/path/to/copy/installer
  

• Após executar o comando anterior e executar a atualização, o instalador é copiado para o local /path/to/copy/installer/<version>/installer. version é substituído pela versão do instalador que você executar.

Solução de problemas

• Os logs de atualização no servidor primário estão disponíveis no local padrão /opt/UiPathAutomationSuite/latest/installer/upgrade-logs, a menos que você use explicitamente um local personalizado para o instalador.
• Em todos os outros nós, os logs estão disponíveis no local padrão /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs, a menos que você tenha alterado explicitamente esse local por meio da variável INSTALLER_DIRECTORY.

Atualizar os componentes compartilhados e os serviços da UiPath®

1. Se você tiver o Insights habilitado, você deve executar o seguinte comando para garantir que os dados do Insights persistam após a atualização:

   kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -
   

   Observação:

   A execução deste comando não terá nenhum impacto negativo se o Insights não estiver habilitado.

2. Para atualizar os componentes compartilhados e os serviços de produtos da UiPath®, execute o seguinte comando no nó do servidor primário:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
   

   Importante:

   Após concluir a atualização, o modo de manutenção será desabilitado automaticamente.

3. Para verificar se o Automation Suite está íntegro, execute um dos seguintes comandos:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check
   

   Observação:

   Se você não puder encontrar helm-charts.json, você pode usar versions.json. Para baixar versions.json, consulte Download dos pacotes de instalação.

Depois de concluir a atualização, execute a atividade de limpeza e migração aplicável a você.