Automation Suite
2022.10
False
Imagen de fondo del banner
Guía de instalación de Automation Suite
Última actualización 24 de abr. de 2024

Paso 3: Pasos posteriores a la implementación

Nota: Al usar Azure Bastion, ten en cuenta que copiar y pegar comandos divididos en varias líneas usando \ puede no funcionar como se espera. Para garantizar que las nuevas líneas se interpreten correctamente, utilice el widget de portapapeles de la consola.

Validar la instalación

Para comprobar si Automation Suite se instaló correctamente, debe ir a la cuenta de almacenamiento, dentro del contenedor de indicadores . La instalación está completa si el contenido del archivo generado automáticamente llamado installResult (en el contenedor) es successful. El contenido será failed si falla la instalación.

Actualizar certificados

Importante:

El proceso de instalación genera certificados autofirmados en su nombre. No obstante, la plantilla de implementación de Azure también ofrece la opción de proporcionar un certificado de servidor emitido por una autoridad de certificación en el momento de la instalación en lugar de utilizar un certificado autofirmado de manera automática.

Estos certificados autofirmados caducarán en 90 días, y deberá sustituirlos por certificados firmados por una autoridad de certificación de confianza en cuanto finalice la instalación. Si no actualiza los certificados, la instalación dejará de funcionar transcurridos 90 días.

Para obtener instrucciones, consulta Gestión de certificados.

Exploring flags and logs

Si necesita más información sobre el proceso de instalación de Automation Suite u otras operaciones, un buen lugar para comenzar es la cuenta de almacenamiento utilizada para almacenar varios indicadores y registros durante la implementación y el mantenimiento del clúster.

Para localizar la cuenta de almacenamiento, siga los siguientes pasos:

  1. Navega hasta el grupo de recursos en el que se realizó la implementación.
  2. Filtrar por tipo de recurso Cuenta de almacenamiento.
  3. Localiza la cuenta de almacenamiento cuyo nombre termina en st. Por ejemplo:


  4. Selecciona la cuenta de almacenamiento y luego haz clic en Contenedores. Sus opciones son indicadores y registros.


Contenedor de banderas

El contenedor de indicadores almacena varios indicadores o archivos necesarios para la orquestación o simplemente para informar del estado de varias operaciones. En un clúster nuevo, el contenido del contenedor de indicadores suele tener el aspecto que se muestra en el siguiente ejemplo:



Los archivos de los contenedores de indicadores se utilizan para organizar diversas operaciones, como el proceso de instalación de Automation Suite en el clúster, u operaciones específicas del clúster, como la actualización de instancias. Por ejemplo:

  • uipath-server-000000.success indica que la instalación de la infraestructura se completó correctamente en ese nodo específico del clúster;
  • installResult lee success si la instalación general se ha realizado correctamente.

Contenedor de registros

Al realizar una operación, normalmente genera un archivo de registro en el contenedor de registros . En un clúster nuevo, el contenido del contenedor de registros normalmente se ve como se muestra en el siguiente ejemplo:



Cada archivo del contenedor de registros representa los registros de un paso específico del proceso de instalación. Por ejemplo:

  • infra-uipath-server-000000.log almacena los registros de instalación de la infraestructura;
  • fabric.log almacena los registros de la instalación de la estructura;
  • services.log almacena los registros para la instalación de la aplicación y los servicios.

Acceder a las salidas de implementación

Una vez completada la instalación, deberá acceder a las salidas de implementación en la pestaña Salidas.

Para ello, ve a tu grupo de recursos y, a continuación, a Implementaciones → mainTemplate (o algo similar a Microsoft.Template-DateTime) → Salidas.






Salidas de implementación

Salida

Descripción

Documentación

Un enlace a la documentación.

URL

La URL del equilibrador de carga. Puede utilizarse para el acceso directo.

Si se activaron dominios personalizados, este es el dominio que utilizaría para el enlace CNAME.

KeyVaultURL

La URL de Azure Portal para el almacén de claves creado por la implementación. Contiene todos los secretos (credenciales) que se utilizaron en la implementación.

ArgoCDURL

La URL para acceder a ArgoCD. Está disponible en la VNet. El acceso externo a esta URL debe configurarse como se describe en el Paso 4: configurar el DNS.

