Skip to main content

Esta versão do GitHub Enterprise Server será descontinuada em 2024-03-07. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Problemas conhecidos com backups para sua instância

Confira uma visão geral das soluções alternativas para problemas que afetam o processo de backup ou restauração para GitHub Enterprise Server.

Sobre os problemas conhecidos com os backups do GitHub Enterprise Server

GitHub fornece soluções alternativas para os problemas a seguir, que podem afetar o backup ou a restauração de dados para uma instância do GitHub Enterprise Server. Para saber mais, confira "Problemas conhecidos" nas Notas sobre a versão do GitHub Enterprise Server.

Os usuários não podem entrar após a restauração de um backup

Nota: Esse problema conhecido foi corrigido em GitHub Enterprise Server Backup Utilities 3.8.1.

Se você usou GitHub Enterprise Server Backup Utilities 3.7.0 ou 3.8.0 para fazer backup de uma instância que executa qualquer versão na série GitHub Enterprise Server 3.7 ou 3.8, depois que você restaura o backup para uma nova instância, os usuários não podem entrar. Embora os usuários não possam entrar, o backup em si não é afetado e todos os dados estão intactos.

Depois de restaurar um backup existente afetado por esse problema, você poderá resolver o problema modificando a configuração na nova instância.

Restaurar de um backup existente

Se você tiver restaurado um backup existente do GitHub Enterprise Server Backup Utilities 3.8.0 para uma nova instância e os usuários não puderem entrar, você precisará gerar dados de configuração da instância de origem de GitHub Enterprise Server e ajustar a configuração na instância de destino.

Para garantir que os usuários possam entrar na nova instância de destino, verifique se o ambiente atende aos requisitos a seguir.

  1. Conecte-se por SSH à instância de origem GitHub Enterprise Server da qual você fez backup. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Substitua HOSTNAME pelo nome do host real da instância. Para obter mais informações sobre o acesso SSH, confira "Acesar o shell administrativo (SSH)".

    Shell
    ssh -p 122 admin@HOSTNAME
    
  2. Para exibir uma lista de chaves de descriptografia, execute o comando a seguir.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    
  3. Copie a saída para um local seguro e temporário.

  4. Para exibir uma lista de chaves de criptografia, execute o comando a seguir.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  5. Copie a saída para um local seguro e temporário.

  6. Conecte-se por SSH à instância de destino GitHub Enterprise Server na qual você armazenou o backup. Substitua HOSTNAME pelo nome do host real da instância.

    Shell
    ssh -p 122 admin@HOSTNAME
    
  7. Habilite o modo de manutenção. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".

  8. Para verificar se a instância de destino está pronta para configuração, execute os seguintes comandos. Não deve haver nenhuma saída exibida.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  9. Para atualizar as chaves de descriptografia na instância de destino, execute o comando a seguir. Substitua DECRYPTION-KEY-LIST pela saída da etapa 1.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material "DECRYPTION-KEY-LIST"
    
  10. Para atualizar a chave de criptografia na instância de destino, execute o comando a seguir. Substitua ENCRYPTION-KEY pela saída da etapa 4.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key "ENCRYPTION-KEY"
    
  11. Para aplicar a configuração, execute o comando a seguir.

    Shell
    ghe-config-apply
    
  12. Aguarde a conclusão da execução de suas configurações.

  13. Para garantir que a configuração da instância de destino contenha as chaves, execute os seguintes comandos e verifique se a saída corresponde à etapa 1 e à etapa 4.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  14. Faça com que um usuário entre na instância de destino. Se qualquer problema surgir, entre em contato com o Suporte do GitHub Enterprise. Para obter mais informações, confira "Entrando em contato com o suporte do GitHub".