Restaurando o backup

Restaure um cluster do Automation Suite a partir de um backup de instantâneo e habilite novamente o backup após a conclusão da restauração.

Observação:

Depois que um cluster é restaurado, o backup de instantâneo não é habilitado. Para habilitá-lo após a restauração, consulte Habilitação do instantâneo de backup.

Restaurar o cluster não restaura fontes de dados externas, como o SQL Server, objectstore ou o registro compatível com OCI. Certifique-se de restaurar essas fontes de dados para o snapshot relevante.

Para restaurar o cluster, execute as seguintes etapas:

1. Instale a infraestrutura de cluster em todos os nós do servidor. Detalhes...

   Observação:

   O hardware que você fornece para o cluster de restauração deve ser semelhante ao hardware do cluster de backup. Para obter detalhes, consulte Requisitos de hardware e software.

2. Configure o instantâneo no cluster restaurado. Detalhes...

3. Selecione o snapshot para restaurar. Detalhes...

4. Restaure os dados e as configurações. Detalhes...

Step 1: Installing the cluster infrastructure

Preparação

1. Baixe o instalador de restauração. Você pode encontrá-lo dentro do pacote as-installer.zip . Para obter instruções de download, consulte Download dos pacotes de instalação.

2. Em ambientes offline, você deve fornecer um registro externo compatível com OCI ou um registro temporário. Observe que a configuração do registro deve permanecer a mesma do cluster original. Para configurar o registro, consulte as seguintes instruções:

   • Configurando o registro externo compatível com OCI
   • Configuração do registro temporário do Docker. Escolha esta opção apenas se você não usou um registro externo compatível com OCI antes de ocorrer o desastre.

3. Prepare o arquivo de configuração e disponibilize-o em todos os nós do cluster. Para preparar o arquivo de configuração, siga uma das seguintes etapas:

   • Opção A: reutilize o arquivo cluster_config.json que você aplicou ao cluster antes de ocorrer o desastre;
   • Opção B: crie um arquivo cluster_config.json mínimo com os parâmetros necessários, conforme mostrado no exemplo a seguir:

     {
       "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 }
     }
     

     Observação:

     Esse exemplo usa parâmetros para uma configuração de backup baseada em NFS. Se você usar uma configuração de backup diferente, deve substituir a seção relacionada ao NFS pelos parâmetros específicos para sua configuração de backup.

A seguinte tabela descreve todos os parâmetros que você deve incluir no arquivo cluster_config.json mínimo. Certifique-se de fornecer os mesmos valores de parâmetros usados no cluster original. Você pode alterar os valores de parâmetro após a restauração.

Importante:

Em ambientes offline, além de definir os parâmetros cluster_config.json listados na tabela a seguir, você também deve fornecer a configuração do registro externo compatível com OCI. Para obter detalhes, consulte Configuração do registro externo compatível com OCI.

Parâmetro	Valor
fqdn	FQDN do cluster do Automation Suite. O valor deve ser igual ao antigo FQDN. Fornecer um valor FQDN diferente pode fazer com que a restauração falhe.
fixed_rke_address	O endereço fixo usado para registro de nó de balanceamento de carga e solicitações de API do Kube. Se o balanceador de carga estiver configurado como recomendado, o valor deve ser o mesmo que o de fqdn . Caso contrário, use o valor fqdn do primeiro nó do servidor. Para obter detalhes, consulte Configuração do balanceador de carga .
rke_token	Use um GUID recém-gerado aqui. Este é um segredo pré-compartilhado, específico do cluster. É necessário para todos os nós associados ao cluster.
profile	Define o perfil da instalação. Os perfis disponíveis são: default – perfil de avaliação de nó único. ha – perfil de produção pronto para alta disponibilidade de vários nós
install_type	Indica o tipo de instalação que você planeja realizar. Suas opções são: online – instalação com acesso à Internet offline – instalação sem acesso à Internet
server	O FQDN ou o endereço IP do local de armazenamento do instantâneo (como mynfs.mycompany.com ou 192.23.222.81 ).
location	O local ou caminho para o local de armazenamento do instantâneo.
infra.pod_log_path	O caminho para o diretório personalizado usado para logs do pod. Isso é necessário se o cluster tiver sido configurado com o caminho de logs de pod personalizado.
proxy	Este parâmetro é obrigatório apenas se o proxy estiver habilitado. Para obter detalhes, consulte Opcional: configuração do servidor do proxy.

Para obter detalhes sobre como configurar cluster_config.json, consulte Manual: experiência de instalação avançada.

Execução

Instalar a infraestrutura de cluster no nó do servidor primário

Para instalar a infraestrutura no nó primário do cluster de restauração, execute os seguintes comandos:

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

