Restaurar copia de seguridad

Restaure un clúster de Automation Suite a partir de una copia de seguridad de instantánea y vuelva a habilitar la copia de seguridad después de que se complete la restauración.

Nota:

Una vez que se restaura un clúster, la copia de seguridad de la instantánea no está habilitada. Para habilitarla después de la restauración, consulta Habilitar la instantánea de copia de seguridad.

La restauración del clúster no restaura orígenes de datos externos como SQL Server, el almacén de objetos o el registro compatible con OCI. Asegúrate de restaurar esta fuente de datos a la instantánea correspondiente.

Para restaurar el clúster, siga los siguientes pasos:

1. Instala la infraestructura del clúster en todos los nodos del servidor. Detalles...

   Nota:

   El hardware que proporciones para el clúster de restauración debe ser similar al hardware del clúster de copia de seguridad. Para obtener más información, consulta Requisitos de hardware y software.

2. Configura la instantánea en el clúster restaurado. Detalles...

3. Seleccione la instantánea que desea restaurar. Detalles...

4. Restaure los datos y la configuración. Detalles...

Step 1: Installing the cluster infrastructure

Preparación

1. Descarga el instalador de restauración. Puedes encontrarlo dentro del paquete as-installer.zip . Para obtener instrucciones de descarga, consulta Descargar los paquetes de instalación.

2. En entornos sin conexión, debes proporcionar un registro externo compatible con OCI o un registro temporal. Ten en cuenta que la configuración del registro debe seguir siendo la misma que la del clúster original. Para configurar el registro, consulta las siguientes instrucciones:

   • Configurar el registro externo compatible con OCI
   • Configurar el registro temporal de Docker. Elige esta opción solo si no utilizaste un registro externo compatible con OCI antes de que ocurriera el desastre.

3. Prepara el archivo de configuración y haz que esté disponible en todos los nodos del clúster. Para preparar el archivo de configuración, sigue uno de los siguientes pasos:

   • Opción A: reutilizar el archivo cluster_config.json que aplicaste al clúster antes de que ocurriera el desastre;
   • Opción B: crea un archivo cluster_config.json mínimo con los parámetros necesarios, como se muestra en el siguiente ejemplo:

     {
       "fixed_rke_address": "fqdn",
       "fqdn": "fqdn",
       "rke_token": "guid",
       "profile": "cluster_profile",
       "external_object_storage": { 
         "enabled": false 
       },
       "install_type": "offline or online",
       "snapshot": {
         "enabled": true,
         "nfs": {
           "server": "nfs_server_endpoint",
           "location": "nfs_server_mountpoint"
         }
       },
       "proxy": { "enabled": false }
     }
     

     Nota:

     Este ejemplo utiliza parámetros para una configuración de copia de seguridad basada en NFS. Si utilizas una configuración de copia de seguridad diferente, debes reemplazar la sección relacionada con NFS con los parámetros específicos de tu configuración de copia de seguridad.

La siguiente tabla describe todos los parámetros que debes incluir en el archivo mínimo cluster_config.json . Asegúrate de proporcionar los mismos valores de parámetro que los utilizados en el clúster original. Puedes cambiar los valores de los parámetros después de la restauración.

Importante:

En entornos sin conexión, además de establecer los parámetros cluster_config.json enumerados en la siguiente tabla, también debes proporcionar la configuración del registro externo compatible con OCI. Para obtener más información, consulta Configuración de registro compatible con OCI externo.

Parámetro	Valor
fqdn	FQDN del clúster de Automation Suite. El valor debe ser el mismo que el antiguo FQDN. Proporcionar un valor de FQDN diferente puede hacer que la restauración falle.
fixed_rke_address	La dirección fija utilizada para cargar el registro de nodos de equilibrio y las solicitudes de API de Kube. Si el equilibrador de carga está configurado como se recomienda, el valor debe ser el mismo que el de fqdn . De lo contrario, utiliza el valor fqdn del primer nodo del servidor. Para obtener más información, consulta Configurar el equilibrador de carga .
rke_token	Utilice aquí un GUID recién generado. Este es un secreto previamente compartido y específico del clúster. Es necesario para todos los nodos que se unan al clúster.
profile	Establece el perfil de la instalación. Los perfiles disponibles son: default – perfil de evaluación de nodo único ha – perfil de producción multinodo preparada para alta disponibilidad
install_type	Indica el tipo de instalación que planea realizar. Tus opciones son: online: una instalación con acceso a Internet offline : una instalación sin acceso a Internet
server	El FQDN o la dirección IP de la ubicación de almacenamiento de la instantánea (como mynfs.mycompany.com o 192.23.222.81 ).
location	La ubicación o ruta a la ubicación de almacenamiento de la instantánea.
infra.pod_log_path	La ruta al directorio personalizado utilizado para los registros del pod. Esto es necesario si el clúster se configuró con una ruta de registros de pod personalizada.
proxy	Este parámetro es obligatorio solo si el proxy está habilitado. Para obtener más información, consulta Opcional: configurar el servidor proxy.

Para obtener más información sobre cómo cluster_config.json, consulta Manual: experiencia de instalación avanzada.

Ejecución

Instalar la infraestructura del clúster en el nodo del servidor principal

Para instalar la infraestructura en el nodo del clúster de restauración principal, ejecuta los siguientes comandos:

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json --accept-license-agreement --restore

Importante:

Copie cluster_config.json del nodo del servidor principal a los nodos de servidor/agentes restantes. El paso de instalación de la infraestructura en el nodo del servidor principal añade valores adicionales que necesitan los nodos restantes.

