Migração entre clusters do Automation Suite

Migre dados e configurações entre clusters do Automation Suite no EKS/AKS.

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;
• Migre do Automation Suite no Linux para uma nova instalação do Automation Suite no OpenShift.

Qualquer cenário de migração não listado acima não é compatível.

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 Suite no EKS/AKS ou do Automation Suite no OpenShift;
• Migração de um Automation Suite no cluster OpenShift para o Automation Suite no cluster Linux;
• Migração do Automation Suite no EKS/AKS para uma nova instalação do Automation Suite no OpenShift;
• Migração do Automation Suite no OpenShift para uma nova instalação do Automation Suite no EKS/AKS;
• Migração do Automation Suite no EKS para o Automation Suite no AKS ou do Automation Suite no AKS para o Automation Suite no EKS;
• Migração do Automation Suite no EKS para uma nova instalação do Automation Suite no EKS;
• Migração do Automation Suite no AKS para uma nova instalação do Automation Suite no AKS;
• Migrando do Automation Suite no OpenShift para uma nova instalação do Automation Suite no OpenShift.

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

For detailed migration instructions, refer to the Automation Suite on EKS/AKS Installation Guide.

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.
• You must have an external objectstore configured in your source cluster. If you use in-cluster storage, refer to Migrating in-cluster objectstore to external objectstore.
• 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. Se você não usar os componentes de monitoramento integrados, você deve configurar componentes de monitoramento externos após a atualização de migração.	N/A

Preparando a migração do cluster

Preparação do cluster de destino

Importante:

Do not run uipathctl manifest apply until you have completed Step 1 in the Running the cluster migration section. Running this command too early can result in configuration inconsistencies in the target cluster.

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 e as configurações.

   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 dedicado e PostgreSQL para o Process Mining O banco de dados Airflow é necessário para o Process Mining no Automation Suite 2.2510.

   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.

   To generate the kubeconfig file, refer to Generating the kubeconfig file.

4. If you are migrating from Automation Suite on Linux to a EKS/AKS deployment, you must put the source cluster in maintenance mode. For details, refer to Putting the cluster in maintenance mode.

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. Follow the steps to hydrate the registry used by the target cluster with the offline bundle in Option B: Hydrating the registry with the offline bundle.

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

If you use a private registry, you must seed it. For instructions, refer to Configuring the OCI-compliant registry.

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]

• [skill_ids]: Opcional. Matriz de 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.