ArgoCDPassword

La contraseña que se utiliza para iniciar sesión en el portal de ArgoCD.

HostAdminUsername y HostAdminPassword

Las credenciales utilizadas para la administración del host.

URL de administración de clúster

Todas las credenciales utilizadas en la implementación se almacenan como secretos dentro de un almacén de claves aprovisionado durante la implementación. Para acceder a los secretos, filtre los recursos del grupo de recursos, busque Almacén y, a continuación, haga clic en Secretos.

Nota:
Si ve la advertencia The operation “List” is not enabled in the key vault’s access policy en la pestaña Secretos, siga estos pasos:
  1. Diríjase a Directivas de acceso → Añadir directiva de acceso → Configurar la plantilla → Gestión de secretos → Seleccionar principal.
  2. Seleccione su usuario y, a continuación, haga clic en Guardar.
  3. Vuelva a Secretos. La advertencia debería haber desaparecido y los secretos deberían ser visibles.


Acceder a las máquinas virtuales del clúster

Las máquinas virtuales se aprovisionan dentro de una VNet privada. Puede acceder a ellas a través de Azure Bastion, siguiendo estos pasos:

  1. Diríjase al grupo de recursos en el que ha implementado Automation Suite.
  2. Dado que los agentes, los agentes de GPU y las máquinas virtuales del servidor están dentro de los conjuntos de escalado, tiene que dirigirse al conjunto de escalado que contenga la instancia deseada.


  3. Vaya a la sección Instancias de la pestaña Configuración.


  4. Haga clic en el nombre de la máquina virtual que desee conectar.


  5. Haga clic en el botón Conectar y elija Bastion en el menú desplegable.


  6. Introduzca las credenciales proporcionadas en la implementación (los parámetros correspondientes al nombre de usuario de administrador y a la contraseña de administrador, los cuales podrá encontrar en el almacén de credenciales, en Secretos) y haga clic en Conectar.


Requisitos de DNS

Tal como se menciona en el Paso 1: Preparar la implementación de Azure, la implementación de Automation Suite en Azure crea un equilibrador de carga con una IP pública y una etiqueta de DNS asociada. Esta etiqueta de DNS es propiedad de Microsoft.

La implementación también aprovisiona una zona de DNS privada dentro de la VNet del clúster y añade varios registros que se utilizan durante el proceso de instalación y configuración.

Si elige conectarse desde una máquina externa, no podrá utilizar la zona de DNS privada para resolver el DNS de varios servicios, por lo que deberá añadir estos registros a su archivo de host.

Consulta Paso 4: Configurar el DNS para obtener más detalles.

Ahora debería poder conectarse a varios servicios que se ejecutan en su clúster.

Acceso al Portal de administración del clúster

El portal de administración de clústeres es una ubicación centralizada donde puedes encontrar todos los recursos necesarios para completar la instalación de Automation Suite y realizar operaciones comunes posteriores a la instalación. Para obtener más información, consulta Primeros pasos con el portal de administración de clústeres.

Para acceder al portal de administración de clústeres, realice el siguiente paso:

Acceda a la siguiente URL: https://${CONFIG_CLUSTER_FQDN}/uipath-management.
Nota: No necesita credenciales para acceder al portal de administración de clústeres.

Acceder a la interfaz general de Automation Suite

La interfaz de usuario de uso general de Automation Suite sirve de portal tanto para los administradores como para los usuarios de su organización. Se trata de un recurso común en el ámbito de la organización desde el que todo el mundo puede acceder a todas las áreas de Automation Suite: páginas de administración, páginas de la plataforma, páginas específicas de los servicios y también páginas específicas de los usuarios.

Para acceder a Automation Suite, siga estos pasos:

  1. Diríjase a la siguiente URL: https://${Loadbalancer_dns}, donde <loadbalancer_dns> es la etiqueta de DNS para el equilibrador de carga. Se encuentra en Salidas.
  2. Cambie a la organización predeterminada.
  3. El nombre de usuario es orgadmin.
  4. Recupera la contraseña yendo a Keyvault, Secretos y Contraseña de administrador Host.

Acceder a la administración del host

El portal del host es donde los administradores de sistemas configurar la instancia de Automation Suite. Los ajustes configurados desde este portal son heredados por todas las organizaciones. Algunos pueden sobrescribirse en el nivel de la organización.

