Actualizar Automation Suite

Realiza actualizaciones de versiones principales y secundarias de Automation Suite en EKS/AKS.

Automation Suite consists of multiple components. Both you as a customer and UiPath® share responsibility of these components. For details, refer to Responsibility matrix.

Usted es responsable de actualizar:

• Infraestructura de Kubernetes donde se implementa Automation Suite (AKS o EKS)
• 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:

• If you upgrade to Automation Suite 2.2510, you need to bring a PostgreSQL database for AutomationSuite_Airflow and configure the connection string for it in input.json. For details, refer to Process Mining-specific configuration.
• If you upgarde from versions prior to 2.2510.0 using Studio Web, make sure to use the same storage class name as specified in storage_class_single_replica, to support RWX access mode. For details, refer to Configuring input.json.

Además, revisa la siguiente guía de mantenimiento de la base de datos antes de iniciar la actualización.

Importante:

Las tablas de base de datos de Automation Suite muy grandes pueden hacer que los trabajos de migración de la base de datos tarden mucho más o no se completen durante la actualización. Mantener las tablas de la base de datos en buen estado reduce este riesgo.

We recommend archiving or purging data that is no longer needed from high-volume tables before starting the upgrade; for details, refer to Performing database maintenance.

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

1. Check the compatibility matrix to determine the supported versions for each available upgrade scenario. If you brought your own components, make sure the versions of your components are compatible with the version you plan to upgrade to. For details, refer to Compatibility matrix.

2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, refer to Downloading the installation packages.

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
     

   • 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
     

4. If you are using an offline setup with an external OCI-compliant registry, you must hydrate the registry with container images and Helm charts before upgrade. For details, refer to Hydrating the registry with the offline bundle.

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 input.json antes de la actualización: postgresql_connection_string_template_sqlalchemy_pyodbc.

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

6. Si Integration Service está instalado, asegúrate de que tus colas en la nube externas (SQS) están sincronizadas y la replicación entre regiones está habilitada. Por ejemplo:

   • En Azure Queue Storage, configura las opciones de redundancia GRS/RA-GRS o GZRS/RA-GZRS. Para obtener más información, consulta:
     • Redundancia de datos en Azure Storage
     • Fiabilidad en Azure Queue Storage
     • Guía de diseño con redundancia geográfica
   • En Amazon SQS, crea colas SQS en cada región y replica los mensajes utilizando la distribución de SNS o la lógica personalizada. Para obtener más información, consulta:
     • Amazon SQS: recuperación activa/activa ante desastres
     • Entrega de mensajes SNS entre regiones

7. If you upgrade to Automation Suite 2.2510.0 or later from previous Automation Suite 2024.10 versions and have Studio Web enabled, you must also enable Solutions. For details, refer to Enabling or disabling Solutions. Make sure you also review the additional hardware requirements for Solutions. For details, refer to Capacity Planning.

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> --versions versions.json
   

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

   uipathctl cluster maintenance enable
   

   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
   

4. Haz una copia de seguridad del clúster y de la base de datos SQL y, a continuación, comprueba que la copia de seguridad se haya completado correctamente. Crea también una copia de seguridad antes de actualizar tu infraestructura de Kubernetes.

   Si cumples simultáneamente los siguientes requisitos, asegúrate de copiar el valor de global.userInputs.identity.krb5KeytabSecret a global.kerberosAuthConfig.userKeytab:

   • 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. A partir de Automation Suite 2.2510.2, el modo de mantenimiento debe permanecer habilitado durante la actualización. Para versiones anteriores a Automation Suite 2.2510.2, deshabilita el modo de mantenimiento antes de realizar la actualización:

   uipathctl cluster maintenance disable
   

   Nota:

   Si actualizas a Automation Suite 2.2510.2 o posterior, omite este paso y deshabilita el modo de mantenimiento solo después de que se complete la actualización.

6. Actualizar los servicios y componentes de UiPath®:

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

   En Automation Suite 2.2510.0, el comando uipathctl cluster upgrade falla con el siguiente error cuando el modo de mantenimiento está deshabilitado: Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'.

   Para evitar el mensaje de error, utiliza el siguiente comando para realizar la actualización. Asegúrate de haber creado todas las copias de seguridad necesarias antes de continuar.

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

   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.

7. A partir de Automation Suite 2.2510.2, deshabilita el modo de mantenimiento:

   uipathctl cluster maintenance disable
   

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

   uipathctl health check --namespace <uipath> --versions versions.json
   

   Nota:

   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 Uninstall Dapr and Uninstall Cert Manager sections.

Actualizar la infraestructura de Kubernetes

Nota:

Automation Suite supports upstream N-1 to N-3 versions of Kubernetes irrespective of the cloud provider. For instance, if upstream is 1.27, we support versions 1.26, 1.25, and 1.24. For supported versions, refer to the Compatibility matrix.

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

Los siguientes escenarios describen qué operaciones posteriores a la actualización son necesarias para tu entorno:

• Si actualizaste a Automation Suite 2.2510.0 o superior y Process Mining o Task Mining estaba habilitado en la versión anterior:

  • Uninstall Dapr. For details, refer to How to uninstall Dapr.
  • Uninstall Cert Manager. For details, refer to How to uninstall Cert Manager.

• Si actualizaste 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. La reactivación de la licencia debe realizarse utilizando el botón Actualizar licencia . No desactives y vuelvas a activar manualmente la licencia, ya que hacerlo deshabilita los servicios.