Actualizar Automation Suite

Automation Suite consta de varios componentes. Tanto usted como cliente como UiPath® comparten la responsabilidad de estos componentes. Para obtener más información, consulta Matriz de responsabilidad.

Usted es responsable de actualizar:

• Infraestructura de Kubernetes donde se implementa Automation Suite (OpenShift)
• Los componentes que elija incorporar como parte de Automation Suite (por ejemplo, Gatekeeper, FluentD, etc.)

UiPath® es responsable de actualizar:

• Servicios de UiPath® (por ejemplo, Orchestrator)
• Componentes implementados como parte de Automation Suite (p. Ej., ArgoCD)

Actualizar los servicios y componentes de UiPath®

Preparación

Nota:

• Si actualizas a Automation Suite 2.2510 o superior, debes traer una base de datos PostgreSQL para AutomationSuite_Airflow y configurar la cadena de conexión para ella en input.json.

  Consulta Configuración específica de Process Mining para obtener más detalles.

• Si actualizas desde versiones anteriores a la 2.2510.0 utilizando Studio Web, asegúrate de utilizar el mismo nombre de clase de almacenamiento que se especifica en storage_class_single_replica, para admitir el modo de acceso RWX.

  Consulta Configurar input.json para obtener más información.

Para preparar la actualización, realiza los pasos siguientes:

1. Comprueba la matriz de compatibilidad para determinar las versiones compatibles para cada escenario de actualización disponible. Si has traído tus propios componentes, asegúrate de que las versiones de tus componentes sean compatibles con la versión a la que planeas actualizar. Para obtener más información, consulta Matriz de compatibilidad.
2. Descarga versions.json y uipathctl para la versión a la que quieres actualizar, en tu máquina de gestión. Para descargar las instrucciones, consulta Descarga de paquetes de instalación.
3. Generate the latest input.json file as follows:
   • Opción A: para obtener la última revisión de tu archivo input.json, ejecuta el siguiente comando:

     uipathctl manifest get-revision --namespace <uipath>

   • Opción B: para enumerar todos los archivos input.json anteriores y determinar el que quieres elegir, ejecuta el siguiente comando:

     uipathctl manifest list-revisions --namespace <uipath>

4. Si utilizas una configuración sin conexión con un registro externo compatible con OCI, debes hidratar el registro con imágenes de contenedor y diagramas de Helm antes de la actualización. Para obtener más información, consulta Hidratar el registro con el paquete sin conexión.
5. Si Process Mining está instalado y quieres utilizar la última versión de Airflow que necesita PostgreSQL, debes añadir o actualizar la plantilla de cadena de conexión sqlalchemy aplicable a PostgreSQL en el archivo cluster_config.json antes de la actualización: postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>

Ejecución

Para actualizar los servicios y componentes de UiPath®, sigue los siguientes pasos:

1. Confirma que tu clúster es saludable:

   uipathctl health check --namespace <uipath>

2. Coloca el clúster en modo de mantenimiento para garantizar una copia de seguridad coherente:

   uipathctl cluster maintenance enable --namespace <uipath>

   Importante:

   Esta operación causa tiempo de inactividad y la automatización de tu negocio se suspende mientras está habilitado el modo de mantenimiento.

3. Verificar que el clúster está en modo de mantenimiento:

   uipathctl cluster maintenance is-enabled --namespace <uipath>

4. Haz una copia de seguridad del clúster y de la base de datos SQL y comprueba que la copia de seguridad se ha completado correctamente.
   Importante:

   Se recomienda encarecidamente crear una copia de seguridad del clúster y de la base de datos SQL antes de actualizar Automation Suite. Esto es para garantizar que puedas restaurar el clúster si algo sale mal durante la operación de actualización. Esto también es aplicable antes de actualizar tu infraestructura de Kubernetes.

   Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:

   • ha configurado la integración de Active Directory con el nombre de usuario y la contraseña
   • you have Windows authentication enabled
   • no utilizas la autenticación integrada de SQL
5. Actualizar los servicios y componentes de UiPath®:

   uipathctl cluster upgrade input.json --versions versions.json

   Importante:

   Esta operación causa tiempos de inactividad y la automatización de tu negocio se suspende durante el proceso de actualización. Es importante que realices la actualización solo durante tu ventana de mantenimiento.

6. Comprobar que el clúster es seguro después de la actualización:

   uipathctl health check --namespace <uipath>

   Note: If you upgraded to Automation Suite 2.2510 or higher, you can uninstall Dapr and Cert Manager, if you previously installed these add-ons for Process Mining or Task Mining. For details, refer to the and sections.

Actualizar la infraestructura de Kubernetes

Nota: Automation Suite admite las versiones N-1 a N-3 de Kubernetes independientemente del proveedor de la nube. Por ejemplo, si el flujo ascendente es 1.27, admitimos las versiones 1.26, 1.25 y 1.24. Para las versiones compatibles, consulta la matriz de compatibilidad.

Eres responsable de actualizar la infraestructura de Kubernetes que aloja Automation Suite. Debes seguir las prácticas estándar de tu empresa para actualizar la infraestructura de Kubernetes.

Realizar operaciones posteriores a la actualización

La siguiente tabla describe los posibles escenarios en los que debes realizar operaciones posteriores a la actualización:

Condición

Acción

1. Has actualizado a Automation Suite 2.2510.0 o posterior.

Debes reactivar inmediatamente tus licencias existentes para cada organización y host. Activación en línea: reactivar directamente después de la actualización. Activación sin conexión: genera un nuevo archivo de carga útil de activación desde la instancia de Automation Suite y, a continuación, cárgalo en Activación. La reutilización de archivos de activación antiguos no está permitida y dará como resultado una licencia no válida.