Paso 3: Pasos posteriores a la implementación

Nota:

When using Azure Bastion, keep in mind that copy-pasting commands split over multiple lines using \ may not work as expected. To ensure new lines are interpreted correctly, use the console's clipboard widget.

Validar la instalación

To check if Automation Suite was installed successfully, you must go to the storage account, inside the flags container. The installation is complete if the contents of the auto-generated file called installResult (in the container) is successful. The contents will be failed if the installation failed.

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.

For instructions, see Managing certificates.

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. Filter by resource type Storage Account.

3. Localiza la cuenta de almacenamiento cuyo nombre termina en st. Por ejemplo:

   

4. Selecciona la cuenta de almacenamiento y luego selecciona Contenedores. Tus opciones son marcadores y registros.

   

Contenedor de banderas

The flags container stores various flags or files needed for orchestration or just to report the status of various operations. On a new cluster, the flags container contents typically look as shown in the following example:

Files in the flags containers are used to orchestrate various operations, such as the Automation Suite installation process on the cluster, or specific cluster operations, such as Instance Refresh. For example:

• 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

When performing an operation, it typically produces a log file in the logs container. On a fresh cluster, the logs container contents typically look as shown in the following example:

Every file in the logs container represents the logs for a specific step of the installation process. For example:

• 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, vaya a su 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	The URL for accessing ArgoCD. This is available within the VNet. External access to this URL must be set up as described in: Step 4: Configuring the 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	The URL for the Cluster Administration portal.

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. Selecciona el nombre de la máquina virtual que quieres conectar.

   

5. Selecciona el botón Conectar y luego elige Bastion en el menú desplegable.

   

6. Introduce las credenciales proporcionadas en la implementación (parámetros Nombre de usuario de administrador y Contraseña de administrador , que puedes encontrar en el almacén de claves de credenciales, en Secretos) y selecciona Conectar.

   

Requisitos de DNS

As mentioned in Step 1: Preparing your Azure Deployment, the Automation Suite Azure deployment creates a Load Balancer with a public IP and a DNS label associated. This DNS label is Microsoft-owned.

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.

See Step 4: Configuring the DNS for more details.

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

Acceso al Portal de administración del clúster

The Cluster Administration portal is a centralized location where you can find all the resources required to complete an Automation Suite installation and perform common post-installation operations. For details, see Getting started with the Cluster Administration portal.

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:

You do not need any credentials to access the Cluster Administration portal.

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. Enter the username you previously specified as a value for the UiPath Admin Username parameter.
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. Go to the following URL: https://alm.${Loadbalancer_dns}, where <loadbalancer_dns> is the DNS label for the load balancer and is found under Outputs. Note that you must configure external access to this URL as described in Step 4: Configuring the 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.

See Rancher documentation for more details.

See Using the monitoring stack for more on how to use Rancher monitoring in 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 su 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. Selecciona el conjunto de escalado adecuado y selecciona Escalado.

   

3. Modifica el campo Recuento de instancias utilizando el control deslizante o el campo de entrada junto a él y luego selecciona 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

After performing an Automation Suite cluster upgrade, Azure template deployments require some changes to ensure a new node joins the cluster correctly. To automate the changes, we recommend using the dedicated script. For instructions, see the Azure deployment template docs.

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

Consejo:

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

Para evitar la pérdida de datos, la política de actualización de VMSS del servidor se establece 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 de los servidores a través de los Runbooks proporcionados.

The InstanceRefresh, RemoveNodes, RemoveServers, and CheckServerZoneResilience runbooks are supported only for multi-node HA-ready production deployments.

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:

The InstanceRefresh, RemoveNodes, and RemoveServers runbooks are affected by an issue causing node removal operations to fail if Process Mining (AirFlow) and/or Automation Suite Robots service pods are scheduled on the node.

InstanceRefresh

Descripción

The InstanceRefresh runbook has the following use cases:

• 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. Go to the Azure Portal and search for the resource called InstanceRefresh.

2. Selecciona 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).

     Selecciona el botón Aceptar para iniciar el runbook.

     

Detalles de implementación

The InstanceRefresh runbook is a wrapper for the RemoveNodes runbook. As a result, the status is tracked while running RemoveNodes. It updates all the VMSS OS versions (if needed) and extracts, based on the received parameters, the hostname for the node rotation operation and forwards them to the RemoveNodes. If the cluster has exactly three servers, the InstanceRefresh runbook creates three new servers; otherwise, RemoveNodes handles the scale-up to maintain at least one server in each Availability Zone at all times.

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 los equipos de los nodos que quieres eliminar. Para ello, ve a un VMSS y selecciona Instances en la sección Settings .

   

