Instalación de Automation Suite

Instrucciones de instalación de alto nivel para Automation Suite en AKS y EKS.

Esta página le guía a través de las instrucciones de instalación de alto nivel de Automation Suite en AKS y EKS.

Antes de comenzar, ten en cuenta lo siguiente:

• Se requiere el conocimiento de la gestión de recursos en la nube de Kubernetes, AWS y Azure para implementar y gestionar Automation Suite en AKS/EKS. Si tienes problemas de instalación y configuración de Automation Suite en AKS/EKS, ponte en contacto con UiPath® Professional Services.
• Antes de elegir tu perfil de implementación, consulta Escenarios de implementación.
• El proceso de instalación genera certificados autofirmados en tu nombre. Debes reemplazarlos por certificados firmados por una autoridad de certificación (AC) de confianza tan pronto como se complete la instalación. Para obtener instrucciones, consulta Gestionar los certificados.
• Automation Suite admite la habilitación del estándar federal de procesamiento de información 140-2 (FIPS 140-2) en los nodos AKS. Para obtener más información, consulta Seguridad y cumplimiento. No puedes habilitar FIPS 140-2 en nodos EKS.

Paso 1: aprovisionar los requisitos previos de la infraestructura

Antes de instalar Automation Suite, debes configurar los recursos de la nube en tu entorno. Esto incluye lo siguiente:

• Clúster de AKS o EKS
• Obligatorio para instalaciones sin conexión: registro externo compatible con OCI
• Almacenamiento de objetos: Azure Blob o Amazon S3
• Bloquear almacenamiento
• Almacenamiento de archivos
• Bases de datos
• Almacenamiento en caché
• Redes (p. Ej., VNET / VPC, DNS, subredes, grupos de seguridad / NSG, puerta de enlace Nat, IP elástica y puerta de enlace a Internet)
• Políticas de trabajo en red
• Certificados

Para obtener instrucciones sobre los requisitos previos, consulta Resumen de requisitos previos.

Opcional: configurar el proxy

Si utilizas un servidor proxy para el tráfico orientado a Internet, debes permitir una lista de URL y utilizar la configuración no_proxy al configurar el proxy. Para obtener instrucciones sobre cómo configurar tu proxy, consulta Proxy.

Paso 2: configurar el registro externo compatible con OCI

En las instalaciones sin conexión, necesitas un registro compatible con OCI (Open Container Initiative) para almacenar las imágenes del contenedor y los gráficos de Helm de implementación.

Hay dos formas de cargar los artefactos de Automation Suite en el registro externo compatible con OCI:

• Opción A: duplicando tu registro compatible con OCI con el registro de UiPath®
• Opción B: hidratando tu registro compatible con OCI con el paquete sin conexión

Paso 3: descargar el software en tu máquina cliente

Debe instalar el siguiente software en su máquina de gestión. La máquina de administración se refiere a la máquina que usa para operar su clúster y que puede acceder a su clúster a través del archivo kubeconfig . Su máquina de administración puede ejecutar Linux, Windows o MacOS.

Las siguientes herramientas son necesarias para ejecutar correctamente las comprobaciones de requisitos, la instalación y los pasos posteriores a la instalación en tu clúster a través de la máquina cliente.

Herramienta	Descripción	Descargar
uipathctl	Obligatorio. uipathctl es una herramienta de línea de comandos de UiPath® que te permite ejecutar comandos en Automation Suite Kubernetes alojados en Azure Kubernetes Service (AKS) y Amazon Elastic Kubernetes Service (EKS). Puedes utilizar uipathctl para comprobar los requisitos previos en tu entorno, instalar Automation Suite, configurarlo y gestionarlo desde una única CLI unificada.	Descargar uipathctl Ejecutar uipathctl
versions.json	Obligatorio. Necesario para realizar comprobaciones de requisitos previos y pasos de instalación.	Descargar version.json
kubectl	Opcional. Asegúrese de que kubectl coincida con la versión de su clúster	Descargar kubectl

Paso 4: Configurar input.json

Debes editar el archivo input.json para proporcionar las entradas necesarias para el instalador uipathctl y realizar operaciones como la configuración de las cadenas de conexión SQL y los servicios de UiPath® que te gustaría habilitar.

