Manual: instalar Automation Suite

La siguiente tabla enumera los pasos que debes realizar para la instalación de Automation Suite:

Pasos	Instalación de nodo único	Instalación multinodo	Modo básico
Requisito previo
Paso 1: aceptar el acuerdo de licencia
Paso 2: instalar la infraestructura en la primera máquina del servidor
Paso 3: instalar la infraestructura en las otras máquinas del servidor
Paso 4: instalar la infraestructura en todas las máquinas con agente
Paso 5: hidratar el registro en clúster para instalaciones sin conexión
Step 6: Completing the installation

Requisito previo

Configura la variable de entorno KUBECONFIG para que apunte al archivo de configuración de RKE2 Kubernetes y actualiza la variable de entorno PATH para incluir el directorio de herramientas de RKE2 utilizando los siguientes comandos de exportación:

export KUBECONFIG=/etc/rancher/rke2/rke2.yaml 
export PATH=$PATH:/var/lib/rancher/rke2/bin

Paso 1: aceptar el acuerdo de licencia

Antes de ejecutar la instalación, asegúrate de leer el acuerdo de licencia.

Para aceptar el acuerdo de licencia, elija uno de los siguientes métodos:

• Opción 1 (Variable de entorno): establece la variable de entorno LICENSE_AGREEMENT en accept ejecutando el siguiente comando:

  export LICENSE_AGREEMENT=accept

• Opción 2 (parámetro en línea): anexa --accept-license-agreement a cada ejecución de uipathctl.

Paso 2: instalar la infraestructura en la primera máquina del servidor

Para instalar la infraestructura en la primera máquina del servidor, navega hasta la carpeta del instalador y ejecuta el siguiente comando:

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

Nota:

• El parámetro -k instala la infraestructura en la primera máquina del servidor.

• Una vez que se instala la infraestructura, la máquina del servidor se convierte en un nodo en el clúster de Automation Suite.

Paso 3: instalar la infraestructura en las otras máquinas del servidor

Para expandir el clúster de Automation Suite, instala la infraestructura en las máquinas servidor adicionales.

Para hacerlo, ejecuta el siguiente comando en todas las máquinas del servidor adicionales:

cd /opt/UiPathAutomationSuite/<version>/installer
 
./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j server --accept-license-agreement

Nota: El parámetro -j server añade las máquinas como nodos de servidor al clúster de Automation Suite existente. La marca fixed_rke_address en el archivo cluster_config.json conecta el clúster de Automation Suite existente.

Paso 4: instalar la infraestructura en todas las máquinas con agente

Si tienes máquinas agente adicionales, debes instalar la infraestructura en esas máquinas y añadirlas como nodos agente al clúster de Automation Suite.

Para ello, ejecuta el siguiente comando en todas las máquinas de los agentes:

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j agent --accept-license-agreement

Nota:

El parámetro de servidor -j añade las máquinas como nodos de servidor al clúster de Automation Suite existente. El fixed_rke_address en el archivo cluster_config.json conecta el clúster de Automation Suite existente.

Paso 5: hidratar el registro en clúster para instalaciones sin conexión

Este paso solo es necesario si utilizas el registro en clúster para instalaciones sin conexión.

Para inicializar el registro en clúster desde el registro temporal, ejecuta el siguiente comando:

cd /opt/UiPathAutomationSuite/<version>/installer
./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json

Si estás configurando Automation Suite con proyectos modernos de Document Understanding habilitados, utiliza la opción --serial con el comando hydrate-registry para evitar problemas de falta de memoria:

./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json --serial

Step 6: Completing the installation

En este punto, todos los nodos deben estar interconectados para establecer la infraestructura para instalar Automation Suite.

Para completar la instalación, sigue los siguientes pasos:

1. Verifica si todos los nodos están disponibles en el primer nodo del servidor ejecutando el siguiente comando:

   kubectl get nodes

   La salida del comando mencionado debe ser similar a la que se muestra en la siguiente imagen. Ten en cuenta que el número total de nodos debe coincidir con la suma de los nodos del servidor y del agente.
   

2. Crea los requisitos previos necesarios para la instalación de componentes compartidos ejecutando el siguiente comando:

   ./bin/uipathctl prereq create /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

   Se trata principalmente de depósitos de almacenamiento de objetos y bases de datos SQL. Las bases de datos SQL necesarias para la instalación se crean en el servidor SQL si se establece sql.create_db key en el archivo de configuración. Los depósitos de almacenamiento de objetos se crean en el proveedor de la nube si la clave object_storage.create_bucket está establecida en el archivo de configuración.

3. Valida los requisitos previos requeridos por la instalación de componentes compartidos ejecutando el siguiente comando:

   ./bin/uipathctl prereq run /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

4. Después de verificar la infraestructura, instala los componentes compartidos y los servicios ejecutando el siguiente comando:

   ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions ./versions/helm-charts.json