Paso 1: configurar el registro compatible con OCI para las instalaciones sin conexión

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. Si realizas una instalación en línea, omite este paso.

Nota:

Recomendamos encarecidamente traer tu propio registro. Si no tienes uno disponible, puedes instalar temporalmente un registro compatible con OCI en una de las máquinas del servidor.

Cargar los artefactos de Automation Suite en el registro externo compatible con OCI

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.

En la siguiente tabla se compara las dos opciones para cargar los artefactos en el registro para que puedas elegir la que mejor se adapte a tus necesidades:

Opción A: duplicar el registro	Opción B: hidratar el registro
Copia los artefactos del registro de UiPath® en cualquier registro de destino.	Utiliza el tarball sin conexión para descomprimir y cargar los artefactos en el registro de destino.
Requiere herramientas de Docker y Helm.	Requiere herramientas Podman y Helm.
Requiere acceso a Internet para copiar los artefactos del registro de UiPath® al registro de destino.	Requiere acceso a Internet solo para descargar el tarball sin conexión al servidor de salto. Cargar el tarball no requiere acceso a Internet.
Requiere un espacio temporal para almacenar en caché las imágenes durante el método de copia. Este espacio generalmente se configura durante la instalación de Docker. La ubicación predeterminada es /var/lib/docker.	Requiere un espacio temporal para extraer el tarball y un espacio temporal para que Podman cargue las imágenes. La ubicación de la extracción del tarball debe proporcionarse durante el paso de hidratación. La ubicación de Podman puede ser /var/tmp, que debe tener el almacenamiento adecuado disponible.
La capacidad de almacenamiento necesaria para el directorio /var/lib/docker es de unos 128 GiB.	La capacidad de almacenamiento necesaria para la extracción es de unos 200 GiB y /var/tmp debe ser de 256 GiB.

Nota: se recomienda realizar la operación de duplicación o hidratación desde la máquina de gestión o el cuadro de salto, en lugar de utilizar los nodos del servidor.

Opción A: duplicar el registro de UiPath® en tu registro

Este método requiere acceso a Internet en la máquina de salto desde la que cargas los artefactos de Automation Suite en tu registro compatible con OCI.

Requisitos previos para duplicar el registro de UiPath®

Para duplicar el registro de UiPath®, necesitas lo siguiente:

• una máquina virtual que ejecute una distribución de Linux (recomendado) o un ordenador portátil (no recomendado);

• un cliente de Docker autenticado con el registro privado;

• Helm 3.8 o posterior autenticado con el registro privado;

• as-images.txt;
• as-helm-charts.txt;
• mirror-registry.sh;
• conectividad saliente a registry.uipath.com;
• 128 GiB de espacio en disco libre para Docker en la partición /var/lib/docker en la máquina desde la que cargas las imágenes y los gráficos del contenedor.

Instalar Docker y Helm

Debes tener Docker y Helm instalados y autenticados en la máquina desde la que planeas cargar las imágenes del contenedor de Automation Suite y los gráficos en tu registro.

• Para descargar los binarios de Docker, consulta la documentación oficial.

• Para autenticar el registro de Docker, consulta la documentación oficial. También puedes utilizar el siguiente comando reemplazando las credenciales de ejemplo por tus credenciales de registro reales:

  docker login my.registry.io:443 --username "admin" --password "secret"

• Para descargar los binarios de Helm, consulta la documentación oficial.

• Para autenticar el registro de Helm, consulta la documentación oficial. También puedes utilizar el siguiente comando reemplazando las credenciales de ejemplo por tus credenciales de registro reales:

  helm registry login my.registry.io:443 --username "admin" --password "secret"

Descargar as-images.txt

Para descargar as-images.txt, consulta Descargar paquetes de instalación.

Descargar as-helm-charts.txt

Para descargar as-helm-charts.txt, consulta Descargar paquetes de instalación.

Descargar los paquetes opcionales de Document Understanding

Para descargar los paquetes opcionales de Document Understanding, consulta la documentación de Document Understanding.

Descargar mirror-registry.sh

Para descargar el script mirror-registry.sh, consulta Descargar los paquetes de instalación.

Cargar las imágenes de Automation Suite a tu registro

El script mirror-registry.sh requiere conectividad saliente a los registros del origen(registry.uipath.com predeterminado) y de destino.

Nota:

El script mirror-registry.sh no realiza la autenticación en el registro. Se supone que ya te has autenticado en el registro.

Marca	Variable de entorno	Descripción
--images-manifest	IMAGES_MANIFEST	Obligatorio. Ruta al archivo de manifiesto de la imagen.
--helm-charts-manifest	HELM_CHARTS_MANIFEST	Obligatorio. Ruta al archivo de manifiesto del gráfico Helm.
--target-registry-url	TARGET_REGISTRY_URL	Obligatorio. Pasa la URL para el registro de destino.
--source-registry-url	SOURCE_REGISTRY_URL	Opcional. Pasa la URL del registro de origen; el valor predeterminado es registry.uipath.com.

Para cargar las imágenes de Automation Suite en tu registro:

1. Asegúrate de tener los permisos necesarios para ejecutar el script de shell ejecutando el siguiente comando:

   chmod +x mirror-registry.sh