Importante:

Copie cluster_config.json do nó do servidor principal para os nós de servidor/agentes restantes. A etapa de instalação da infraestrutura no nó do servidor primário adiciona valores extras dos quais os nós restantes precisam.

Instalando a infraestrutura de cluster em servidores secundários

Para instalar a infraestrutura nos servidores secundários:

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

Como instalar a infraestrutura em todas as máquinas de agente

Para instalar a infraestrutura nos nós do agente:

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

Preenchimento do registro no cluster para instalações offline

Essa etapa é necessária apenas se você usar um registro no cluster para instalações offline. Você deve hidratar o registro antes de disparar a restauração, usando o seguinte comando:

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

Instalando a infraestrutura de cluster em nós de serviço

Instalação da infraestrutura de cluster nos nós de Automation Suite Robots

Para instalar a infraestrutura de cluster nos nós de Automation Suite Robots:

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

Instalando a infraestrutura de cluster em nós de GPU

Para instalar a infraestrutura do cluster nos nós da GPU:

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

Etapa 2: preparando o cluster para restauração

Depois que a infraestrutura estiver instalada, você precisa preparar o instantâneo do cluster para restauração. Com base em seu cenário, você deve executar os seguintes comandos:

• Se você usar um objetore externo:

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

• Se você usar um ceph-objectstore no cluster:

  ./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 o backup do cluster restaurado, siga as etapas na seção Configurar o instantâneo do cluster .

Step 3: Selecting the snapshot to restore

Depois de configurar o snapshot, liste os snapshots existentes e decida aquele que você deseja usar como um ponto de restauração.

Step 4: Restoring data and settings

Para restaurar para um cluster anterior, forneça o nome do instantâneo do qual você deseja converter usando o sinalizador --from-snapshot <snapshot-name> .

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

O comando dispara o processo de restauração. O processo primeiro restaura o backup e depois executa tarefas relacionadas ao Automation Suite. Quando o armazenamento do Ceph no cluster é configurado, ele também restaura os dados do Ceph antes de sincronizar os aplicativos.

Se o processo de restauração falhar, você pode executar novamente o comando restore create com um novo nome. A nova tentativa retoma o processo de restauração da etapa em que falhou durante a tentativa anterior.

Para verificar o status do processo de restauração, execute o seguinte comando:

./bin/uipathctl snapshot restore history

Esse comando mostra apenas o status de restauração do estado do cluster (recursos do Kubernetes).

Para monitorar as tarefas de restauração e pós-restauração de dados do Objectstore executadas pelo Automation Suite, verifique a saída do terminal do comando restore create de instantâneo.

Se você não especificar o nome do snapshot mais recente, o cluster restaurará o snapshot mais recente bem-sucedido. Consulte a lista de instantâneo para obter instantâneos disponíveis.

Restaurando cluster_config.json

Após a recuperação do cluster do Automation Suite, você pode querer recuperar o arquivo cluster_config.json para uso futuro, como adicionar novos nós ao cluster, atualizar, etc.

Para restaurar cluster_config.json, siga as seguintes etapas:

1. Você precisa encontrar a última configuração aplicada, executando o seguinte comando:

   ./bin/uipathctl manifest list-revisions
   

   A amostra a seguir é um exemplo da saída do 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. Selecione o número correto da VERSÃO implantado antes da criação do backup e execute o seguinte comando para recuperar o arquivo cluster_config.json :

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

   A amostra a seguir é um exemplo da saída do comando:

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

Adicionando certificados de CA ao armazenamento de confiança

Após restaurar o cluster, certifique-se de adicionar seus certificados de CA ao armazenamento de confiança das VMs restauradas. Para detalhes, consulte:

• Acessando o certificado TLS
• Adding the CA certificate to the host trust store

Recuperação de nova senha de monitoramento

Observação:

Esta seção é aplicável apenas se você usar a solução de monitoramento integrada.

Após a restauração de um cluster do Automation Suite, você precisa recuperar a nova senha de monitoramento. Para isso, siga as etapas de Acesso às ferramentas de monitoramento.

Habilitação do AI Center no cluster restaurado

Depois de restaurar um cluster do Automation Suite com o AI Center™ habilitado, siga as etapas do procedimento Habilitação do AI Center no cluster restaurado .

Geração de novo ticket do Kerberos

Se a autenticação do Kerberos estiver configurada, você deve certificar-se de que o tíquete do Kerberos não esteja expirado.

Para gerar um novo tíquete do Kerberos, execute os seguintes 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>

Certifique-se de substituir <cron-job-name>, <new_job_name> e <namespace> pelo nome real do seu trabalho cron, o nome pretendido para o novo trabalho e seu namespace real, respectivamente.