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. Trae tu 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 ningún 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: 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 mientras se copian los artefactos del registro de UiPath® en el 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 de 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 /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 que tengamos los permisos necesarios para ejecutar el script del 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 anexar el nombre del proyecto a la URL de 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. Aparte de eso, 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 mirror-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

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 piensas 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 GiB para utilizarlo como backend del 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 de Automation Suite existente, sigue los siguientes pasos en su lugar. Para obtener más información sobre cómo aplicar un parche 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.