2. Carga las imágenes de Automation Suite en tu registro, ejecutando el siguiente comando:

   ./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt

   Nota: Para los registros, como Harbor, que requieren el uso de un proyecto, asegúrate de añadir el nombre del proyecto a la URL del registro de destino que incluyes en el comando, como se muestra en el siguiente ejemplo:

   ./mirror-registry.sh --target-registry-url my.registry.io:443/myproject --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt

Opción B: hidratar el registro con el paquete sin conexión

Este método solo requiere acceso a Internet en la máquina de salto para descargar el paquete sin conexión. Una vez que el paquete esté disponible, podrás cargarlo a tu registro compatible con OCI sin conexión a Internet.

Nota:

Este método también puede requerir espacio adicional en la máquina para descomprimir y cargar en tu registro. Además, este método puede tardar más que el enfoque de duplicación.

Requisitos previos para hidratar el registro

Para hidratar el registro, necesitas lo siguiente:

• es preferible una máquina virtual que ejecute una distribución de Linux a la ejecución del script en un ordenador portátil;
• capacidad de descargar y copiar o propagar de alguna manera el paquete sin conexión a la máquina virtual;
• Helm 3.8 o posterior autenticado con el registro privado;
• Podman instalado, configurado y autenticado con el registro privado;
• 150 GiB de espacio en disco libre para Podman en /var/lib/containers para cargar los contenedores localmente antes de enviarlos al registro remoto. Puedes cambiar la ruta predeterminada actualizando la ubicación de la ruta de graphRoot en el resultado del comando podman info.
• Establece la variable de entorno TMP_DIR como se describe en la documentación oficial de Podman.
• as.tar.gz

Instalar Podman y Helm

Debes asegurarte de tener Docker y Helm instalados y autenticados en la máquina desde la que planeas cargar las imágenes del contenedor de Automation Suite y los gráficos en tu registro.

• Para descargar los binarios de Podman, consulta la documentación oficial.
• Para autenticarte en el registro de Podman, consulta la documentación oficial. También puedes utilizar el siguiente comando reemplazando las credenciales de ejemplo por tus credenciales de registro reales:

  podman login my.registry.io:443 --username "admin" --password "secret"

• Para descargar los binarios de Helm, consulta la documentación oficial.
• Para autenticar el registro de Helm, consulta la documentación oficial. También puedes utilizar el siguiente comando reemplazando las credenciales de ejemplo por tus credenciales de registro reales:

  helm registry login my.registry.io:443 --username "admin" --password "secret"

Descargando as.tar.gz

Para descargar as.tar.gz, consulta Descargar paquetes de instalación.

Descargar los paquetes opcionales de Document Understanding

Para descargar paquetes opcionales de Document Understanding, consulta la documentación de Document Understanding.

Descargar hydrate-register.sh

Para descargar el script hydrate-registry.sh, consulta Descargar los paquetes de instalación.

Cargar las imágenes de Automation Suite al registro

Para cargar las imágenes de Automation Suite en el registro, utiliza el script hydrate-registry.sh .

El script hydrate-registry.sh no requiere conectividad saliente excepto con los registros de destino.

Nota:

El script hydrate-registry.sh no realiza la autenticación en el registro. Se supone que ya te has autenticado en el registro.

Marca	Descripción
--offline-bundle-path	Obligatorio. Ruta al paquete sin conexión.
--target-registry-url	Obligatorio. Pasa la URL para el registro de destino.
--extract-path	La ubicación que se utilizará para desatar el paquete sin conexión. Puede ser una ubicación /var/lib/containers o una ubicación personalizada. Asegúrate de tener un mínimo de 100 GiB de almacenamiento. Se recomienda tener 256 GiB de almacenamiento.

Para cargar las imágenes de Automation Suite en el registro:

1. Asegúrate de que tengamos los permisos necesarios para ejecutar el script del shell, ejecutando el siguiente comando:

   chmod +x hydrate-registry.sh

2. Carga las imágenes de Automation Suite en tu registro ejecutando el siguiente comando:

   ./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path

Note: For registries, such as Harbor, which require using a project, make sure you append the project name to the target registry URL you include in the command, as shown in the following example:

./hydrate-registry.sh --target-registry-url my.registry.io:443/myproject --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path

For Document Understanding offline bundles, make sure to include --extract-path in the command, as shown in the following example:

./hydrate-registry.sh  --target-registry-url my.registry.io:443 --optional-bundle-path ./dusemistructured-2023.10.0.tar.gz --extract-path /tmp

Configurar el certificado para el registro externo compatible con OCI

Para configurar correctamente tu registro externo compatible con OCI, debes actualizar el almacén de confianza de todas las máquinas en las que planeas instalar Automation Suite. Para obtener instrucciones sobre cómo realizar este paso después de la instalación, consulta Gestionar certificados.

Para hacerlo, sigue los siguientes pasos:

1. Añade el archivo de CA a la ubicación /etc/pki/ca-trust/source/anchors/.
2. Ejecuta update-ca-trust para actualizar el almacén de confianza del sistema operativo. Una vez que se actualiza el almacén de confianza, el archivo de certificado extraído se fusiona en /etc/pki/ca-trust/extracted/ca-bundle.trust.crt.

Nota:

Debes proporcionar el certificado CA durante la instalación de Automation Suite. Debes proporcionar el certificado en el parámetro registry_ca_cert en el archivo cluster_config.json. Para obtener más información, consulta Configuración de registro compatible con OCI externo.