Automatizado: Actualización en línea

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

In the following illustration, the Server 1 node (or Ansible host node) uses Ansible to orchestrate the upgrade of entire Automation Suite cluster.

Preparación

Importante:

Before upgrading, make sure you have prepared your environment for using the uipathctl.sh script. For details, see Using uipathctl.sh.

Asegúrate de tener 10 GB de espacio libre en la carpeta /opt/UiPathAutomationSuite en todos los nodos. Si no tienes suficiente espacio, 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. Log into the server node that you previously identified as the Ansible host node via SSH.

2. Conviértete en usuario root.

   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. Download as-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see as-installer.zip.

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

5. Descomprime as-installer.zip.

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

6. Proporciona los permisos necesarios al instalador.

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

7. Genere el archivo cluster_config.json más reciente en el nodo de host de Ansible.

   Nota:

   For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

   • 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
     

   • If you upgrade from Automation Suite 2022.10 to Automation Suite 2023.4 or later, and Orchestrator is enabled on both the old and new versions, you must set the orchestrator.block_classic_executions flag to true in the cluster_config.json file. Using the flag shows that you agree with blocking classic folders executions. Not using the flag causes the upgrade operation to fail. For a configuration example, see Orchestrator-specific configuration.

   • If you upgrade Automation Suite from a previous version and now enable Process Mining as well, you must update the sql_connection_string_template_sqlalchemy_pyodbc. Below is an example.

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

   • If you upgrade Automation Suite from a version previous to 2023.4 and you have Apps enabled, you must create the SQL database for Apps, and then update the cluster_config.json file with the following configuration:

     "apps": {
     "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
     "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
     }
     

     Nota:

     Usa el archivo cluster_config.json actualizado en los siguientes pasos de actualización.

See also Manual: Advanced installation experience.

Importante:

If you previously deployed your single-node installation using any Azure template version prior to 2022.10.3, and you now want to upgrade to a newer Automation Suite version, you must set the zone_resilience flag to false in the cluster_config.json file in /opt/UiPathAutomationSuite/Installer.

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.

For instructions, see Rollback on error.

Configuring the backup

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

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

2. Log into the server node that you previously identified as the Ansible host node via 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
   

   Nota:

   La copia de seguridad puede tardar un tiempo. Espere unos 15 o 20 minutos aproximadamente y, después, verifique la copia de seguridad de nuevo.

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:

This operation will cause downtime, and your business automation will be suspended during the entire upgrade process.

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:

   Create a backup of your SQL Server after enabling maintenance mode so that no further transactions are recorded in your SQL database.

Upgrading the cluster

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

1. Conéctate al nodo del host de Ansible a través de SSH, y conviértete en usuario root.

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:

   Make sure you have updated cluster_config.json generated as described in the Preparation steps.

   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --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:

   If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 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 ofrece instrucciones para un entorno en línea, elige el valor online.
--steps	Los valores posibles son: all, infra, fabric y services. Indica cada etapa del proceso de instalación y actualización. all: un superconjunto de todos los demás pasos, que actualiza toda la Automation Suite. infra : actualiza Kubernetes y otros componentes de infraestructura en Automation Suite en todos los nodos. 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.
--cluster-config	El archivo cluster_config.json, 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. For details, see Generating the Ansible inventory.ini file.

Nota:

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

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

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

  kubectl get applications -n argocd
  

• Al actualizar desde una versión de Automation Suite anterior a la 2023.4.0, comprueba si Apps está ejecutándose y luego, elimina MongoDB:

  ./configureUiPathAS.sh mongodb uninstall --force
  

• Si se produce un error al eliminar MongoDB con el comando ./configureUiPathAS.sh mongodb uninstall --force, ejecuta el siguiente comando:

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

Enabling the backup post-upgrade

Nota:

Make sure Automation Suite is up and running and your automation continues as expected before proceeding with the next steps.

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

To enable the backup, follow the instructions in described in the Backing up and restoring the cluster documentation.

Completar una actualización con una plantilla de implementación

After performing an Automation Suite cluster upgrade, Azure and AWS template deployments require some changes to ensure a new node joins the cluster correctly through scale-out operations. To automate the changes, we recommend using the dedicated scripts. For instructions, see the Azure deployment template docs and the AWS deployment template docs.

Consideraciones especiales

Al realizar una actualización para un clúster implementado con plantillas de Azure, puede producirse un error similar al que se muestra en la siguiente imagen:

Esto se debe a la forma en que funciona el equilibrador de carga de Azure. Para solucionar el problema, modifica el campo fixed_rke_address en el archivo cluster_config.json . Debes cambiar el valor de este campo a la dirección IP de la primera instancia del servidor antes de ejecutar el comando de actualización. El cluster_config.json cargado en el almacén de claves debe seguir teniendo la dirección IP del ILB, ya que el nodo no está en buen estado y el tráfico no se equilibrará en él.