Migrar entre clústeres de Automation Suite

Migrar datos y configuraciones entre clústeres de Automation Suite en EKS/AKS.

Acerca de la migración del clúster

Puedes migrar de un clúster de Automation Suite a otro si utilizas el espacio de nombres uipath en lugar de un espacio de nombres personalizado y quieres pasar de un tipo de Automation Suite a otro. Admitimos los siguientes escenarios:

• Migrar de Automation Suite en Linux a una nueva instalación de Automation Suite en EKS/AKS;
• Migra de Automation Suite en Linux a una nueva instalación de Automation Suite en OpenShift.

No se admite ningún escenario de migración no mencionado anteriormente.

Ten en cuenta que puedes intentar realizar la operación de migración varias veces sin afectar a tu clúster existente.

Los siguientes escenarios de migración no son compatibles:

• Migrar de Automation Suite en Linux a una instalación existente de Automation Suite en EKS/AKS o Automation Suite en OpenShift;
• Migrar un clúster de Automation Suite en OpenShift a un clúster de Automation Suite en Linux;
• Migrar de Automation Suite en EKS/AKS a una nueva instalación de Automation Suite en OpenShift;
• Migrar de Automation Suite en OpenShift a una nueva instalación de Automation Suite en EKS/AKS;
• Migrar de Automation Suite en EKS a Automation Suite en AKS o de Automation Suite en AKS a Automation Suite en EKS;
• Migrar de Automation Suite en EKS a una nueva instalación de Automation Suite en EKS;
• Migrar de Automation Suite en AKS a una nueva instalación de Automation Suite en AKS;
• Migrar de Automation Suite en OpenShift a una nueva instalación de Automation Suite en OpenShift.

Descripción general del proceso

La siguiente tabla proporciona una descripción general del proceso de migración del clúster.

Paso	Descripción
1.	Obligatorio . Asegúrate de cumplir los requisitos de migración. Requisitos Migración de datos y responsabilidades
2.	Obligatorio. Prepara el clúster de destino y las imágenes de docker tanto para el clúster de origen como para el de destino. Preparar el clúster de destino Opcional. Si tu implementación es sin conexión o si utilizas un registro OCI privado, asegúrate de que las imágenes necesarias están disponibles. Hidratar el registro compatible con OCI en una configuración sin conexión Hidratar el registro compatible con OCI en una configuración en línea
3.	Obligatorio. Inicia la migración, mueve los datos y ejecuta la instalación de Automation Suite. Ejecutar la migración del clúster
4.	Opcional . Si AI Center está habilitado tanto en el clúster de origen como en el de destino, migra las habilidades. Migrar las habilidades de AI Center

Para obtener instrucciones de migración detalladas, consulta la Guía de instalación de Automation Suite en EKS/AKS.

Requisitos

Para migrar de un clúster de Automation Suite a otro, debes cumplir los siguientes requisitos:

• Descarga los siguientes artefactos:
  • uipathctl
  • versions.json
• Debes establecer la conectividad entre los dos entornos.
• Debes tener un almacén de objetos externo configurado en tu clúster de origen. Si utilizas almacenamiento en clúster, consulta Migrar el almacén de objetos en el clúster a un almacén de objetos externo.
• Debes conceder al clúster de origen permisos de lectura/escritura en el almacén de objetos de destino. Cuando se copian volúmenes persistentes (PV), el clúster de origen escribe sus datos en el almacén de objetos de destino y, a continuación, el clúster de destino extrae los datos del almacén de objetos y crea los PV correspondientes.
• Si migras desde Automation Suite en Linux, la versión de tu clúster de origen debe ser 2022.10 o posterior.
• Si migras a Automation Suite en OpenShift, la versión de tu clúster de origen debe ser 2023.10 o posterior.
• Requisitos solo sin conexión: debes hidratar el clúster de destino.

Migración de datos y responsabilidades

La siguiente tabla describe los mecanismos de migración de datos y las responsabilidades de cada componente.

Datos	Mecanismo de migración
	Estado	Responsabilidad
