Atualizando o Automação Suite

Importante:

• A partir do Automation Suite 2025.10, Os backups baseados em servidor NFS não serão compatíveis se você estiver usando um objectstore externo. Seus backups serão armazenados diretamente no objectstore externo. Se você estiver atualizando para a 2025.10, é incentivado a alternar para o objectstore externo para backups.

  Saiba mais sobre Como configurar o objectstore externo ou entre em contato com o suporte.

• O Automation Suite 2023.4.5 e 2023.10.2 incluem uma atualização para o Kubernetes 1.26.11. Dessa forma, ao atualizar o Automation Suite, você deve certificar-se de não fazer o downgrade do Kubernetes. Para fazer isso, ao migrar do Automation Suite 2023.4.5 ou de uma versão menor posterior para a próxima versão principal, você deve fazer atualização para a versão 2023.10.2 no mínimo.

• Para os caminhos de atualização disponíveis, consulte Caminhos de atualização do Automation Suite.

• Se você planeja atualizar a partir do Automation Suite 2022.10 ou anterior e o Process Mining estiver habilitado, deverá migrar aplicativos de processos para o novo layout de gráfico do processo antes de iniciar a atualização.

• Se você atualizar de uma versão do Automation Suite instalada em uma máquina com FIPS 140-2 desabilitado, poderá habilitar o FIPS 140-2 seguindo as instruções em Segurança e conformidade.

• Você não pode habilitar ou desabilitar nenhum produto durante uma atualização do Automation Suite.

• Se você atualizar para o Automation Suite 2024.10 e desejar usar projetos modernos do Document Understanding, você deve atender aos requisitos adicionais de hardware que especificamos nas Recomendações adicionais do Document Understanding.

Requisitos

• Certifique-se de atender aos requisitos de hardware e software para a nova versão do Automation Suite. Se o AI Center estiver habilitado, certifique-se de atender aos requisitos do CUDA.

• Certifique-se de seguir as práticas recomendadas de atualização do Automation Suite e execute o processo de atualização que melhor se adeque às suas necessidades.

Processo de atualização

O Automation Suite oferece suporte a dois processos de atualização:

• Atualização no local

• Atualização lado a lado

Processo de atualização no local

O processo de atualização no local do Automation Suite permite migrar para uma nova versão do Automation Suite mantendo suas configurações e dados intactos no mesmo hardware.

• No processo de atualização no local, primeiro você atualiza o Kubernetes e outros componentes de infraestrutura sequencialmente para a versão de destino.

• Após as atualizações do Kubernetes e de outros componentes de infraestrutura, você deve desinstalar a versão atual e instalar a versão de destino de componentes compartilhados e produtos da UiPath®.

• Em caso de falha de hardware sem recuperação durante o processo de atualização, é necessário reverter para a versão anterior usando o recurso de backup e restauração.

Atualização lado a lado

A atualização lado a lado do Automation Suite se beneficia de uma experiência de atualização corporativa, que geralmente é chamada de azul-verde e é um processo padrão em todo o setor.

• A atualização lado a lado permite que você execute uma atualização com segurança usando um ambiente paralelo em vez de atualizar no local.

• Este método permite que os administradores alterem o tráfego do cluster antigo do Automation Suite (ou seja, a implantação azul) para o novo cluster do Automation Suite (ou seja, a implantação verde) após verificar a nova implantação. Se você detectar um problema, poderá reverter rapidamente para a implantação antiga.

Mecanismo e recursos de atualização

Recursos	Mecanismo de atualização
	Atualização no local	Atualização lado a lado
Atualização para uma nova versão LTS
Atualizar a partir de qualquer versão suportada	1	2
Migração de dados de alta fidelidade		3
Nenhum tempo de inatividade durante a atualização
Reversão instantânea
Sem requisitos de hardware adicionais		4

<sup class="ph sup">1 Você pode atualizar a partir de qualquer versão do Automation Suite, mas uma atualização intermediária entre suas versões inicial e de destino pode ser necessária. Para obter detalhes, consulte Caminhos de atualização locais.

² Você pode atualizar a partir de qualquer versão do Automation Suite, exceto 2021.10. Para obter detalhes, consulte Caminhos de atualização lado a lado.

³ Para obter detalhes, consulte Migração de dados e responsabilidades.

⁴ Atualizações lado a lado exigem hardware adicional. Você pode trazer um ambiente paralelo com as mesmas especificações que o cluster de origem ou começar com o hardware necessário para um cluster de nó único e ir escalando-o.

Caminhos de atualização no local

A matriz a seguir mostra os caminhos de atualização no local disponíveis para as versões do Automation Suite:

