Instalación de Automation Suite en EKS / AKS

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 su perfil de implementación, consulta Escenariosde implementación.

• El proceso de instalación genera certificados autofirmados en su nombre. Debes reemplazarlos por certificados firmados por una entidad de certificación (CA) de confianza tan pronto como se complete la instalación. Para obtener instrucciones, consulta Gestionar los certificados.

• Automation Suite en AKS/EKS no admite actualmente el estándar federal de procesamiento de información 140-2 (FIPS 140-2). Si necesitas FIPS 140-2 para Automation Suite, puedes implementar Automation Suite en máquinas RHEL habilitadas para FIPS 140-2. Para obtener más información, consulta Seguridad y cumplimiento.

Paso 1: aprovisionar los requisitos previos de la infraestructura

Antes de instalar Automation Suite , debe configurar los recursos de la Cloud en su entorno. Esto incluye:

• Clúster de AKS o EKS
• Solo sin conexión: registro externo compatible con OCI
• Almacenamiento de objetos: Azure Blob o Amazon S3
• Bloquear almacenamiento
• Almacenamiento de archivos
• Base 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)
• Certificados
• Políticas de trabajo en red

Para obtener instrucciones sobre requisitos previos, consulta Requisitos.

Opcional: configurar el proxy

Si usa un servidor proxy para el tráfico de Internet, debe permitir una lista de URL y usar la configuración de no_proxy mientras configura el proxy. Para obtener instrucciones sobre cómo configurar tu proxy, consulta Configuración del 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: hidratar 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 la línea de comandos de UiPath® que te permite ejecutar comandos para Automation Suite Kubernetes alojados en Azure Kubernetes Service (AKS) y Amazon Elastic Kubernetes Service (EKS). Puede utilizar uipathctl para comprobar los requisitos previos en su entorno, instalar Automation Suite , configurarlo y administrarlo desde una única CLI unificada. Para obtener más información, incluida una lista completa de uipathctl operaciones, consulta la documentación de referencia de uipathctl.	Descargar uipathctl Ejecutar uipathctl
versions.json	Requerido. Necesario para realizar comprobaciones de requisitos 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 Configuración de input.json.

Opcionalmente, puede traer sus 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 trae, consulte Traer sus 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 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 uipathctl prereq. 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 debido a la limitación del lado del cliente, no a la prioridad y a la imparcialidad. En este caso, espere unos minutos para que el comando se complete por completo o intente volver a ejecutarlo.

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

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 .
2. Para volver a ejecutar la instalación, utiliza el mismo comando que en el paso 1, con todos los argumentos e indicadores.
3. 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

Nota:

Si tienes problemas durante la instalación, consulta Solución de problemas.