Proporcionamos diferentes archivos de plantilla input.json para AKS y EKS. Para obtener instrucciones sobre cómo configurar input.json, consulta Configurar input.json.

Opcionalmente, puedes traer tus propios componentes que forman parte de la pila de Automation Suite. Para obtener más información sobre los componentes, consulta Automation Suite en la pila EKS/AKS. Para obtener más información sobre cómo configurar el componente que traes, consulta Trae tus propios componentes.

Si realizas una instalación sin conexión, asegúrate de configurar tu registro externo compatible con OCI.

Para instalar Automation Suite en EKS/AKS en modo sin conexión, debes seguir los siguientes pasos adicionales:

• Establece explícitamente el valor del parámetro install_type en offline en el archivo input.json;
• Configura un registro externo compatible con OCI.

Paso 5: Acceder a tu clúster con uipathctl

uipathctl requiere acceso al servidor KubeAPI para realizar operaciones a nivel de clúster, como la implementación, la creación de recursos, etc. Para acceder al servidor de KubeAPI, uipathctl utiliza el archivo kubeconfig , que contiene las credenciales de nivel de administrador necesarias para acceder al clúster. Este archivo debe estar presente en la carpeta ~/.kube/config (ubicación predeterminada) de tu máquina local (de gestión).

Opcionalmente, si te preocupa almacenar el archivo kubeconfig en la ubicación predeterminada, puedes proporcionarlo con la ayuda del --kubeconfig durante cada ejecución de uipathctl.

Por ejemplo, puedes utilizar tu método preferido para actualizar tu archivo ~/.kube/config utilizando AWS CLI o Azure CLI.

Paso 6: comprobar los requisitos previos de la infraestructura

Las comprobaciones de requisitos previos garantizan que la infraestructura en la Cloud necesaria se ha aprovisionado correctamente y la máquina cliente puede acceder a ella antes de iniciar la instalación de Automation Suite .

El instalador puede generar automáticamente las siguientes configuraciones en su nombre:

• Las bases de datos SQL necesarias para la instalación en el servidor SQL según si la clave sql.create_db está establecida en tu archivo input.json .
• Los depósitos de almacenamiento de objetos necesarios en tu proveedor de Cloud si la clave external_object_storage.create_bucket está establecida en el archivo de configuración.

Para permitir que el instalador genere estas configuraciones, ejecuta el siguiente comando:

uipathctl prereq create input.json --versions versions.json

Importante:

El comando uipathctl prereq create no crea las bases de datos SQL necesarias para Process Mining. Debes crearlos manualmente siguiendo las instrucciones en Traer tu propia base de datos.

Para verificar los requisitos previos según las entradas que configuraste en input.json, ejecuta el siguiente comando:

uipathctl prereq run input.json --versions versions.json

Para comprobar los requisitos previos para la instalación, ejecuta . De forma predeterminada, el comando comprueba todos los requisitos previos. Sin embargo, también te permite ejecutar estrictamente las comprobaciones que son relevantes para ti:

• Si quieres excluir componentes de la ejecución, utiliza la marca --excluded. Por ejemplo, si no quieres comprobar las cadenas de conexión de la base de datos, ejecuta uipathctl prereq --excluded SQL. El comando ejecuta todas las comprobaciones de requisitos previos excepto la relacionada con SQL.
• Si quieres incluir solo ciertos componentes en la ejecución, utiliza la marca --included. Por ejemplo, si solo quieres comprobar el DNS y el almacén de objetos, ejecuta uipathctl prereq --included DNS,OBJECTSTORAGE.

Nota:

Puedes encontrar los nombres de los componentes que puedes incluir o excluir de las comprobaciones de requisitos previos aquí. En el ejemplo, la primera palabra de cada línea sombreada representa el nombre del componente. Por ejemplo: SQL, OBJECTSTORE, DNS, etc.

Importante:

Es posible que recibas un mensaje de limitación de AKS, como Esperado 1,0447523 s debido a la limitación del lado del cliente, no a la prioridad y la equidad. En este caso, deja pasar unos minutos para que el comando se complete por completo o intenta volver a ejecutarlo.

Para ver un ejemplo de resultado de salida, consulta Ejemplo de salida: comprobación de requisitos previos.

