Automatizado: Actualización sin conexión

Ansible se utiliza para automatizar la actualización de todo el clúster de Automation Suite realizando algunas operaciones en una máquina.

En la siguiente ilustración, el nodo del Servidor 1 (o nodo de host de Ansible) utiliza Ansible para organizar la actualización de todo el clúster de Automation Suite.

Preparación

Importante:

Antes de actualizar, asegúrese de haber preparado su entorno para utilizar el script uipathctl.sh . Para obtener más información, consulta Uso de uipathctl.sh.

Asegúrate de tener 10 GiB de espacio libre en la carpeta /opt/UiPathAutomationSuite en todos los nodos. Si no dispones de espacio suficiente, puedes aumentar la capacidad de esta carpeta o eliminar todos los archivos del instalador anterior excepto cluster_config.json. Siempre puedes volver a descargar el instalador anterior.

Para verificar el espacio disponible, ejecuta el siguiente comando: df -h /opt/UiPathAutomationSuite.

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

1. Inicia sesión en el nodo del servidor que identificaste previamente como nodo de host de Ansible a través de SSH. Asegúrese de haber seleccionado el nodo del servidor principal con el disco adicional del paquete de UiPath adjunto en /uipath como su nodo de host de Ansible.
2. Hazte usuario raíz:

   sudo su -

3. Crea una carpeta de instalación en el directorio /opt/UiPathAutomationSuite:

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer

4. Descarga sf-installer.zip y cópiala en /opt/UiPathAutomationSuite/{version}/installer. Para obtener instrucciones de descarga, consulta sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer

5. Descomprime sf-installer.zip:

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .

6. Descarga sf-infra.tar.gz y cópiala en /uipath/{version}. Para obtener instrucciones de descarga, consulta sf-infra.tar.gz.

   cp /path/to/sf-infra.tar.gz /uipath/{version}

7. Descarga sf.tar.gz y cópiala en /uipath/{version}. Para obtener instrucciones de descarga, consulta sf.tar.gz.

   cp /path/to/sf.tar.gz /uipath/{version}

8. Proporciona los permisos necesarios al instalador:

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer

9. Genere el archivo cluster_config.json más reciente en el nodo de host de Ansible.
   Nota: para obtener más información sobre cómo configurar los parámetros cluster_config.json , consulta Experiencia de instalación avanzada.

   • Si tienes el cluster_config.json antiguo, genera el archivo de configuración desde el clúster:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

   • Si no dispones del archivo cluster_config.json antiguo, anula los valores predeterminados que hayas podido realizar en la instalación de la versión anterior:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json

   • Si actualizas Automation Suite desde una versión anterior y ahora habilitas Process Mining también, debes actualizar sql_connection_string_template_sqlalchemy_pyodbc. A continuación se muestra un ejemplo.

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

   Consulta también Manual: Experiencia de instalación avanzada.

Ejecución

Importante:

Si se produce algún error o problema durante o después de la actualización, puedes revertir la versión anterior, siempre que previamente hayas configurado una copia de seguridad.

Para obtener instrucciones, consulta Reversión por error.

Hidratación del registro de Docker

Para minimizar el tiempo de inactividad necesario, hidrata docker-registry con imágenes de contenedor para la nueva versión de los productos antes de la actualización.

Importante:

• Asegúrate de no hidratar el contenedor y/u otras imágenes infra más de 10 horas antes de la actualización.

• Si actualizas Document Understanding y Computer Vision, debes descargar las imágenes base que coincidan con tu versión actualizada de Automation Suite (utiliza la imagen base que corresponde a tu versión de Paquete ML) e hidratarlas en tu registro de docker antes de la actualización para evitar alteraciones en tus habilidades de DU en ejecución. Para descargar los paquetes de instalación de Document Understanding y Computer Vision, consulta Descargar los paquetes de instalación.

Para hidratar docker-registry, ejecuta el siguiente comando en el primer nodo del servidor:

cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp

Configuring the backup

Para configurar la copia de seguridad, sigue los siguientes pasos:

1. Asegúrate de haber activado la copia de seguridad en el clúster. Debes crear la copia de seguridad utilizando la misma versión del instalador que utilizaste para la implementación actual. Para obtener instrucciones, consulta la documentación de copia de seguridad y restauración correspondiente a la versión de Automation Suite desde la que piensas actualizar. Por ejemplo, si planeas actualizar desde Automation Suite 2021.10, sigue las instrucciones de la guía 2021.10.
2. Inicia sesión en el nodo del servidor que identificaste previamente como nodo de host de Ansible a través de SSH.
3. Verifica que todos los volúmenes deseados tienen copias de seguridad en el clúster:

   /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   Aviso: La copia de seguridad puede tardar algún tiempo, así que espera de 15 a 20 minutos y vuelve a verificar la copia de seguridad de los volúmenes.

Una vez creada la copia de seguridad, continúa con los pasos siguientes.

Putting the cluster in maintenance mode

La puesta del clúster en modo de mantenimiento apagará el controlador de entrada y todos los servicios UiPath, bloqueando todo el tráfico entrante al clúster Automation Suite.

Importante: Esta operación ocasionará tiempo de inactividad, y la automatización de tu empresa se suspenderá durante todo el proceso de actualización.

1. Para poner el clúster en Modo de mantenimiento, ejecuta:

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode

2. Para verificar que el clúster está en modo de mantenimiento, ejecuta:

   ./configureUiPathAS.sh is-maintenance-enabled

   Importante: Crea una copia de seguridad de tu SQL Server después de activar el modo de mantenimiento para que no se registren más transacciones en tu base de datos SQL.