• - está disponível um percurso direto de atualização no local entre versões principais;

• - é necessária uma atualização intermediária no local entre suas versões inicial e de destino.

  Observação: se você precisar atualizar para uma versão intermediária, poderá usar a versão intermediária como versão base para continuar atualizando ao longo do caminho de atualização.

Os caminhos de atualização no local são específicos do Automation Suite no Linux. Para o Automation Suite no EKS/AKS, por um lado, você deve manter a compatibilidade com o Kubernetes. Para o Automation Suite no OpenShift, por outro lado, você deve manter a compatibilidade com o OpenShift.

Observação:

Recomendamos fortemente que você atualize para a versão menor mais recente do Automation Suite. Isso permite que você aproveite os aprimoramentos mais recentes e garante a operação perfeita de todos os componentes internos.

Versão inicial	Automation Suite na versão direcionada do Linux
	2022.10.x	2023.4.x	2023.10.x	2024.10.x
2021.10.x	2021.10.x → 2022.10.9 → 2022.10.10 → 2022.10.12 → 2022.10.15 ou posterior	2021.10.x → 2022.10.9 → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.12	2021.10.x → 2022.10.9 → 2023.10.2 → 2023.10.4 → 2023.10.7 → 2023.10.9 → 2023.10.10	2021.10.x → 2022.10.9 → 2023.10.2 → 2024.10.3 → 2024.10.4 ou posterior
2022.4.x	(2022.4.0 - 2022.4.6) → 2022.10.9 → 2022.10.10 → 2022.10.12 → 2022.10.15 ou posterior (2022.4.7 — 2022.4.11) → 2022.10.10 → 2022.10.12 → 2022.10.15 ou posterior (2022.4.12 - 2022.4.13) → 22.10.13 → 22.10.15 (2022.4.14 - 2022.4.15) → 2022.10.13 → 2022.10.15	(2022.4.0 - 2022.4.6) → 2022.10.9 → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.12 (2022.4.7 - 2022.4.11) → 2022.10.10 → 2023.4.7 → 2023.4.10 → 2023.4.12 (2022.4.12 - 2022.4.13) → 2022.10.13 → (2023.4.8 - 2023.4.10) → 2023.4.12 2022.4.15 → 2022.10.13 → 2023.4.10 → 2023.4.12	Requer 2022.4.7 no mínimo com Ceph em dispositivos raw e a conclusão da migração do Cilium antes de iniciar a atualização. (2022.4.7 - 2022.4.11) → 2023.10.3 → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 (2022.4.12 - 2022.4.13) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 (2022.4.14 - 2022.4.15) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10	Requer 2022.4.7 no mínimo com Ceph em dispositivos raw e a conclusão da migração do Cilium antes de iniciar a atualização. (2022.4.7 - 2022.4.10) → 2023.10.3 → 2024.10.3 → 2024.10.4 ou posterior (2022.4.11 - 2022.4.15) → 2024.10.3 → 2024.10.4 ou posterior
2022.10.x	(2022.10.0 — 2022.10.9) → 2022.10.10 (2022.10.10 — 2022.10.11) → 2022.10.13 → 2022.10.15 (2022.10.12 - 2022.10.13) → 2022.10.15	(2022.10.0 — 2022.10.9) → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.12 (2022.10.10 — 2022.10.11) → 2023.4.7 → 2023.4.10 → 2023.4.12 (2022.10.12 - 2022.10.13) → 2023.4.10 → 2023.4.12 2022.10.14 → 2023.4.12	(2022.10.0 — 2022.10.9) → 2023.10.2 → (2023.10.4 - 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 (2022.10.10 — 2022.10.11) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 (2022.10.12 - 2022.10.13) → 2023.10.7 → 2023.10.9 → 2023.10.10 2022.10.14 → 2023.10.9 → 2023.10.10	(2022.10.0 — 2022.10.9) → 2023.10.2 → 2024.10.3 → 2024.10.4 ou posterior (2022.10.10 — 2022.10.11) → 2024.10.3 → 2024.10.4 ou posterior (2022.10.12 - 2022.10.14) → 2024.10.0 ou posterior
2023.4.x	N/A	(2023.4.0 — 2023.4.4) → 2023.4.5 (2023.4.5 — 2023.4.6) → (2023.4.7 — 2023.4.8) → (2023.4.9 — 2023.4.10) → 2023.4.12 2023.4.11 → 2023.4.12	(2023.4.0 — 2023.4.4) → 2023.10.2 → (2023.10.4 — 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 (2023.4.5 - 2023.4.6) → (2023.10.4 - 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 (2023.4.7 - 2023.4.8) → 2023.10.7 → 2023.10.9 → 2023.10.10 (2023.4.9 - 2023.4.10) → 2023.10.7 → 2023.10.9 → 2023.10.10 (2023.4.11 - 2023.4.12) → 2023.10.10	(2023.4.0 e 2023.4.4) → 2023.10.2 → 2024.10.3 → 2024.10.4 ou posterior (2023.4.5 - 2023.4.6) → 2024.10.3 → 2024.10.4 ou posterior (2023.4.7 — 2023.4.12) → 2024.10.4
2023.10.x	N/A	N/A	(2023.10.0 — 2023.10.3) → (2023.10.4 - 2023.10.5) → (2023.10.6 - 2023.10.7) → (2023.10.8 - 2023.10.9) → 2023.10.10	(2023.10.0 — 2023.10.1) → (2023.10.2 - 2023.10.3) → 2024.10.3 → 2024.10.4 ou posterior (2023.10.4 — 2023.10.9) → 2024.10.4
2024.10.x	N/A	N/A	N/A	Qualquer atualização direta é suportada.

Observação:

• Em alguns casos, a atualização do Automation Suite requer a transição por meio de uma versão intermediária ou ignorar totalmente algumas versões para manter o bom funcionamento dos componentes internos. Não seguir as diretrizes de atualização na tabela anterior pode levar a um downgrade de componente interno ou uma atualização de componente interno malsucedida, fazendo com que a atualização do Automation Suite falhe.

• Se você planeja atualizar a partir do Automation Suite 2022.10 ou anterior e o Process Mining estiver habilitado, deverá migrar aplicativos de processos para o novo layout de gráfico do processo antes de iniciar a atualização.

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

• Apenas as atualizações para o Automation Suite 2023.10 e posterior se beneficiam do processo de atualização simplificado.

Percursos de atualização lado a lado

A matriz a seguir mostra os percursos de atualização lado a lado disponíveis para as versões do Automation Suite:

• - um percurso de atualização lado a lado direta entre versões está disponível;
• - não é possível atualizar lado a lado entre suas versões inicial e de destino.

Observação:

Recomendamos fortemente que você atualize para a versão menor mais recente do Automation Suite. Isso permite que você aproveite os aprimoramentos mais recentes e garante a operação perfeita de todos os componentes internos.

Versão inicial	Versão de destino
	2021.10.x	2022.4.x	2022.10.x	2023.4.x	2023.10.x	2024.10.x
2021.10.x
2022.4.x	N/A
2022.10.x	N/A	N/A
2023.4.x	N/A	N/A	N/A
2023.10.x	N/A	N/A	N/A	N/A
2024.10.x	N/A	N/A	N/A	N/A

Práticas recomendadas para atualização

Se você puder trazer um ambiente adicional para realizar a atualização, recomendamos escolher o percurso de atualização lado a lado, pois fornece uma abordagem de atualização mais segura e reversão instantânea.

Se não puder trazer um ambiente adicional para realizar a atualização, é possível optar pela atualização no local. Certifique-se de seguir as práticas recomendadas de validação de atualização.

Práticas recomendadas de validação de atualização

Ambientes

Recomendamos preparar dois ambientes semelhantes do Automation Suite, independentemente de você desejar usar a atualização no local ou lado a lado:

• Cluster de vários nós do Automation Suite para desenvolvimento ou controle de qualidade

  Observação: o ambiente de desenvolvimento/controle de qualidade não precisa estar online o tempo todo se não for usado para outra tarefa que não a validação de atualização.

• Cluster de vários nós do Automation Suite para produção

Backup

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.

O backup dos dados do cluster é feito no servidor NFS. Certifique-se de ter configurado o servidor NFS antes de prosseguir.

Autenticação

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;

• Você tem a autenticação do Windows habilitada;

• Você não usa a autenticação integrada do SQL.

Práticas recomendadas de validação de automação

Para validar as automações que construiu, crie organizações ou tenants separados diretamente em seu ambiente de produção do Automation Suite, que é a solução com o melhor custo-benefício. Para conhecer mais práticas recomendadas, consulte Orchestrator — Melhores práticas de automação.

Validação da versão

Para validar suas automações em diferentes ambientes e versões, faça uso de seu segundo cluster do Automation Suite após instalar o novo cluster do Automation Suite, mas antes de transicionar o tráfego para o novo cluster em produção.

Licenciamento

A atualização para uma nova versão do Automation Suite não requer uma licença adicional, independentemente do caminho de atualização escolhido. No entanto, se você seguir nossas práticas recomendadas e usar dois clusters do Automation Suite (um para controle de qualidade/dev e outro para produção), você precisará de uma licença por cluster.