- Información general
- Requisitos
- Preinstalación
- Preparar la instalación
- Descarga de los paquetes de instalación
- Configurar el registro compatible con OCI
- Conceder permisos de instalación con roles de clúster
- Conceder permisos de instalación sin roles de clúster
- Instalar y configurar la malla de servicio
- Instalar y configurar la herramienta GitOps
- Instalar el operador de secretos externos
- Implementar Redis a través de OperatorHub
- Aplicar configuraciones varias
- Ejecutar uipathctl
- Instalación
- Después de la instalación
- Migración y actualización
- Supervisión y alertas
- Administración de clústeres
- Configuración específica del producto
- Configuración avanzada de Orchestrator
- Configurar parámetros de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar NLog
- Guardar los registros del robot en Elasticsearch
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Omitir la instalación de la biblioteca de host
- Ai Trust Layer
- Solución de problemas
- Cómo desinstalar Automation Suite
- Cómo resolver el fallo de comprobación de conectividad prerrequisito en OpenShift 4.16–4.18
- Cómo implementar Insights en un clúster habilitado para FIPS
- Cómo deshabilitar la habilitación automática de CDI en el operador de GPU de Nvidia
- Cómo codificar la URL de una contraseña de cadena de conexión de PostgreSQL
- 500 errores y limitación de tasa en solicitudes S3 en ODF
- Solución de problemas de secretos externos
- Configurar las tolerancias del controlador CSI para ODF 4.20
- Durable Execution Service troubleshooting
- Los pods de AI Center y Document Understanding no se inician con la verificación del certificado TLS habilitada
- Studio Desktop no puede cargar conectores y actividades de Integration Service
- Errores de validación del certificado TLS
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Configurar solicitudes de recursos y límites para cargas de trabajo creadas por uipathctl
Actualizar Automation Suite
Actualiza Automation Suite a versiones más recientes en el clúster de OpenShift.
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
- Si actualizas a Automation Suite 2.2510, debes traer una base de datos PostgreSQL para
AutomationSuite_Airflowy configurar la cadena de conexión para ella eninput.json. Para obtener más información, consulta Configuración específica de Process Mining. - 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.
Para obtener más información, consulta Configurar input.json.
Además, revisa la siguiente guía de mantenimiento de la base de datos antes de iniciar la actualización.
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.
Recomendamos archivar o purgar los datos que ya no sean necesarios de las tablas de alto volumen antes de iniciar la actualización; para obtener más información, consulta Realizar mantenimiento de la base de datos.
Para preparar la actualización, realiza los pasos siguientes:
- Consulta 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.
- Descarga
versions.jsonyuipathctlpara la versión a la que quieres actualizar, en tu máquina de gestión. Para obtener instrucciones de descarga, consulta Descargar los paquetes de instalación. - Generate the latest
input.jsonfile 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>uipathctl manifest get-revision --namespace <uipath> - Opción B: para enumerar todos los archivos
input.jsonanteriores y determinar el que quieres elegir, ejecuta el siguiente comando:uipathctl manifest list-revisions --namespace <uipath>uipathctl manifest list-revisions --namespace <uipath>
- Opción A: para obtener la última revisión de tu archivo
- 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 gráficos de Helm antes de la actualización. Para obtener más información, consulta Hidratar el registro con el paquete sin conexión.
- 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
sqlalchemyaplicable a PostgreSQL en el archivoinput.jsonantes de la actualización:postgresql_connection_string_template_sqlalchemy_pyodbc.postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name> - Si actualizas a Automation Suite 2.2510.0 o posterior desde versiones anteriores de Automation Suite 2024.10 y tienes habilitado Studio Web, también debes habilitar Soluciones. Para obtener más información, consulta Habilitar o deshabilitar soluciones. Asegúrate de revisar también los requisitos de hardware adicionales para las soluciones. Para obtener más información, consulta Planificación de la capacidad.
Ejecución
Para actualizar los servicios y componentes de UiPath®, sigue los siguientes pasos:
-
Confirma que tu clúster es saludable:
uipathctl health check --namespace <uipath> --versions versions.jsonuipathctl health check --namespace <uipath> --versions versions.json -
Coloca el clúster en modo de mantenimiento para garantizar una copia de seguridad coherente:
uipathctl cluster maintenance enable --namespace <uipath>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.
-
Verificar que el clúster está en modo de mantenimiento:
uipathctl cluster maintenance is-enabled --namespace <uipath>uipathctl cluster maintenance is-enabled --namespace <uipath> -
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.krb5KeytabSecretaglobal.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
-
Deshabilitar el modo de mantenimiento:
uipathctl cluster maintenance disableuipathctl cluster maintenance disableNota: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.
-
Actualizar los servicios y componentes de UiPath®:
uipathctl cluster upgrade input.json --versions versions.jsonuipathctl cluster upgrade input.json --versions versions.jsonImportante: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.
-
Comprobar que el clúster es seguro después de la actualización:
uipathctl health check --namespace <uipath> --versions versions.jsonuipathctl health check --namespace <uipath> --versions versions.jsonNota:Si actualizaste a Automation Suite 2.2510 o superior, puedes desinstalar Dapr y Cert Manager, si previamente instalaste estos complementos para Process Mining o Task Mining. Para obtener más información, consulta las secciones y.
Actualizar la infraestructura de Kubernetes
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
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 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.