{"meta":{"title":"Restaurando com base em um backup","intro":"Restaure uma GitHub Enterprise Server instância usando um instantâneo de backup criado anteriormente.","product":"Administradores da empresa","breadcrumbs":[{"href":"/pt/enterprise-server@3.17/admin","title":"Administradores da empresa"},{"href":"/pt/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance","title":"Fazer backup e restaurar"},{"href":"/pt/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance/restoring-from-a-backup","title":"Restaurar do backup"}],"documentType":"article"},"body":"# Restaurando com base em um backup\n\nRestaure uma GitHub Enterprise Server instância usando um instantâneo de backup criado anteriormente.\n\nVocê pode restaurar uma GitHub Enterprise Server instância de um backup usando a linha de comando. O serviço de backup dá suporte à restauração da instância completa, incluindo a configuração e os dados do usuário.\n\n> \\[!WARNING] Restaurar a partir de um backup **substituirá todos os dados existentes** em sua instância. Essa operação não pode ser desfeita.\n\n## Requisitos de versão do instantâneo\n\nVocê só poderá restaurar um instantâneo se ele for, no máximo, de duas versões de funcionalidade anteriores à versão da instância de destino.\n\nPor exemplo:\n\n* Um instantâneo da versão 3.17 pode ser restaurado para um destino executando 3.17.x, 3.18.x ou 3.19.x.\n* Não é possível restaurar um instantâneo 3.17 para a 3.20, pois ela está mais de duas versões à frente.\n\nVocê também não pode restaurar de uma versão mais recente para uma mais antiga. Por exemplo, tentar restaurar um instantâneo 3.18 para uma instância 3.17 resultará em falha com: `Error: Snapshot can not be restored to an older release of GitHub Enterprise Server.`\n\n## Pré-requisitos\n\nAntes de restaurar um backup:\n\n1. **Habilite o modo de manutenção** na instância de destino. Consulte [Habilitar e programar o modo de manutenção](/pt/enterprise-server@3.17/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode).\n2. **Verifique o acesso** ao armazenamento de backup que contém o instantâneo.\n3. **Pause os serviços que causam interferência** — se estiver usando alta disponibilidade (HA), verifique se a replicação foi interrompida.\n4. **Prepare-se para GitHub Actions** — se estiver habilitado, verifique se a instância de destino está configurada com o armazenamento externo correto. Confira [Restaurando com GitHub Actions habilitadas](/pt/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance/restoring-with-github-actions-enabled) para obter detalhes.\n\n## Iniciando a operação de restauração\n\nPara restaurar de um instantâneo:\n\n1. Acesse a instância de destino via SSH como o usuário `admin`.\n\n2. Execute um dos seguintes comandos:\n\n   * Restaure o instantâneo mais recente:\n\n     ```shell\n     ghe-restore\n     ```\n\n   * Restaure um instantâneo específico. Substitua `<SNAPSHOT_TIMESTAMP>` pelo carimbo de data/hora do instantâneo que você deseja restaurar (por exemplo, `YYYYMMDDTHHMMSS`).\n\n     ```shell\n     ghe-restore -s <SNAPSHOT_TIMESTAMP>\n     ```\n\n   * (Opcional) Substitua a configuração do dispositivo, os certificados e os dados de licença do backup. A `-c` opção não controla a restauração de banco de dados ou repositório:\n\n     ```shell\n     ghe-restore -c          # Latest snapshot\n     ghe-restore -s <SNAPSHOT_TIMESTAMP> -c  # Specific snapshot\n     ```\n\n3. **Finalizar em Console de Gerenciamento:**\n\n   * Revise todas as configurações (rede, autenticação, TLS etc.).\n   * Clique em **Save settings** para aplicá-las e iniciar os serviços.\n   * A instância não estará totalmente operacional até que esta etapa seja concluída.\n\n4. **Valide a instância restaurada** para garantir que tudo funciona conforme o esperado.\n\n5. **Se estiver usando HA**, conclua a restauração em uma instância autônoma primeiro. Em seguida, reconfigure a HA.\n\n   * Se encontrar problemas de sincronização (por exemplo, UUIDs obsoletos no `ghe-repl-status`), execute `ghe-repl-teardown`.\n   * Para obter ajuda, entre em contato Suporte do GitHub.\n\n6. **Registre novamente os executores auto-hospedados GitHub Actions**, pois a restauração invalida os tokens anteriores.\n\n## Rotação e retenção de instantâneo\n\nOs snapshots são podados automaticamente com base nas suas configurações de retenção.\n\n* Somente os n instantâneos mais recentes são mantidos (conforme configurado).\n* Instantâneos mais antigos são excluídos após cada backup bem-sucedido.\n* Instantâneos são nomeados usando carimbos de data/hora (`YYYYMMDDTHHMMSS`) para facilitar a referência.\n* Links rígidos são usados para armazenar arquivos inalterados com eficiência, preservando a capacidade de restauração completa.\n\n## Solução de problemas de falhas de restauração\n\nSe uma operação de restauração falhar, verifique:\n\n* **Integridade do backup** – verifique se o instantâneo não foi interrompido ou corrompido.\n* **Acesso ao armazenamento** – verifique se a instância pode montar e ler o volume de backup.\n* **Incompatibilidade de versão** – confirme se a versão do instantâneo é compatível com a instância de destino.\n* **Logs** – revisar `/var/log/github-backup/restore-verbose-[timestamp].log` para identificar erros.\n\nSe o Console de Gerenciamento mostrar uma falha genérica, acesse a instância via SSH para acessar os logs detalhados."}