Para acceder a la administración del host, siga estos pasos:

  1. Diríjase a la siguiente URL: https://${Loadbalancer_dns}, donde <loadbalancer_dns> es la etiqueta de DNS para el equilibrador de carga. Se encuentra en Salidas.
  2. Cambie a la organización del host.
  3. Escribe el nombre de usuario que especificó previamente como valor para el parámetro Nombre de usuario de administrador de UiPath .
  4. Introduce la contraseña que has especificado previamente como un valor para el parámetro Clave de administrador de UiPath. Recupera la contraseña yendo a Keyvault, Secretos y Contraseña de administrador Host.

Acceder a ArgoCD

Puede utilizar la consola ArgoCD para gestionar los productos instalados.

Para acceder a ArgoCD, siga estos pasos:

  1. Diríjase a la siguiente URL: https://alm.${Loadbalancer_dns}, donde <loadbalancer_dns> es la etiqueta de DNS para el equilibrador de carga. Se encuentra en Salidas. Ten en cuenta que debes configurar el acceso externo a esta URL, tal como se describe en el Paso 4: Configurar el DNS.
  2. El nombre de usuario es admin.
  3. Para acceder a la contraseña, vaya a la pestaña Salidas o al almacén de credenciales.

Acceder a Rancher

Automation Suite utiliza Rancher para proporcionar herramientas de gestión de clústeres listas para usar. Esto le ayuda a gestionar el clúster y acceder a opciones de supervisión y resolución de problemas.

Consulta Documentación de Rancher para obtener más información.

Consulta Utilizar la pila de supervisión para obtener más información sobre cómo utilizar la supervisión de Rancher en Automation Suite.

Para acceder a la consola de Rancher, siga estos pasos:

  1. Diríjase a la siguiente URL: https://monitoring.${Loadbalancer_dns}, donde <loadbalancerdns> es la etiqueta del DNS del equilibrador de carga y puede encontrarse entre las Salidas de la implementación.
  2. El nombre de usuario es admin.
  3. Para acceder a la contraseña, ejecute lo siguiente.
    kubectl get secrets/rancher-admin-password -n cattle-system \
-o "jsonpath={.data['password']}" | echo $(base64 -d)kubectl get secrets/rancher-admin-password -n cattle-system \
-o "jsonpath={.data['password']}" | echo $(base64 -d)

Escalar el clúster

Los recursos informáticos aprovisionados en la implementación son conjuntos de escalado de Azure, que facilitan la escalabilidad.

Puede añadir manualmente recursos adicionales a un conjunto de escalado específico, incluyendo la inclusión de nodos de servidor, nodos agente o nodos agente especializados (como nodos de GPU).

Puede llevar a cabo un escalado manual identificando el conjunto de escalado específico y añadiendo recursos directamente.

Para ello, siga estos pasos:

  1. Diríjase a Azure Portal y filtre por el conjunto de escalado específico:


  2. Seleccione el conjunto de escalado adecuado y haga clic en Escalado.


  3. Modifique el campo Número de instancias utilizando el control deslizante o el campo de entrada cercano. Después, haga clic en Guardar.
    Nota: En el caso de los conjuntos de escalado del servidor, el número de instancias debe ser impar.
  4. La operación de escalado debe iniciarse en segundo plano. Los recursos nuevos estarán disponibles una vez completado el proceso.

Completar una actualización

Después de realizar una actualización de clúster de Automation Suite, las implementaciones de plantillas de Azure requieren algunos cambios para garantizar que un nuevo nodo se una al clúster correctamente. Para automatizar los cambios, recomendamos utilizar el script dedicado. Para obtener instrucciones, consulta los documentos de la plantilla de implementación de Azure.

Operaciones del ciclo de vida de la máquina virtual de Azure

Consejo:

Azure permite un máximo de 15 minutos para prepararse para el apagado, mientras que la finalización elegante de un nodo de Automation Suite varía desde los 20 minutos (para los nodos agente y agente de GPU) a varias horas (en el caso de los nodos servidor).