Instalación de la infraestructura del clúster en servidores secundarios

Para instalar la infraestructura en los servidores secundarios:

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j server --accept-license-agreement --restore

Instalar la infraestructura en todas las máquinas agente

Para instalar la infraestructura en los nodos agente:

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j agent --accept-license-agreement --restore

Hidratar el registro en el clúster para instalaciones sin conexión

Este paso solo es necesario si utilizas un registro en clúster para instalaciones sin conexión. Debes hidratar el registro antes de desencadenar la restauración, utilizando el siguiente comando:

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

Instalar la infraestructura del clúster en los nodos de servicio

Instalación de la infraestructura del clúster en nodos de Automation Suite Robots

Para instalar la infraestructura del clúster en los nodos de Automation Suite Robots:

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j asrobots --accept-license-agreement --restore

Instalación de la infraestructura del clúster en nodos de GPU

Para instalar la infraestructura del clúster en los nodos de la GPU:

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j gpu --accept-license-agreement --restore

Paso 2: preparar el clúster para la restauración

Una vez instalada la infraestructura, debes preparar la instantánea del clúster para la restauración. Según tu escenario, debes ejecutar los siguientes comandos:

• Si utilizas un objeto externo:

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

• Si utilizas un almacén de objetos ceph en el clúster:

  ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --only base,rook-ceph-operator,rook-ceph-object-store,velero --versions versions/helm-charts.json
  

Para configurar la copia de seguridad del clúster restaurado, sigue los pasos de la sección Configurar la instantánea del clúster .

Step 3: Selecting the snapshot to restore

Después de configurar la instantánea, enumera las instantáneas existentes y decide cuál quieres utilizar como punto de restauración.

Step 4: Restoring data and settings

Para restaurar a un clúster anterior, proporciona el nombre de la instantánea desde la que deseas convertir usando la --from-snapshot <snapshot-name> .

./bin/uipathctl snapshot restore create <restore_name> --from-snapshot <snapshot_name>

El comando desencadena el proceso de restauración. El proceso primero restaura la copia de seguridad y luego realiza tareas relacionadas con Automation Suite. Cuando se configura el almacenamiento de Ceph en el clúster, también restaura los datos de Ceph antes de sincronizar las aplicaciones.

Si el proceso de restauración falla, puedes volver a ejecutar el comando restore create con un nuevo nombre. El reintento reanuda el proceso de restauración desde el paso en el que falló durante el intento anterior.

Para comprobar el estado del proceso de restauración, ejecuta el siguiente comando:

./bin/uipathctl snapshot restore history

Este comando solo muestra el estado de restauración del estado del clúster (recursos de Kubernetes).

Para supervisar la restauración de datos del almacén de objetos y las tareas posteriores a la restauración realizadas por Automation Suite, compruebe la salida del terminal del comando de instantánea restore create .

Si no especificas el nombre de la instantánea, el clúster restaura la última instantánea correcta. Consulta la lista de instantáneas para ver las instantáneas disponibles.

Restaurar cluster_config.json

Después de la recuperación del clúster de Automation Suite, es posible que desee recuperar el archivo cluster_config.json para su uso futuro, como agregar nuevos nodos al clúster, actualizar, etc.

Para restaurar cluster_config.json, sigue los siguientes pasos:

1. Debes encontrar la última configuración aplicada ejecutando el siguiente comando:

   ./bin/uipathctl manifest list-revisions
   

   El siguiente ejemplo es un ejemplo de la salida del comando:

   VERSION  UPDATED                        STATUS
   1        2024-11-07 00:46:41 +0000 UTC  successful
   2        2024-11-07 01:14:20 +0000 UTC  successful
   3        2024-11-07 01:23:23 +0000 UTC  successful
   

2. Selecciona el número de VERSIÓN correcto implementado antes de la creación de la copia de seguridad y ejecuta el siguiente comando para recuperar el archivo cluster_config.json :

   ./bin/uipathctl manifest get-revision --version <VERSION>
   

   El siguiente ejemplo es un ejemplo de la salida del comando:

   ./bin/uipathctl manifest get-revision --version 1 > ./cluster_config.json
   

Añadir certificados de CA al almacén de confianza

Después de restaurar el clúster, asegúrate de añadir tus certificados de CA al almacén de confianza de las máquinas virtuales restauradas. Para obtener más información, consulta:

• Acceder al certificado TLS
• Adding the CA certificate to the host trust store

Recuperar nueva contraseña de supervisión

Nota:

Esta sección solo es aplicable si utilizas la solución de supervisión integrada.

Después de restaurar un clúster de Automation Suite, debes recuperar la nueva contraseña de supervisión. Para esto, sigue los pasos desde Acceder a las herramientas de supervisión.

Habilitar AI Center en el clúster restaurado

Después de restaurar un clúster de Automation Suite con AI Center™ habilitado, sigue los pasos del procedimiento Habilitar AI Center en el clúster restaurado .

Generando un nuevo ticket de Kerberos

Si la autenticación Kerberos está configurada, debes asegurarte de que el ticket de Kerberos no haya caducado.

Para generar un nuevo ticket de Kerberos, ejecuta los siguientes comandos:

kubectl get cronjobs -A | grep kerberos //to identify the job with name kerberos-tgt-update
kubectl create job --from=cronjob/<cron-job-name> <new_job_name> -n <namespace>

Asegúrate de reemplazar <cron-job-name>, <new_job_name> y <namespace> con el nombre real de tu trabajo cron, el nombre previsto para el nuevo trabajo y tu espacio de nombres real, respectivamente.