Completar una actualización

Context

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:

• Debes añadir la identidad de servicio gestionado (MSI) asociada a la implementación (llamada como <basename>-MSI) como identidad asignada por el usuario a todos los conjuntos de escalado/máquinas virtuales de la implementación. Para ello, ve a Conjunto de escala/máquina virtual > Identidad > Asignado por el usuario > Añadir. Es posible que las versiones más recientes de las plantillas de Automation Suite ya tengan esto añadido.

• You must grant the existing MSI rights to read/write/manage secrets in the deployed key vault (named like <basename>-VAULT). To do this, go to the keyvault, click Access Policies, then Add, select all Secret Operations, choose the MSI, then Add.

• 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:

  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.

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

• 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:

• We strongly recommend updating to the latest RHEL OS version supported by Automation Suite. For details, see Deployment profiles at a glance.
• 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.
• For details on the upgrade errors you might encounter, see Manual: Online upgrade and Automated: Online upgrade.

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, utiliza el siguiente comando:

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     The script asks you to provide a series of parameters during the run. For details on the required parameters, see Deploying Automation Suite to 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" }.

        For details on the required parameters, see Deploying Automation Suite to Azure.

     3. Ejecuta el script upgradeUiPathAS.sh:

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

        Nota:

        Asegúrate de reemplazar {ASversion} por la versión de Automation Suite en los comandos mencionados. 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 específica de Automation Suite en el archivo cluster_config.json . Puedes encontrar el archivo cluster_config.json en este enlace.