Migração entre clusters do Automation Suite

Sobre a migração do cluster

Você pode migrar de um cluster do Automation Suite para outro se usar o namespace uipath em vez de um namespace personalizado e quiser mudar de uma versão do Automation Suite para outra. Os seguintes cenários são suportados:

• Migrar do Automation Suite no Linux para uma nova instalação do Automation Suite no EKS/AKS;
• Migração do Automation Suite no EKS/AKS para uma nova instalação do Automation Suite no OpenShift;
• Migrar do Automation Suite no OpenShift para uma nova instalação do Automation Suite no EKS/AKS;
• Migre do Automation Suite no EKS para o Automation Suite no AKS ou do Automation Suite no AKS para o Automation Suite no EKS.

Observe que você pode tentar executar a operação de migração várias vezes sem impacto em seu cluster existente.

Os seguintes cenários de migração não são compatíveis:

• Migração do Automation Suite no Linux para uma instalação existente do Automation no EKS/AKS ou Automation Suite no OpenShift;
• Migrando um Automation Suite no cluster do OpenShift para o Automation Suite no cluster do Linux.

Visão geral do processo

A tabela a seguir fornece uma visão geral do processo de migração do cluster.

Etapa	Description
1.	Obrigatório . Certifique-se de atender aos requisitos de migração. Requisitos Migração de dados e responsabilidades
2.	Obrigatório. Prepare o cluster de destino e as imagens do Docker para o cluster de origem e de destino. Preparação do cluster de destino Opcional. Se sua implantação estiver offline ou se você usar um registro de OCI privado, certifique-se de que as imagens necessárias estejam disponíveis. Preenchimento do registro compatível com OCI em uma configuração offline Preenchimento do registro compatível com OCI em uma configuração online
3.	Obrigatório. Inicie a migração, mova os dados e execute a instalação do Automation Suite. Execução da migração do cluster
4.	Opcional . Se o AI Center estiver habilitado nos clusters de origem e de destino, migre as habilidades. Migração das habilidades do AI Center

Para obter instruções detalhadas de migração, consulte o Automation Suite no Guia de Instalação do EKS/AKS.

Requisitos

Para migrar de um cluster do Automation Suite para outro, você deve atender aos seguintes requisitos:

• Baixe os seguintes artefatos:
  • uipathctl
  • versions.json
• Você deve estabelecer conectividade entre os dois ambientes.
• Você deve ter um objectstore externo configurado em seu cluster de origem. Se você usar o armazenamento no cluster, consulte Migração do objectstore no cluster para o objectstore externo.
• Você deve conceder permissões de leitura/gravação do cluster de origem ao armazenamento de objetos de destino. Quando volumes persistentes (PVs) são copiados, o cluster de origem grava seus dados no armazenamento de objetos de destino e, em seguida, o cluster de destino extrai os dados do armazenamento de objetos e cria os PVs correspondentes.
• Se você migrar do Automation Suite no Linux, a versão do seu cluster de origem deve ser a 2022.10 ou mais recente.
• Se você migrar para o Automation Suite no OpenShift, a versão do seu cluster de origem deve ser a 2023.10 ou mais recente.
• Requisitos apenas offline: você deve hidratar o cluster de destino.

Migração de dados e responsabilidades

A tabela a seguir descreve os mecanismos de migração de dados e as responsabilidades de cada componente.

Dados	Mecanismo de migração
	Status	Responsabilidade
