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:

Debes elegir una de las siguientes opciones para configurar el registro compatible con OCI:

• Recomendado. Traiga su propio registro. Para obtener más información, consulta Cargar los artefactos de Automation Suite en el registro externo compatible con OCI en esta página.
• Si no tienes un registro, puedes instalar temporalmente un registro compatible con OCI en una de las máquinas del servidor. Para obtener más información, consulta Configurar el registro temporal de Docker en esta página.

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. 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 Descarga de paquetes de instalación.

Descargar as-helm-charts.txt

Para descargar as-helm-charts.txt, consulta Descarga de 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:

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

Descargar as.tar.gz

Para descargar as.tar.gz, consulta Descarga de 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 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
   

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:

./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, como se muestra en el siguiente ejemplo:

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

Configurar el registro temporal de Docker

Nota:

Este paso solo es necesario para las instalaciones sin conexión que utilizan un registro en clúster. Puedes omitir este paso si realizas una instalación sin conexión que utiliza un registro externo compatible con OCI, o una instalación en línea. Debes realizar este paso solo en uno de los nodos del servidor. Debes asegurarte de que el nodo tenga una capacidad adicional de 512 GB para ser utilizado como backend para el registro. Normalmente se recomienda que esté en el punto de montaje /uipath .

El registro temporal de Docker solo es necesario durante la instalación o la actualización. Una vez que la instalación o actualización se realiza correctamente, el registro temporal ya no es necesario y debe desinstalarse.

Requisitos previos para configurar el registro temporal

Para configurar el registro temporal, necesitas lo siguiente:

• as-fs.tar.gz : para descargarlo, consulta Descargar los paquetes de instalación.

Instalar el registro temporal

Para instalar el registro temporal de Docker en uno de los nodos, ejecuta el siguiente comando:

./configureUiPathAS.sh registry install-temp-registry -i cluster_config.json

Marca	Descripción
-i, --input	Opcional. Acepta la ruta a cluster_config.json. Solo es necesario al cambiar el puerto de registro y la ruta del archivo predeterminados.

De forma predeterminada, el registro temporal se instala en la máquina en el puerto 30070 y utiliza la ruta del archivo /uipath/data/registry. Debes abrir el puerto 30070 en el equilibrador de carga y el nodo en el que instalas el registro temporal de docker.

Nota:

El grupo del backend del equilibrador de carga debe dirigirse exclusivamente a los nodos que alojan el registro temporal de Docker.

Si quieres cambiar el puerto del registro temporal predeterminado y la ruta del archivo, debes actualizar el archivo cluster_config.json como se muestra en el siguiente ejemplo:

{
  "infra": {
    "tmp_docker_registry": {
      "node_port": "<new port number>",
      "file_path": "/uipath/data/registry"
    }
  }
}

Hidratar el registro temporal

Instalar Podman es obligatorio antes de hidratar el registro temporal. Si ya has validado e instalado los paquetes RPM necesarios, Podman se instala automáticamente. De lo contrario, es esencial instalar manualmente Podman antes de proceder a la configuración del registro temporal de Docker para las instalaciones sin conexión.

Después de instalar el registro temporal, realiza los siguientes pasos:

1. Hidrata el registro temporal con las imágenes del contenedor y los diagramas de Helm ejecutando el siguiente comando:

   ./configureUiPathAS.sh registry hydrate-temp-registry --offline-bundle /uipath/tmp/as-fs.tar.gz -i cluster_config.json
   

2. Semilla el registro interno desde el registro temporal ejecutando el siguiente comando. Si aplicas un parche, sigue los pasos descritos en la siguiente nota.

   ./configureUiPathAS.sh registry seed-internal-registry -i cluster_config.json
   

   Nota:

   Si aplicas un parche a una versión existente de Automation Suite, sigue los siguientes pasos. Esto no es aplicable a LTS o CU. Para obtener más información sobre cómo aplicar una revisión de Automation Suite, consulta Aplicar un parche.

   1. Descarga los archivos docker-image.json y versions.json, y luego sigue los siguientes pasos:

      1. Cambiar el directorio a la carpeta del instalador:

         cd "${INSTALLER_PATH}"
         

      2. Crear una copia de seguridad de los archivos docker-image.json y helm-charts.json:

         cp versions/docker-images.json versions/docker-images.json.bak
         cp versions/helm-charts.json versions/helm-charts.json.bak
         

      3. Copia los archivos descargados docker-images.json y versions.json en la carpeta del instalador:

         cp <PATH_OF_PATCH_VERSION_docker-images.json> versions/docker-images.json
         cp <PATH_OF_PATCH_VERSION_versions.json> versions/helm-charts.json
         

   2. Siembra el registro interno desde el registro temporal ejecutando el siguiente comando:

      ./configureUiPathAS.sh registry seed-internal-registry -i cluster_config.json
      

   3. Revertir el docker-image.json y helm-charts.json a los archivos originales:

      cp versions/docker-images.json.bak versions/docker-images.json
      cp versions/helm-charts.json.bak versions/helm-charts.json
      

:::

Marca	Descripción
--offline-bundle	Ruta del archivo que contiene la ubicación de as-fs.tar.gz en el nodo de tu servidor.
-i, --input	Opcional. Acepta la ruta del archivo cluster_config.json. Solo es necesario cuando se cambia el puerto de registro y la ruta del archivo predeterminados de Docker.