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.

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.

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.

Consulta Gestionar los administradores del sistema para obtener más información sobre los administradores del host.

Consulta Recorrido por la interfaz para obtener más información sobre el portal del host.

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)

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.

Operaciones de ciclo de vida de máquinas virtuales de Azure

Importante:

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 InstanceRefresh, RemoveNodes, RemoveServersy CheckServerZoneResilience solo son compatibles con 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.

InstanceRefresh

Descripción

El runbook InstanceRefresh tiene los siguientes casos de uso:

• 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 portal de Azure y busca el recurso dominado 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 RemoveNodes . Como resultado, se realiza un seguimiento del estado mientras se ejecutaRemoveNodes. 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 RemoveNodes. Si el clúster tiene exactamente tres servidores, el runbook InstanceRefresh crea tres nuevos servidores; de lo contrario, RemoveNodes gestiona la ampliación para mantener al menos un servidor en cada zona de disponibilidad en todo momento.

RemoveNodes

Descripción

El runbook RemoveNodes tiene los siguientes casos de uso:

• 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 portal de Azure y busca el recurso dominado 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 indicadores rellenados por el contenedor InstanceRefresh .

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

   
   

   

   
   

Detalles de implementación

El runbook 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 práctico:

• eliminar servidores del clúster de Automation Suite.

Uso

1. Ve al portal de Azure y busca el recurso dominado 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 RemoveServers elimina el número de servidores recibidos como parámetro de las zonas de disponibilidad con la mayor cantidad de máquinas virtuales.

CheckServerZoneResilience

Descripción

El runbook CheckServerZoneResilience escala el VMSS del servidor y utiliza el runbook RemoveServers para equilibrar los servidores en las zonas de disponibilidad. Es parte del flujo InstanceRefresh y no se debe ejecutar manualmente.

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 con el runbook 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
• Si hay 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>.