Instalación de Automation Suite

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.
• Before choosing your deployment profile, see Deployment scenarios.
• The installation process generates self-signed certificates on your behalf. You should replace them with certificates signed by a trusted Certificate Authority (CA) as soon as installation completes. For instructions, see Managing the certificates.
• Automation Suite on AKS/EKS does not currently support Federal Information Processing Standard 140-2 (FIPS 140-2). If you require FIPS 140-2 for Automation Suite, you can deploy Automation Suite on FIPS 140-2-enabled RHEL machines. For details, see Security and compliance.

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
• 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

For instructions on prerequisites, see Requirements.

Opcional: configurar el proxy

If you use a proxy server for internet-facing traffic, you must allow a list of URLs and use the no_proxy settings while configuring the proxy. For instructions on how to configure your proxy, see Configuring the proxy.

Paso 2: descargar el software en su 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	Required. uipathctl is a UiPath command-line tool that allows you to run commands against Automation Suite Kubernetes hosted on Azure Kubernetes Service (AKS) and 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. Para obtener más información, incluida una lista completa de las operaciones uipathctl , consulta la .	Descargar uipathctl Ejecutar uipathctl
versions.json	Obligatorio. Necesario para realizar comprobaciones de requisitos previos y pasos de instalación.
kubectl	Opcional. Asegúrese de que kubectl coincida con la versión de su clúster

Paso 3: 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 deseas habilitar.

We provide different input.json template files for AKS and EKS. For instructions on how to configure input.json, see Configuring input.json.

Optionally, you can bring your own components that are part of the Automation Suite stack. For details on the components, see Automation Suite on EKS/AKS stack. For details on how to configure the component you bring, see Bring your own components.

Paso 4: Acceder a su 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 5: 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:

The uipathctl prereq create command does not create the required SQL databases for Process Mining. You must manually create them by following the instructions in Bring your own database.

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

To check the prerequisites for installation, run `` . By default, the command checks all the prerequisites. However, it also allows you to run strictly the checks that are relevant to you:

• 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:

You can find the names of the components you can include or exclude from the prerequisite checks here. In the example, the first word on each outdented line represents the component name. For example: 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.

For an output result example, see Output example: prerequisite check.

Paso 6: instalar Automation Suite

Nota:

To see which deployment scenarios are available for Automation Suite on AKS/AKS, see Deployment scenarios.

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
   

   For an output example, see Output example: Automation Suite installation.

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:

If you run into issues during installation, see Troubleshooting.