Para evitar pérdidas de datos, la política de actualización VMSS del servidor está establecida en manual y las máquinas virtuales del servidor tienen habilitada la protección para las acciones del conjunto de escalado. Como resultado, recomendamos gestionar el ciclo de vida del servidor a través de los Runbooks proporcionados.

Los runbook ActualizaciónDeInstancia, EliminarNodos, EliminarServidoresy CheckServerZoneResilience solo se admiten para implementaciones de producción multinodo preparadas para alta disponibilidad.

El número de servidores después de ejecutar cualquier runbook debe ser impar y superior a tres (por ejemplo, no puede ejecutar una actualización de instancia si tiene 4 servidores; no puede eliminar un servidor si tiene un total de cinco).

Todas las máquinas virtuales de los VMS deben estar en estado Running .

Solo se debe ejecutar un runbook a la vez.

Importante: los runbook ActualizarDeInstancias, EliminarNodos y EliminarServidores se ven afectados por un problema que provoca que las operaciones de eliminación de nodos fallen si los pods de servicio Process Mining (AirFlow) y / o Automation Suite Robots están programados en el nodo.

InstanceRefresh

Descripción

El runbook InstanceRefresh tiene los siguientes casos prácticos:

  • Actualice la SKU del sistema operativo VMSS en los conjuntos de escalas de servidor, agente y GPU.
  • Realizar una operación de rotación de nodo para uno o más VMS.
  • Otros cambios de configuración de VMSS que se aplicaron a VMSS de antemano.

Uso

  1. Ve al Azure Portal y busca el recurso llamado InstanceRefresh.
  2. Haga clic en el botón de inicio para abrir la lista de parámetros. Complete los parámetros teniendo en cuenta:
    • Se realiza una operación de rotación de nodo en un VMSS solo si el parámetro REFRESH<node_type> está establecido en True. Si varios parámetros REFRESH<node_type> se establecen en True, el orden de rotación de nodos de VMSS será Servidores -> Agentes -> Agentes de GPU.
    • Debes proporcionar el parámetro NEWOSVERSION para actualizar la SKU del SO VMSS. Puedes encontrar la SKU de imagen de las máquinas virtuales de Azure Marketplace disponible usando az vm image list-skus --location <deployment_location> --offer RHEL --publisher RedHat --output table. Las VM actuales no se actualizan automáticamente al último modelo (se necesita una operación de rotación de nodo para ello).

      Haga clic en el botón Aceptar para iniciar el runbook.



Detalles de implementación

El runbook InstanceRefresh es un contenedor para el runbook EliminarNodes. Como resultado, se realiza un seguimiento del estado mientras se ejecuta EliminarNodos. Actualiza todas las versiones del sistema operativo VMSS (si es necesario) y extrae, según los parámetros recibidos, el nombre de host para la operación de rotación de nodo y los reenvía a EliminarNodos. Si el clúster tiene exactamente tres servidores, el runbook InstanceRefresh crea tres nuevos servidores; de lo contrario, RemoveNodes gestiona el escalado para mantener al menos un servidor en cada zona de disponibilidad en todo momento.

RemoveNodes

Descripción

El runbook de EliminarNodos tiene los siguientes casos prácticos:

  • Elimina los nodos especificados del clúster de Automation Suite.
  • Realiza una operación de rotación de nodos para una/dos máquinas virtuales.

Uso

  1. Busca los nombres de equipo de los nodos que quieres eliminar. Para ello, vaya a un VMSS y haga clic en Instances en la sección Settings .


  2. Ve al Azure Portal y busca el recurso llamado RemoveNodes.
  3. Haz clic en el botón de inicio para abrir la lista de parámetros. Completa los parámetros teniendo en cuenta lo siguiente:
  • NODESTOBEREMOVEDCOMPUTERNAME es una lista separada por comas de los nombres de las máquinas virtuales que quieres eliminar (p. Ej., pxlqw-agent-000009,pxlqw-agent-00000A) y es el único parámetro obligatorio. Recomendamos eliminar los nodos de un solo VMSS a la vez.
  • ISINSTANCEREFRESH y THREESERVERSSCENARIO son marcadores rellenados por el contenedor InstanceRefresh .

    Haga clic en el botón Aceptar para iniciar el runbook.



Detalles de implementación