Actualizar el clúster

Para actualizar el clúster de Automation Suite, siga los siguientes pasos:

1. Conéctate al nodo del host Ansible a través de SSH y conviértete en usuario raíz.
2. Para realizar los pasos de actualización en todos los nodos, ejecute el siguiente comando con los parámetros básicos. Para un control más detallado, consulta la sección de parámetros.
   Nota: Asegúrate de haber actualizado cluster_config.json como se describe en los pasos de Preparación.

   # Please replace {version} with installer version, in all the below commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-infra-bundle /uipath/{version}/sf-infra.tar.gz --accept-license-agreement

   Importante:

   El proceso de actualización requiere migrar de Canal CNI a Cilium CNI. La actualización automatizada realiza este paso automáticamente y luego reinicia todos los nodos del clúster para completar la migración.

   Una vez que se reinicien los nodos, espere unos minutos para asegurarse de que todos los servicios vuelven a estar en línea. Puede iniciar sesión en ArgoCD para supervisar el estado de todas las aplicaciones.

   Importante:

   Si recibes el siguiente error, sigue las instrucciones de Degradación de Ceph de la versión 16.2.6 a la 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Parámetros básicos

Parámetro	Valor
--install-type	Valores posibles: online y offline. Dado que esta página proporciona instrucciones para un entorno sin conexión, elija el valor offline .
--steps	Los valores posibles son: all, infra, fabric y services. Indica cada etapa del proceso de instalación y actualización. all - Recomendado: un superconjunto de todos los demás pasos, que actualiza Automation Suite por completo. infra : actualiza Kubernetes y otros componentes de infraestructura en Automation Suite en todos los nodos. bundles : carga e hidrata el registro de Docker alojado en el clúster de Automation Suite con las imágenes del contenedor de estructuras y servicios. Importante: debes cargar e hidratar el registro de Docker al mismo tiempo que actualizas Kubernetes y los componentes de la infraestructura. Para ejecutar los dos pasos simultáneamente, ejecuta --steps bundles infra. No ejecutar --steps bundles por su cuenta, ya que dañará el clúster. fabric : actualiza toda la estructura y los componentes compartidos de Automation Suite. services : actualiza todos los servicios de los productos UiPath instalados en Automation Suite. Si se produce un error durante la actualización, puede utilizar estos puntos de control para reanudar la operación de actualización en lugar de volver a intentarlo desde el principio.
--offline-bundle	Ruta al paquete sin conexión sf.tar.gz , que contiene las imágenes del contenedor de servicios y la estructura. Se recomienda almacenarlo en /uipath/{version}/sf.tar.gz
--offline-infra-bundle	Ruta al paquete sin conexión sf-infra.tar.gz , que contiene Kubernetes y paquetes de infraestructura.
--cluster-config	cluster_config.json archivo, que define los parámetros, ajustes y preferencias aplicados a los servicios UiPath implementados a través de Automation Suite.

Parámetros avanzados

Parámetro	Valor
--ansible-username	Especifique el nombre de usuario que se utilizará para las conexiones SSH a todos los nodos. Predeterminado: usuario actual. Si usas un nombre de usuario diferente para todos los nodos, en lugar de usar este parámetro, establece el nombre de usuario para todos los nodos en inventory.ini y pásalo al script. Ejemplo: Mientras se ejecuta el script, inicia sesión con el nombre de usuario myadminuser. Sin embargo, si quieres utilizar el nombre de usuario testadmin para conectarte a través de SSH, debes proporcionar testadmin a este parámetro.
--inventory	Especifique un archivo de inventario de Ansible existente. Si no se especifica, se generará uno automáticamente a partir del clúster existente con la configuración básica. En determinadas situaciones en las que quieres tener un control más detallado, puede que quieras proporcionar tu propio archivo de inventario. Un ejemplo sería si quieres utilizar un nombre de usuario SSH o una clave SSH diferente para todos los nodos del clúster. Para obtener más información, consulta Generar el archivo Inventory.ini de Ansible.

Nota:

Si la actualización falló por cualquier motivo, pero la carga en el Registro de Docker se realizó correctamente, no es necesario volver a cargar. Puede reanudar la actualización ejecutando directamente la instalación del servicio o la estructura: ./uipathctl.sh upgrade --install-type offline --steps {fabric | services} .

Una vez realizada la actualización, el modo de mantenimiento se desactivará automáticamente.

Después de realizar la actualización, puedes seguir los siguientes pasos adicionales:

• Para verificar si Automation Suite está en buen estado, ejecute:

  kubectl get applications -n argocd

• Si experimentas incidencias con las vulnerabilidades de imagen o el consumo de almacenamiento después de realizar una actualización, elimina las imágenes del instalador antiguo. Para obtener más detalles, consulta la sección Solucionar problemas.

Enabling the backup post-upgrade

Nota: Asegúrate de que Automation Suite está en funcionamiento y de que tu automatización continúa según lo previsto antes de proceder con los pasos siguientes.

Antes de comenzar a actualizar el clúster, el script de actualización crea automáticamente una copia de seguridad del clúster y, luego, la desactiva temporalmente. Puede que quieras habilitar la copia de seguridad manualmente una vez finalizada la actualización

Para habilitar la copia de seguridad, sigue las instrucciones descritas en la documentación del clúster Hacer copia de seguridad y restaurar.