Comprobaciones de requisitos previos

Se recomienda ejecutar comprobaciones de requisitos previos para asegurar que se ha configurado correctamente la infraestructura en la nube y validar input.json antes de iniciar la instalación de Automation Suite.

Puedes ejecutar una comprobación de requisitos previos utilizando el comando. De forma predeterminada, este comando verifica todos los requisitos previos. Puedes utilizar los siguientes marcadores:

• --excluded, si quieres excluir componentes de la ejecución.
• --verbose, si quieres acceder a la salida detallada de la comprobación de requisitos previos. Puedes omitir esta marca para obtener un resultado más conciso y simplificado.

El requisito previo y las comprobaciones/pruebas de estado se ejecutan en el espacio de nombres uipath-check. Debes permitir la creación del espacio de nombres uipath-check o crearlo tú mismo antes de ejecutar las comprobaciones/pruebas. Además, algunas comprobaciones/pruebas requieren que permitas la comunicación entre los espacios de nombres entre uipath-check y uipath , o que habilites el uso de hostNetwork.

Las comprobaciones de la siguiente tabla se ejecutan en cada nodo:

Comprobar	Descripción
Conexión SQL	Valida que Automation Suite pueda conectarse correctamente a SQL server para productos de UiPath® y servicios compartidos (como Identity, Portal, Org Mamagement, etc.) utilizando las cadenas de conexión SQL proporcionadas en input.json. Esto es obligatorio para una instalación correcta.
Roles de SQL DB	Valida los roles y permisos necesarios para los productos de UiPath®. Esto es obligatorio para una instalación correcta.
Compatibilidad SQL DB	Valida los requisitos de compatibilidad de SQL DB.
Resolución FQDN	Valida que el FQDN y los subdominios se puedan resolver correctamente.
API de almacenamiento de objetos	Valida que las API de almacén de objetos sean accesibles en función de la información de acceso proporcionada en input.json. Esto es obligatorio para una instalación correcta de los servicios de UiPath®.
Caché / Redis	Valida la conexión a Cloud Redis o ElastiCache. Esto es obligatorio para una instalación correcta.
Capacidad	Valida que tenga una capacidad mínima de CPU y RAM de los nodos trabajadores en función de los productos habilitados en input.json .
ClaseDeAlmacenamiento	Valida que las clases de almacenamiento para el almacenamiento de archivos estén configuradas como es necesario para el Automation Suite Robot.
Componentes opcionales	Valida que su clúster tenga componentes que eligió excluir de la instalación de Automation Suite .
Ingress	Valida que la entrada del clúster esté configurada correctamente y que las solicitudes de URL FQDN puedan llegar a los productos de UiPath®.
Políticas de red	Comprueba si las políticas de red configuradas en Automation Suite son compatibles con el clúster.
Registro	Valida que Automation Suite pueda acceder al registro de UiPath® docker. Esto es obligatorio para una instalación correcta.
Conectividad de clúster	Valida si la comunicación del clúster está configurada correctamente: Entre dos pods aleatorios completados Entre pod a una IP de clúster multinodo Entre pod a una IP de clúster multinodo sin una IP de clúster Entre el pod a una IP de clúster multinodo usando RedHost Entre pod a una IP de clúster multinodo sin una IP de clúster establecida mediante la red de host Entre dos pods ubicados en el mismo nodo a través de ClústerIP

Paso 7: Instalación de Automation Suite

Nota:

Para ver qué escenarios de implementación están disponibles para Automation Suite en AKS/EKS, consulta Escenarios de implementación.

1. Después de validar con éxito los requisitos previos, puede proceder a instalar Automation Suite ejecutando el siguiente comando:

   uipathctl manifest apply input.json --versions versions.json
   

   Para ver un ejemplo de salida, consulta Ejemplo de salida: instalación de Automation Suite.

   Nota:

   Si tienes problemas al ejecutar la instalación, vuelve a ejecutar el comando de instalación con todos los argumentos y marcadores. Para obtener más información sobre los problemas que puedes encontrar, consulta Resolución de problemas.

2. Para validar que tu instalación se ha realizado correctamente y los servicios están en buen estado, ejecuta el siguiente comando:

   uipathctl health check