- Información general
- Requisitos
- Plantillas de implementación
- Manual: preparar la instalación
- Manual: preparar la instalación
- Paso 2: configurar el registro compatible con OCI para las instalaciones sin conexión
- Paso 3: configurar el almacén de objetos externo
- Paso 4: configurar High Availability Add-on
- Paso 5: configurar las bases de datos SQL
- Paso 6: configurar el equilibrador de carga
- Paso 7: configurar el DNS
- Paso 8: configurar los discos
- Paso 9: configurar los ajustes a nivel de kernel y sistema operativo
- Paso 10: configurar los puertos de nodo
- Paso 11: aplicar ajustes varios
- Paso 12: Validar e instalar los paquetes RPM necesarios
- Paso 13: Generar cluster_config.json
- Configuración de certificados
- Configuración de la base de datos
- Configuración del almacén de objetos externo
- Configuración de URL prefirmada
- Configuración de la autenticación Kerberos
- Configuración de registro externo compatible con OCI
- Disaster recovery: configuraciones activas/pasivas y activas/activas
- Configuración de High Availability Add-on
- Configuración específica de Orchestrator
- Configuración específica de Insights
- Process Mining-specific configuration
- Configuración específica de Document Understanding
- Automation Suite Robots-specific configuration
- Configuración de la supervisión
- Opcional: configurar el servidor proxy
- Opcional: habilitación de la resistencia a fallos de zona en un clúster multinodo de producción preparada para alta disponibilidad
- Opcional: pasar resolv.conf personalizado
- Optional: Increasing fault tolerance
- parámetros de install-uipath.sh
- Inclusión de un nodo agente dedicado compatible con GPU
- Añadir un nodo agente dedicado a Task Mining
- Conexión de la aplicación Task Mining
- Añadir un nodo agente dedicado a Automation Suite Robots
- Paso 15: configurar el registro temporal de Docker para las instalaciones sin conexión
- Paso 16: validar los requisitos previos para la instalación
- Manual: realizar la instalación
- Después de la instalación
- Administración de clústeres
- Gestionar los productos
- Primeros pasos con el Portal de administración del clúster
- Migrar del en el clúster a High Availability Add-on externo
- Migrar del registro en clúster a un registro externo compatible con OCI
- Cambiar manualmente al clúster secundario en una configuración activa/pasiva
- Disaster Recovery: realizar operaciones posteriores a la instalación
- Convertir una instalación existente en una configuración en varios sitios
- Directrices sobre la actualización de una implementación activa/pasiva o activa/activa
- Directrices sobre la copia de seguridad y restauración de una implementación activa/pasiva o activa/activa
- Redireccionando el tráfico de los servicios no compatibles al clúster principal
- Escalar una implementación de nodo único (evaluación) a una implementación multinodo (HA)
- Supervisión y alertas
- Migración y actualización
- Paso 1: Mover los datos de la organización de identidad de independiente a Automation Suite
- Paso 2: restaurar la base de datos del producto independiente
- Paso 3: Realizar una copia de seguridad de la base de datos de la plataforma en Automation Suite
- Paso 4: Fusionar organizaciones en Automation Suite
- Paso 5: actualizar las cadenas de conexión de los productos migrados
- Paso 6: migrar el Orchestrator independiente
- Paso 7: migrar Insights independiente
- Paso 8: Migrar Test Manager independiente
- Paso 9: eliminar el tenant predeterminado
- Realizar una migración de un solo tenant
- Migrar de Automation Suite en Linux a Automation Suite en EKS / AKS
- Actualizar Automation Suite
- Descargar los paquetes de instalación y obtener todos los archivos del primer nodo del servidor
- Recuperar la última configuración aplicada del clúster
- Actualizar la configuración del clúster
- Configurar el registro compatible con OCI para las instalaciones sin conexión
- Ejecutar la actualización
- Realizar operaciones posteriores a la actualización
- Configuración específica del producto
- Uso de la herramienta de configuración de Orchestrator
- Configurar parámetros de Orchestrator
- Configuración de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Buenas prácticas y mantenimiento
- Solución de problemas
- Cómo solucionar los problemas de los servicios durante la instalación
- Cómo desinstalar el clúster
- Cómo limpiar los artefactos sin conexión para mejorar el espacio en disco
- Cómo borrar datos de Redis
- Cómo habilitar el registro de Istio
- Sacar a Ceph del modo solo lectura
- Cómo limpiar los registros antiguos almacenados en el depósito sf-logs
- Cómo deshabilitar los registros de transmisión para AI Center
- Cómo depurar instalaciones de Automation Suite fallidas
- Cómo eliminar imágenes del instalador antiguo después de la actualización
- Cómo deshabilitar la descarga de la suma de comprobación TX
- Cómo actualizar desde Automation Suite 2022.10.10 y 2022.4.11 a 2023.10.2
- Cómo establecer manualmente el nivel de registro de ArgoCD en Info
- Cómo expandir el almacenamiento de AI Center
- Cómo generar el pull_secret_value codificado para registros externos
- Cómo abordar los cifrados débiles en TLS 1.2
- Cómo trabajar con certificados
- Cómo reenviar registros de aplicaciones a Splunk
- Cómo limpiar las imágenes de Docker no utilizadas de los pods de registro
- Cómo recopilar datos de uso de DU con el almacén de objetos en el clúster (Ceph)
- Cómo instalar RKE2 SELinux en entornos aislados
- Cómo limpiar copias de seguridad diferenciales antiguas en un servidor NFS
- No se puede ejecutar una instalación sin conexión en el sistema operativo RHEL 8.4
- Error al descargar el paquete
- La instalación sin conexión falla porque falta un binario
- Error en la comprobación de requisitos previos para el módulo iscsid de selinux
- Azure disk not marked as SSD
- Fallo tras la actualización del certificado
- El antivirus causa problemas de instalación
- Automation Suite not working after OS upgrade
- Automation Suite requiere que backlog_wait_time se establezca en 0
- El volumen no se puede montar porque no está listo para las cargas de trabajo
- Error de recopilación de registros del paquete de soporte
- Se ignora la cadena de conexión SQL de la automatización de pruebas
- Configuración de DNS no respetada por CoreDNS
- Pérdida de datos al reinstalar o actualizar Insights tras la actualización de Automation Suite
- La actualización de nodo único falla en la etapa de tejido
- Upgrade fails due to unhealthy Ceph
- El volumen no se puede montar y permanece en estado de bucle de conexión/desconexión
- La actualización falla debido a objetos clásicos en la base de datos de Orchestrator
- El clúster de Ceph se encuentra en un estado degradado tras una actualización en paralelo.
- Un componente Insights en mal estado provoca el fallo de la migración
- La actualización del servicio falla para Apps
- Tiempos de actualización in situ
- La migración del registro de Docker se atasca en la fase de eliminación de PVC
- Error de aprovisionamiento de AI Center después de actualizar a 2023.10 o posterior
- La actualización falla en entornos sin conexión
- La validación SQL falla durante la actualización
- pod de snapshot-controller-crds en estado CrashLoopBackOff después de la actualización
- Error de actualización/reinstalación del punto final de la API REST de Longhorn
- La actualización falla debido a los tamaños de PVC de Insights anulados
- La actualización del servicio falla durante la ejecución del script previo al servicio
- Fallo al cargar o descargar datos en el almacén de objetos
- PVC resize does not heal Ceph
- Fallo en el redimensionamiento de PVC de objectstore
- Error de archivo adjunto de volumen de StatefulSet
- Rook Ceph o Looker pod atascados en estado Init
- Error al compactar las métricas debido a bloques corruptos en Thanos
- Establecer un intervalo de tiempo de espera para los portales de gestión
- La autenticación no funciona tras la migración
- kinit: no se puede encontrar la KDC para el territorio <AD Domain> mientras se obtienen las credenciales iniciales
- kinit: keytab no contiene claves adecuadas para *** mientras se obtienen las credenciales iniciales
- Error en la operación GSSAPI debido a un código de estado no válido
- Alarma recibida por un error en el trabajo de Kerberos-tgt-update
- Proveedor de SSPI: servidor no encontrado en la base de datos de Kerberos
- Error en inicio de sesión de un usuario AD debido a una cuenta deshabilitada
- ArgoCD login failed
- Fallo en la obtención de la imagen de Sandbox
- Los pods no se muestran en la interfaz de usuario de ArgoCD
- Fallo de la sonda Redis
- El servidor RKE2 no se inicia
- ArgoCD entra en estado de progreso tras la primera instalación
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Unhealthy services after cluster restore or rollback
- Faltan métricas de Ceph-rook en los paneles de supervisión
- Los pods no pueden comunicarse con FQDN en un entorno de proxy
- Error al configurar las alertas de correo electrónico después de la actualización
- No hay problema ascendente en buen estado
- Error al añadir nodos agente en entornos sin conexión
- El acceso a FQDN devuelve RBAC: error de acceso denegado
- Document Understanding no se encuentra en la barra izquierda de Automation Suite
- Estado fallido al crear una sesión de etiquetado de datos
- Estado fallido al intentar implementar una habilidad ML
- El trabajo de migración falla en ArgoCD
- El reconocimiento de la escritura manual con el extractor de formularios inteligente no funciona
- Error en la implementación de la habilidad ML debido a la caducidad del token
- Ejecutar alta disponibilidad con Process Mining
- La ingestión de Process Mining falló al iniciar sesión con Kerberos
- Después de Disaster Recovery, Dapr no funciona correctamente para Process Mining
- Configurar Dapr con Redis en modo clúster
- No se puede conectar a la base de datos AutomationSuite_ProcessMining_Warehouse utilizando una cadena de conexión en formato pyodbc
- La instalación de Airflow falla con sqlalchemy.exc.ArgumentError: no se pudo analizar la URL rfc1738 de la cadena ''
- Cómo añadir una regla de tabla de IP para utilizar el puerto 1433 de SQL Server
- El certificado de Automation Suite no es de confianza desde el servidor donde se ejecuta CData Sync
- Ejecutar la herramienta de diagnóstico
- Uso del paquete de soporte de Automation Suite
- Explorar registros
Paso 3: Pasos posteriores a la implementación
Completa los pasos de verificación y configuración posteriores a la implementación después de instalar Automation Suite en la infraestructura de Azure.
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
El proceso de instalación genera certificados autofirmados en tu nombre. Estos certificados son compatibles con FIPS 140-2. La plantilla de implementación de Azure también te 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 y generado de forma 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.
Si instalaste Automation Suite en un host habilitado para FIPS 140-2 y deseas actualizar los certificados, asegúrate de que sean compatibles con FIPS 140-2.
Para obtener instrucciones, consulta Gestionar certificados.
Habilitar FIPS 140-2
Después de completar una instalación de Automation Suite utilizando la plantilla de implementación de Azure, puedes habilitar FIPS 140-2 en tus máquinas. Para obtener instrucciones, consulta Seguridad y cumplimiento.
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:
-
Navega hasta el grupo de recursos en el que se realizó la implementación.
-
Filter by resource type Storage Account.
-
Localiza la cuenta de almacenamiento cuyo nombre termina en
st. Por ejemplo: -
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.successindica que la instalación de la infraestructura se completó correctamente en ese nodo específico del clúster;installResultleesuccesssi 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.logalmacena los registros de instalación de la infraestructura;fabric.logalmacena los registros de la instalación de la estructura;services.logalmacena 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 | La URL para acceder a ArgoCD. Esto está disponible dentro de la VNet. El acceso externo a esta URL debe configurarse como se describe en: 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 | La URL del portal de administración del clúster. |
| DashboardMonitoringURL | La URL de las herramientas de supervisión del panel (Grafana): https://monitoring.<fqdn>/dashboard. Asegúrate de reemplazar <fqdn> con tu FQDN. |
| MetricsMonitoringURL | La URL de las herramientas de supervisión de métricas (Prometheus): https://monitoring.<fqdn>/metrics. Asegúrate de reemplazar <fqdn> con tu FQDN. |
| AlertmanagerMonitoringURL | La URL de las herramientas de supervisión de Alertmanager: https://monitoring.<fqdn>/alertmanager. Asegúrate de reemplazar <fqdn> con tu FQDN. |
Todas las credenciales utilizadas en la implementación se almacenan como secretos dentro de un Key Vault aprovisionado durante la implementación. Para acceder a los secretos, filtra los recursos dentro del grupo de recursos, busca Vault y luego selecciona Secretos.
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:
- Diríjase a Directivas de acceso → Añadir directiva de acceso → Configurar la plantilla → Gestión de secretos → Seleccionar principal.
- Selecciona tu usuario y luego selecciona Guardar.
- 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:
-
Diríjase al grupo de recursos en el que ha implementado Automation Suite.
-
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.
-
Vaya a la sección Instancias de la pestaña Configuración.
-
Selecciona el nombre de la máquina virtual que quieres conectar.
-
Selecciona el botón Conectar y luego elige Bastion en el menú desplegable.
-
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
Como se menciona en el Paso 1: Preparar la implementación de Azure, la implementación de Automation Suite Azure crea un equilibrador de carga con una IP pública y una etiqueta de DNS asociada. Esta etiqueta 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 el Paso 4: Configurar el DNS para obtener más información.
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 del clúster es una ubicación centralizada donde puedes encontrar todos los recursos necesarios para completar una 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 del clúster.
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.
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:
- 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. - Cambie a la organización predeterminada.
- El nombre de usuario es orgadmin.
- 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:
- 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. - Cambie a la organización del host.
- Enter the username you previously specified as a value for the UiPath Admin Username parameter.
- 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:
- Ve a la siguiente URL:
https://alm.${Loadbalancer_dns}, donde<loadbalancer_dns>es la etiqueta DNS para el equilibrador de carga y se encuentra en Salidas. Ten en cuenta que debes configurar el acceso externo a esta URL como se describe en el Paso 4: Configurar el DNS. - El nombre de usuario es admin.
- Para acceder a la contraseña, vaya a la pestaña Salidas o al almacén de credenciales.
Acceder a las herramientas de supervisión
Para acceder a las herramientas de supervisión por primera vez, inicie sesión como administrador con las siguientes credenciales predeterminadas:
- Nombre de usuario: admin
- Contraseña: para recuperar la contraseña , ejecuta el siguiente comando:
kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -dkubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d
Para actualizar la contraseña predeterminada utilizada para la autenticación Dex al acceder a las herramientas de supervisión, sigue los siguientes pasos.
- Ejecuta el siguiente comando reemplazando
<your-password>con tu nueva contraseña:password="<your-password>" password=$(echo -n $password | base64) kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"password="<your-password>" password=$(echo -n $password | base64) kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]" - Ejecuta el siguiente comando para actualizar la contraseña:
./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement
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:
-
Diríjase a Azure Portal y filtre por el conjunto de escalado específico:
-
Selecciona el conjunto de escalado adecuado y selecciona Escalado.
-
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.
-
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
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.
Los runbooks de InstanceRefresh, RemoveNodes y RemoveServers se ven afectados por un problema que provoca que las operaciones de eliminación de nodos fallen si utilizas Azure para el gobierno de los Estados Unidos.
Trabajadoras híbridas
Todas nuestras cuentas de almacenamiento y servidores SQL tienen puntos de conexión privados. Un grupo de trabajadores híbridos ejecuta las operaciones automatizadas existentes para que funcionen sin problemas.
Un trabajador híbrido es una máquina virtual que se encuentra dentro de la VNET y en la que se ejecutarán las diversas automatizaciones.
La máquina virtual suele ser una Standard_D2s_v3 o una Standard_F2s_v2, dependiendo de la que elijas para las máquinas virtuales de tu servidor y de si la cuota lo permite. La máquina virtual se apaga cuando finaliza la implementación para minimizar los costes.
Los runbook se dividen en dos categorías: runbook regulares y runbook híbridos. Utilice los runbook normales para iniciar una operación y recopilar todos los datos. El runbook normal inicia la máquina virtual de trabajo híbrida y el runbook híbrido, y este último completa la operación.
Cuando la operación finalice, puede desactivar la máquina virtual de trabajo híbrido para limitar los costes.
La siguiente tabla describe el desglose del runbook:
| Runbook regulares | Runbook híbrido |
|---|---|
| AddGpuNode | HybridAddGpuNode |
| BackupCluster | HybridBackupCluster |
| GetAllBackups | HybridGetAllBackups |
| InstanceRefresh | HybridInstanceRefresh (+HybridCheckServerZoneRezilience) |
| RegisterAiCenterExternalOrchestrator | HybridRegisterAiCenterExternalOrchestrator |
| RemoveNodes | HybridRemoveNodes |
| RemoveServers | HybridRemoveServers |
| RestoreClusterInitialize | HybridRestoreClusterInitialize + HybridRestoreClusterSnapshot |
| ValidateFullInstall | Se ejecuta al final de la implementación para validar la instalación completa. |
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
- Go to the Azure Portal and search for the resource called InstanceRefresh.
- 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 enTrue. Si varios parámetrosREFRESH<node_type>se establecen enTrue, el orden de rotación de nodos de VMSS será Servidores -> Agentes -> Agentes de GPU. - Debes proporcionar el parámetro
NEWOSVERSIONpara actualizar la SKU del SO VMSS. Puedes encontrar la SKU de imagen de las máquinas virtuales de Azure Marketplace disponible usandoaz 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).
- Se realiza una operación de rotación de nodo en un VMSS solo si el parámetro
Selecciona 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 ejecuta RemoveNodes. Actualiza todas las versiones del sistema operativo VMSS (si es necesario) y extrae, en función de los parámetros recibidos, el nombre de host para la operación de rotación de nodos 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 se encarga de 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
-
Busca los nombres de los equipos de los nodos que quieres eliminar. Para ello, ve a un VMSS y selecciona
Instancesen la secciónSettings. -
Go to the Azure Portal and search for the resource called RemoveNodes.
-
Selecciona el botón de inicio para abrir la lista de parámetros. Completa los parámetros teniendo en cuenta lo siguiente:
NODESTOBEREMOVEDCOMPUTERNAMEes 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.ISINSTANCEREFRESHandTHREESERVERSSCENARIOare 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:
- Escale el VMSS con una o dos máquinas virtuales en función de la cantidad de nodos que se eliminarán.
- 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:
- 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 * 60minutos para los servidores. - Detenga el servicio rke en las instancias. La operación agota el tiempo de espera después de 5 minutos.
- 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 * 60minutos para los servidores.
RemoveServers
Descripción
The RemoveServers runbook has the following use case:
- eliminar servidores del clúster de Automation Suite.
Uso
- Go to the Azure Portal and search for the resource called RemoveServers.
- Selecciona el botón de inicio para abrir la lista de parámetros. Completa los parámetros teniendo en cuenta lo siguiente:
-
REMOVEDSERVERSCOUNTes 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 la implementación inicial se creó sin un nodo de GPU, creamos el conjunto de escalado de VM, pero tenemos un SKU diferente para evitar problemas de disponibilidad de zona/SKU. Este runbook cambia el SKU a un SKU de GPU y añade un nodo.
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:
- Navega hasta el grupo de recursos donde implementaste Automation Suite, luego identifica y selecciona Automation Account.
- Selecciona Runbooks y luego el runbook AddGPUNode .
- 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_v3Standard_NC12s_v3Standard_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
El runbook de BackupCluster te ayuda a hacer una copia de seguridad de tu clúster.
Uso
-
Navega hasta el grupo de recursos donde implementaste Automation Suite, luego identifica y selecciona la cuenta de Automation.
-
Selecciona Runbooks y luego el runbook BackupCluster .
-
Proporcione un nombre para la copia de seguridad que desea crear.
-
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.
-
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 esFailed, 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
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:
-
Identify the restore files you want to use. To do this, navigate to your Automation Suite deployment Automation Account, and run the GetAllBackups runbook.
-
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.
-
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.
-
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 therestores/<backup-name>/folder, wherebackup-nameis the name of the backup used to perform the restore. -
Después de una restauración, debes confirmar que el clúster está en buen estado (consulta Validar la instalación o cualquier enlace de solución de problemas de ArgoCD). Después de esto, tienes 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 de nodos en la cuenta de almacenamiento, dentro del contenedor de registros , en blobs como
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
- Acordonar y drenar:
- 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>.
- Validar la instalación
- Actualizar certificados
- Habilitar FIPS 140-2
- Exploring flags and logs
- Contenedor de banderas
- Contenedor de registros
- Acceder a las salidas de implementación
- Salidas de implementación
- Acceder a las máquinas virtuales del clúster
- Requisitos de DNS
- Acceso al Portal de administración del clúster
- Acceder a la interfaz general de Automation Suite
- Acceder a la administración del host
- Acceder a ArgoCD
- Acceder a las herramientas de supervisión
- Escalar el clúster
- Completar una actualización
- Operaciones del ciclo de vida de la máquina virtual de Azure
- Trabajadoras híbridas
- InstanceRefresh
- RemoveNodes
- RemoveServers
- CheckServerZoneResilience
- AddGpuNode
- RegisterAiCenterExternalOrchestrator
- BackupCluster
- GetAllBackups
- RestoreClusterInitialize, RestoreSnapshot
- Solución de problemas