2. Go to the Azure Portal and search for the resource called RemoveNodes.

3. Selecciona 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 and THREESERVERSSCENARIO are flags populated by the InstanceRefresh wrapper.

  Selecciona el botón Aceptar para iniciar el runbook.

  

Detalles de implementación

El runbook RemoveNodes tiene un enfoque recursivo para superar el tiempo de espera de uso compartido justo de 3 horas. Elimina o vuelve a cargar el primero o los dos primeros nodos (el número se elige para cumplir con 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

The RemoveServers runbook has the following use case:

• eliminar servidores del clúster de Automation Suite.

Uso

1. Go to the Azure Portal and search for the resource called RemoveServers.
2. Selecciona 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 eliminar no más de 2 servidores a la vez para no alcanzar el tiempo de espera de uso compartido justo .

  

Detalles de implementación

The RemoveServers runbook removes the number of servers received as a parameter from the Availability Zones with the most VMs.

CheckServerZoneResilience

Descripción

The CheckServerZoneResilience runbook scales out the server VMSS and uses the RemoveServers runbook to balance the servers across Availability Zones. This is part of the InstanceRefresh flow and should not be run manually.

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:

Do not scale the initial GPU VMSS created before running this runbook if the initial deployment was created without GPU nodes.

Uso

Para utilizar este runbook, siga los siguientes pasos:

1. Navega hasta el grupo de recursos donde implementaste Automation Suite, luego identifica y selecciona Automation Account.
2. Selecciona Runbooks y luego el runbook AddGPUNode .
3. Proporciona un nombre para el SKU que deseas tener y selecciona 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 único 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 corta (aproximadamente 1-2 horas), recomendamos generarlo justo antes de ejecutar el runbook. Para obtener instrucciones, consulta Clave de instalación.

BackupCluster

Descripción

The BackupCluster runbook helps you back up you cluster.

Uso

1. Navega hasta el grupo de recursos donde implementaste Automation Suite, luego identifica y selecciona la cuenta de Automation.

   

2. Selecciona Runbooks y luego el runbook BackupCluster .

   

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, selecciona 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

The GetAllBackups runbook helps you view a list of all available backups, both scheduled and manual.

RestoreClusterInitialize, RestoreSnapshot

Descripción

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

Uso

Nota:

When starting the restore process, we put the cluster in maintenance mode. Once the restore process is successful, we take the cluster out of maintenance mode.

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

1. Identify the restore files you want to use. To do this, navigate to your Automation Suite deployment Automation Account, and run the GetAllBackups runbook.

   

   

2. When the runbook job is complete, check the bottom of the Output tab for a list of available backups. Select the one you want to use in the restore operation and copy it.

3. Navigate back to the Automation Account and run the RestoreClusterInitialize runbook. For the parameter, paste the name of the previously copied backup file. At this point, the restore process is started.

   

4. The RestoreSnapshot job is started automatically. When the job is done, the restore process is complete.

   Nota:

   Logs are present in the storage account (ending with st), in the backups container, under the restores/<backup-name>/ folder, where backup-name is the name of the backup used to perform the restore.

5. After a restore, you should confirm that the cluster is in a good state (see Validating the installation or any ArgoCD troubleshooting link). After this, you have the option to enable the backup on the cluster by running the RestoreClusterFinalize runbook with the same parameter as in the previous step. This enables backups for the cluster.

Solución de problemas

• In case a VM fails to join the Automation Suite cluster, a rollback will be tried. The newly created VMs will follow the same steps as an usual node removal (cordon, drain, stop the rke service, remove the node from the cluster, and delete the VMs). You can find the logs from the joining node procedure in the storage account, inside the logs container, in blobs like infra-<hostname>.log.
• In case of a failure while deleting nodes, any runbook will stop and display the logs for the step that failed. Fix the issue, complete the process manually or using the RemoveNodes runbook. You can find all the logs in the storage account, inside the logs container, as follows:
  • 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 se agote el tiempo de espera, debes esperar a que el paso finalice su ejecución, comprobar los registros y completar el proceso manualmente o utilizando el runbook RemoveNodes . Todos los runbooks utilizan la característica Azure Run Command 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 blobs en el siguiente formato: <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.