Actualizar Automation Suite en EKS / AKS

Importante:

Si utilizas Active Directory (AD) y estás planeando actualizar a 2023.4.0, te recomendamos encarecidamente que saltes directamente a la versión 2023.4.3, ya que 2023.4.0, 2023.4.1 y 2023.4.2 se ven afectados por un problema de AD.

Automation Suite on AKS/EKS consists of multiple components. Both you as a customer and UiPath share responsibility of these components. For details, see Compatibility 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:

Hay un problema conocido con la lógica de copia de seguridad en Automation Suite para las versiones 2023.10.0 a 2023.10.7 de AKS/EKS. En concreto, esta incidencia excluye la copia de seguridad de los paneles de Insights. Sin embargo, se ha realizado una copia de seguridad de todos los datos históricos.

Para incluir los paneles de Insights en la copia de seguridad, debes reconfigurar la solución de copia de seguridad utilizando el script disponible aquí. Este script te permite reconfigurar la solución de copia de seguridad y crear la copia de seguridad. Para obtener más información sobre cómo ejecutar el comando, consulta esta sección.

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 compatabile with the version you plan to upgrade to. For details, see Compatibility matrix.

2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, see 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
     

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
   

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 comprueba que la copia de seguridad se ha completado correctamente.

   Importante:

   It is strongly recommended to create a backup of the cluster and the SQL database before upgrading Automation Suite. This is to ensure you can restore the cluster if something goes wrong during the upgrade operation.

   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. Deshabilitar el modo de mantenimiento:

   uipathctl cluster maintenance disable
   

   Nota:

   Debe deshabilitar el modo de mantenimiento antes de la actualización. El proceso de actualización de Automation Suite no admite tener habilitado el modo de mantenimiento.

6. 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.

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

   uipathctl health check
   

Upgrading Kubernetes infrastructure

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, see 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.