Sql	Retenido Tienes dos opciones: Reutiliza las mismas bases de datos para la nueva instalación. Apunta las cadenas de conexión SQL de la configuración del clúster al servidor de la base de datos existente. Clona tus bases de datos y utiliza los clones en su lugar.	Cliente
Registro de Docker	No migrado Si utilizas un registro privado, debes hidratar el registro de destino. Si usas registry.uipath.com para el clúster de destino, no se necesitan más pasos).	Cliente
FQDN	Obligatorio Debes elegir un nuevo FQDN para el nuevo clúster. Opcionalmente, puedes volver al FQDN anterior si es necesario.	Cliente
Certificados	No migrado Debes aportar certificados como parte de la nueva instalación del clúster.	Cliente
Configuración de clústeres	No migrado Debes generar el nuevo input.json aplicable al tipo de clúster de destino (AKS o EKS).	Cliente
Alertas y paneles personalizados creados por los usuarios	No migrado Después de la migración, debes volver a configurar cualquier alerta personalizada en los paneles de Alert Manager y Grafana.	Cliente
Registros de aplicación/configuración de transmisión de Prometheus creada por los usuarios	No migrado Debes volver a configurar el registro de la aplicación y la transmisión de Prometheus.	Cliente
Cargas de trabajo dinámicas	Depende de la aplicación Los trabajos de entrenamiento del AI Center se han perdido; Las habilidades se conservan.	Habilidades (el script debe ejecutarse después de la actualización): UiPath® Trabajos de formación: cliente
Almacén de objetos	Almacén de objetos externo: retenido Para el almacén de objetos externo, tienes dos opciones: Reutilizar el almacén de objetos externo existente y conectarlo al nuevo entorno. Crear una réplica de tu almacén de objetos actual y utilizarla para la nueva configuración. Importante : si utilizas un almacén de objetos en el clúster, debes realizar una migración de ceph a externo antes de la actualización.	Migración de un almacén de objetos en el clúster a un almacén de objetos externo: cliente Almacén de objetos externo: UiPath®
Insights	Retenido	UiPath®
Datos de MongoDB	Retenido Los datos de MongoDB se mueven al SQL de destino.	UiPath®
RabbitMQ	No es necesario	UiPath®
Seguimiento (datos)	No es necesario Los datos de supervisión no se aplican al nuevo clúster. Si no utilizas los componentes de supervisión integrados, debes configurar los componentes de supervisión externos después de la actualización de la migración.	N/D

Preparar la migración del clúster

Preparar el clúster de destino

Importante:

No ejecutes uipathctl manifest apply hasta que hayas completado el Paso 1 en la sección Ejecutar la migración del clúster . Ejecutar este comando demasiado pronto puede dar lugar a inconsistencias en la configuración en el clúster de destino.

Nota:

No modifiques el clúster de origen después de iniciar el proceso de migración.

Para preparar el clúster de destino, sigue los siguientes pasos:

1. Descarga la versión de destino de input.json en el clúster de origen y genera el archivo input.json ejecutando el siguiente comando:

   uipathctl manifest get-revision
   

   Para obtener más información, consulta el siguiente diagrama:

   

2. En función del archivo input.json generado anteriormente, modifica el archivo input.json del clúster de destino.

   Debes transferir la configuración específica de Orchestrator que incluye la configuración.

   Además, debes actualizar los siguientes componentes para que hagan referencia a la infraestructura correcta en el clúster de destino:

   • Almacén de objetos externo
   • Detalles de conexión de SQL Server o PostgreSQL
   • Configuración del clúster de Redis
   Nota:

   Se requiere Microsoft SQL Server y PostgreSQL dedicado para la base de datos Airflow de Process Mining para Process Mining en Automation Suite 2.2510.

   Si migras desde una versión anterior a la 2024.10.3, el archivo input.json generado para el clúster de destino no contiene la cadena de conexión para la base de datos PostgreSQL de Airflow. Para utilizar la última versión de Airflow, que requiere PostgreSQL, deberás añadir manualmente la plantilla de cadena de conexión sqlalchemy para PostgreSQL al archivo input.json para el clúster de destino antes de la migración.

   Postgresql_connection_string_template_sqlalchemy_pyodbc

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

