Completar una actualización

Contexto

Después de realizar una actualización de clúster de Automation Suite, se necesitan algunos cambios para garantizar que un nuevo nodo se una al clúster correctamente. Para automatizar los cambios, recomendamos usar el script upgradeUiPathAS.sh.

Esta página proporciona instrucciones sobre cómo reemplazar la extensión de script personalizado (CSE) en los recursos de cálculo para que se puedan añadir nuevos nodos a tu clúster al actualizar a una nueva versión de Automation Suite.

El proceso descrito en las siguientes secciones descarga los scripts necesarios para realizar algunas modificaciones menores en los recursos de Azure, así como para validar algunos requisitos previos. Los scripts se encuentran dentro de las carpetas <targetVersion> y Modules . Si el proceso falla, se le preguntará si desea conservar los archivos.

Después de asegurarnos de que los requisitos previos son válidos, los objetos CustomScriptExtension se actualizan en todos nuestros recursos de cálculo para que los nodos recién añadidos utilicen Automation Suite <targetVersion>. Por último, los archivos de los nodos del clúster iniciales se sobrescriben para que coincidan también con los archivos de <targetVersion>.

Preparación

Requisitos previos

Asegúrate de cumplir los siguientes requisitos:

• Debe añadir la Identidad de servicio administrado (MSI) asociada con la implementación (denominada como <basename>-MSI) como una identidad asignada por el usuario para todos los conjuntos de escalas / máquinas virtuales de la implementación. Para ello, vaya a Conjunto de escalas / máquina virtual > Identidad > Usuario asignado > Agregar. Es posible que las versiones más recientes de las plantillas de Automation Suite ya lo tengan agregado.
• Debes conceder los derechos MSI existentes para leer / escribir / gestionar secretos en el almacén de claves implementadas (denominado <basename>-VAULT). Para ello, dirígete al almacén de claves, haz clic en Políticas de acceso, Agregar, selecciona todas las Operaciones secretas, elige el MSI y, por último, en Agregar.
• Asegúrese de revisar el archivo cluster_config.json y cambiar cualquier valor booleano marcado como cadena ("true"/"false") a valores booleanos reales (true/false). Por ejemplo:
  • para habilitar la resistencia de la zona, utilice "zone_resilience": true.
  • para permitir que el instalador cree las bases de datos, utiliza "sql.create_db": true.
  Nota:

  Si actualizas de Automation Suite 2022.10 a Automation Suite 2023.4 o posterior, y Orchestrator está habilitado tanto en la versión antigua como en la nueva, debes establecer el indicador orchestrator.block_classic_executions en true en el archivo cluster_config.json. El uso del indicador muestra que estás de acuerdo con el bloqueo de las ejecuciones de carpetas clásicas. El no utilizarlo ocasiona un error de la operación de actualización. Este parámetro no es necesario en las nuevas instalaciones.
• Después del proceso de actualización, exporta el contenido del nuevo archivo cluster_config.json a un secreto del almacén de claves de Azure llamado clusterConfig en el almacén de claves de implementación (para obtener más información, consulta el elemento de la lista anterior). Usa el valor del campo FixedRKEAddress como IP del equilibrador de carga interno. Para ello, ejecute un comando similar al siguiente:

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)

• En la máquina que ejecuta el script de actualización, debes iniciar sesión en Azure y establecer el contexto en la suscripción correcta. La cuenta debe tener el rol Owner en el grupo de recursos en el que se implementó el clúster.

Consideraciones y recomendaciones

Antes de iniciar la operación de actualización, asegúrese de tener en cuenta las siguientes recomendaciones:

• Recomendamos encarecidamente actualizar a la última versión del sistema operativo RHEL compatible con Automation Suite. Para obtener más información, consulta Perfiles de implementación de un vistazo.
• Antes de iniciar la operación de actualización, puede crear dos contenedores llamados logs y flags en la cuenta de almacenamiento de implementación (llamada <basename>st). Si no los crea, el script de actualización puede hacerlo por usted.
• Si los conjuntos de escalas del servidor implementados no tienen un disco Ceph adjunto, el script crea uno y lo adjunta al conjunto de escalas del servidor.
• El proceso de actualización cambia el modelo de VMSS, pero no lo aplica para instancias más antiguas.
• Para obtener más información sobre los errores de actualización que puede encontrar, consulte Manual: actualización en línea y Automatizado: actualización en línea.

Ejecución

Para actualizar con éxito a una nueva versión de Automation Suite, siga los siguientes pasos:

1. Descarga el script upgradeUiPathAS.sh desde aquí.
2. Navega hasta la ruta en la que has descargado el script y ejecuta el siguiente comando: chmod +x ./upgradeUiPathAS.sh.
3. Ejecute el proceso de actualización en modo interactivo o no interactivo en un entorno Linux:

   • Opción A: para ejecutar el proceso en modo interactivo, utilice el siguiente comando:

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     El script le pide que proporcione una serie de parámetros durante la ejecución. Para obtener más información sobre los parámetros necesarios, consulta Implementación de Automation Suite en Azure.

   • Opción B: para ejecutar el proceso en un modo no interactivo, siga los siguientes pasos:

     1. Crea una carpeta <targetVersion> junto al script descargado.
     2. Dentro de la carpeta <targetVersion> , crea un archivo llamado paramValues.json con la siguiente estructura:
        { "param1":"value1", "param2":"value2" }.

        Para obtener más información sobre los parámetros necesarios, consulta Implementación de Automation Suite en Azure.

     3. Ejecuta el script upgradeUiPathAS.sh:

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        Nota: Asegúrate de reemplazar {ASversion} con la versión de Automation Suite en los comandos mencionados anteriormente. La versión de Automation Suite puede diferir de la versión de la plantilla de Azure.

Parámetros

Puedes encontrar descripciones de los parámetros necesarios para actualizar a una versión de Automation Suite específica en el archivo cluster_config.json. Puedes encontrar el archivo cluster_config.json en este enlace.