Sql	Mantido Você tem duas opções: Reutilize os mesmos bancos de dados para a nova instalação. Aponte as strings de conexão do SQL da configuração do cluster para o servidor de banco de dados existente. Clone seus bancos de dados e use os clones.	Cliente
Registro do Docker	Não migrado Se você usar um registro privado, você deve hidratar o registro de destino. Se você usar registry.uipath.com para o cluster de destino, nenhuma etapa adicional será necessária.)	Cliente
FQDN	Required Você deve escolher um novo FQDN para o novo cluster. Opcionalmente, você pode reverter para o FQDN anterior se necessário.	Cliente
Certificados	Não migrado Você deve trazer certificados como parte da nova instalação do cluster.	Cliente
Configuração de cluster	Não migrado Você deve gerar o novo input.json aplicável ao tipo de cluster de destino (AKS ou EKS).	Cliente
Alertas e painéis personalizados criados pelos usuários	Não migrado Após a migração, você deve reconfigurar quaisquer alertas personalizados nos painéis do Alert Manager e do Grafana.	Cliente
Logs do aplicativo/configuração de streaming do Prometheus criada por usuários	Não migrado Você deve reconfigurar o log do aplicativo e o streaming do Prometheus.	Cliente
Cargas de trabalho dinâmicas	Depende do aplicativo Os trabalhos de treinamento do AI Center são perdidos; As habilidades são mantidas.	Habilidades (o script necessário deve ser executado após a atualização): UiPath® Trabalhos de treinamento: cliente
Armazenamento de objeto	Objectstore externo: Retido Para o Objectstore externo, você tem duas opções: Reutilize o armazenamento de objetos externo existente e conecte-o ao novo ambiente. Crie uma réplica do seu armazenamento de objetos atual e use-a para a nova configuração. Importante : se você estiver usando um armazenamento de objetos no cluster, você deve executar uma migração do Ceph-para-externo antes da atualização.	Migração de no cluster para o Objectstore externo: Cliente Objectstore externo: UiPath®
Insights	Mantido	UiPath®
Dados do MongoDB	Mantido Os dados do MongoDB são movidos para o SQL de destino.	UiPath®
RabbitMQ	Não é necessário	UiPath®
Monitoramento (dados)	Não é necessário Os dados de monitoramento não se aplicam ao novo cluster.	N/A

Preparando a migração do cluster

Preparação do cluster de destino

Importante:

Não execute uipathctl manifest apply até concluir a Etapa 1 na seção Executando a migração do cluster . A execução desse comando muito cedo pode resultar em inconsistências de configuração no cluster de destino.

Observação:

Não modifique o cluster de origem após iniciar o processo de migração.

Para preparar o cluster de destino, siga as seguintes etapas:

1. Baixe a versão de destino do input.json no cluster de origem e gere o arquivo input.json executando o seguinte comando:

   uipathctl manifest get-revision
   

   Para obter detalhes, consulte o seguinte diagrama:

   

2. Com base no arquivo input.json gerado anteriormente, modifique o arquivo input.json do cluster de destino.

   Você deve transferir a configuração específica do Orchestrator, que inclui a chave de criptografia por tenant e as configurações dos buckets de armazenamento do Azure/Amazon S3 .

   Além disso, você deve atualizar os seguintes componentes para que façam referência à infraestrutura correta no cluster de destino:

   • Objectstore externo
   • Detalhes da conexão do SQL Server ou PostgreSQL
   • Configuração do cluster do Redis
   Observação:

   Microsoft SQL Server e PostgreSQL dedicado para o banco de dados Process Mining Airflow é a opção recomendada para a versão 2024.10.3 ou mais recente.

   Se você migrar de uma versão anterior à 2024.10.3, o arquivo input.json gerado para o cluster de destino não conterá a string de conexão para o banco de dados PostgreSQL do Airflow. Para usar a versão mais recente do Airflow, que requer PostgreSQL, você precisará adicionar manualmente o modelo de string de conexão sqlalchemy para PostgreSQL ao arquivo input.json para o cluster de destino antes da migração.

   Postgresql_connection_string_template_sqlalchemy_pyodbc

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/DB_NAME_PLACEHOLDER
   

3. Valide os pré-requisitos no cluster de destino executando o seguinte comando:

   uipathctl prereq run input-target.json --kubeconfig kubeconfig.target --versions versions.json
   

   Observação:

   input-target.json é o arquivo input.json correspondente ao cluster de destino.

   Para gerar o arquivo kubeconfig , consulte Como gerar o arquivo kubeconfig.

4. Se você estiver migrando do Automation Suite no Linux para uma implantação do EKS/AKS, você deve colocar o cluster de origem no modo de manutenção. Para obter detalhes, consulte Colocar o cluster no modo de manutenção.