El runbook de RemoveNodes tiene un enfoque recurrente para superar el tiempo de espera de 3 horas de uso compartido justo. Elimina o vuelve a cargar los primeros o los dos primeros nodos (el número se elige para cumplir la restricción del número impar de servidores) de la lista recibida y vuelve a ejecutar otra instancia del runbook con la lista restante.

La operación de reparación de nodos requiere seguir los siguientes pasos:

  1. Escale el VMSS con una o dos máquinas virtuales en función de la cantidad de nodos que se eliminarán.
  2. Realiza la eliminación de nodos para las instancias antiguas.

La operación de eliminación de nodo de un nodo requiere seguir los siguientes pasos:

  1. Acordonar y vaciar las instancias. El tiempo de espera de la operación se agota después de 20 minutos para un agente y number_of_instances * 60 minutos para los servidores.
  2. Detenga el servicio rke en las instancias. La operación agota el tiempo de espera después de 5 minutos.
  3. Elimina los nodos del clúster de Automation Suite y elimina las VM. El tiempo de espera de la operación se agota después de 20 minutos para los agentes y number_of_instances * 60 minutos para los servidores.

RemoveServers

Descripción

El runbook RemoveServers tiene el siguiente caso de uso:

  • eliminar servidores del clúster de Automation Suite.

Uso

  1. Vaya a Azure Portal y busque el recurso llamado RemoveServers.
  2. Haz clic en el botón de inicio para abrir la lista de parámetros. Completa los parámetros teniendo en cuenta lo siguiente:
  • REMOVEDSERVERSCOUNT es el número de servidores que se eliminarán. Recomendamos no eliminar más de 2 servidores a la vez para no alcanzar el tiempo de espera de uso compartido justo.


Detalles de implementación

El runbook EliminarServidores elimina el número de servidores recibidos como parámetro de las zonas de disponibilidad con más máquinas virtuales.

CheckServerZoneResilience

Descripción

El runbook CheckServerZoneResilience escala el VMSS del servidor y utiliza el runbook EliminarServidores para equilibrar los servidores en las zonas de disponibilidad. Esto forma parte del flujo de actualización de instancia y no se debe ejecutar manualmente.

AddGpuNode

Descripción

En el escenario en el que se creó la implementación inicial sin un nodo de GPU, creamos el conjunto de escalas de VM, pero tenemos un SKU diferente para evitar problemas de disponibilidad de zona / SKU. Este runbook cambia la SKU a SKU de GPU y agrega un nodo.

Importante: No escale el VMSS de la GPU inicial creado antes de ejecutar este runbook si la implementación inicial se creó sin nodos de GPU.

Uso

Para utilizar este runbook, siga los siguientes pasos:

  1. Navega hasta el grupo de recursos en el que implementaste Automation Suite y luego identifica Cuenta de automatizacióny haz clic en ella.
  2. Haz clic en Runbook y luego en el runbook AddGPUNode.
  3. Proporciona un nombre para el SKU que deseas y haz clic en Iniciar.

Parámetros:

skuName : la SKU para los nodos de GPU VMSS.

Valores permitidos:

  • Standard_NC8as_T4_v3
  • Standard_NC12s_v3
  • Standard_NC24s_v3

RegisterAiCenterExternalOrchestrator

Descripción

El runbook registra AI Center en el Orchestrator externo proporcionado en el momento de la implementación.

Uso

El documento expone un solo parámetro obligatorio, IdentityToken, que es un token de acceso a la instalación generado por el servicio de identidad externo. Dado que el token tiene una disponibilidad breve (aproximadamente de 1 a 2 horas), recomendamos generarlo justo antes de ejecutar el runbook. Para obtener más información, consulta Clave de instalación.

BackupCluster

Descripción

El runbook de Copia de seguridad de clúster le ayuda a realizar una copia de seguridad de su clúster.

Uso

  1. Diríjase hasta el grupo de recursos donde implementó Automation Suite, luego identifíquelo y haga clic en Cuenta de automatización.


  2. Haga clic en Runbook y luego en el runbook de Copia de seguridad de clúster.


  3. Proporcione un nombre para la copia de seguridad que desea crear.


  4. Para iniciar una operación de copia de seguridad para el clúster de Automation Suite, haz clic en el botón Iniciar en la parte superior de la página.


  5. Una vez que el estado del trabajo de runbook sea Completed, la operación de copia de seguridad habrá finalizado. Si el estado del trabajo de runbook es Failed, puede consultar los registros de la cuenta de almacenamiento para obtener más información.


