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

Referencia para configurar un registro compatible con OCI para almacenar imágenes de contenedores y gráficos de Helm para instalaciones sin conexión en Automation Suite.

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: hidratando 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 un almacenamiento adecuado disponible.
La capacidad de almacenamiento necesaria para el directorio /var/lib/docker es de unos 128 GB.	La capacidad de almacenamiento necesaria para la extracción es de unos 200 GB, y /var/tmp debe ser de 256 GB.

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 ejecuta una distribución de Linux (recomendado) o un portátil (no recomendado)
• un cliente 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 GB de espacio libre en disco para Docker en la partición /var/lib/docker de la máquina desde la que se cargan 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. Como alternativa, puedes utilizar el siguiente comando reemplazando las credenciales de muestra 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. Como alternativa, puedes utilizar el siguiente comando reemplazando las credenciales de muestra por tus credenciales de registro reales:

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

Descargando los artefactos

Descarga los siguientes artefactos antes de continuar:

• as-images.txt: consulta Descargar los paquetes de instalación
• as-helm-charts.txt: consulta Descargar los paquetes de instalación
• mirror-registry.sh: consulta Descargar los paquetes de instalación
• Paquetes opcionales de Document Understanding: consulta la documentación de Document Understanding

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	Obligatorio	Descripción
--images-manifest	IMAGES_MANIFEST	Sí	Ruta al archivo de manifiesto de la imagen.
--helm-charts-manifest	HELM_CHARTS_MANIFEST	Sí	Ruta al archivo de manifiesto del gráfico de Helm.
--target-registry-url	TARGET_REGISTRY_URL	Sí	URL del registro de destino.
--source-registry-url	SOURCE_REGISTRY_URL	No	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
   

   Para registros como Harbor que requieren un proyecto, anexa el nombre del proyecto a la URL del registro de destino:

   ./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:

• Se prefiere una máquina virtual que ejecute una distribución de Linux a ejecutar el script en un 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 GB de espacio libre en disco para Podman en /var/lib/containers para cargar los contenedores localmente antes de enviarlos al registro remoto. Si necesitas cambiar la ruta predeterminada, actualiza la variable graphRoot en el archivo /etc/containers/storage.conf . Por ejemplo, puedes editar storage.conf utilizando sudo nano /etc/containers/storage.conf, cambiar graphRoot a tu nueva ruta y luego verificar que la ruta se actualiza utilizando el comando podman info .
• Establece la variable de entorno TMP_DIR como se describe en la documentación oficial de Podman. Esta variable especifica el almacenamiento temporal para las imágenes de contenedor descargadas durante las operaciones de extracción y construcción, cruciales para evitar errores de falta de espacio si /var/tmp está limitado.
• 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. Como alternativa, puedes utilizar el siguiente comando reemplazando las credenciales de muestra 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. Como alternativa, puedes utilizar el siguiente comando reemplazando las credenciales de muestra por tus credenciales de registro reales:

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

Descargando los artefactos

Descarga los siguientes artefactos antes de continuar:

• as.tar.gz: consulta Descargar los paquetes de instalación
• hydrate-registry.sh: consulta Descargar los paquetes de instalación
• Paquetes opcionales de Document Understanding: consulta la documentación de Document Understanding

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	Obligatorio	Descripción
--offline-bundle-path	Sí	Ruta al paquete sin conexión.
--target-registry-url	Sí	URL del registro de destino.
--extract-path	Sí	La ubicación que se utilizará para descomprimir el paquete sin conexión. Puede ser /var/lib/containers o una ubicación personalizada. Asegúrate de tener un mínimo de 100 GB de almacenamiento. Se recomienda tener 256 GB 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
   

   Para registros como Harbor que requieren un proyecto, anexa el nombre del proyecto a la URL del registro de destino:

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

   Para los paquetes sin conexión de Document Understanding, asegúrate de incluir --extract-path en el comando:

   ./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.