5. Clone os bancos de dados SQL da implantação de origem para a implantação de destino.

Hidratar o registro do registro compatível com OCI sem acesso à Internet

O processo de migração requer que a tag de imagem uipathcore Docker mais recente esteja disponível para os clusters de origem e destino. Se seu cluster de origem estiver offline, disponibilize a imagem executando as seguintes etapas:

1. Siga as etapas para hidratar o registro usado pelo cluster de destino com o pacote offline na Opção B: Hidratar o registro com o pacote offline.

2. Copie o binário uipathctl e o arquivo versions.json em uma VM com acesso ao cluster de origem.

3. Execute o seguinte comando:

   jq -r '.[][] | select(.name=="uipath/uipathcore") | .ref + ":" + .version' "/path/to/versions.json" > images.txt
   

4. Semeie a imagem uipathcore do registro do cluster de destino para o registro do cluster de origem:

   ./uipathctl registry seed --tag-file ./images.txt \
               --source-registry "target.registry.fqdn.com" \
               --source-password "target-registry-username" \
               --source-username "target-registry-password" \
               --dest-registry "source.registry.fqdn.com" \
               --dest-username "source-registry-username" \
               --dest-password "source-registry-password"
   

   Observação:

   Certifique-se de atualizar o comando da seguinte forma:

   • Substitua target.registry.fqdn.com, target.registry.fqdn.com e target-registry-password pelos valores adequados que correspondam ao registro associado ao cluster de destino;
   • Substitua source.registry.fqdn.com, source.registry.fqdn.com e source-registry-password pelos valores adequados que correspondam ao registro associado ao cluster de origem.

Preenchimento do registro compatível com OCI com acesso à internet

Se você usar um registro privado, você deve gerá-lo. Para obter instruções, consulte Configuração do registro compatível com OCI.

Execução da migração do cluster

Para migrar para o cluster de destino do Automation Suite, execute as seguintes etapas:

1. Execute a migração executando o seguinte comando:

   uipathctl cluster migration run input-target.json --kubeconfig kubeconfig.source --target-kubeconfig kubeconfig.target --versions versions-target.json
   

2. Conclua a instalação do Automation Suite no cluster de destino executando o seguinte comando:

   uipathctl manifest apply input-target.json --kubeconfig kubeconfig.target --versions versions-target.json
   

Migrando as habilidades do AI Center

As etapas nesta seção serão aplicáveis apenas se você tiver habilitado o AI Center nos clusters de origem e de destino. Observe que as instruções presumem que o AI Center no cluster de destino aponta para o banco de dados que contém os dados de habilidades para executar as habilidades.

Depois de concluir a migração, você deve sincronizar as habilidades do AI Center para que você possa usá-las novamente.

Verificação do status da migração de habilidades

Você pode usar o script a seguir para sincronizar a habilidade de ML do AI Center com o cluster de destino. O script aciona a sincronização em segundo plano se nenhuma sincronização ativa estiver em andamento.

O script sincroniza as habilidades em segundo plano (assíncrono) e retorna um status. A tarefa garante que as habilidades sejam implantadas e atualiza a entrada do banco de dados para refletir o status atual.

uipathctl service aicenter sync-skills [skill_ids]

Parâmetro	Description
[skill_ids]	O array opcional dos IDs de habilidade separados por espaço. Se você fornecer o ID da habilidade, apenas essas habilidades serão atualizadas; caso contrário, todas as habilidades implantadas serão sincronizadas novamente.

uipathctl service aicenter sync-skills 783273-3232-3232-323 32-32-323-3232

//this will only sync the skills with ID 783273-3232-3232-323 and 32-32-323-3232

Para visualizar o status da habilidade de ML do AI Center, execute o seguinte comando:

uipathctl service aicenter sync-skill-status [skill_ids]

O comando pode retornar qualquer um dos seguintes status:

• InProgess - implantação de habilidade em andamento.
• Failed - falha na implantação de habilidade.
• OutOfSync - habilidade disponível no banco de dados; no entanto, ainda não foi implantada.
• Available - quando as habilidades são implantadas e disponíveis para consumo.