3. Valida los requisitos previos en el clúster de destino, ejecutando el siguiente comando:

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

   Nota:

   input-target.json es el archivo input.json correspondiente al clúster de destino.

   Para generar el archivo kubeconfig , consulta Generar el archivo kubeconfig.

4. Si estás migrando de Automation Suite en Linux a una implementación de EKS/AKS, debes poner el clúster de origen en modo de mantenimiento. Para obtener más información, consulta Poner el clúster en modo de mantenimiento.

5. Clona las bases de datos SQL de la implementación de origen a la implementación de destino.

Hidratar el registro compatible con OCI sin acceso a Internet

El proceso de migración requiere que la última etiqueta de imagen de Docker uipathcore esté disponible tanto para el clúster de origen como para el de destino. Si tu clúster de origen está sin conexión, haz que la imagen esté disponible siguiendo los siguientes pasos:

1. Sigue los pasos para hidratar el registro utilizado por el clúster de destino con el paquete sin conexión en la Opción B: hidratar el registro con el paquete sin conexión.

2. Copia el binario uipathctl y el archivo versions.json en una máquina virtual con acceso al clúster de origen.

3. Ejecuta el siguiente comando:

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

4. Inicia la imagen uipathcore desde el registro del clúster de destino al registro del clúster de origen:

   ./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"
   

Nota:

Asegúrate de actualizar el comando de la siguiente manera:

• Sustituye target.registry.fqdn.com, target.registry.fqdn.com y target-registry-password por los valores adecuados que correspondan al registro asociado al clúster de destino;
• Sustituye source.registry.fqdn.com, source.registry.fqdn.com y source-registry-password por los valores adecuados que correspondan al registro asociado al clúster de origen.

Hidratar el registro compatible con OCI con acceso a Internet

Si utilizas un registro privado, debes inicializarlo. Para obtener instrucciones, consulta Configurar el registro compatible con OCI.

Ejecutar la migración del clúster

Para migrar al clúster de Automation Suite de destino, sigue los siguientes pasos:

1. Inicia la migración ejecutando el siguiente comando:

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

2. Completa la instalación de Automation Suite en el clúster de destino ejecutando el siguiente comando:

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

Migrar las habilidades de AI Center

Los pasos de esta sección solo son aplicables si habilitaste AI Center tanto en el clúster de origen como de destino. Ten en cuenta que las instrucciones suponen que AI Center en el clúster de destino apunta a la base de datos que contiene los datos de la habilidad para ejecutar las habilidades.

Después de completar la migración, debes sincronizar las habilidades de AI Center para que puedas utilizarlas de nuevo.

Comprobar el estado de migración de habilidad

Puedes utilizar el siguiente script para sincronizar la habilidad ML de AI Center con el clúster de destino. El script desencadena la sincronización en segundo plano si no hay ninguna sincronización activa en curso.

El script sincroniza las habilidades en segundo plano (asíncrono) y las muestra. El trabajo garantiza la implementación de las habilidades y actualiza la entrada de la base de datos para reflejar el estado actual.

uipathctl service aicenter sync-skills [skill_ids]

• [skill_ids]: Opcional. Matriz de ID de habilidad separados por espacio. Si proporcionas el ID de la habilidad, solo se actualizarán esas habilidades; de lo contrario, todas las habilidades implementadas se vuelven a sincronizar.

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 ver el estado de la habilidad ML de AI Center, ejecuta el siguiente comando:

uipathctl service aicenter sync-skill-status [skill_ids]

El comando puede mostrar cualquiera de los siguientes estados:

• InProgess: la implementación de habilidades está en curso.
• Failed: la implementación de habilidades ha fallado.
• OutOfSync: la habilidad está disponible en la base de datos; sin embargo, aún no se ha implementado.
• Available: las habilidades están implementadas y disponibles para su uso.