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:

• 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.
• Asegúrate de que tu versión de RHEL para los conjuntos de escalado de máquinas virtuales (servidor, agente, etc.) esté actualizada y coincida con la versión a la que estás actualizando.
• 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.
• Si actualizas a Automation Suite 2023.10 o posterior e Insights está habilitado tanto en el entorno antiguo como en el nuevo, debes establecer el marcador insights.external_object_storage.bucket_name en el mismo depósito utilizado para platform en el archivo cluster_config.json. El no utilizarlo ocasiona un error de la operación de actualización. Este parámetro no es necesario en las nuevas instalaciones.
• Si actualizas a Automation Suite 2023.10 o posterior, asegúrate de rellenar los siguientes campos en cluster_config.json si sql.create_db está establecido en true:

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

• 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 Requisitos de hardware y software.
• 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.
• 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 . Debe 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 al almacén de claves debe seguir teniendo la dirección IP del ILB, ya que el nodo no funciona correctamente y el tráfico no se equilibrará hacia él.

Ejecución

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

1. Descargue 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 específica de Automation Suite en el archivo cluster_config.json . Puedes encontrar el archivo cluster_config.json en este enlace.