GetAllBackups

Descripción

El runbook GetAllBackup le ayuda a ver una lista de todas las copias de seguridad disponibles, tanto las programadas como las manuales.



RestoreClusterInitialize, RestoreSnapshot

Descripción

Estos runbook le ayudarán a restaurar el clúster.

Uso

Nota: al iniciar el proceso de restauración, ponemos el clúster en modo de mantenimiento. Una vez que el proceso de restauración es correcto, sacamos el clúster del modo de mantenimiento.

Para realizar una operación de restauración, siga los siguientes pasos:

  1. Identifique los archivos de restauración que desea utilizar. Para ello, navega a tu cuenta de automatización de implementación de Automation Suite y ejecuta el runbook GetAllBackup.




  2. Cuando el trabajo de runbook esté completo, comprueba la parte inferior de la pestaña Salida para ver una lista de las copias de seguridad disponibles. Seleccione el que desea utilizar en la operación de restauración y cópielo.
  3. Vuelva a la Cuenta de automatización y ejecute el runbook RestoreClusterInitialize. Para el parámetro, pegue el nombre del archivo de copia de seguridad copiado anteriormente. En este punto se inicia el proceso de restauración.


  4. El trabajo RestoreSnapshot se inicia automáticamente. Una vez finalizado el trabajo, el proceso de restauración ha finalizado.
    Nota: Los registros están presentes en la cuenta de almacenamiento (que termina en st), en el contenedor de copias de seguridad, en la carpeta restores/<backup-name>/ , donde backup-name es el nombre de la copia de seguridad utilizada para realizar la restauración.
  5. Después de una restauración, debe confirmar que el clúster está en buen estado (consulte Validación de la instalación o cualquier enlace de solución de problemas de ArgoCD). Después de esto, tiene la opción de habilitar la copia de seguridad en el clúster ejecutando el runbook RestoreClusterFinalize con el mismo parámetro que en el paso anterior. Esto habilita las copias de seguridad para el clúster.

Solución de problemas

  • En caso de que una máquina virtual no pueda unirse al clúster de Automation Suite, se intentará una reversión. Las máquinas virtuales recién creadas seguirán los mismos pasos que una eliminación de nodo habitual (acordonar, drenar, detener el servicio rke, eliminar el nodo del clúster y eliminar las máquinas virtuales). Puedes encontrar los registros del procedimiento de unión al nodo en la cuenta de almacenamiento, dentro del contenedor de registros , en blob como infra-<hostname>.log.

  • En caso de error al eliminar los nodos, cualquier runbook se detendrá y mostrará los registros del paso que ha fallado. Solucione el problema, complete el proceso manualmente o usando el runbook de RemoveNodes. Puedes encontrar todos los registros en la cuenta de almacenamiento, dentro del contenedor de registros , de la siguiente manera:

    • Acordonar y drenar - <timestamp>-<runbook_abreviation>-drain_nodes.log
    • Detener el servicio rke: <timestamp>-<runbook_abreviation>-stop_rke.log
    • Eliminar el nodo del clúster: <timestamp>-<runbook_abreviation>-remove_nodes.log
  • En caso de que haya un tiempo de espera, debes esperar a que finalice su ejecución, comprobar los registros y completar el proceso manualmente o utilizando el runbook de RemoveNodes. Todos los runbooks utilizan la característica Comando de ejecución de Azure para ejecutar código en el contexto de las máquinas virtuales. Una limitación de este método es que no devuelve el estado de la ejecución. Por lo tanto, los pasos para acordonar, drenar y detener el servicio rke se ejecutan de forma asíncrona, y el estado se mantiene con los blobs en el siguiente formato: <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.

Was this page helpful?

Soporte y servicios
Obtén la ayuda que necesitas
UiPath Academy
RPA para el aprendizaje - Cursos de automatización
Foro de UiPath
Foro de la comunidad UiPath
Logotipo blanco de UiPath
Confianza y seguridad
Términos de uso
Política de privacidad
Política de cookies
© 2005-2024 UiPath. All rights reserved.